أطلقنا أداة MCP مفتوحة المصدر لإدارة حملات Google Ads

في كاتبي، ندير حملات Google Ads لعملاء في الإمارات بشكل يومي. من إعداد الحملات الجديدة إلى مراجعة الكلمات المفتاحية وميزانيات الإعلانات — كل هذا كان يتطلب فتح واجهة Google Ads وتنفيذ خطوات يدوية متكررة في كل مرة.

لهذا السبب بنينا حلاً عملياً: سيرفر MCP مفتوح المصدر يربط بين الذكاء الاصطناعي وحسابات Google Ads مباشرة، واليوم نشاركه مع الجميع على GitHub.

وش هو سيرفر MCP أصلاً؟

MCP (Model Context Protocol) هو معيار مفتوح من شركة Anthropic يسمح للذكاء الاصطناعي بالاتصال بأدوات وأنظمة خارجية بطريقة موحدة. الفكرة بسيطة: بدل أن يكتب المطور كوداً خاصاً لكل نظام، يستخدم بروتوكول واحد يربط بين النماذج الذكية وأي أداة — قواعد بيانات، أنظمة CRM، أو في حالتنا هذه، Google Ads.

سيرفر MCP هو الوسيط: يستقبل طلبات من الذكاء الاصطناعي، ينفذها على النظام الفعلي، ويرجع النتيجة بصيغة يفهمها النموذج.

ليش بنينا أداة خاصة لإدارة Google Ads؟

فريقنا يدير حسابات متعددة تحت وكالة إعلانية واحدة (MCC). العمل اليومي يشمل:

• متابعة أداء الحملات: الظهور، النقرات، التكلفة، التحويلات
• تعديل الميزانيات اليومية حسب الأداء
• إيقاف أو تشغيل الحملات عند الحاجة
• إضافة كلمات مفتاحية جديدة أو إيقاف كلمات غير مربحة
• مراجعة كلمات البحث الفعلية لاكتشاف هدر الميزانية
• البحث عن أفكار كلمات مفتاحية جديدة عبر Keyword Planner

قبل هذه الأداة، كل مهمة من هذه تتطلب فتح الواجهة والتنقل بين القوائم. مع سيرفر MCP، يكفي أن يطلب فريقنا من الذكاء الاصطناعي تنفيذ المهمة — وهو يتصل بالـ API مباشرة.

شنو اللي تسويه الأداة بالضبط؟

النسخة الأولى تتضمن 14 أداة تغطي دورة حياة الحملة الإعلانية بالكامل:

🟢 إدارة الحسابات: list_accounts — يعرض كل الحسابات تحت الوكالة مع العملة والمنطقة الزمنية

🟢 إدارة الحملات: list_campaigns لعرض الحملات وحالتها، get_campaign_stats لتقارير الأداء لآخر 30 يوم، set_campaign_status لإيقاف أو تشغيل الحملة، update_campaign_budget لتعديل الميزانية اليومية، create_search_campaign لإنشاء حملة بحث جديدة

🟢 إدارة الكلمات المفتاحية: list_keywords لعرض الكلمات مع الجودة والظهور، add_keywords لإضافة كلمات جديدة، set_keyword_status وremove_keyword لإيقاف أو حذف الكلمات، update_keyword_bid لتعديل سعر النقرة

🟢 التقارير والبحث: get_search_terms لمراجعة كلمات البحث الفعلية، get_keyword_ideas لتوليد أفكار كلمات جديدة من Keyword Planner، list_ad_groups لعرض المجموعات الإعلانية

مثال عملي — كيف نستخدمها؟

أسهل طريقة لفهم الأداة هي مثال حقيقي من عملنا:

السيناريو: عميل أبلغنا أن ميزانيته اليومية مكلفة، ويريد خفضها مع استمرار الحملة.

بالطريقة التقليدية: فتح الواجهة، البحث عن الحملة، تعديل الميزانية، التأكد من الحفظ — 5 دقائق على الأقل.

مع سيرفر MCP: نطلب من الذكاء الاصطناعي "خفف ميزانية حملة X إلى 40 درهم" — فينفذ التعديل فوراً ويعيد قراءة الحملة للتأكد من نجاح التغيير.

مثال آخر: عند إعداد حملة جديدة، بدل إدخال 20 كلمة مفتاحية واحدة واحدة، نعطي الأداة قائمة الكلمات ونطلب إضافتها دفعة واحدة للمجموعة الإعلانية الصحيحة.

ليش نشرناها مفتوحة المصدر؟

قرار النشر المفتوح مبني على قناعة عملية، مو فقط حماس:

🟢 الشفافية: العملاء يرون بالضبط كيف تُدار حملاتهم — لا صندوق أسود

🟢 تحسين مستمر: المطورون حول العالم يضيفون أدوات جديدة ويصلحون المشاكل

🟢 معيار موحد: بدل أن يبني كل فريق أدواته الخاصة، نشارك أداة واحدة يعمل الجميع على تحسينها

🟢 مصداقية: إدارة إعلانات عملائك تحتاج أدوات حقيقية قابلة للتدقيق، والنشر المفتوح أقوى دليل على ذلك

الترخيص MIT — يمكن لأي شركة استخدامها وتعديلها بحرية، حتى تجارياً.

كيف تجربها بنفسك؟

التثبيت بسيط ولا يحتاج خبرة برمجة عميقة:

الخطوة 1: ثبت الحزمة عبر pip

pip install -e .
# أو عبر pipx للمستخدمين المتقدمين
pipx install .

الخطوة 2: جهز بيانات الدخول — تحتاج Developer Token من مركز API الخاص بحسابك، وبيانات OAuth:

export GOOGLE_ADS_DEVELOPER_TOKEN="..."
export GOOGLE_ADS_CLIENT_ID="..."
export GOOGLE_ADS_CLIENT_SECRET="..."
export GOOGLE_ADS_REFRESH_TOKEN="..."

الخطوة 3: أضف السيرفر إلى عميل MCP الذي تستخدمه — Claude Desktop أو أي عميل يدعم البروتوكول:

{
  "mcpServers": {
    "google-ads-campaign": {
      "command": "google-ads-campaign-mcp",
      "env": { "GOOGLE_ADS_DEVELOPER_TOKEN": "..." }
    }
  }
}

المستودع كامل مع التوثيق وأمثلة الاستخدام موجود على GitHub.

تحديات تقنية واجهناها أثناء البناء

البناء على Google Ads API له خصوصيته، ومن أبرز التحديات:

🟡 إصدارات الواجهة: Google تحدث الـ API باستمرار — نسخة v25 غيرت أسماء بعض الحقول وأنواعها، مما يتطلب تحديث الكود دورياً

🟡 حقول إلزامية غير متوقعة: عند إنشاء حملة جديدة، الواجهة تطلب حقولاً إضافية (مثل تصنيف الإعلانات السياسية الأوروبية) التي تسبب رفض الطلب إذا لم تُضبط

🟡 قيود على الإعدادات القديمة: خيارات مثل تكلفة النقرة المحسّنة (Enhanced CPC) لم تعد مقبولة للحملات الجديدة، ويجب ضبطها بقيم متوافقة

هذه التحديات ليست عائقاً — بل سبب إضافي لوجود أداة مركزية تتعامل معها مرة واحدة بدل إعادة اكتشافها في كل مشروع.

كيف تعمل الأداة من الداخل؟

لفهم القيمة الحقيقية، من المفيد معرفة البنية التقنية:

🟢 الطبقة الأولى — الاتصال: السيرفر يبني جلسة مع Google Ads API باستخدام بيانات الدخول المخزنة بأمان (Developer Token + OAuth). لا يتم تخزين أي بيانات حساسة داخل الكود.

🟢 الطبقة الثانية — الاستعلامات: لغة GAQL (شبيهة بـ SQL) تسترجع بيانات الحملات والكلمات المفتاحية. كل أداة قراءة تستخدم استعلامات جاهزة محسّنة، مع تحويل النتائج إلى صيغة JSON يسهل على الذكاء الاصطناعي فهمها.

🟢 الطبقة الثالثة — التعديلات: عمليات التحديث ترسل دفعات (حتى 50 عنصراً في الطلب الواحد) لتسريع المهام الكبيرة، مثل إضافة قائمة كلمات مفتاحية كاملة في طلب واحد.

🟢 الطبقة الرابعة — معالجة الأخطاء: رسائل الخطأ من Google تُترجم إلى صيغة واضحة، بحيث يفهم المستخدم سبب رفض أي طلب بدل مواجهة أكواد غامضة.

هذه البنية تجعل الأداة سهلة التوسع: أي أداة جديدة تحتاج فقط استعلام GAQL أو عملية تحديث — والباقي جاهز.

أين تتناسب مع أدوات الإعلان الأخرى؟

قد تتساءل: هل هذه الأداة بديل عن لوحة Google Ads أو أدوات مثل Google Ads Editor؟

🟢 لوحة Google Ads: الواجهة الرسمية — ممتازة للاستكشاف المرئي والتقارير التفصيلية، لكنها بطيئة للمهام المتكررة

🟢 Google Ads Editor: أداة سطح المكتب — قوية للتعديلات الجماعية دون اتصال، لكنها تحتاج تحميل وتحديث يدوي

🟢 سيرفر MCP: يكمل الاثنين — ينفذ المهام المتكررة بسرعة البرق عبر الذكاء الاصطناعي، ويمكن دمجه في سير عمل أتمتة أكبر

السيناريو الأمثل: استخدام الأداة للمهام التشغيلية اليومية (تعديل الميزانيات، إيقاف الكلمات، مراجعة الأداء) مع الاحتفاظ بالواجهة الرسمية للتحليل المتعمق والاستكشاف البصري.

أخطاء شائعة عند إدارة الحملات — وكيف تساعد الأداة

خلال سنوات إدارة الحملات، نرى أخطاء متكررة يمكن لهذه الأداة تقليلها:

🔴 عدم مراجعة كلمات البحث: كثير من الميزانيات تضيع على كلمات غير ذات صلة. أداة get_search_terms تعرض كلمات البحث الفعلية بضغطة واحدة.

🔴 تعديل الميزانية بالخطأ: مع الأداة، كل تعديل يُقرأ مرة ثانية للتأكد من نجاحه — لا تعديلات صامتة.

🔴 نسيان إيقاف الحملات الخاسرة: أداة set_campaign_status تجعل إيقاف الحملة أمراً فورياً بدل تركه ليوم إضافي.

🔴 تأخير إضافة كلمات جديدة: بدل إدخال الكلمات واحدة واحدة، add_keywords تضيفها دفعة واحدة من قائمة جاهزة.

كيف نستخدمها في كاتبي يومياً؟

عملياً، فريقنا يعتمد عليها في مهام أسبوعية منتظمة:

🟢 المراجعة الأسبوعية: سحب تقارير الأداء لكل العملاء في دقائق بدل ساعات

🟢 إعداد الحملات الجديدة: إنشاء حملة بحث أولية مع ميزانية محددة ثم ضبط الكلمات المفتاحية تدريجياً

🟢 استجابة سريعة للعملاء: عندما يطلب عميل تعديل ميزانية أو إيقاف حملة، يتم التنفيذ فوراً دون انتظار

🟢 اكتشاف الفرص: عبر get_keyword_ideas نستكشف كلمات مفتاحية جديدة بتكلفة منخفضة وحجم بحث مناسب

هذه المهام كانت تشغل ساعات أسبوعية — والآن أصبحت أوامر بسيطة.

الأسئلة الشائعة

هل الأداة مجانية؟

نعم — السيرفر مفتوح المصدر بالكامل برخصة MIT، مجاني للاستخدام التجاري والشخصي.

هل أحتاج حساب Google Ads خاص؟

تحتاج حساباً موجوداً وDeveloper Token صالح من Google Ads API — نفس المتطلبات لأي استخدام رسمي للواجهة.

هل تدعم الحسابات العربية؟

نعم — تعمل مع أي حساب بغض النظر عن اللغة، وتدعم الكلمات المفتاحية العربية في العمليات.

هل الأداة تعدّل حملاتي الحالية؟

نعم، تشمل أدوات تعديل: إيقاف/تشغيل الحملات، تعديل الميزانيات، تعديل أسعار النقرات. ننصح بتجربتها على حساب اختباري أولاً.

كيف أضيف أدوات جديدة؟

المشروع مفتوح — يمكنك إضافة أدوات عبر ملفات Python واضحة، ثم مشاركة التحسين عبر Pull Request.

كيف كاتبي تساعدك؟

📊 إدارة Google Ads — فريقنا يدير حملاتك اليومية ويستخدم هذه الأدوات لتحسين الأداء

🔧 أدوات مخصصة — نبني لك سيرفرات MCP وأدوات أتمتة تناسب أعمالك

🤖 تكامل ذكاء اصطناعي — نربط الذكاء الاصطناعي بأنظمتك: Google Ads، ERPNext، واتساب، وأكثر

إذا كنت مهتماً بأتمتة حملاتك الإعلانية أو بناء أدوات مشابهة لأعمالك، تواصل معنا — نناقش حالتك ونقترح الحل الأنسب.

📱 تواصل معنا على واتساب