ربط Search Console بأي عميل MCP

نقطة النهاية

يوجد الخادم عند /mcp على نطاق التطبيق ويتحدث Streamable HTTP بإصدار البروتوكول 2025-06-18. يرسل العملاء POST لـ JSON-RPC، ثم طلب 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
• البحث: الكلمات المفتاحية، وصفحات نتائج البحث، والروابط الخلفية، وتتبع الترتيب، وفحوص الموقع، وهي تستهلك أرصدة البحث
• محرك المحتوى: content_list_tasks وcontent_claim وcontent_get_brief وcontent_submit وcontent_publish وأدوات الأغلفة، للكتابة من الطابور

التواريخ اختيارية

إذا حذفت النطاق في أي أداة يستخدم الخادم آخر 28 يوماً مستقراً، مع مراعاة تأخر تقارير Search Console، وتكون نافذة المقارنة افتراضياً الفترة السابقة بنفس الطول. لا يحتاج العميل لمعرفة تاريخ اليوم ليطرح سؤالاً منطقياً.

النطاقات وحدود المعدّل

المفتاح للقراءة فقط أو للقراءة والكتابة. مفتاح القراءة فقط لا يصل إلى أداة كتابة إطلاقاً، وكل تعديل بمفتاح الكتابة يُسجَّل في سجل التدقيق.

• 60 طلباً في الدقيقة لكل مفتاح، و1,000 في الساعة لكل حساب
• تجاوز الحد يُرجع HTTP 429 مع Retry-After بالثواني
• إبطال مفتاح واحد دون المساس ببقية الحساب

REST، إن فضّلت

أدوات Search Console وGA4 متاحة أيضًا كمسارات GET وPOST ضمن /v1 مع مستند OpenAPI 3.1 مولَّد في /v1/openapi.json، ويصلح أيضًا كمواصفة لاستدعاء الدوال. المفاتيح نفسها، والصلاحيات نفسها، والحدود نفسها.