ADS Beast لمساعدي الذكاء الاصطناعي
ADS Beast للمطورين
كل ما يمكن أن يصل إليه تكامل يمر عبر مفتاح API واحد بصلاحيات. المفتاح نفسه يعمل مع REST API ومع خادم MCP.
مفاتيح API
- ينشئ المسؤول المفاتيح في ADS Beast ضمن مفاتيح API. يبدأ المفتاح بـ
absk_ويُعرض مرة واحدة. - المفتاح تابع لمؤسسة واحدة. ويمكن أيضًا ربطه بعميل واحد، وعندها لا يرى إلا ذلك العميل.
- لكل مفتاح حد خاص به لعدد الطلبات في الدقيقة: 60 طلبًا ما لم تحدد غير ذلك.
- الفوترة والإعدادات والاتصالات بالمنصات الإعلانية لا يمكن الوصول إليها بمفتاح إطلاقًا.
- المفتاح لا يغيّر حساب الإعلانات مباشرة أبدًا، حتى مع صلاحية الكتابة. أي تغيير في حملة أو ميزانية أو عرض سعر أو إعلان أو كلمة مفتاحية يصبح اقتراحًا: يوافق عليه شخص، أو تطبّق سياسة التطبيق التلقائي للعميل مجموعة آمنة ومحدودة. الموافقة على الاقتراحات وتغيير إعدادات الحماية تبقى لشخص.
الصلاحيات
الصلاحية تفتح مجالًا واحدًا للقراءة أو للكتابة. المجال الذي لا يذكره المفتاح يرد بـ 403. read:* تغطي القراءة كلها.
| المجال | الصلاحيات |
|---|---|
| العملاء المحتملون ونتائجهم | read:leadswrite:leadswrite:quality-outcomes |
| الحملات | read:campaignswrite:campaigns |
| العملاء | read:clientswrite:clients |
| التقارير | read:reportswrite:reports |
| التنبيهات | read:alertswrite:alerts |
| المهام | read:taskswrite:tasks |
| اقتراحات التغيير ومسودات الحملات | read:proposalswrite:proposals |
| Webhooks | read:webhookswrite:webhooks |
| المراسلات | read:outreachwrite:outreach |
| سلامة النشر لموقع | read:seo |
REST API
العنوان الأساسي: https://adsbeast.pro/api. أرسل المفتاح في Authorization: Bearer absk_... أو X-API-Key.
الأمر أدناه يعيد اسم المفتاح ومؤسسته وصلاحياته. ابدأ به حين يرد شيء بـ 401 أو 403.
curl -s https://adsbeast.pro/api/whoami -H "Authorization: Bearer absk_your_key"Invoke-RestMethod -Uri https://adsbeast.pro/api/whoami -Headers @{ Authorization = "Bearer absk_your_key" }MCP
- خادمان عبر Streamable HTTP:
https://adsbeast.pro/api/mcpوفيه الأدوات المفتوحة، وhttps://adsbeast.pro/api/mcp/workspaceوفيه أدوات مؤسستك. - المصافحة و
tools/listتستجيبان بلا مفتاح. كل استدعاء لأداة من أدوات الحساب يحتاج إلى مفتاح. - الأدوات التي تكتب معلَّمة في بياناتها الوصفية، فالعميل الذي يطلب تأكيد مثل هذه الإجراءات سيسأل أولًا.
curl -s https://adsbeast.pro/api/mcp/workspace \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'(Invoke-RestMethod -Method Post -Uri https://adsbeast.pro/api/mcp/workspace -ContentType "application/json" -Body '{"jsonrpc":"2.0","id":1,"method":"tools/list"}').result.tools.nameWebhooks
- يرسل ADS Beast الأحداث إلى عنوانك كطلب HTTP POST يحمل JSON، مثل
lead.createdعند وصول عميل محتمل جديد. - كل طلب يحمل
X-ADS-Beast-Eventوفيه اسم الحدث، وX-ADS-Beast-Signature: sha256=...وهو HMAC لجسم الطلب الخام بالسر الخاص بنقطة الاستقبال. تحقق منه قبل أن تثق بجسم الطلب. - التسليم الذي يفشل تُعاد محاولته حتى ثلاث مرات بفواصل زمنية متزايدة.
- تسجّل نقطة استقبال بأداة
create_webhookأو عبر REST API، وlist_webhook_eventsتعيد أسماء الأحداث.
import hashlib, hmac
def is_from_adsbeast(secret: str, raw_body: bytes, header: str) -> bool:
expected = "sha256=" + hmac.new(secret.encode(), raw_body, hashlib.sha256).hexdigest()
return hmac.compare_digest(expected, header) # header: X-ADS-Beast-Signatureالإضافات
- يضم المستودع العام إضافتين برخصة MIT:
ad-spec-guardوفيها الأدوات المفتوحة، وadsbeastوفيها أدوات الحساب. - يثبّتهما Claude Code وCodex من المستودع بوصفه marketplace. أما العملاء الآخرون فيضيفون الخادم عبر العنوان.
الحدود حسب الخطة
الخطة تحدد عدد استدعاءات أدوات MCP التي تستطيع المؤسسة إجراءها في الشهر. حين تنتهي الحصة ترد الأدوات بخطأ حتى الشهر التالي. لا تُفرض أي رسوم إضافية.
الجدول يُقرأ من الفهرس نفسه الذي تُقرأ منه صفحة الأسعار.
| الخطة | السعر | استدعاءات MCP شهريًا | الحسابات الإعلانية |
|---|---|---|---|
| Free | السعر$0 شهريًا | استدعاءات MCP شهريًا100 | الحسابات الإعلانية1 |
| Connector | السعر$19 شهريًا | استدعاءات MCP شهريًا2,000 | الحسابات الإعلانيةبلا سقف |
| Starter | السعر$49 شهريًا | استدعاءات MCP شهريًا10,000 | الحسابات الإعلانيةبلا سقف |
| Agency | السعر$199 شهريًا | استدعاءات MCP شهريًا100,000 | الحسابات الإعلانيةبلا سقف |
| Enterprise | السعر$599 شهريًا | استدعاءات MCP شهريًابلا حد ثابت، استخدام عادل | الحسابات الإعلانيةبلا سقف |
الدعم
أسئلة عن تكامل: support@adsbeast.pro. مشكلات في الإضافات: متتبع المشكلات في المستودع.