اسکریپت رصد رتبه با Claude Code: پلی‌بوک عملی

آخرین به‌روزرسانی: اوت 2026

اگر هر صبح بین سرچ کنسول، شیت و چند ابزار رتبه‌سنج می‌چرخید، مشکل شما کمبود داده نیست. مشکل، نبود یک جریان پایدار برای دیدن افت و رشد است. اسکریپت رصد رتبه با Claude Code وقتی ارزش دارد که بخواهید داده را با منطق خودتان جمع کنید، گزارش بسازید و هر بار برای تغییرات کوچک منتظر ابزارهای عمومی نمانید.

خلاصه سریع

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

این پلی‌بوک برای چه تیمی مناسب است؟

این روش برای تیمی خوب است که بین ۵۰ تا ۵۰۰ کوئری حیاتی دارد و نمی‌خواهد برای هر پروژه یک داشبورد سنگین بخرد. آژانس‌های کوچک، تیم محتوای اینهاوس و فروشگاه‌هایی که چند دسته مهم دارند، بیشترین نفع را می‌برند. اگر هنوز لیست کلمات کلیدی شما تثبیت نشده، اول سراغ خوشه‌بندی کلمات کلیدی با Claude Code بروید.

مزیت اصلی، کنترل است. می‌توانید فقط کوئری‌های رتبه ۴ تا ۱۵ را رصد کنید، برند را حذف کنید و برای افت بیش از ۳ پله هشدار بگذارید. برای تیمی که قبلاً تحلیل سرچ کنسول با Claude Code را در جریان کار آورده، این اسکریپت یک لایه منطقی بعدی است، نه یک پروژه جانبی.

پیش‌نیازها و معماری ساده اسکریپت

چهار جزء کافی است. ورودی کلمات کلیدی، منبع داده، زمان‌بند و محل ذخیره. در بسیاری از موارد، ورودی از CSV یا Google Sheet می‌آید. منبع داده می‌تواند Search Console باشد، یا یک سرویس SERP API اگر رتبه زنده لازم دارید. برای اتصال تمیز، MCP سرچ کنسول برای Claude کار را سریع‌تر می‌کند.

برای اجرا، یک کران جاب روزانه یا GitHub Actions کافی است. خروجی را در SQLite یا یک فایل CSV نسخه‌دار ذخیره کنید. بعد یک خلاصه ایمیلی یا فایل گزارش بسازید. معماری ساده یعنی وابستگی کم، دیباگ راحت و هزینه پایین. اگر با اتصال ابزارها آشنا نیستید، توضیح MCP server زمینه خوبی می‌دهد.

گام‌به‌گام ساخت اسکریپت با Claude Code

کار را با یک پرامپت دقیق شروع کنید. بگویید اسکریپت پایتون می‌خواهید که فایل keywords.csv را بخواند، برای هر کوئری و URL هدف داده بگیرد، نتیجه را با تاریخ ذخیره کند و در صورت افت بیش از ۳ رتبه، هشدار بسازد. Claude Code وقتی ورودی، خروجی و خطاهای قابل انتظار را می‌داند، نسخه اول بهتری تحویل می‌دهد.

1. اسکیما را مشخص کنید. keyword، landing_page، device، country، checked_at، position.
2. از Claude Code بخواهید ساختار فایل‌ها را بسازد. config، fetcher، storage، reporter.
3. روی ۱۵ کوئری تست بگیرید، نه روی کل لیست.
4. لاگ خطا و ریت لیمیت را اضافه کنید.

یک نمونه ساختار ساده:

python rank_tracker.py --input keywords.csv --device mobile --country ir
python report.py --days 7 --alert-threshold 3

مثال واقعی. برای یک سایت محتوایی با ۴۷ کوئری در بازه رتبه ۸ تا ۱۲، خروجی روزانه نشان داد ۹ کوئری پس از آپدیت عنوان صفحه افت کرده‌اند. همین گزارش، اصلاح تایتل را در همان روز ممکن کرد. اگر می‌خواهید چنین اتوماسیون‌هایی را در مقیاس بزرگ‌تر ببینید، مرور ابزارهای اتوماسیون سئو مقایسه خوبی می‌دهد.

قواعد پایش رتبه: دقت، فرکانس و خطاها

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

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

فرمت خروجی و گزارش‌هایی که واقعاً مفیدند

CSV برای آرشیو خوب است، اما برای تصمیم‌گیری کافی نیست. گزارش خوب باید سه چیز را نشان دهد. برندگان، بازندگان و صفحاتی که نزدیک جهش‌اند. مثلاً کوئری‌هایی که از ۱۱ به ۹ رسیده‌اند، معمولاً ارزش اقدام سریع دارند. اگر روی AI Overview هم کار می‌کنید، راهنمای بهینه‌سازی برای AI Overview کمک می‌کند اولویت گزارش را بهتر بچینید.

