تولید خودکار پست وبلاگ Shopify با هوش مصنوعی Gemini

تولیدکننده پست وبلاگ هوش مصنوعی برای محصولات Shopify با استفاده از Google Gemini و Google Sheets

این گردش کار، ایجاد پست‌های وبلاگ بهینه‌شده برای سئو (SEO) را برای محصولات Shopify شما خودکار می‌کند. از Google Sheets به عنوان هاب داده و از هوش مصنوعی Google Gemini برای تولید محتوا استفاده می‌کند، که آن را برای صاحبان فروشگاه‌های تجارت الکترونیک و بازاریابان که به دنبال بهبود تلاش‌های بازاریابی محتوا و سئو خود بدون نوشتن دستی هستند، ایده‌آل می‌سازد.

شما می‌توانید این گردش کار و موارد دیگر را در کاتالوگ Axeto.ai ما بیابید: https://axeto.ai/n8n

نمای کلی گردش کار

این گردش کار به چندین بخش منطقی تقسیم شده است:

1. دریافت ورودی و استخراج داده‌های محصول: تمامی محصولات Shopify را دریافت کرده و داده‌های خام آن‌ها را برای ماندگاری در یک Google Sheet ذخیره می‌کند.

2. پاکسازی و قالب‌بندی داده‌ها: توضیحات محصول (تبدیل HTML به متن ساده) را پاکسازی کرده، URLهای تصویر را تجزیه می‌کند و داده‌های ساختاریافته را در یک Google Sheet اصلاح‌شده آماده می‌کند.

3. فیلتر کردن و انتخاب: محصولاتی را که هنوز پست وبلاگ برای آن‌ها تولید نشده است، شناسایی کرده و پردازش را به یک محصول در هر اجرا محدود می‌کند.

4. تولید محتوای پست وبلاگ با هوش مصنوعی: داده‌های پاکسازی‌شده محصول را از طریق یک Langchain agent به Google Gemini AI ارسال می‌کند تا یک پست وبلاگ ساختاریافته، شامل عنوان، مقدمه، ویژگی‌ها، نقدها، فیلدهای SEO و قالب‌بندی، تولید کند.

5. مدیریت و انتشار محتوای پست وبلاگ: خروجی هوش مصنوعی را تجزیه کرده، آن را برای Shopify قالب‌بندی می‌کند، پست وبلاگ را با استفاده از Shopify Admin API ایجاد می‌کند و Google Sheet را با وضعیت پست وبلاگ و شناسه مقاله Shopify به‌روزرسانی می‌کند.

6. مدیریت وضعیت و نظارت: Google Sheets را برای پیگیری وضعیت تولید و انتشار پست وبلاگ به‌روز می‌کند، از تکرارناپذیری اطمینان حاصل کرده و پیشرفت را گزارش می‌دهد.

---

تحلیل گره به گره (Node Analysis)

۱. دریافت ورودی و استخراج داده‌های محصول

این بخش گردش کار را به صورت دستی فعال می‌کند، تمام محصولات فروشگاه Shopify شما را بازیابی کرده و اطلاعات خام آن‌ها را در یک صفحه Google Sheets ذخیره می‌کند.

• گره‌ها (Nodes):

* Start Creation (محرک دستی - Manual Trigger)

* Get All Product Details (گره Shopify)

* Product Details to Sheet (گره Google Sheets)

• جزئیات گره‌ها:

* Start Creation (محرک دستی - Manual Trigger): گردش کار را به صورت دستی آغاز می‌کند.

* Get All Product Details (گره Shopify): با استفاده از Shopify Admin API، تمام داده‌های محصول را واکشی می‌کند. نیاز به اعتبارنامه‌های احراز هویت شده Shopify دارد.

* پیکربندی: عملیات getAll بر روی منبع product.

* موارد مرزی (Edge Cases): محدودیت‌های نرخ (rate limits) API Shopify، انقضای احراز هویت، خطاهای شبکه.

* Product Details to Sheet (گره Google Sheets): داده‌های محصول (عنوان، تصاویر، handle، شناسه، توضیحات) را به یک صفحه "Raw Input" در Google Sheets اضافه یا به‌روزرسانی می‌کند. برای جلوگیری از تکرار، ردیف‌ها را بر اساس product_id مطابقت می‌دهد.

* پیکربندی: نگاشت فیلدهای محصول به ستون‌های خاص.

* موارد مرزی (Edge Cases): محدودیت‌های سهمیه (quota limits) API Google Sheets، شکست احراز هویت، عدم تطابق طرح‌واره (schema mismatches).

۲. پاکسازی و قالب‌بندی داده‌ها

