Soubory cookie

Soubory cookie používáme pro přihlášení (nezbytné) a analytiku (volitelné). Další informace - Ochrana osobních údajů.

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í.

Leady a jejich výsledkyread:leadswrite:leadswrite:quality-outcomes
Kampaněread:campaignswrite:campaigns
Klientiread:clientswrite:clients
Reportyread:reportswrite:reports
Upozorněníread:alertswrite:alerts
Úkolyread:taskswrite:tasks
Návrhy změn a koncepty kampaníread:proposalswrite:proposals
Webhookyread:webhookswrite:webhooks
Oslovováníread:outreachwrite:outreach
Bezpečnost publikování weburead: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.

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 přes Streamable HTTP: https://adsbeast.pro/api/mcp s otevřenými nástroji a https://adsbeast.pro/api/mcp/workspace s nástroji vaší organizace.
  • Navázání spojení a tools/list odpoví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á.
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 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-Event s názvem události a X-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_webhook nebo 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-Signature

Pluginy

  • Ve veřejném repozitáři jsou dva pluginy pod licencí MIT: ad-spec-guard s otevřenými nástroji a adsbeast s nástroji účtu.
  • Claude Code a Codex je instalují z repozitáře jako z marketplace. Ostatní klienti přidávají server přes URL.

github.com/notformal/adsbeast-plugins

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.

FreeCena$0 měsíčněMCP volání měsíčně100Reklamní účty1
ConnectorCena$19 měsíčněMCP volání měsíčně2 000Reklamní účtyBez omezení
StarterCena$49 měsíčněMCP volání měsíčně10 000Reklamní účtyBez omezení
AgencyCena$199 měsíčněMCP volání měsíčně100 000Reklamní účtyBez omezení
EnterpriseCena$599 měsíčněMCP volání měsíčněBez pevného limitu, přiměřené používáníReklamní účtyBez omezení

Zobrazit ceník

Podpora

Dotazy k integraci: support@adsbeast.pro. Potíže s pluginy: issue tracker repozitáře.

support@adsbeast.pro