ADS Beast dla asystentów AI
ADS Beast dla deweloperów
Wszystko, do czego może sięgnąć integracja, przechodzi przez jeden klucz API z zakresami. Ten sam klucz działa dla REST API i dla serwera MCP.
Klucze API
- Klucze tworzy administrator w ADS Beast, w sekcji Klucze API. Klucz zaczyna się od
absk_i jest pokazywany tylko raz. - Klucz należy do jednej organizacji. Można go też powiązać z jednym klientem i wtedy widzi tylko tego klienta.
- Każdy klucz ma własny limit żądań na minutę: 60, jeśli nie ustawisz innego.
- Rozliczenia, ustawienia i połączenia z platformami reklamowymi są dla klucza całkowicie niedostępne.
- Klucz nigdy nie zmienia konta reklamowego bezpośrednio, nawet z prawem zapisu. Zmiana kampanii, budżetu, stawki, reklamy lub słowa kluczowego staje się propozycją: zatwierdza ją człowiek albo wąski bezpieczny zestaw stosuje polityka automatycznego stosowania klienta. Zatwierdzać propozycje i zmieniać ustawienia ochrony może tylko człowiek.
Zakresy
Zakres otwiera jeden obszar do odczytu albo zapisu. Obszar, którego klucz nie wymienia, odpowiada 403. read:* obejmuje cały odczyt.
| Obszar | Zakresy |
|---|---|
| Leady i ich wyniki | read:leadswrite:leadswrite:quality-outcomes |
| Kampanie | read:campaignswrite:campaigns |
| Klienci | read:clientswrite:clients |
| Raporty | read:reportswrite:reports |
| Alerty | read:alertswrite:alerts |
| Zadania | read:taskswrite:tasks |
| Propozycje zmian i wersje robocze kampanii | read:proposalswrite:proposals |
| Webhooki | read:webhookswrite:webhooks |
| Wysyłki outreach | read:outreachwrite:outreach |
| Bezpieczeństwo publikacji na stronie | read:seo |
REST API
Adres bazowy: https://adsbeast.pro/api. Wysyłaj klucz jako Authorization: Bearer absk_... albo X-API-Key.
Polecenie poniżej zwraca nazwę klucza, jego organizację i zakresy. Zacznij od niego, gdy coś odpowiada 401 albo 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
- Dwa serwery przez Streamable HTTP:
https://adsbeast.pro/api/mcpz narzędziami otwartymi ihttps://adsbeast.pro/api/mcp/workspacez narzędziami Twojej organizacji. - Handshake i
tools/listodpowiadają bez klucza. Każde wywołanie narzędzia konta wymaga klucza. - Narzędzia, które zapisują, są oznaczone w metadanych, więc klient, który potwierdza takie działania, najpierw zapyta.
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.nameWebhooki
- ADS Beast wysyła zdarzenia na Twój adres jako HTTP POST z JSON, na przykład
lead.created, gdy przychodzi nowy lead. - Każde żądanie zawiera
X-ADS-Beast-Eventz nazwą zdarzenia orazX-ADS-Beast-Signature: sha256=..., czyli HMAC surowej treści żądania z sekretem punktu końcowego. Sprawdź podpis, zanim zaufasz treści. - Nieudana dostawa jest ponawiana do trzech razy z rosnącymi przerwami.
- Punkt końcowy rejestrujesz narzędziem
create_webhookalbo przez REST API.list_webhook_eventszwraca nazwy zdarzeń.
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-SignatureWtyczki
- W publicznym repozytorium są dwie wtyczki na licencji MIT:
ad-spec-guardz narzędziami otwartymi iadsbeastz narzędziami konta. - Claude Code i Codex instalują je z repozytorium jako marketplace. Inni klienci dodają serwer po adresie URL.
Limity według planu
Plan określa, ile wywołań narzędzi MCP organizacja może wykonać w miesiącu. Gdy pula się skończy, narzędzia odpowiadają błędem do następnego miesiąca. Nic nie jest doliczane.
Tabela jest odczytywana z tego samego katalogu co strona cennika.
| Plan | Cena | Wywołania MCP miesięcznie | Konta reklamowe |
|---|---|---|---|
| Free | Cena$0 miesięcznie | Wywołania MCP miesięcznie100 | Konta reklamowe1 |
| Connector | Cena$19 miesięcznie | Wywołania MCP miesięcznie2 000 | Konta reklamoweBez limitu |
| Starter | Cena$49 miesięcznie | Wywołania MCP miesięcznie10 000 | Konta reklamoweBez limitu |
| Agency | Cena$199 miesięcznie | Wywołania MCP miesięcznie100 000 | Konta reklamoweBez limitu |
| Enterprise | Cena$599 miesięcznie | Wywołania MCP miesięcznieBez stałego limitu, w ramach fair use | Konta reklamoweBez limitu |
Wsparcie
Pytania o integrację: support@adsbeast.pro. Problemy z wtyczkami: zgłoszenia (issues) w repozytorium.