این بخش داده‌های خام محصول را برای مصرف توسط هوش مصنوعی پالایش می‌کند. HTML را از توضیحات پاک کرده، URL تصاویر را در یک آرایه استخراج می‌کند و یک صفحه Google Sheets "Refined Input" را به‌روزرسانی می‌کند.

• گره‌ها (Nodes):

* Fix the input format (گره کد - Code Node)

* Update the sheet (گره Google Sheets)

• جزئیات گره‌ها:

* Fix the input format (گره کد - Code Node): یک گره کد جاوا اسکریپت که:

* تگ‌های HTML را از فیلد description حذف می‌کند تا cleanDescription ایجاد شود.

* فیلد images را به یک آرایه از URLها (imageSources) تجزیه (parse) می‌کند.

* شامل مدیریت خطا برای داده‌های بدشکل است.

* خروجی‌ها (Outputs): JSON با فیلدهایی مانند product_id, title, handle, description (HTML), cleanDescription (متن ساده), imageSources (آرایه), totalImages و یک فیلد اختیاری error.

* موارد مرزی (Edge Cases): HTML بدشکل، فیلد images به صورت رشته یا آرایه، شکست تجزیه JSON، فیلدهای گمشده.

* Update the sheet (گره Google Sheets): داده‌های محصول پاکسازی شده را به صفحه "Refined Input" اضافه یا به‌روزرسانی می‌کند.

* پیکربندی: نگاشت فیلدهایی مانند title, handle, images (تا ۴ مورد به عنوان ستون‌های جداگانه), cleanDescription, blog_status (پیش‌فرض "unused") و blog_id.

* موارد مرزی (Edge Cases): محدودیت‌های API Google Sheets، خطاهای احراز هویت، عدم تطابق اندیس‌های آرایه تصاویر.

۳. فیلتر کردن و انتخاب

این بخش اطمینان حاصل می‌کند که فقط محصولاتی که نیاز به پست وبلاگ دارند پردازش شوند و گردش کار را محدود می‌کند تا در هر بار اجرا فقط یک محصول را پردازش کند.

• گره‌ها (Nodes):

* Filter Duplicates (گره If)

* Limit = 1 (گره Limit)

* Nothing (گره NoOp)

• جزئیات گره‌ها:

* Filter Duplicates (گره If): بررسی می‌کند که آیا فیلد blog_status در صفحه "Refined Input" برابر با "unused" یا یک رشته خالی است یا خیر.

* خروجی‌ها (Outputs):

* True: برای محصولاتی که نیاز به وبلاگ دارند، به مرحله بعدی می‌رود.

* False: محصولاتی که قبلاً پردازش شده‌اند را رد می‌کند.

* موارد مرزی (Edge Cases): مقادیر غیرمنتظره یا گمشده blog_status.

* Limit = 1 (گره Limit): اجرای گردش کار را به پردازش فقط یک محصول در هر اجرا محدود می‌کند.

* Nothing (گره NoOp): به عنوان یک placeholder برای شاخه‌ای که محصولات فیلتر می‌شوند (وضعیت "unused" نیست) عمل می‌کند.

۴. تولید محتوای پست وبلاگ با هوش مصنوعی

این بخش از هوش مصنوعی Google Gemini از طریق یک عامل Langchain برای تولید یک پست وبلاگ جامع بر اساس عنوان محصول و توضیحات پاکسازی شده استفاده می‌کند.

• گره‌ها (Nodes):

* Magic Room (گره عامل Langchain - Langchain Agent Node)

* Gemini (گره مدل زبان Google Gemini - Google Gemini LM Node)

* Output Parser (گره تجزیه‌کننده خروجی Langchain - Langchain Output Parser Node)

• جزئیات گره‌ها:

* Magic Room (گره عامل Langchain - Langchain Agent Node): یک prompt دقیق را برای تولید محتوا به Google Gemini ارسال می‌کند.

* پیکربندی:

* ورودی (Input): title و cleanDescription محصول.

* پیام سیستم (System Message): دستورالعمل‌هایی برای ساختار محتوا (عنوان، مقدمه، ویژگی‌ها، نقدها، فراخوان به اقدام)، تعداد کلمات مورد نظر، قالب‌بندی HTML و خروجی JSON برای متادیتای SEO (عنوان صفحه، توضیحات متا) ارائه می‌دهد.

* نوع Prompt: Define (prompt ثابت).

* موارد مرزی (Edge Cases): اتمام زمان مدل هوش مصنوعی، خروجی بدشکل هوش مصنوعی، محدودیت‌های سهمیه API، خطاهای اعتبارنامه.

* Gemini (گره مدل زبان Google Gemini - Google Gemini LM Node): مدل هوش مصنوعی زیربنایی است که prompt را پردازش می‌کند. نیاز به اعتبارنامه‌های احراز هویت شده Google Palm API دارد.

