راهنمای اتصال میزفا تولز به n8n و اتوماسیون فرآیندهای سئو

با اتصال میزفا تولز به ابزار قدرتمند اتوماسیون n8n، می‌تونی فرآیندهای تکراری و زمان‌بر سئو را به‌طور کامل خودکار کنی. پایگاه داده ۱۱ ابزار تخصصی میزفا تولز از طریق وب‌سرویس رسمی (API) در دسترس است و به کمک سناریوهای آماده، امکان استخراج کلمات کلیدی، دریافت وضعیت دامنه‌ها، بررسی حجم جستجو و اتصال آن‌ها به ده‌ها ابزار دیگر مانند Google Sheets، تلگرام یا پایگاه داده سازمان فراهم می‌شود.

برای اتصال میزفا تولز به n8n تنها به دو مورد نیاز داری:

1. کلید دسترسی API (API Key): کلید اختصاصی خود را از بخش تنظیمات حساب کاربری در پنل میزفا تولز دریافت کن.
2. نرم‌افزار n8n: نسخه ابری (Cloud) یا نسخه میزبانی شخصی (Self-hosted) روی سرور یا لوکال.

1. وارد محیط کاربری n8n شو و یک ورک‌فلو جدید باز کن.
2. از منوی بالا سمت راست (یا کلیدهای میانبر Ctrl+O یا Cmd+O) گزینه Import from File را انتخاب کن.
3. فایل JSON مورد نظرت را از میان فایل‌های استخراج‌شده پکیج زیپ انتخاب کن تا تمامی نودها و ساختار ارتباطی در صفحه بارگذاری شوند.
4. در نود «تنظیمات» یا نودهای اتصال HTTP، کلید API خود را در بخش هدر درخواست (Authorization یا پارامتر کلید) قرار بده.

در پکیج ارائه‌شده، سه سناریوی کاربردی و دقیق برای پاسخ به نیازهای روزمره کارشناسان سئو و مدیران وب طراحی شده است:

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

• جریان کلی سناریو: تنظیمات ← لیست دامنه‌ها ← انتخاب دامنه ← کلمات دامنه

[نود تنظیمات] ──► [دریافت لیست دامنه‌ها] ──► [نود جدا کردن دامنه‌ها] ──► [استخراج کلمات با صفحه‌بندی]

• نود «تنظیمات»:
  • در فیلد domain_url نام دامنه مورد نظرت (مثلاً mizfa.tools) را ثبت کن.
  • چنانچه این فیلد را خالی بگذاری، سیستم به صورت هوشمند اولین دامنه موجود در حسابت را انتخاب می‌کند.
  • اگر دامنه واردشده در پنل کاربری پیدا نشود، سناریو متوقف شده و یک پیام خطای شفاف به همراه لیست تمامی دامنه‌های در دسترس حسابت نمایش داده می‌شود.
  • پارامترهای columns (ستون‌های خروجی)، sort_column (ستون مرتب‌سازی) و sort_order (صعودی یا نزولی) نیز در همین نود قابل تنظیم هستند.
• نود «جدا کردن دامنه‌ها»:
  • خروجی این نود فهرست کامل تمام دامنه‌های فعال پروژه شماست.
• دریافت خودکار کلمات (صفحه‌به‌صفحه):
  • کلمات دامنه به صورت دسته‌های ۱۰۰تایی و با صفحه‌بندی خودکار دریافت می‌شوند.
  • برای رعایت محدودیت مصرف وب‌سرویس (حداکثر ۲۰ درخواست در هر دقیقه)، میان فراخوانی صفحات وقفه و تاخیر زمانی استاندارد لحاظ شده تا بدون مسدود شدن یا بروز خطا تمام صفحات واکشی شوند.

این سناریو معادل قابلیت کیورد پلنر در ابزار تحقیق کلمات است؛ یک واژه یا عبارت کلیدی مبنا دریافت می‌کند و ده‌ها ایده و کلمه مرتبط را همراه با داده‌های سرچ به شما تحویل می‌دهد.

