Súbory cookie

Cookies používame na prihlásenie (povinné) a na analytiku (voliteľné). Viac - Zásady ochrany osobných údajov.

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.

Leady a ich výsledkyread:leadswrite:leadswrite:quality-outcomes
Kampaneread:campaignswrite:campaigns
Klientiread:clientswrite:clients
Reportyread:reportswrite:reports
Upozorneniaread:alertswrite:alerts
Úlohyread:taskswrite:tasks
Návrhy zmien a koncepty kampaníread:proposalswrite:proposals
Webhookyread:webhookswrite:webhooks
Oslovovanieread:outreachwrite:outreach
Bezpečnosť publikovania weburead: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.

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

  • Dva servery cez Streamable HTTP: https://adsbeast.pro/api/mcp s otvorenými nástrojmi a https://adsbeast.pro/api/mcp/workspace s nástrojmi vašej organizácie.
  • Nadviazanie spojenia a tools/list odpovedajú 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.
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 server

Webhooky

  • 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-Event s názvom udalosti a X-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_webhook alebo cez REST API. Názvy udalostí vráti 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

Pluginy

  • Vo verejnom repozitári sú dva pluginy pod licenciou MIT: ad-spec-guard s otvorenými nástrojmi a adsbeast s nástrojmi účtu.
  • Claude Code a Codex ich inštalujú z repozitára ako z marketplace. Ostatní klienti pridávajú server cez URL.

github.com/notformal/adsbeast-plugins

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.

FreeCena$0 mesačneMCP volania mesačne100Reklamné účty1
ConnectorCena$19 mesačneMCP volania mesačne2 000Reklamné účtyBez obmedzenia
StarterCena$49 mesačneMCP volania mesačne10 000Reklamné účtyBez obmedzenia
AgencyCena$199 mesačneMCP volania mesačne100 000Reklamné účtyBez obmedzenia
EnterpriseCena$599 mesačneMCP volania mesačneBez pevného limitu, primerané používanieReklamné účtyBez obmedzenia

Pozrieť cenník

Podpora

Otázky k integrácii: support@adsbeast.pro. Problémy s pluginmi: issue tracker repozitára.

support@adsbeast.pro