* موارد مرزی (Edge Cases): انقضای توکن API، محدودیت‌های نرخ، خرابی شبکه.

* Output Parser (گره تجزیه‌کننده خروجی Langchain - Langchain Output Parser Node): خروجی JSON هوش مصنوعی را به فیلدهای داده ساختاریافته تجزیه می‌کند و طرح‌واره‌ای را برای فیلدهایی مانند blog_title, content, excerpt, page_title, و meta_description اعمال می‌کند.

* موارد مرزی (Edge Cases): خطاهای تجزیه در صورتی که خروجی هوش مصنوعی از طرح‌واره مورد انتظار منحرف شود.

۵. مدیریت و انتشار محتوای پست وبلاگ

این بخش محتوای وبلاگ تولید شده توسط هوش مصنوعی را قالب‌بندی می‌کند، آن را به عنوان یک مقاله وبلاگ در Shopify منتشر می‌کند و صفحه Google Sheets را با وضعیت انتشار و شناسه مقاله Shopify به‌روزرسانی می‌کند.

• گره‌ها (Nodes):

* Update Blog Content (گره Google Sheets)

* Fix Content Format (گره کد - Code Node)

* Blog Creation (گره درخواست HTTP - HTTP Request Node)

* Status Update (گره Google Sheets)

* Update Input table (گره Google Sheets)

* Nothing1 (گره NoOp)

• جزئیات گره‌ها:

* Update Blog Content (گره Google Sheets): فیلدهای محتوای وبلاگ تولید شده (عنوان، محتوا، متادیتای SEO) را به یک صفحه "Blog Post" اضافه می‌کند.

* پیکربندی: نگاشت فیلدهایی مانند blog_title, content, excerpt, page_title, meta_description, blog_status ("generated"), product_id, و handle.

* موارد مرزی (Edge Cases): محدودیت‌های API، داده‌های نامنطبق، مشکلات اعتبارنامه.

* Fix Content Format (گره کد - Code Node): یک گره کد جاوا اسکریپت که محتوای خام HTML وبلاگ را برای API Shopify آماده می‌کند با فرار دادن کاراکترهای خاص (بک‌اسلش، کوتیشن، خطوط جدید) و حذف کاراکترهای بازگشت به ابتدا (carriage returns).

* خروجی‌ها (Outputs): یک رشته JSON امن برای فیلد body_html در API Shopify.

* موارد مرزی (Edge Cases): فرار دادن نامناسب که منجر به خطاهای API می‌شود.

* Blog Creation (گره درخواست HTTP - HTTP Request Node): Shopify Admin API را برای ایجاد یک مقاله وبلاگ جدید فراخوانی می‌کند.

* پیکربندی:

* متد (Method): POST

* URL: /admin/api/2025-07/blogs/{blog_id}/articles.json (جایگزین {blog_id} با شناسه وبلاگ خود).

* بدنه JSON (JSON Body): شامل title, author (تنظیم شده به "Manish Kumar"), tags, body_html (از گره قبلی) و یک مُهر زمانی published_at.

* نیاز به اعتبارنامه‌های احراز هویت شده Shopify دارد.

* خروجی‌ها (Outputs): پاسخ API Shopify حاوی article_id مقاله جدید.

* موارد مرزی (Edge Cases): محدودیت‌های نرخ API، blog_id نامعتبر، خطاهای احراز هویت، مشکلات شبکه.

* Status Update (گره Google Sheets): ردیف صفحه "Blog Post" را با article_id دریافتی از Shopify به‌روزرسانی کرده و blog_status را به "posted" تنظیم می‌کند.

* موارد مرزی (Edge Cases): تداخل نوشتن (write conflicts)، مجوزهای صفحه، خطاهای اعتبارنامه.

* Update Input table (گره Google Sheets): صفحه "Refined Input" را به‌روزرسانی می‌کند تا blog_status محصول پردازش شده را به عنوان "used" علامت‌گذاری کند و از پردازش مجدد آن جلوگیری کند.

* موارد مرزی (Edge Cases): مشکلات همگام‌سازی (sync issues)، محدودیت‌های API.

* Nothing1 (گره NoOp): یک گره placeholder برای نشان دادن پایان اجرای گردش کار پس از به‌روزرسانی‌های موفق.

۶. مستندات و دستورالعمل‌ها

چندین گره Sticky Note در گردش کار گنجانده شده‌اند. اینها صرفاً برای اهداف اطلاعاتی هستند و توضیحات، دستورالعمل‌های کاربر و اطلاعات تماس نویسنده را ارائه می‌دهند و بر منطق اجرای گردش کار تأثیر نمی‌گذارند.

---

جدول خلاصه