קובצי Cookie

אנחנו משתמשים בעוגיות לכניסה למערכת (הכרחיות) ולניתוח נתונים (אופציונליות). פרטים נוספים - מדיניות פרטיות.

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

support@adsbeast.pro