Файлы 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