/ الدليل / الملعب / mcp-google-ads
← كل الخوادم ↗ GitHub
● رسمي cohnen ⚡ فوري

mcp-google-ads

بواسطة cohnen · cohnen/mcp-google-ads

تشغيل GAQL على حسابك في Google Ads من المحادثة — قائمة الحسابات وأداء الحملات والإعلانات والاستعلامات المخصصة — مع مصادقة OAuth أو حساب الخدمة.

mcp-google-ads هي Python MCP تتصل بـ Google Ads API. خمس قدرات: قائمة الحسابات المتاحة وتشغيل GAQL التعسفية وقراءة أداء الحملة وقراءة أداء الإعلان وتشغيل الاستعلامات المخصصة. يتطلب Google Ads Developer Token (موافقة من 1-3 أيام عمل) ومصادقة OAuth أو حساب الخدمة.

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

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

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

عرض مباشر

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

google-ads.replay ▶ جاهز
0/0

التثبيت

اختر العميل

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

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

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

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

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

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

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

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

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

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

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

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

claude mcp add google-ads -- uvx mcp-google-ads

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

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

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

فحص صحة الحملة الأسبوعي عبر الحسابات

👤 مديرو التسويق المدفوع والوكالات ⏱ ~20 min intermediate

متى تستخدمه: أسبوعياً — أي الحملات التي تحرق الميزانية بـ CTR منخفضة / CPA عالية؟

المتطلبات الأساسية
  • Google Ads Developer Token (معتمد) — ads.google.com > Tools > API Center — 1-3 أيام عمل
  • عميل OAuth أو حساب الخدمة مع وصول Ads — Google Cloud Console
الخطوات
  1. قائمة الحسابات
    اسرد جميع حسابات Google Ads التي يمكنني الوصول إليها.✓ تم النسخ
    → MCC + الحسابات الفرعية
  2. سحب الأداء
    لكل حساب، اسحب آخر 7 أيام: اسم الحملة والتكلفة والنقرات والتحويلات وCPA. علّم الحملات حيث CPA > $100.✓ تم النسخ
    → قائمة النقاط الساخنة المرتبة
  3. اقترح إجراء
    للحملات الثلاث الأسوأ، اقترح: إيقاف، خفض السعر، أو التحقيق بشكل أعمق بناءً على الأرقام.✓ تم النسخ
    → خطة العمل

النتيجة: مراجعة النقاط الساخنة الأسبوعية في دقائق.

المزالق
  • نوافذ الإسناد تختلف حسب إجراء التحويل — أدرج segments.conversion_action_name والتحقق من كل واحد على حدة
اجمعها مع: notion

تعدين مصطلحات البحث عن الكلمات الرئيسية السلبية

👤 مسوقو الأداء ⏱ ~15 min intermediate

متى تستخدمه: صيانة الحساب المنتظمة — اقبض على الاستعلامات المهدرة قبل أن تتراكم.

الخطوات
  1. سحب مصطلحات البحث
    GAQL: search_term_view آخر 30 يوم، أعمدة [search_term, campaign, cost, conversions]. Cost > $10 و conversions = 0.✓ تم النسخ
    → قائمة الاستعلامات المهدرة
  2. جمّع واقترح
    اجمع حسب العبارات المتكررة. اقترح كلمات رئيسية سلبية لإضافتها على مستوى الحساب أو الحملة.✓ تم النسخ
    → قائمة سلبية مع المستوى

النتيجة: قائمة الكلمات الرئيسية السلبية منظمة لتطبيقها.

المزالق
  • الكلمات الرئيسية السلبية العريضة يمكن أن تحجب حركة المرور الشرعية — استخدم السلبيات الدقيقة أو الجملية أولاً؛ استخدم السلبيات العريضة فقط عندما تكون متأكداً جداً

تدقيق أداء نصوص الإعلان عبر الحملة

👤 كاتبو الإعلانات ومديرو PPC ⏱ ~15 min intermediate