یک خروجی مفید می‌تواند شامل ایمیل روزانه با ۵ افت مهم، فایل هفتگی CSV و داشبورد ساده باشد. مثال مشخص. ستونی برای best_position_14d و ستونی برای delta_3d بگذارید. این دو با هم، افت واقعی را از نویز جدا می‌کنند.

نگهداری، بهبود و مقیاس‌دادن اسکریپت

از روز اول، اسکریپت را ماژولار بنویسید. fetcher را از reporter جدا کنید. تنظیمات پروژه را در config نگه دارید. وقتی سایت دوم اضافه شود، فقط یک فایل پیکربندی تازه لازم دارید. برای تیم‌هایی که چند جریان داده دارند، سرورهای MCP رایگان برای Claude می‌تواند اتصال‌ها را یکدست‌تر کند.

Claude Code در نگهداری هم مفید است. می‌تواند تست بنویسد، لاگ‌های مبهم را شفاف کند و موقع تغییر API نسخه جدید پیشنهاد دهد. قدم بعدی مشخص است. اول ۲۰ کوئری حساس را انتخاب کنید، بعد نسخه اولیه را با یک زمان‌بند روزانه بالا بیاورید. اگر از همان روز اول ۳۰۰ کوئری را وارد کنید، بیشتر خطاها از پیچیدگی خودتان می‌آیند.

سوالات متداول

آیا این اسکریپت برای چند سایت هم جواب می‌دهد؟

بله، اگر ساختار پروژه را از ابتدا چندمستاجره بچینید. برای هر سایت یک فایل config، منبع کلمات کلیدی و خروجی جدا داشته باشید. شناسه سایت را در تمام ردیف‌های ذخیره‌سازی ثبت کنید. این مدل برای آژانس‌ها و هلدینگ‌ها بهتر جواب می‌دهد. فقط هشدارها را هم تفکیک کنید تا افت یک سایت، گزارش بقیه را شلوغ نکند.

هر چند وقت یک‌بار باید رتبه‌ها را بررسی کنم؟

برای صفحات درآمدزا و کوئری‌های نزدیک صفحه اول، بررسی روزانه منطقی است. برای کلمات محتوایی پایدار، دو یا سه بار در هفته کافی است. اگر سایت تازه دچار تغییر فنی، مهاجرت یا آپدیت محتوا شده، موقتاً فرکانس را بالا ببرید. اصل مهم این است که بازه بررسی با اهمیت صفحه و سرعت تغییر بازار شما هماهنگ باشد.

اگر داده‌های رتبه ناپایدار باشند چه کنم؟

اول متغیرها را محدود کنید. کشور، دیوایس و زمان اجرا را ثابت نگه دارید. بعد به جای یک نقطه داده، میانگین متحرک سه یا پنج برداشت را ببینید. هشدار را هم روی افت تکرارشونده بگذارید، نه روی یک نوسان تکی. در بعضی حوزه‌ها، تفاوت رتبه ۹ و ۱۱ در یک روز طبیعی است و نباید فوراً به تغییر محتوا منجر شود.

Claude Code چه کمکی در نگهداری اسکریپت می‌کند؟

بیشترین کمک در سه جاست. بازنویسی بخش‌های تکراری، اضافه کردن تست و سریع‌تر کردن دیباگ. مثلاً اگر لاگ‌ها نشان دهند یک endpoint گهگاه timeout می‌دهد، Claude Code می‌تواند retry، backoff و مدیریت استثنا را اضافه کند. همچنین وقتی بخواهید خروجی تازه مثل Slack alert یا خلاصه ایمیلی بسازید، سرعت توسعه به شکل محسوسی بهتر می‌شود.

برای شروع به چه ابزارهایی نیاز دارم؟

حداقل‌ها ساده‌اند. یک محیط اجرای پایتون، فایل CSV یا شیت کلمات کلیدی، منبع داده رتبه و یک زمان‌بند. برای ذخیره، SQLite کافی است. برای گزارش، CSV و ایمیل هم جواب می‌دهد. اگر از سرچ کنسول استفاده می‌کنید، دسترسی API یا لایه MCP کار را راحت‌تر می‌کند. لازم نیست از روز اول داشبورد پیچیده یا زیرساخت گران داشته باشید.

چطور هشدار افت رتبه را تنظیم کنم؟

یک آستانه واحد برای همه کلمات نگذارید. برای کوئری‌های حساس، افت ۲ یا ۳ رتبه مهم است. برای کوئری‌های دورتر، شاید افت ۵ رتبه هم هنوز بحرانی نباشد. بهتر است هشدار وقتی فعال شود که افت در دو بررسی متوالی دیده شود یا میانگین هفتگی خراب شود. خروجی هشدار باید شامل کوئری، URL، آخرین رتبه و تغییر نسبت به میانگین قبلی باشد.

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