Search Console کو کسی بھی MCP کلائنٹ سے منسلک کریں

اینڈ پوائنٹ

سرور ایپ ڈومین پر /mcp پر موجود ہے اور پروٹوکول ورژن 2025-06-18 پر Streamable HTTP استعمال کرتا ہے۔ کلائنٹس JSON-RPC POST کرتے ہیں، ایک initialize درخواست بھیجتے ہیں، پھر tools/list۔ کچھ بھی انسٹال کرنے کی ضرورت نہیں اور راستے میں کوئی لوکل پراکسی نہیں ہوتی۔

• Authorization: Bearer کے ساتھ ایسی کلید جو apk_live_ کے فارمیٹ اور 32 ہیکس کریکٹرز پر مشتمل ہو
• کلیدیں تخلیق کے وقت صرف ایک بار دکھائی جاتی ہیں اور صرف SHA-256 ہیش کے طور پر محفوظ کی جاتی ہیں
• ہر کال کلید کے آخری استعمال کے ٹائم اسٹیمپ اور درخواست کاؤنٹر کو اپ ڈیٹ کرتی ہے

ٹولز

کام کے لحاظ سے گروپ شدہ، واضح ناموں کے ساتھ تاکہ ماڈل درست ٹول چنے۔ صرف پڑھنے والی کلید کبھی ایسے ٹول تک نہیں پہنچتی جو لکھتا ہو یا ریسرچ کریڈٹس خرچ کرتا ہو۔

• دریافت: list_properties، search_analytics
• کارکردگی: top_queries، top_pages، top_countries، compare_periods
• تشخیص: content_decay، cannibalization، ctr_benchmark، page_poaching، rank_changes، new_lost_rankings
• انڈیکسنگ: url_inspection، sitemaps
• ٹائم لائن: annotations، اور لکھنے والی کلید پر create_annotation
• اینالیٹکس: ga4_overview، ga4_breakdown، ga4_key_events
• ریسرچ: کی ورڈز، SERPs، بیک لنکس، رینک ٹریکنگ اور سائٹ آڈٹس، جو ریسرچ کریڈٹس خرچ کرتے ہیں
• کنٹینٹ انجن: قطار سے لکھنے کے لیے content_list_tasks، content_claim، content_get_brief، content_submit، content_publish اور کور ٹولز

تاریخیں اختیاری ہیں

کسی بھی ٹول پر رینج نہ دیں تو سرور Search Console کی رپورٹنگ تاخیر کو مدِنظر رکھتے ہوئے آخری 28 مستحکم دن استعمال کرتا ہے، جبکہ موازنے کی ونڈو بطورِ ڈیفالٹ اسی طوالت کی پچھلی مدت ہوتی ہے۔ کلائنٹ کو معقول سوال پوچھنے کے لیے کبھی بھی آج کی تاریخ جاننے کی ضرورت نہیں ہوتی۔

اسکوپس اور ریٹ لمٹس

کلید یا تو صرف پڑھنے والی ہوتی ہے یا پڑھنے اور لکھنے والی۔ صرف پڑھنے والی کلید کسی لکھنے والے ٹول تک بالکل نہیں پہنچ سکتی، اور لکھنے والی کلید پر ہر تبدیلی آڈٹ لاگ کی جاتی ہے۔

• فی کلید فی منٹ 60 درخواستیں، فی اکاؤنٹ فی گھنٹہ 1,000
• حد سے تجاوز پر HTTP 429 سیکنڈز میں Retry-After کے ساتھ واپس ملتا ہے
• باقی اکاؤنٹ کو چھیڑے بغیر ایک ہی کلید منسوخ کریں

اگر آپ ترجیح دیں تو REST

Search Console اور GA4 ٹولز /v1 کے تحت GET اور POST روٹس کے طور پر بھی دستیاب ہیں، اور /v1/openapi.json پر خودکار OpenAPI 3.1 دستاویز موجود ہے جو فنکشن کالنگ اسپیک کا کام بھی دیتی ہے۔ وہی کلیدیں، وہی اسکوپس، وہی حدود۔