/ الدليل / الملعب / mcp-gsc
← كل الخوادم ↗ GitHub
● مجتمع AminForou ⚡ فوري

mcp-gsc

بواسطة AminForou · AminForou/mcp-gsc

استخراج بيانات Google Search Console إلى Claude — 20 أداة لتحليل البحث وفحص عناوين URL والخرائط الموقعية. مثالية لفحص وتقارير تحسين محركات البحث.

يربط mcp-gsc (AminForou) Google Search Console بمساعدات الذكاء الاصطناعي. 20 أداة تغطي إدارة الخصائص وتحليل البحث مع التصفية والمقارنة وفحص عناوين URL (حالة الفهرسة) وتقديم ومراقبة الخرائط الموقعية. المصادقة عبر OAuth (شخصي) أو حساب الخدمة (الفريق).

▶ شاهد العرض 📦 التثبيت 💡 حالات الاستخدام

لماذا تستخدمه

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

gsc.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "gsc": {
      "command": "uvx",
      "args": [
        "mcp-gsc"
      ],
      "_inferred": true
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "gsc": {
      "command": "uvx",
      "args": [
        "mcp-gsc"
      ],
      "_inferred": true
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "gsc": {
      "command": "uvx",
      "args": [
        "mcp-gsc"
      ],
      "_inferred": true
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "gsc": {
      "command": "uvx",
      "args": [
        "mcp-gsc"
      ],
      "_inferred": true
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "gsc",
      "command": "uvx",
      "args": [
        "mcp-gsc"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json
{
  "context_servers": {
    "gsc": {
      "command": {
        "path": "uvx",
        "args": [
          "mcp-gsc"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add gsc -- uvx mcp-gsc

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: mcp-gsc

إنشاء تقرير تحسين محركات البحث الأسبوعي باستخدام mcp-gsc

👤 مديرو تحسين محركات البحث والفريقات المختصة بالمحتوى ⏱ ~15 min beginner

متى تستخدمه: صباح يوم الاثنين — تريد ملخص أداء الأسبوع الماضي قبل الاجتماع.

المتطلبات الأساسية
  • الوصول إلى Google Search Console للخاصية — search.google.com/search-console
  • بيانات اعتماد OAuth أو حساب الخدمة — console.cloud.google.com — enable Search Console API
الخطوات
  1. استخراج أفضل الاستعلامات والتغييرات
    For acme.com, top 20 queries last week vs the previous week. Show clicks, CTR, position deltas.✓ تم النسخ
    → جدول التغييرات
  2. استخراج أفضل الصفحات سريعة التغيير
    Top 10 pages with the biggest clicks changes (up or down).✓ تم النسخ
    → قائمة الرابحين والخاسرين
  3. صياغة الملخص
    Write a 5-bullet summary for the team meeting, with an action item for the biggest loser.✓ تم النسخ
    → تقرير جاهز للنسخ

النتيجة: تقرير يوم الاثنين في 10 دقائق.

اجمعها مع: google-sheets

تدقيق مشاكل الفهرسة عبر موقعك

👤 متخصصو تحسين محركات البحث التقنيين ⏱ ~30 min intermediate

متى تستخدمه: انخفض حجم الزيارات وتريد معرفة ما إذا كانت Google لا تزال تفهرس ما يجب أن تفهرسه.

الخطوات
  1. اختر أفضل الصفحات
    From top 50 landing pages last month, inspect each URL's indexing status via inspect_url_enhanced.✓ تم النسخ
    → الحالة لكل عنوان URL: مفهرس / تم الزحف إليه لكن لم يتم فهرسته / مستبعد
  2. تجميع المشاكل
    Group by issue type. For 'crawled but not indexed', what's the common pattern?✓ تم النسخ
    → التشخيص حسب المجموعة

النتيجة: قائمة الإصلاحات المرتبة حسب الأولوية بناءً على بيانات Google Search Console الفعلية.

التحقق من صحة الخريطة الموقعية وحالة التقديم

👤 أي شخص ينشر صفحات جديدة ⏱ ~10 min beginner

متى تستخدمه: للتو أطلقت صفحات جديدة — تحقق من اختيار Google للخريطة الموقعية.

الخطوات
  1. قائمة الخرائط الموقعية
    get_sitemaps for acme.com. Show last-read dates and error counts.✓ تم النسخ
    → قائمة صحة الخرائط الموقعية
  2. أعد تقديم القديمة منها
    For sitemaps not read in 7 days, resubmit.✓ تم النسخ
    → تم التقديم

النتيجة: ثقة بأن Google ترى المحتوى الجديد.

استخراج فرص التصنيف من Google Search Console

👤 متخصصو تحسين محركات البحث في مرحلة النمو ⏱ ~40 min intermediate

متى تستخدمه: تريد استعلامات تصنفها في المواضع 11-20 وقريبة من الصفحة الأولى.

الخطوات
  1. ابحث عن الاستعلامات القريبة من النجاح
    Queries last 90 days with avg position between 11 and 20 AND >100 impressions. Return with the landing page.✓ تم النسخ
    → قائمة الأهداف
  2. حدد الأولويات حسب الجهد
    For top 20, check the landing page — is it already optimized for the query? If not, suggest on-page changes.✓ تم النسخ
    → قائمة الفرص المرجحة حسب الجهد

النتيجة: قائمة انتظار تحسين محركات البحث المرتبة حسب الأولوية بناءً على بيانات Google Search Console الفعلية.

اجمعها مع: firecrawl

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

gsc + google-sheets

تقرير تحسين محركات البحث الأسبوعي المؤتمت يُدرج في جدول مشترك

Every Monday, run my weekly SEO report and append to 'SEO Weekly' sheet.✓ تم النسخ
gsc + firecrawl

احصد صفحات المنافسين التي تصنفها لاستعلاماتك المستهدفة

For each near-miss query in GSC, find the top SERP pages (via firecrawl), and summarize why they outrank me.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداةالمدخلاتمتى تستدعيهاالتكلفة
list_properties اكتشف ما لديك إمكانية الوصول إليه 1 API call
get_search_analytics site, start_date, end_date, dimensions[], filters?, row_limit? الاستعلام الرئيسي 1 API call
inspect_url_enhanced site, url تصحيح الأخطاء في الفهرسة لكل عنوان URL 1 API call
get_sitemaps site صحة الخريطة الموقعية 1 API call
submit_sitemap site, feedpath ادفع Google للزحف مرة أخرى 1 API call

التكلفة والحدود

تكلفة التشغيل

حصة API
واجهة برمجية Google Search Console: 1200 استعلام في الدقيقة لكل مشروع، 6000 استعلام يومياً لكل موقع
الرموز لكل استدعاء
نتائج التحليلات حتى 25 ألف صف لكل استدعاء — قسّم قبل إرسال الكل
التكلفة المالية
مجاني
نصيحة
استخدم row_limit والمرشحات؛ إرسال أفضل 10 آلاف استعلام يفسد السياق للأدوات الذكية

الأمان

الصلاحيات والأسرار ونطاق الأثر

الحد الأدنى من الصلاحيات: https://www.googleapis.com/auth/webmasters.readonly
تخزين بيانات الاعتماد: GSC_OAUTH_CLIENT_SECRETS_FILE أو GSC_CREDENTIALS_PATH في متغيرات البيئة
نقل البيانات الخارجي: searchconsole.googleapis.com
لا تمنح أبدًا: webmasters (full)

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

403 User does not have permission

يجب أن يكون حساب OAuth أو حساب الخدمة مستخدماً تم التحقق منه في Google Search Console لهذه الخاصية. أضفه ضمن Settings → Users

Empty analytics response

Google Search Console لها تأخر في البيانات من يومين إلى 3 أيام؛ قد تكون end_date > اليوم - 3 فارغة. أيضاً: أنواع البحث 'Web' و 'Discover' مختلفة

OAuth flow loops

يجب أن تتطابق Redirect URI في client_secrets.json بدقة (بما في ذلك منفذ http://localhost)

البدائل

mcp-gsc مقابل البدائل

البديلمتى تستخدمهاالمقايضة
واجهة Google Search Console الويبالعمل اليدوي العرضيلا أتمتة، لا حلقة تقارير
واجهات برمجية Ahrefs/SEMrushتريد تتبع التصنيفات من جهات خارجية، وليس بيانات Google الخاصةمدفوع؛ مجموعة بيانات مختلفة

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills