يتضمن SearchAds Manager خادم MCP محليًا متاحًا على macOS فقط، يعمل داخل التطبيق ويعيد استخدام بيانات اعتماد Apple Search Ads التي أُعدّت مسبقًا في إعدادات حسابك.

ما الذي يقدّمه

• استكشف التطبيقات التي تملكها والبلدان المدعومة قبل إنشاء الحملات.
• اجلب تقارير الحملات والمجموعات الإعلانية والكلمات المفتاحية دون إنشاء نصوص برمجية مخصصة لواجهة API.
• أنشئ الحملات والمجموعات الإعلانية والكلمات المفتاحية وحدّثها واحذفها من Codex عبر نقطة نهاية محلية محمية بالمصادقة.
• أبقِ الاتصال محليًا على Mac أثناء تشغيل التطبيق.

آلية التشغيل

1. يرتبط الخادم بالعنوان 127.0.0.1 فقط.
2. لا يتوفر الخادم إلا أثناء تشغيل تطبيق macOS.
3. يُحمى الوصول برمز يتم إنشاؤه وتخزينه في إعدادات التطبيق.
4. نقطة نهاية MCP هي /mcp.
5. تتوفر نقطة نهاية للتحقق من سلامة التشغيل على /health.

الإعدادات في SearchAds Manager

تتضمن شاشة الإعدادات في تطبيق macOS بطاقة خادم MCP لـ Codex التي تحتوي على:

1. مفتاح تبديل للتفعيل
2. منفذ TCP قابل للضبط
3. رمز وصول يتم إنشاؤه
4. عنوان URL الكامل لـ MCP الذي يتضمن بيانات المصادقة
5. أمر Codex جاهز للتنفيذ
6. عرض حالة مستمع الاتصالات المحلي

أدوات MCP المتاحة

الاستكشاف والبيانات الوصفية

• list_apps
• list_supported_countries

التقارير

• get_campaign_report
• get_adgroup_report
• get_keyword_report

إدارة الحملات

• list_campaigns
• create_campaigns
• update_campaigns
• delete_campaigns

إدارة المجموعات الإعلانية

• list_adgroups
• add_adgroups
• update_adgroups
• delete_adgroups

إدارة الكلمات المفتاحية

• list_keywords
• add_keywords
• update_keywords
• delete_keywords

سير العمل المعتاد

1. استدعِ list_apps للعثور على adam_id للتطبيق الذي تريد الترويج له.
2. استدعِ list_supported_countries للتحقق من رموز البلدان أو المناطق الصالحة.
3. افحص الأداء الحالي باستخدام get_campaign_report أو get_adgroup_report أو get_keyword_report.
4. راجع الحالة الحالية باستخدام list_campaigns وlist_adgroups وlist_keywords.
5. نفّذ عمليات الكتابة على دفعات صغيرة ومحددة بوضوح لتسهيل فهم الأخطاء والتراجع عن التغييرات عند الحاجة.

الخطوة التالية

لإضافة الخادم إلى Codex وإجراء اختبار أولي ببيانات مؤقتة، افتح ربط SearchAds Manager بـ Codex.