Своя обёртка над каждой площадкой
Google Ads и Meta говорят на разных языках: свои поля, свои статусы, свои лимиты. Прослойка, написанная ради одного отчёта, живёт дольше самого отчёта.
Один рекламный API для вашего кода и ваших агентов
REST API v1 и MCP-сервер работают на одном ключе вида vk_live_… и на одном наборе областей доступа: 31 инструмент для ассистента и эндпоинты для кампаний, аналитики, лидов Meta и правил. Ключ можно выдать только на чтение, а запись без нужной области отвечает 403.
Почему интеграция с рекламой обходится дороже, чем кажется
Ассистенту некуда подключиться
Claude или ChatGPT способен рассуждать про кампании, но у него нет ни доступа, ни границ: обычно выбор стоит между ключом от всего и ничем.
Ключ, о котором все забыли
Токен лежит в переменной окружения без срока, без области действия и без следа: непонятно, кто им пользуется и что случится, если он утечёт.
Три шага от ключа до первого вызова
Создайте ключ
В разделе ключей разработчика задайте имя, набор областей доступа и, при желании, срок жизни в днях. Ключ показывается один раз, в базе остаётся SHA-256-хеш.
Подключите клиент
REST-запросы идут на /api/v1 с заголовком Authorization: Bearer, x-api-key или apikey. Ассистент подключается к MCP-эндпоинту /mcp тем же ключом.
Работайте в границах ключа
Доступны только выданные области: без campaigns:write запись вернёт 403 insufficient_scope, а созданная кампания появится черновиком, а не в эфире.
Что получает разработчик и что получает агент
31 инструмент MCP
Кампании, аналитика, лиды Meta, правила, health-скоры и генерация текстов — доступны ассистенту как обычные инструменты по одному ключу.
REST API v1
Кампании с паузой, возобновлением, метриками и health-скором, аналитика, лиды Meta, обзор аккаунта и правила автоматизации.
Девять областей доступа
campaigns, analytics, rules, health, leads и ai:generate — ключ для дашборда можно выдать строго на чтение, не открывая запись.
Ключи, которые не теряются
Префикс в списке, счётчик запросов, время последнего использования и срок жизни; отзыв мгновенно выключает ключ во всех интеграциях.
Спецификация OpenAPI 3.0
Схема отдаётся по /api/docs/openapi.json, рядом живёт интерактивная документация — клиент генерируется, а не пишется руками.
Те же правила безопасности
Кампании из API и MCP создаются черновиками, запись требует write-области, и ничего не уходит в кабинет площадки само.
В цифрах
- 31
- инструмент MCP по одному ключу разработчика
- 9
- областей доступа, которые можно выдать ключу по отдельности
- 100
- запросов в минуту на ключ по умолчанию
Вопросы разработчиков
Как получить API-ключ Valkiria?
В разделе ключей разработчика нажмите «Создать ключ», задайте имя, отметьте нужные области доступа и при желании укажите срок жизни в днях. Ключ вида vk_live_… показывается ровно один раз: в базе хранится только его SHA-256-хеш. Отозвать ключ можно в любой момент, отзыв срабатывает сразу.
Как подключить Valkiria к Claude или ChatGPT по MCP?
MCP-сервер живёт на эндпоинте /mcp и работает по транспорту Streamable HTTP. В настройках MCP-клиента укажите этот адрес и заголовок Authorization: Bearer с вашим ключом vk_live_… После подключения ассистенту становится доступен 31 инструмент — но только в пределах областей, выданных этому ключу.
Может ли AI-агент запустить кампанию сам?
Нет. Создание кампании через API и MCP отдаёт черновик, а не активную кампанию, и в ответе прямо сказано, что дальше нужен человек. Любая запись требует области campaigns:write, без неё вызов возвращает 403 insufficient_scope. Ключ вообще можно выдать только на чтение.
Какие эндпоинты доступны в API v1?
Кампании: список, чтение, создание, изменение, пауза, возобновление, удаление, метрики и health-скор. Аналитика: сводка, расходы, конверсии и отчёты. Лиды Meta: формы, лиды, синхронизация и приём лида. Плюс обзор аккаунта, список подключённых площадок и правила автоматизации с шаблонами и историей.
Есть ли ограничение по числу запросов?
По умолчанию 100 запросов в минуту на ключ; значение задаётся при настройке установки, поэтому на своём сервере его можно поднять. При превышении приходит ответ об ограничении — ключ при этом не блокируется и продолжает работать в следующем окне.
Через API доступны все рекламные площадки?
Кампания в API привязана к площадке, и создать её можно только там, где кабинет уже подключён: иначе ответ прямо скажет, что площадку нужно подключить. Отдельный вызов возвращает список подключённых площадок вместе с состоянием токена, поэтому проверить это можно до первой записи.
Выдайте первый ключ за минуту
Ключ создаётся с нужными областями и сроком, а отзывается в один клик. Начните с ключа только на чтение и расширьте права, когда убедитесь в поведении.