ADS Beast pre AI asistentov
ADS Beast pre vývojárov
Všetko, k čomu sa integrácia dostane, ide cez jeden API kľúč s rozsahmi prístupu. Ten istý kľúč funguje pre REST API aj pre MCP server.
API kľúče
- Kľúče vytvára administrátor v ADS Beast v časti API kľúče. Kľúč sa začína na
absk_a zobrazí sa iba raz. - Kľúč patrí jednej organizácii. Dá sa naviazať aj na jedného klienta a potom vidí len tohto klienta.
- Každý kľúč má vlastný limit požiadaviek za minútu: 60, ak nenastavíte iný.
- Fakturácia, nastavenia a pripojenia k reklamným platformám nie sú s kľúčom dostupné vôbec.
- Kľúč nikdy nemení reklamný účet priamo, ani s právom zápisu. Zmena kampane, rozpočtu, ponuky, reklamy alebo kľúčového slova sa stane návrhom: schváli ju človek, alebo úzku bezpečnú skupinu zmien použije politika automatického použitia klienta. Schvaľovať návrhy a meniť nastavenia ochrany môže iba človek.
Rozsahy prístupu
Rozsah otvára jednu oblasť na čítanie alebo zápis. Oblasť, ktorú kľúč neuvádza, odpovie 403. read:* pokrýva všetko čítanie.
| Oblasť | Rozsahy |
|---|---|
| Leady a ich výsledky | read:leadswrite:leadswrite:quality-outcomes |
| Kampane | read:campaignswrite:campaigns |
| Klienti | read:clientswrite:clients |
| Reporty | read:reportswrite:reports |
| Upozornenia | read:alertswrite:alerts |
| Úlohy | read:taskswrite:tasks |
| Návrhy zmien a koncepty kampaní | read:proposalswrite:proposals |
| Webhooky | read:webhookswrite:webhooks |
| Oslovovanie | read:outreachwrite:outreach |
| Bezpečnosť publikovania webu | read:seo |
REST API
Základná adresa: https://adsbeast.pro/api. Kľúč posielajte ako Authorization: Bearer absk_... alebo X-API-Key.
Príkaz nižšie vráti názov kľúča, jeho organizáciu a rozsahy prístupu. Začnite ním, keď niečo odpovie 401 alebo 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
- Dva servery cez Streamable HTTP:
https://adsbeast.pro/api/mcps otvorenými nástrojmi ahttps://adsbeast.pro/api/mcp/workspaces nástrojmi vašej organizácie. - Nadviazanie spojenia a
tools/listodpovedajú bez kľúča. Každé volanie nástroja účtu kľúč potrebuje. - Nástroje, ktoré zapisujú, sú tak označené v metadátach, takže klient, ktorý si takéto akcie necháva potvrdiť, sa najprv opýta.
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.nameWebhooky
- ADS Beast posiela udalosti na vašu adresu ako HTTP POST s JSON, napríklad
lead.created, keď príde nový lead. - Každá požiadavka obsahuje
X-ADS-Beast-Events názvom udalosti aX-ADS-Beast-Signature: sha256=..., čo je HMAC surového tela s tajným kľúčom koncového bodu. Overte ho skôr, než telu uveríte. - Doručenie, ktoré zlyhá, sa skúša najviac trikrát s predlžujúcimi sa pauzami.
- Koncový bod zaregistrujete nástrojom
create_webhookalebo cez REST API. Názvy udalostí vrátilist_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-SignaturePluginy
- Vo verejnom repozitári sú dva pluginy pod licenciou MIT:
ad-spec-guards otvorenými nástrojmi aadsbeasts nástrojmi účtu. - Claude Code a Codex ich inštalujú z repozitára ako z marketplace. Ostatní klienti pridávajú server cez URL.
Limity podľa plánu
Plán určuje, koľko volaní MCP nástrojov môže organizácia urobiť za mesiac. Keď sa limit vyčerpá, nástroje odpovedajú chybou až do ďalšieho mesiaca. Nič sa neúčtuje navyše.
Tabuľka sa číta z toho istého katalógu ako stránka s cenníkom.
| Plán | Cena | MCP volania mesačne | Reklamné účty |
|---|---|---|---|
| Free | Cena$0 mesačne | MCP volania mesačne100 | Reklamné účty1 |
| Connector | Cena$19 mesačne | MCP volania mesačne2 000 | Reklamné účtyBez obmedzenia |
| Starter | Cena$49 mesačne | MCP volania mesačne10 000 | Reklamné účtyBez obmedzenia |
| Agency | Cena$199 mesačne | MCP volania mesačne100 000 | Reklamné účtyBez obmedzenia |
| Enterprise | Cena$599 mesačne | MCP volania mesačneBez pevného limitu, primerané používanie | Reklamné účtyBez obmedzenia |
Podpora
Otázky k integrácii: support@adsbeast.pro. Problémy s pluginmi: issue tracker repozitára.