vibe-agent-mcp

Автономный ИИ-агент для Agent API «Вайб-Маркетолог», живущий на тарифах Claude Code (без отдельных платных API-токенов модели) — второе тестовое задание для компании.

Первое тестовое (детерминированный линтер их генератора, ad-preflight) принято на 90/100 и названо основателем «одной из самых сильных работ кампании»: он нашёл, что 34% сгенерированных заголовков превышают лимит Яндекс.Директа (58–59 знаков при лимите 56). Это тестовое — тот же линтер, но встроенный в автономный цикл: сгенерировать → проверить → переформулировать → остановиться, с MCP-сервером сверху, чтобы Claude Code мог сам дёргать API.

Что это

• mcp_server/server.py — MCP-сервер, 7 инструментов поверх Agent API (4 бесплатных read-only, 2 платных write, 1 локальный preflight-чек).
• orchestrator/run_agent.py — автономный цикл с бюджетным гейтом: генерирует объявления, прогоняет через preflight, при браке переформулирует запрос, останавливается по чистоте выдачи или по бюджету/итерациям.
• vendor/ad-preflight — git submodule на первый тестовый проект; чек-логика (check_ad, лимиты Директа, ст. 5 ФЗ «О рекламе», сверка обещаний с лендингом) переиспользуется напрямую, не переписана.

Важные поправки к брифу (найдено на живом API, не в документации)

1. Нет бесплатного /generate/estimate для direct/*. Он бесплатен только для общей мультимедиа-фабрики (image/video/text/voice/music) и для brand_id-полей. У direct/ads-generate (49₽), direct/landing-audit (39₽), direct/sitelinks (29₽), direct/forecast (49₽) цена фиксированная и известна заранее из /capabilities.direct_tools. Бюджетный гейт в этом решении сравнивает потрачённое с этой таблицей цен, а не делает pre-flight dry-run запрос перед каждым платным вызовом.
2. /api/agent/brands реально работает (0 брендов на аккаунте), но direct/ads-generate принимает только url/utp, не brand_id — бренд не пробрасывается в генератор напрямую.
3. /agent/list, /agent/message, safety-check недоступны этому токену (404 not_found, не вопрос скоупа) — это Bitrix24-инбокс и риск- оценка реальных кампаний Директа, по документации «предоставляются по партнёрскому соглашению». Не используются в решении.

Подробности проверки — в docs/boundaries.md.

Как запустить

git clone --recurse-submodules <URL этого репо>
cd vibe-agent-mcp
pip install -r requirements.txt

Токен: VIBE_API_TOKEN в окружении или файл C:/Users/Ilay/vibe_token.txt (в репозиторий не коммитится, см. .gitignore). Пример — .env.example.

Отладка без реальных денег

python orchestrator/run_agent.py --url https://vibemarketolog.ru --dry-run \
    --max-iterations 3 --out runs/test/report.md

--dry-run вообще не бьёт в платное API — гоняет весь цикл (гейт, генерация, preflight, переформулировка, отчёт) на fixtures/raw_response_sample.json (реальный платный ответ с первого тестового). Это позволяет отладить всю логику на 0₽ перед тем, как тратить реальный баланс.

Реальный автономный прогон

python orchestrator/run_agent.py --url <лендинг> --max-iterations 3 --audit \
    --out runs/<дата>/report.md

Регистрация MCP-сервера в Claude Code

claude mcp add vibe -- python <абсолютный путь>/mcp_server/server.py

MCP-инструменты (8)

Инструмент	Стоимость	Что делает
account_status	бесплатно	баланс, дневной лимит и остаток
price_table	бесплатно	фиксированные цены direct/* из /capabilities
list_brands	бесплатно	список брендов/товаров аккаунта
get_brand	бесплатно	профиль одного бренда
preflight_check	бесплатно, локально	вердикты ГОДНО/ИСПРАВИМО/БРАК/ГАЛЛЮЦИНАЦИЯ по пакету объявлений
generate_ads	49₽	direct/ads-generate — пакет объявлений
audit_landing	39₽	direct/landing-audit — аудит лендинга
generate_sitelinks	29₽	direct/sitelinks — быстрые ссылки и уточнения (бонус, не в брифе)

Результат живого прогона — 31.07.2026

Полные материалы: runs/2026-07-31_live/ — report.md, console_log.txt (полный stdout прогона).

Лендинг: vibemarketolog.ru. Бюджет: 3 генерации + 1 аудит (186₽ из 453₽ на балансе). Баланс до прогона — 453₽, после — 267₽ (проверено через /balance независимо от лога прогона): списано ровно 186₽ = 3×49 + 39.

Итерация	utp	стоимость	ГОДНО	ИСПРАВИМО	БРАК	ГАЛЛЮЦИНАЦИЯ
1	(пусто)	49₽	45	12	90	0
2	«каждый заголовок ≤56 знаков…»	49₽	32	4	111	0
3	«каждый заголовок ≤56 знаков…»	49₽	15	0	153	0

Остановка: исчерпаны 3 итерации, брак остаётся (программа честно не рапортует успех, которого не было).

Честная находка: переформулировка utp с текстовой инструкцией про длину заголовка не снизила брак, а увеличила его — 90→111→153. Разбор причины и вывод — в docs/boundaries.md, раздел 1. Это не баг цикла: гейт и критерий остановки отработали корректно (не зациклились, не приукрасили результат), проблема в самой стратегии «попроси генератор словами исправить формат» для этого типа дефекта.

Бонус: direct/sitelinks (29₽) — вне брифа, для полноты MCP-инструментов

Живой вызов на том же лендинге вернул 8 корректных sitelinks (title≤30, description≤60) — сырой ответ: runs/2026-07-31_live/raw/sitelinks.json.

Честно про этот вызов: он оплачен дважды (58₽ вместо 29₽) — я тестировал скрипт демо-вызова, он упал на отсутствующей папке runs/…/raw/ уже ПОСЛЕ успешного платного POST, я пересоздал папку и перезапустил, оплатив ещё раз. Баланс упал 267₽ → 209₽ вместо ожидаемых 267₽ → 238₽. Вывод для реального использования: любой скрипт с платным вызовом обязан гарантировать существование выходной директории (или писать во временный файл) до запроса, а не полагаться на то, что запись после него не упадёт. Мелочь, но именно так на реальных деньгах теряются 29₽ по невнимательности — а не из-за API.

Границы решения

Полный честный список — docs/boundaries.md: что проверено вживую, что нет, где решение сломается и почему.

---

Илья Шаповалов · ilya-proof.vercel.app · github.com/yagaMI-Reverse