خوشه‌بندی کلمات کلیدی

📋 راهنمای کامل برای هر پروژه (از صفر تا نتیجه)

1. دانلود و Deploy اسکریپت:
   • از کارت «دانلود اسکریپت Autom8» (سمت راست) فایل Autom8-Keyword-Clustering.gs را دانلود کن.
   • در Google Apps Script (script.google.com) یک پروژه جدید بساز.
   • کل کد فایل دانلود شده را کپی و در Google Apps Script Paste کن (فایل Code.gs).
   • Deploy → New deployment → Type: Web app → Execute as: Me → Who has access: Anyone → Deploy
   • Web App URL را کپی کن (مثال: https://script.google.com/macros/s/.../exec)
2. ایجاد یا انتخاب Google Sheet:
   • گزینه 1 - ایجاد خودکار Sheet در فولدر code/ (پیشنهادی):
   • اگر Spreadsheet ID را خالی بگذارید و نام سایت را وارد کرده باشید، Sheet جدید به صورت خودکار در فولدر 01-Scripts/SEO/keyword-clustering/{نام-سایت}/code/ ایجاد می‌شود
   • گزینه 2 - استفاده از Sheet موجود:
   • اگر Sheet موجود داری: Spreadsheet ID را از URL کپی کن و وارد کن
   • 💡 نکته: اگر Sheet جدید به صورت خودکار ایجاد شود، در فولدر 01-Scripts/SEO/keyword-clustering/{نام-سایت}/code/ قرار می‌گیرد
3. ساخت فولدرهای Drive (مرحله اول - مهم):
   • گزینه 1 - ساخت ساختار کامل Autom8 (پیشنهادی):
   • به صفحه "ساختار فولدرها" برو (از منوی بالا یا اینجا کلیک کن)
   • Web App URL اسکریپت drive-structure-setup.gs را وارد کن
   • روی «ایجاد ساختار کامل» کلیک کن
   • این کار فولدر autom8/01-Scripts/SEO/keyword-clustering/ را می‌سازد
   • گزینه 2 - ساخت فقط فولدرهای یک سایت:
   • در این صفحه، در بخش «مدیریت سایت‌ها و پروژه‌ها»:
   • نام سایت/پروژه را وارد کن (مثال: "روناک الکترونیک")
   • Web App URL اسکریپت keyword-clustering را Paste کن
   • دکمه «ساخت خودکار» را بزن (این کار فولدر 01-Scripts/SEO/keyword-clustering/{نام-سایت}/ را می‌سازد)
   • لینک فولدر به صورت خودکار در فیلد «لینک فولدر Drive» ذخیره می‌شود
4. ثبت پروژه در Autom8:
   • در این صفحه، در بخش «مدیریت سایت‌ها و پروژه‌ها»:
   • نام سایت/پروژه را وارد کن (مثال: "روناک الکترونیک")
   • Web App URL اسکریپت keyword-clustering را Paste کن
   • Spreadsheet ID را وارد کن
   • لینک فولدر Drive را وارد کن (یا از دکمه «ساخت خودکار» استفاده کن)
   • روی «ذخیره سایت» بزن
5. راه‌اندازی Sheets:
   • دکمه «راه‌اندازی Sheets» را بزن
   • کارت سبز بالا باید تأیید کند که Sheetهای Autom8-* ساخته شدند
   • روی لینک «باز کردن Sheet در Google Sheets» کلیک کن تا Sheet را ببینی
6. وارد کردن داده‌های Search Console (دو روش):
   • روش 1 - خودکار (پیشنهادی):
     • اگر داده‌های Search Console را قبلاً در Google Sheets Export کرده‌ای (مثلاً Sheet با نام "Performance-on-Search-2025-11-27")
     • دکمه «وارد کردن داده‌های Search Console» را بزن
     • نام Sheet حاوی داده‌ها را وارد کن (مثال: "Performance-on-Search-2025-11-27") یا خالی بگذار تا اولین Sheet غیر-Autom8 استفاده شود
     • داده‌ها به صورت خودکار به Sheet «Autom8-Keywords» کپی می‌شوند
     • ✅ پیام موفقیت با آمار ردیف‌های وارد شده نمایش داده می‌شود
   • روش 2 - دستی:
     • در Google Search Console → Performance → Export به Google Sheets
     • یا Export به CSV و سپس Import به Google Sheets
     • در Google Sheets، به Sheet "Autom8-Keywords" برو
     • ستون‌های اصلی را کپی کن: Top queries, Clicks, Impressions, CTR, Position
     • در Sheet "Autom8-Keywords" Paste کن (ردیف اول هدر است، ردیف‌های بعدی داده‌ها)
7. شروع Clustering:
   • دکمه «شروع Clustering» را بزن
   • صبر کن تا Clustering انجام شود (بسته به تعداد کلیدواژه‌ها ممکن است چند دقیقه طول بکشد)
   • ✅ پیام موفقیت نمایش داده می‌شود
8. ساخت Hierarchy و Internal Links (اختیاری):
   • دکمه «ساخت Hierarchy» را بزن تا سلسله‌مراتب خوشه‌ها ساخته شود
   • دکمه «ساخت Internal Links» را بزن تا لینک‌های داخلی بین خوشه‌ها ساخته شود
9. بررسی نتایج:
   • در Google Sheets، Sheetهای زیر را بررسی کن:
   • Autom8-Clusters: لیست خوشه‌های ایجاد شده با Pillar Keyword و آمار
   • Autom8-Hierarchy: سلسله‌مراتب خوشه‌ها (Parent-Child)
   • Autom8-Internal-Links: لینک‌های داخلی پیشنهادی
10. Export و ذخیره:
    • دکمه «Export به Toon» یا «Export هر دو» را بزن
    • خروجی JSON/Toon در Sheet «Autom8-Export-Comparison» ذخیره می‌شود
    • خروجی را کپی کن و در فولدر 01-Scripts/SEO/keyword-clustering/{نام-سایت}/data/ در Drive ذخیره کن
    • 💡 نکته: اگر ساختار Autom8 را ساخته‌ای، مسیر کامل این است: autom8/01-Scripts/SEO/keyword-clustering/{نام-سایت}/data/