{"_id":"yandex-direct-mcp","_rev":"3-2433df6684086cba70ea50eb5642cb40","name":"yandex-direct-mcp","dist-tags":{"latest":"1.1.1"},"versions":{"1.0.0":{"name":"yandex-direct-mcp","version":"1.0.0","keywords":["mcp","model-context-protocol","yandex","direct","ppc","advertising","campaigns","ads","russian","claude","ai"],"author":{"name":"Alternex"},"license":"MIT","_id":"yandex-direct-mcp@1.0.0","maintainers":[{"name":"altrr2","email":"albertpopkov@hotmail.com"}],"homepage":"https://github.com/altrr2/yandex-tools-mcp/tree/main/packages/yandex-direct-mcp#readme","bugs":{"url":"https://github.com/altrr2/yandex-tools-mcp/issues"},"bin":{"yandex-direct-mcp":"src/index.mjs"},"dist":{"shasum":"947c35272fad9a5781089494d9e90502a1999f88","tarball":"https://registry.npmjs.org/yandex-direct-mcp/-/yandex-direct-mcp-1.0.0.tgz","fileCount":13,"integrity":"sha512-u0nVn4sfZbr3B6igEVGLv636LnwiphyqlMQX6FQmE7fb3dt8Co10jr1mEXAJyToy5EDpZk4+N/at3blDBrG6rg==","signatures":[{"sig":"MEYCIQDFOsVWGps77OEBUCtNUkrLwe4OHXTdQGJfwxbpHH5MIwIhAPe6aHRngfmkoMWGk7nqCGy2G8lM81xKW9X2pkDHQJi+","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":48834},"main":"src/index.mjs","type":"module","engines":{"node":">=18.0.0"},"gitHead":"2f8dd6d38bad5acc9f4ef8c8a2bf6cae9d3eaa54","scripts":{"start":"node src/index.mjs"},"_npmUser":{"name":"altrr2","email":"albertpopkov@hotmail.com"},"repository":{"url":"git+https://github.com/altrr2/yandex-tools-mcp.git","type":"git","directory":"packages/yandex-direct-mcp"},"_npmVersion":"11.18.0","description":"MCP server for Yandex Direct API - PPC campaign management, ads, keywords, bids, and statistics","directories":{},"_nodeVersion":"24.15.0","dependencies":{"zod":"^4.4.3","@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/yandex-direct-mcp_1.0.0_1783520294460_0.27012328458372914","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"yandex-direct-mcp","version":"1.1.0","keywords":["mcp","model-context-protocol","yandex","direct","ppc","advertising","campaigns","ads","russian","claude","ai"],"author":{"url":"https://seyka.ru","name":"Seyka AI"},"license":"MIT","_id":"yandex-direct-mcp@1.1.0","maintainers":[{"name":"altrr2","email":"albertpopkov@hotmail.com"}],"homepage":"https://github.com/seyka-ai/yandex-tools-mcp/tree/main/packages/yandex-direct-mcp#readme","bugs":{"url":"https://github.com/seyka-ai/yandex-tools-mcp/issues"},"bin":{"yandex-direct-mcp":"src/index.mjs"},"dist":{"shasum":"dc4a6ec354bdadd769186d813fe190a157f036a1","tarball":"https://registry.npmjs.org/yandex-direct-mcp/-/yandex-direct-mcp-1.1.0.tgz","fileCount":16,"integrity":"sha512-kGaudaj/4ZNucb7z4yqT95WJPgyVqegOSNjUrFxcHv91RiGOOUnBlxfI+ZnHXQutfjrH/UwY2j0C7nJjBh/OQA==","signatures":[{"sig":"MEUCIQCTQiqBNEpsTH3oeCteOcvR+xLblpe6x5OmQ5W74HoHBAIgaXM8bImAypTh1ItgfmypGBhKLiBkSQa5uF2renntOv0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQC7Cx9pJ5PkHNLMKi/Xkw02lWFRxq68AFY96Znr+35NFAIgC6xxxx7PXX7QgJwNELa5PtnpiyR2db9iAsgO84ZJQpw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":59067},"main":"src/index.mjs","type":"module","engines":{"node":">=18.0.0"},"gitHead":"264f6357e290a7d65bc02d5cba1a1c3234350aaa","scripts":{"test":"bun test","start":"node src/index.mjs"},"_npmUser":{"name":"altrr2","email":"albertpopkov@hotmail.com"},"repository":{"url":"git+https://github.com/seyka-ai/yandex-tools-mcp.git","type":"git","directory":"packages/yandex-direct-mcp"},"_npmVersion":"12.2.1","description":"MCP server for Yandex Direct API - PPC campaign management, ads, keywords, bids, and statistics","directories":{},"_nodeVersion":"24.21.0","dependencies":{"zod":"^4.6.7","@modelcontextprotocol/sdk":"^1.32.2"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/yandex-direct-mcp_1.1.0_1793189702399_0.02909195601001524","host":"s3://npm-registry-packages-npm-production"}},"1.1.1":{"_id":"yandex-direct-mcp@1.1.1","bin":{"yandex-direct-mcp":"src/index.mjs"},"bugs":{"url":"https://github.com/seyka-ai/yandex-tools-mcp/issues"},"dist":{"shasum":"6eb97de0e1c438ad2c09514272966f5b8f4a9591","tarball":"https://registry.npmjs.org/yandex-direct-mcp/-/yandex-direct-mcp-1.1.1.tgz","fileCount":16,"integrity":"sha512-dZZmTNlGIJtcWeurzwddpqal2g3XC3I+JHl2Oh5EiTWFa+yFSiL8jFnZMzjyciRrCG6WTlag/0zTzYIDg3qP7w==","signatures":[{"sig":"MEQCIBoOvO7YRZdiXm/MbwxiS1REL0FJ2PAoDjyCM9OiPo1mAiBSRXTRhqTsZGx7ANMRFhpPMNcP2zRgFqSKcBnNMsYyrw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIGfJmlxTLz+95zHYnM8Avj5LdddgN8F/uDtwMO4nP09tAiEAmV4lerX6jvpN7XlLU4YB1vcz2KsAezFu5SvKwxi7oa8="}],"unpackedSize":59257},"main":"src/index.mjs","name":"yandex-direct-mcp","type":"module","author":{"url":"https://seyka.ru","name":"Seyka AI"},"engines":{"node":">=18.0.0"},"gitHead":"f3230f6b0142611ea4e92471fc9fe14f0db31c71","license":"MIT","scripts":{"test":"bun test","start":"node src/index.mjs"},"version":"1.1.1","_npmUser":{"name":"altrr2","email":"albertpopkov@hotmail.com"},"homepage":"https://github.com/seyka-ai/yandex-tools-mcp/tree/main/packages/yandex-direct-mcp#readme","keywords":["mcp","model-context-protocol","yandex","direct","ppc","advertising","campaigns","ads","russian","claude","ai"],"repository":{"url":"git+https://github.com/seyka-ai/yandex-tools-mcp.git","type":"git","directory":"packages/yandex-direct-mcp"},"_npmVersion":"12.2.1","description":"MCP server for Yandex Direct API - PPC campaign management, ads, keywords, bids, and statistics","directories":{},"maintainers":[{"name":"altrr2","email":"albertpopkov@hotmail.com"}],"_nodeVersion":"24.21.0","dependencies":{"zod":"^4.6.7","@modelcontextprotocol/sdk":"^1.32.2"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/yandex-direct-mcp_1.1.1_1793199942286_0.5112341297091316"}}},"time":{"created":"2026-07-08T14:18:14.404Z","modified":"2026-10-28T15:05:42.814Z","1.0.0":"2026-07-08T14:18:14.614Z","1.1.0":"2026-10-28T12:15:02.498Z","1.1.1":"2026-10-28T15:05:42.375Z"},"bugs":{"url":"https://github.com/seyka-ai/yandex-tools-mcp/issues"},"author":{"url":"https://seyka.ru","name":"Seyka AI"},"license":"MIT","homepage":"https://github.com/seyka-ai/yandex-tools-mcp/tree/main/packages/yandex-direct-mcp#readme","keywords":["mcp","model-context-protocol","yandex","direct","ppc","advertising","campaigns","ads","russian","claude","ai"],"repository":{"url":"git+https://github.com/seyka-ai/yandex-tools-mcp.git","type":"git","directory":"packages/yandex-direct-mcp"},"description":"MCP server for Yandex Direct API - PPC campaign management, ads, keywords, bids, and statistics","maintainers":[{"name":"altrr2","email":"albertpopkov@hotmail.com"}],"readme":"# yandex-direct-mcp\n\nMCP server for [Yandex Direct API](https://yandex.com/dev/direct/) — PPC campaign management: campaigns, ad groups, ads, keywords, bids, and statistics.\n\n[![npm version](https://badge.fury.io/js/yandex-direct-mcp.svg)](https://www.npmjs.com/package/yandex-direct-mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n[English](#english) | [Русский](#русский)\n\n---\n\n## English\n\n> ⚠️ **This server can spend real money.** It defaults to the Yandex Direct **sandbox** environment so setup and testing never touch a live account. Set `YANDEX_DIRECT_LIVE=1` to operate on the real (production) account. Write tools (create/update/manage/set-bids) are clearly flagged in their descriptions.\n\n### Features\n\n- **Campaigns** — list, inspect, create, update, and manage lifecycle (suspend/resume/archive/delete)\n- **Ad groups** — list, create, delete, with region targeting\n- **Ads** — list and create text ads (optionally with an image), manage moderation/lifecycle\n- **Images** — upload ad images (from a URL or base64) and list the account image library\n- **Keywords & bids** — list with current bids, add keywords, set search/network bids (in account currency), set negative keywords\n- **Statistics** — one flexible `get-report` covering any report type, fields, and date range\n- **Account** — balance and geo-region reference\n\n### Setup\n\n#### Step 1: Get OAuth Token\n\n1. Create an app at [oauth.yandex.ru/client/new](https://oauth.yandex.ru/client/new)\n2. Enable **Yandex Direct** API access (scope: `direct:api`)\n3. Set callback URL to `https://oauth.yandex.ru/verification_code`\n4. Run the auth helper:\n\n```bash\nexport YANDEX_CLIENT_ID=your_client_id\nexport YANDEX_CLIENT_SECRET=your_client_secret\nnpx yandex-direct-mcp auth\n```\n\nThe same token works for both the sandbox and production environments.\n\n#### Step 2: Configure Claude\n\n**Claude Desktop** — edit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"yandex-direct\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"yandex-direct-mcp\"],\n      \"env\": {\n        \"YANDEX_DIRECT_TOKEN\": \"your_oauth_token\"\n      }\n    }\n  }\n}\n```\n\n**Claude Code:**\n\n```bash\nclaude mcp add yandex-direct \\\n  -e YANDEX_DIRECT_TOKEN=your_oauth_token \\\n  -- npx -y yandex-direct-mcp\n```\n\nTo operate on a real account, add `-e YANDEX_DIRECT_LIVE=1`. For agency/managed accounts, add `-e YANDEX_DIRECT_LOGIN=client_login`.\n\n### Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `YANDEX_DIRECT_TOKEN` | yes | OAuth token with Yandex Direct API access |\n| `YANDEX_DIRECT_LIVE` | no | Set to `1` to use the production account (real money). Defaults to sandbox. |\n| `YANDEX_DIRECT_LOGIN` | no | Client login for agency/managed accounts (`Client-Login` header) |\n\n### Tools\n\n| Tool | Type | Description |\n|------|------|-------------|\n| `list-campaigns` | read | List campaigns with type, state, status, daily budget |\n| `get-campaign` | read | Campaign details by ID |\n| `create-campaign` | write | Create a text campaign |\n| `update-campaign` | write | Update campaign name / daily budget |\n| `manage-campaign` | write | Suspend/resume/archive/unarchive/delete a campaign |\n| `list-adgroups` | read | List ad groups (optionally by campaign) |\n| `create-adgroup` | write | Create an ad group with region targeting |\n| `delete-adgroup` | write | Delete an ad group |\n| `list-ads` | read | List ads with text and moderation status |\n| `create-text-ad` | write | Create a text ad in an ad group, optionally with an image |\n| `manage-ad` | write | Moderate/suspend/resume/archive/unarchive/delete an ad |\n| `upload-ad-image` | write | Upload an image (URL or base64) and get its `AdImageHash` |\n| `list-ad-images` | read | List images in the account image library |\n| `list-keywords` | read | List keywords with current search/network bids |\n| `add-keywords` | write | Add keywords to an ad group |\n| `set-bids` | write | Set search/network bids on keywords (in account currency) |\n| `set-negative-keywords` | write | Set negative keywords on a campaign or ad group |\n| `get-report` | read | Flexible statistics: any report type, fields, and date range |\n| `get-balance` | read | Account balance and currency |\n| `get-regions` | read | Geo-region IDs for targeting |\n\nBids and budgets are given in account currency (e.g. rubles) and converted to Yandex's micro-units automatically.\n\nSome ad and keyword IDs are larger than JavaScript numbers can hold exactly (above 2^53). The server keeps them exact and returns them as strings; pass them back as strings, exactly as listed.\n\n### Usage Examples\n\nOnce configured, ask Claude:\n\n- \"List my Direct campaigns and their budgets\"\n- \"Create a sandbox campaign named 'Summer Sale' with a 500 daily budget\"\n- \"Add these keywords to ad group 12345 and set bids to 15\"\n- \"Show me clicks, cost, and CTR by campaign for last month\"\n- \"What's my account balance?\"\n\nOnline usage example: <a href=\"https://seyka.ru\" target=\"_blank\">seyka.ru</a>\n\n---\n\n## Русский\n\n> ⚠️ **Этот сервер может тратить реальные деньги.** По умолчанию он работает в **песочнице** Yandex Direct, поэтому настройка и тесты не затрагивают боевой аккаунт. Установите `YANDEX_DIRECT_LIVE=1`, чтобы работать с реальным (боевым) аккаунтом. Инструменты записи (create/update/manage/set-bids) явно помечены в описаниях.\n\n### Возможности\n\n- **Кампании** — список, детали, создание, обновление, управление статусом (пауза/возобновление/архив/удаление)\n- **Группы объявлений** — список, создание, удаление, с таргетингом по регионам\n- **Объявления** — список и создание текстовых объявлений (в том числе с изображением), управление модерацией/статусом\n- **Изображения** — загрузка изображений для объявлений (по URL или в base64) и список библиотеки изображений\n- **Ключевые фразы и ставки** — список с текущими ставками, добавление фраз, установка ставок на поиске/в сетях (в валюте аккаунта), минус-фразы\n- **Статистика** — один гибкий `get-report` с любым типом отчёта, полями и диапазоном дат\n- **Аккаунт** — баланс и справочник регионов\n\n### Настройка\n\n#### Шаг 1: Получите OAuth токен\n\n1. Создайте приложение на [oauth.yandex.ru/client/new](https://oauth.yandex.ru/client/new)\n2. Включите доступ к **API Яндекс Директа** (scope: `direct:api`)\n3. Укажите callback URL: `https://oauth.yandex.ru/verification_code`\n4. Запустите помощник авторизации:\n\n```bash\nexport YANDEX_CLIENT_ID=ваш_client_id\nexport YANDEX_CLIENT_SECRET=ваш_client_secret\nnpx yandex-direct-mcp auth\n```\n\nОдин и тот же токен работает и в песочнице, и в боевом окружении.\n\n#### Шаг 2: Настройте Claude\n\n**Claude Desktop** — отредактируйте `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) или `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"yandex-direct\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"yandex-direct-mcp\"],\n      \"env\": {\n        \"YANDEX_DIRECT_TOKEN\": \"ваш_oauth_токен\"\n      }\n    }\n  }\n}\n```\n\n**Claude Code:**\n\n```bash\nclaude mcp add yandex-direct \\\n  -e YANDEX_DIRECT_TOKEN=ваш_oauth_токен \\\n  -- npx -y yandex-direct-mcp\n```\n\nДля работы с боевым аккаунтом добавьте `-e YANDEX_DIRECT_LIVE=1`. Для агентских/управляемых аккаунтов добавьте `-e YANDEX_DIRECT_LOGIN=логин_клиента`.\n\n### Переменные окружения\n\n| Переменная | Обязательна | Описание |\n|------------|-------------|----------|\n| `YANDEX_DIRECT_TOKEN` | да | OAuth токен с доступом к API Яндекс Директа |\n| `YANDEX_DIRECT_LIVE` | нет | Установите `1` для боевого аккаунта (реальные деньги). По умолчанию — песочница. |\n| `YANDEX_DIRECT_LOGIN` | нет | Логин клиента для агентских аккаунтов (заголовок `Client-Login`) |\n\n### Инструменты\n\n| Инструмент | Тип | Описание |\n|------------|-----|----------|\n| `list-campaigns` | чтение | Список кампаний с типом, статусом, дневным бюджетом |\n| `get-campaign` | чтение | Детали кампании по ID |\n| `create-campaign` | запись | Создать текстовую кампанию |\n| `update-campaign` | запись | Обновить название / дневной бюджет |\n| `manage-campaign` | запись | Пауза/возобновление/архив/удаление кампании |\n| `list-adgroups` | чтение | Список групп объявлений (можно по кампании) |\n| `create-adgroup` | запись | Создать группу объявлений с таргетингом по регионам |\n| `delete-adgroup` | запись | Удалить группу объявлений |\n| `list-ads` | чтение | Список объявлений с текстом и статусом модерации |\n| `create-text-ad` | запись | Создать текстовое объявление в группе, при необходимости с изображением |\n| `manage-ad` | запись | Модерация/пауза/возобновление/архив/удаление объявления |\n| `upload-ad-image` | запись | Загрузить изображение (URL или base64) и получить его `AdImageHash` |\n| `list-ad-images` | чтение | Список изображений в библиотеке аккаунта |\n| `list-keywords` | чтение | Список ключевых фраз с текущими ставками |\n| `add-keywords` | запись | Добавить ключевые фразы в группу |\n| `set-bids` | запись | Установить ставки на поиске/в сетях (в валюте аккаунта) |\n| `set-negative-keywords` | запись | Установить минус-фразы на кампанию или группу |\n| `get-report` | чтение | Гибкая статистика: любой тип отчёта, поля и диапазон дат |\n| `get-balance` | чтение | Баланс и валюта аккаунта |\n| `get-regions` | чтение | ID регионов для таргетинга |\n\nСтавки и бюджеты указываются в валюте аккаунта (например, в рублях) и автоматически конвертируются в микро-единицы Яндекса.\n\nНекоторые ID объявлений и ключевых фраз больше, чем JavaScript может точно хранить в числе (больше 2^53). Сервер сохраняет их точно и возвращает строками; передавайте их обратно строками, ровно как в списке.\n\n### Примеры использования\n\nПосле настройки спросите Claude:\n\n- \"Покажи мои кампании в Директе и их бюджеты\"\n- \"Создай в песочнице кампанию 'Летняя распродажа' с дневным бюджетом 500\"\n- \"Добавь эти ключевые фразы в группу 12345 и установи ставки 15\"\n- \"Покажи клики, расход и CTR по кампаниям за прошлый месяц\"\n- \"Какой у меня баланс?\"\n\nОнлайн пример использования: <a href=\"https://seyka.ru\" target=\"_blank\">seyka.ru</a>\n\n---\n\n## License\n\nMIT\n","readmeFilename":"README.md"}