ملفات تعريف الارتباط

نستخدم ملفات تعريف الارتباط لتسجيل الدخول (ضرورية) وللتحليلات (اختيارية). مزيد من التفاصيل - سياسة الخصوصية.

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
Webhooksread:webhookswrite:webhooks
المراسلاتread:outreachwrite:outreach
سلامة النشر لموقعread:seo

REST API

العنوان الأساسي: https://adsbeast.pro/api. أرسل المفتاح في Authorization: Bearer absk_... أو X-API-Key.

الأمر أدناه يعيد اسم المفتاح ومؤسسته وصلاحياته. ابدأ به حين يرد شيء بـ 401 أو 403.

macOS, Linux
curl -s https://adsbeast.pro/api/whoami -H "Authorization: Bearer absk_your_key"
Windows PowerShell
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 تستجيبان بلا مفتاح. كل استدعاء لأداة من أدوات الحساب يحتاج إلى مفتاح.
  • الأدوات التي تكتب معلَّمة في بياناتها الوصفية، فالعميل الذي يطلب تأكيد مثل هذه الإجراءات سيسأل أولًا.
macOS, Linux
curl -s https://adsbeast.pro/api/mcp/workspace \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Windows PowerShell
(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.name

خادم MCP

Webhooks

  • يرسل 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. أما العملاء الآخرون فيضيفون الخادم عبر العنوان.

github.com/notformal/adsbeast-plugins

الحدود حسب الخطة

الخطة تحدد عدد استدعاءات أدوات 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. مشكلات في الإضافات: متتبع المشكلات في المستودع.

support@adsbeast.pro