Файли cookie

Ми використовуємо cookies для входу в систему (обов’язкові) та аналітики (опційні). Докладніше - Політика конфіденційності.

ADS Beast для ШІ-асистентів

ADS Beast для розробників

Усе, до чого може дістатися інтеграція, іде через один API-ключ з областями доступу. Той самий ключ працює і для REST API, і для MCP-сервера.

API-ключі

  • Ключі створює адміністратор в ADS Beast, у розділі API-ключі. Ключ починається з absk_ і показується один раз.
  • Ключ належить одній організації. Його також можна прив'язати до одного клієнта, і тоді він бачить лише цього клієнта.
  • Кожен ключ має власний ліміт запитів на хвилину: 60, якщо ви не задали інший.
  • Білінг, налаштування та підключення до рекламних майданчиків за ключем недоступні взагалі.
  • Ключ ніколи не змінює рекламний кабінет напряму, навіть із правом запису. Зміна кампанії, бюджету, ставки, оголошення чи ключового слова стає пропозицією: її схвалює людина або вузький безпечний набір застосовує політика автозастосування клієнта. Схвалювати пропозиції й змінювати налаштування захисту може лише людина.

Області доступу

Область доступу відкриває один розділ для читання або запису. Розділ, якого в ключі не названо, відповідає 403. read:* покриває все читання.

Ліди та їхні результатиread:leadswrite:leadswrite:quality-outcomes
Кампаніїread:campaignswrite:campaigns
Клієнтиread:clientswrite:clients
Звітиread:reportswrite:reports
Сповіщенняread:alertswrite:alerts
Завданняread:taskswrite:tasks
Пропозиції змін і чернетки кампанійread:proposalswrite:proposals
Вебхукиread:webhookswrite:webhooks
Розсилкиread:outreachwrite:outreach
Безпека публікацій на сайтіread:seo

REST API

Базова адреса: https://adsbeast.pro/api. Передавайте ключ як Authorization: Bearer absk_... або X-API-Key.

Команда нижче повертає назву ключа, його організацію та області доступу. Починайте з неї, коли щось відповідає 401 або 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

  • Два сервери на Streamable HTTP: https://adsbeast.pro/api/mcp з відкритими інструментами та https://adsbeast.pro/api/mcp/workspace з інструментами вашої організації.
  • Рукостискання та tools/list відповідають без ключа. Для кожного виклику інструмента акаунта ключ потрібен.
  • Інструменти, які записують, позначено в метаданих, тому клієнт, який підтверджує такі дії, спершу запитає.
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-сервер

Вебхуки

  • ADS Beast надсилає події на вашу адресу запитом HTTP POST із JSON, наприклад lead.created, коли надходить новий лід.
  • Кожен запит містить X-ADS-Beast-Event з назвою події та X-ADS-Beast-Signature: sha256=..., це HMAC сирого тіла запиту із секретом адреси. Перевіряйте підпис, перш ніж довіряти тілу.
  • Невдалу доставку повторюють до трьох разів зі зростаючими паузами.
  • Адресу реєструють інструментом create_webhook або через REST API. 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

Плагіни

  • У відкритому репозиторії два плагіни під ліцензією MIT: ad-spec-guard з відкритими інструментами та adsbeast з інструментами акаунта.
  • Claude Code і Codex встановлюють їх із репозиторію як із маркетплейсу. Інші клієнти додають сервер за адресою.

github.com/notformal/adsbeast-plugins

Ліміти за тарифами

Тариф визначає, скільки викликів інструментів MCP організація може зробити за місяць. Коли ліміт закінчується, інструменти відповідають помилкою до наступного місяця. Понад тариф нічого не списується.

Таблиця читається з того самого каталогу, що й сторінка тарифів.

FreeЦіна$0 на місяцьВикликів MCP на місяць100Рекламні кабінети1
ConnectorЦіна$19 на місяцьВикликів MCP на місяць2 000Рекламні кабінетиБез обмеження
StarterЦіна$49 на місяцьВикликів MCP на місяць10 000Рекламні кабінетиБез обмеження
AgencyЦіна$199 на місяцьВикликів MCP на місяць100 000Рекламні кабінетиБез обмеження
EnterpriseЦіна$599 на місяцьВикликів MCP на місяцьБез жорсткого ліміту, добросовісне використанняРекламні кабінетиБез обмеження

Переглянути тарифи

Підтримка

Запитання щодо інтеграції: support@adsbeast.pro. Проблеми з плагінами: трекер завдань репозиторію.

support@adsbeast.pro