ADS Beast pro AI asistenty
ADS Beast pro vývojáře
Všechno, k čemu se integrace dostane, jde přes jeden API klíč s rozsahy přístupu. Stejný klíč funguje pro REST API i pro MCP server.
API klíče
- Klíče vytváří administrátor v ADS Beast v části API klíče. Klíč začíná na
absk_a zobrazí se jen jednou. - Klíč patří jedné organizaci. Dá se také svázat s jedním klientem a pak vidí jen tohoto klienta.
- Každý klíč má vlastní limit požadavků za minutu: 60, pokud nenastavíte jiný.
- Fakturace, nastavení a připojení k reklamním platformám nejsou s klíčem dostupné vůbec.
- Klíč nikdy nemění reklamní účet přímo, ani s právem zápisu. Změna kampaně, rozpočtu, nabídky, reklamy nebo klíčového slova se stane návrhem: schválí ji člověk, nebo úzkou bezpečnou skupinu změn použije politika automatického použití klienta. Schvalovat návrhy a měnit nastavení ochrany může jen člověk.
Rozsahy přístupu
Rozsah otevírá jednu oblast pro čtení nebo zápis. Oblast, kterou klíč neuvádí, odpoví 403. read:* pokrývá veškeré čtení.
| Oblast | Rozsahy |
|---|---|
| Leady a jejich výsledky | read:leadswrite:leadswrite:quality-outcomes |
| Kampaně | read:campaignswrite:campaigns |
| Klienti | read:clientswrite:clients |
| Reporty | read:reportswrite:reports |
| Upozornění | read:alertswrite:alerts |
| Úkoly | read:taskswrite:tasks |
| Návrhy změn a koncepty kampaní | read:proposalswrite:proposals |
| Webhooky | read:webhookswrite:webhooks |
| Oslovování | read:outreachwrite:outreach |
| Bezpečnost publikování webu | read:seo |
REST API
Základní adresa: https://adsbeast.pro/api. Klíč posílejte jako Authorization: Bearer absk_... nebo X-API-Key.
Příkaz níže vrátí název klíče, jeho organizaci a rozsahy přístupu. Začněte jím, když něco odpoví 401 nebo 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 přes Streamable HTTP:
https://adsbeast.pro/api/mcps otevřenými nástroji ahttps://adsbeast.pro/api/mcp/workspaces nástroji vaší organizace. - Navázání spojení a
tools/listodpovídají bez klíče. Každé volání nástroje účtu klíč potřebuje. - Nástroje, které zapisují, jsou tak označené v metadatech, takže klient, který si takové akce nechává potvrdit, se nejdřív zeptá.
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 posílá události na vaši adresu jako HTTP POST s JSON, například
lead.created, když přijde nový lead. - Každý požadavek nese
X-ADS-Beast-Events názvem události aX-ADS-Beast-Signature: sha256=..., což je HMAC surového těla s tajným klíčem koncového bodu. Ověřte ho dřív, než tělu uvěříte. - Doručení, které selže, se zkouší nejvýše třikrát s prodlužujícími se pauzami.
- Koncový bod zaregistrujete nástrojem
create_webhooknebo přes REST API. Názvy událostí vrací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-SignaturePluginy
- Ve veřejném repozitáři jsou dva pluginy pod licencí MIT:
ad-spec-guards otevřenými nástroji aadsbeasts nástroji účtu. - Claude Code a Codex je instalují z repozitáře jako z marketplace. Ostatní klienti přidávají server přes URL.
Limity podle tarifu
Tarif určuje, kolik volání MCP nástrojů může organizace udělat za měsíc. Když se limit vyčerpá, nástroje odpovídají chybou až do dalšího měsíce. Nic se neúčtuje navíc.
Tabulka se čte ze stejného katalogu jako stránka s ceníkem.
| Tarif | Cena | MCP volání měsíčně | Reklamní účty |
|---|---|---|---|
| Free | Cena$0 měsíčně | MCP volání měsíčně100 | Reklamní účty1 |
| Connector | Cena$19 měsíčně | MCP volání měsíčně2 000 | Reklamní účtyBez omezení |
| Starter | Cena$49 měsíčně | MCP volání měsíčně10 000 | Reklamní účtyBez omezení |
| Agency | Cena$199 měsíčně | MCP volání měsíčně100 000 | Reklamní účtyBez omezení |
| Enterprise | Cena$599 měsíčně | MCP volání měsíčněBez pevného limitu, přiměřené používání | Reklamní účtyBez omezení |
Podpora
Dotazy k integraci: support@adsbeast.pro. Potíže s pluginy: issue tracker repozitáře.