متى تستخدمه: أطلقت 3 إعلانات سريعة التجاوب وتريد معرفة أي التركيبات تعمل.

الخطوات
  1. سحب إحصائيات الإعلان
    للحملة X، اسرد جميع الإعلانات + نسبة النقر المئوية لـ 30 يوماً + معدل التحويل. رتب حسب معدل التحويل تنازلياً.✓ تم النسخ
    → أداء الإعلان المرتبة
  2. اقترح
    ما الأنماط التي تميز نصوص الإعلانات الأفضل أداءً؟ ما الذي يجب أن أكرره؟✓ تم النسخ
    → رؤى النصوص

النتيجة: تكرار إبداعي مدفوع بالبيانات.

المزالق
  • الإعلانات منخفضة الحجم تبدو أسوأ مما هي عليه بسبب التباين — اطلب الحد الأدنى من 100 انطباع قبل مقارنة المعدلات

التركيبات

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

google-ads + notion

ملخص التسويق الأسبوعي

اسحب أداء Google Ads من الأسبوع الماضي + أكبر الانتصارات والخسائر؛ أنشئ صفحة Notion في 'Marketing Weekly'.✓ تم النسخ
google-ads + postgres

ربط بيانات Google Ads مع قاعدة البيانات الخاصة بك للحصول على عرض المسار الكامل

احصل على عدد التحويلات من Google Ads للحملة X. اطلب من قاعدة البيانات الصفقات المغلقة الفعلية الناشئة من تلك الحملة.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
list_accessible_accounts اكتشف هيكل الحساب 1 API call
run_gaql customer_id, query: str أي تقرير مخصص 1 API call
campaign_performance customer_id, date_range ملخص سريع للحملة 1 API call
ad_performance customer_id, campaign_id?, date_range تدقيق الإبداع 1 API call

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

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

حصة API
Google Ads API: حد أقصى يومي سخي؛ معدل محدود لكل QPS
الرموز لكل استدعاء
تعتمد النتائج بشكل كبير على نطاق التاريخ والمقاطع — حد أقصى للصفوف
التكلفة المالية
API مجاني؛ أنت تدفع للإعلانات بشكل منفصل
نصيحة
تضمن دائماً نطاق تاريخ في GAQL. قد يؤدي التشغيل بدون حد أقصى إلى إرجاع 100k صف.

الأمان

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

الحد الأدنى من الصلاحيات: قراءة فقط على حسابات Ads حيث يكون ذلك ممكناً
تخزين بيانات الاعتماد: JSON حساب الخدمة أو رمز تحديث OAuth — متغيرات env أو مدير الأسرار
نقل البيانات الخارجي: تذهب بيانات الأداء إلى موفر LLM الخاص بك
لا تمنح أبدًا: منح صلاحيات إدارية على حساب Ads لوكيل يقوم بأكثر من مجرد القراءة

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

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

AUTHENTICATION_ERROR or PERMISSION_DENIED

بريد حساب الخدمة لم يتم إضافته إلى MCC مع الوصول، أو developer_token خاطئ. تحقق من ads.google.com > Access & Security.

مقاييس كثيرة جداً للمقطع

GAQL لديها قيود على أي مقاييس يمكن دمجها مع أي مقاطع. اطلب مجموعة فرعية أبسط.

تحقق: اقرأ جدول توافق GAQL
حد أقصى للرمز المجرب تم تجاوزه

تقدم بطلب للحصول على رمز الإنتاج؛ حتى ذلك الحين اختبر الحسابات الصغيرة بتكرار استعلام منخفض.

البدائل

mcp-google-ads مقابل البدائل

البديلمتى تستخدمهاالمقايضة
Google Ads UI / Editorعندما تسحب التقارير من حين لآخر فقطيدوي؛ بدون رؤية LLM
Meta Ads MCPعندما تقوم أيضاً بتشغيل إعلانات Metaمنصة مختلفة؛ المصادقة الخاصة

المزيد

الموارد

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

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

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