• ورودی‌های نود «تنظیمات»:
  • keyword: کلمه کلیدی اصلی مورد نظر برای تحلیل و گسترش
  • language_code: کد زبان جستجو (مثلاً زبان فارسی یا انگلیسی)
  • location_code: کد موقعیت جغرافیایی بازار هدف
  • columns: فهرست فیلدهای مورد نیاز در جدول خروجی

                             ┌──► شاخه اول: تک‌تک کلمات پیشنهادی (مناسب اتصال به شیت یا دیتابیس)
[تنظیمات و استعلام] ────────┤
                             └──► شاخه دوم: خلاصه نتایج (مجموع سرچ، تعداد کل کلمات و میانگین CPC)

• شاخه اول (لیست مجزا): هر کلمه پیشنهادی را به صورت یک آبجکت مستقل تحویل می‌دهد. این حالت برای درج ردیف‌به‌ردیف در Google Sheets، پایگاه داده SQL یا ارسال به ابزارهای مدیریت وظایف مثل Notion و Trello کاملاً ایده‌آل است.
• شاخه دوم (خلاصه محاسباتی): یک آبجکت خلاصه شامل مجموع حجم جستجوی کل کلمات (Total Search Volume)، تعداد واژه‌های کشف‌شده و میانگین هزینه به ازای کلیک (CPC) ارائه می‌کند که برای گزارش‌های خلاصه و نوتیفیکیشن‌ها مناسب است.

اگر فهرستی از کلمات کلیدی داری و می‌خواهی حجم جستجوی ماهانه (Search Volume) و داده‌های سرپ آن‌ها را به صورت دسته‌ای و با بیشترین سرعت بسنجی، این ورک‌فلو بهترین گزینه است.

• ورودی کلمات کلیدی:
  • در فیلد keywords نود تنظیمات، کلمات مدنظرت را قرار بده؛ می‌تونی هر کلمه را در یک خط مجزا بنویسی یا با کاما از هم جدا کنی.
• حذف هوشمند عبارات تکراری:
  • پیش از ارسال درخواست به وب‌سرویس، الگوریتم داخلی نود به صورت خودکار کلمات تکراری را فیلتر می‌کند تا از هدررفت سهمیه API جلوگیری شود.
• دسته‌بندی و رعایت Rate Limit:
  • وب‌سرویس میزفا تولز برای هر کلید API اجازه ارسال حداکثر ۱ درخواست در هر ۳ ثانیه را می‌دهد.
  • اگر فهرست شما بیش از ۱۰۰ کلمه باشد، این سناریو به صورت خودکار عبارات را به بسته‌های ۱۰۰تایی تقسیم می‌کند و میان هر ارسال ۳.۵ ثانیه وقفه در نظر می‌گیرد تا درخواست‌ها پایدار و بدون رد شدن پردازش شوند.
• ساختار دو شاخه خروجی:
  • دقیقاً مانند سناریوی دوم، این ورک‌فلو هم دو شاخه خروجی دارد:
    1. شاخه ردیف‌های تفکیک‌شده به ازای هر کلمه کلیدی
    2. شاخه خلاصه عملکرد هر درخواست و مجموع ترافیک تخمینی

فایل‌های ارائه‌شده تنها بخشی از امکانات اتصال با n8n هستند. با ترکیب نودهای استاندارد HTTP Request در n8n و متدهای متنوع وب‌سرویس میزفا تولز، می‌تونی سناریوهای اختصاصی زیر را بسازی:

• گزارش خودکار افت و خیز رتبه‌ها: ارسال هفتگی یا ماهانه کلمات صعودی و نزولی به کانال تلگرام یا اسلک تیم مارکتینگ.
• اتصال به داشبوردهای Looker Studio یا PowerBI: انتقال مستقیم آمارهای سئو به پایگاه‌های داده سازمان جهت ساخت گزارش‌های تجمیعی.
• پایش رقبا و شکاف کلمات: اجرای خودکار مقایسه با رقبا و ساخت تسک جدید در نرم‌افزارهای مدیریت پروژه هنگام کشف فرصت‌های سئو.

برای مشاهده تمامی اندپوینت‌ها، پارامترهای ورودی و نمونه پاسخ‌های JSON، به صفحه رسمی مستندات API میزفا تولز مراجعه کن.