Pliki cookie

Używamy plików cookie do logowania (niezbędne) i analityki (opcjonalne). Więcej informacji - Polityka prywatności.

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.

Leady i ich wynikiread:leadswrite:leadswrite:quality-outcomes
Kampanieread:campaignswrite:campaigns
Klienciread:clientswrite:clients
Raportyread:reportswrite:reports
Alertyread:alertswrite:alerts
Zadaniaread:taskswrite:tasks
Propozycje zmian i wersje robocze kampaniiread:proposalswrite:proposals
Webhookiread:webhookswrite:webhooks
Wysyłki outreachread:outreachwrite:outreach
Bezpieczeństwo publikacji na stronieread: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.

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

  • Dwa serwery przez Streamable HTTP: https://adsbeast.pro/api/mcp z narzędziami otwartymi i https://adsbeast.pro/api/mcp/workspace z narzędziami Twojej organizacji.
  • Handshake i tools/list odpowiadają 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.
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

Serwer MCP

Webhooki

  • 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-Event z nazwą zdarzenia oraz X-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_webhook albo przez REST API. list_webhook_events zwraca 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-Signature

Wtyczki

  • W publicznym repozytorium są dwie wtyczki na licencji MIT: ad-spec-guard z narzędziami otwartymi i adsbeast z narzędziami konta.
  • Claude Code i Codex instalują je z repozytorium jako marketplace. Inni klienci dodają serwer po adresie URL.

github.com/notformal/adsbeast-plugins

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.

FreeCena$0 miesięcznieWywołania MCP miesięcznie100Konta reklamowe1
ConnectorCena$19 miesięcznieWywołania MCP miesięcznie2 000Konta reklamoweBez limitu
StarterCena$49 miesięcznieWywołania MCP miesięcznie10 000Konta reklamoweBez limitu
AgencyCena$199 miesięcznieWywołania MCP miesięcznie100 000Konta reklamoweBez limitu
EnterpriseCena$599 miesięcznieWywołania MCP miesięcznieBez stałego limitu, w ramach fair useKonta reklamoweBez limitu

Zobacz cennik

Wsparcie

Pytania o integrację: support@adsbeast.pro. Problemy z wtyczkami: zgłoszenia (issues) w repozytorium.

support@adsbeast.pro