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. Проблемы с плагинами: трекер задач репозитория.