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