v1.3.0

What's Changed

• README: Markdown-механика — шаги быстрого старта абзацами, пункты «Смотрите также» в одну строку by @gistrec in #1
• Анонимная телеметрия использования: usage.gistrec.cloud by @gistrec in #2

New Contributors

• @gistrec made their first contribution in #1

Full Changelog: v1.2.0...v1.3.0

v1.2.0

Аудит-фиксы: корректность статистики (подсчёт data-строк, валидация границ дат), ретрай-идемпотентность (5xx/сеть только для read-методов), SSRF defense-in-depth, таймаут на тело ответа, VideoAdjustment в get_bid_modifiers, конвертация Funds, кэш GeoRegions, request_id в ошибках. Полный список — CHANGELOG.md.

v1.1.5

Добавлено

• Тул get_balance — баланс единого счёта (Amount, AmountAvailableForTransfer, Currency, AccountID) через legacy Live v4 AccountManagement: единственный метод API, отдающий баланс (в v5 финансового сервиса нет). Деньги в валюте счёта, не в микроединицах; отрицательная сумма = задолженность. Клиент получил callV4 (Live v4: другой base URL, токен в теле).

Исправлено

• list_campaigns: в CAMPAIGN_TYPES добавлен UNIFIED_CAMPAIGN (Единая перформанс-кампания) — без него фильтр по типам молча пропускал перформанс-кампании.

v1.1.4 — explicit destructiveHint

Read-only tools now set all four annotation hints explicitly (readOnlyHint, destructiveHint=false, idempotentHint=true, openWorldHint). Some clients (OpenAI Apps review) require destructiveHint on every tool.

v1.1.3 — inline date schema (no $ref)

Fix: isoDate is now a factory so zod-to-json-schema no longer dedupes date fields into a $ref (e.g. dateTo → #/properties/dateFrom). The OpenAI Apps schema analyzer doesn't dereference $ref and flagged such fields as any (unclear arguments). Each date field now inlines its own type+pattern. Affects get_statistics (dateFrom/dateTo) and campaign tools (startDate/endDate).

v1.1.2

Full Changelog: v1.1.1...v1.1.2

v1.1.1

Изменено

• Репозиторий переехал в организацию askads (github.com/askads/mcp-yandex-direct).

npm: npm i mcp-yandex-direct@1.1.1

v1.1.0

Добавлено

• MCP-аннотации (readOnlyHint / destructiveHint / idempotentHint / openWorldHint) на всех тулах — клиент MCP может авто-подтверждать чтение и предупреждать перед записью.
• Тул delete_ad_groups — удаление групп объявлений по id (adgroups/delete).

Исправлено

• Сервер сообщает MCP-клиентам реальную версию из package.json (была захардкожена 1.0.0).

Изменено

• Публикуемый пакет уменьшен: чистка dist/ перед сборкой, без source maps и .d.ts, dev-скрипты (smoke/integration) исключены из сборки.

npm: npm i mcp-yandex-direct@1.1.0

v1.0.5

Highlights

• upload_ad_image — upload an image to the ad library by public URL or base64; returns the AdImageHash for use on a text & image ad (closes the image-ad gap that previously required raw_request).
• MCP registry manifest — server.json + mcpName in package.json for listing in the official MCP registry; docs/PUBLISHING.md covers the publish + LobeHub submission flow.
• Docs — accurate write-safety wording in the README; new dev-facing CLAUDE.md.

Install: npx -y mcp-yandex-direct

v1.0.0 — первый стабильный релиз

MCP-сервер для Yandex Direct API v5 — управление контекстной рекламой из Claude и других MCP-клиентов на естественном языке.

Установка

claude mcp add yandex-direct -e YANDEX_DIRECT_TOKEN=ваш_токен -- npx -y mcp-yandex-direct

Возможности

• Кампании, группы, объявления, ключи — чтение, создание, обновление, lifecycle.
• Ставки и корректировки — ручные ставки на фразы; корректировки (моб./десктоп/демография/ретаргетинг/гео/SMART TV).
• Минус-слова на уровне кампании и группы.
• Расширения — быстрые ссылки, уточнения, визитки; чтение библиотек изображений/видео/креативов.
• Статистика — TSV-отчёты по 6 типам.
• Справочники — регионы, валюты, часовые пояса и т.д.
• raw_request — универсальный вызов любого метода API (полное покрытие v5).

Надёжность

Ретраи на лимиты/5xx с бэкоффом, таймауты, авто-пагинация по LimitedBy, разбор пообъектных ошибок, нормализация денег (рубли ↔ микроединицы), квота Units. 76 юнит-тестов, CI на Node 18/20/22.

Полный список инструментов — docs/TOOLS.md.