ADS Beast לעוזרי AI
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. בעיות בתוספים: מעקב התקלות (issues) של המאגר.