yandex-direct-mcp

io.github.theYahia由 GitHub 帳號 theYahia 發布v3.0.2更新於 Oct 24, 2026

MCP server for Yandex Direct — PPC campaigns, ads, keywords, statistics (Russia)

已驗證STDIO僅桌面資料與分析商業與電商

概覽

AI 產生的概覽

針對 Yandex Direct 的本機 MCP 伺服器，讓助理管理俄羅斯市場的搜尋廣告活動、廣告群組、廣告、關鍵字、出價與統計。

可以做什麼
列出、檢視、建立與更新廣告活動，包含預算與暫停、恢復、封存等狀態變更。列出、建立與刪除廣告群組，並設定群組的排除關鍵字。列出、建立與更新文字廣告，並可暫停、恢復、封存、送審或刪除。列出與新增關鍵字，以盧布設定出價，管理關鍵字狀態並設定廣告活動的排除關鍵字。取得指定期間的統計（曝光、點擊、花費、CTR、CPC）、帳戶餘額與地區代碼。
適用情境
適合在俄羅斯投放 Yandex Direct 廣告時使用，讓助理草擬或調整廣告活動、廣告、關鍵字與出價，或在不開啟網頁後台的情況下取得成效統計與餘額。
執行需求
透過 npx 在本機執行（需要 Node.js）。需在 YANDEX_DIRECT_TOKEN 提供 Yandex Direct 的 OAuth 權杖；權杖所屬應用程式須在 Yandex OAuth 註冊，並在 Direct 中申請 API 存取權。可選 YANDEX_DIRECT_SANDBOX=1 使用沙盒，代理權杖需 YANDEX_DIRECT_LOGIN。需要連線至 Yandex Direct 的網路。
安裝前請注意
create_campaign、create_text_ad、add_keywords、set_keyword_bids 等工具會變更正式廣告帳戶，可能產生真實花費；預算與出價以盧布輸入。建議先以 YANDEX_DIRECT_SANDBOX=1 測試。YANDEX_DIRECT_TOKEN 中的 OAuth 權杖可存取帳戶，須妥善保密。部分工具會刪除或封存廣告、廣告群組與關鍵字。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 yandex-direct-mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

@theyahia/yandex-direct-mcp

MCP-сервер для API Яндекс.Директ — управление контекстной рекламой из любого MCP-клиента (Claude, Cursor и др.): кампании, группы, объявления, ключевые слова, ставки, минус-фразы, статистика, баланс. 20 инструментов.

[npm] [License: MIT]

Деньги — в рублях (бюджеты, ставки на вводе и выводе); сервер сам конвертирует в микроединицы API. Поддержаны песочница для безопасного теста и агентский режим (Client-Login).

Установка

Claude Desktop

json
{  "mcpServers": {    "yandex-direct": {      "command": "npx",      "args": ["-y", "@theyahia/yandex-direct-mcp"],      "env": {        "YANDEX_DIRECT_TOKEN": "ваш_токен"      }    }  }}

Claude Code

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

Конфигурация (переменные окружения)

ПеременнаяОбязательнаНазначение
YANDEX_DIRECT_TOKENдаOAuth-токен Яндекс.Директ
YANDEX_DIRECT_SANDBOXнет1 — работа в песочнице (изолированные данные, без трат). Тот же токен, отличается только URL
YANDEX_DIRECT_LOGINнетЛогин клиента для агентских токенов (заголовок Client-Login). Обязателен, если токен агентский

Как получить токен

OAuth-токен выпускается для приложения, зарегистрированного в Яндекс OAuth, с доступом к API Директа. Подробности — регистрация приложения и получение токена. Доступ к API нужно запросить в интерфейсе Директа.

⚠️ Внимание: реальные траты

Инструменты create_campaign, create_text_ad, add_keywords, set_keyword_bids и др. меняют боевой рекламный аккаунт и могут расходовать деньги. Для отладки сценариев включайте песочницу (YANDEX_DIRECT_SANDBOX=1).

Инструменты (20)

Кампании

ИнструментОписание
list_campaignsСписок кампаний (фильтр по статусу/типу, пагинация)
get_campaignДетальная информация о кампании по ID
create_campaignСоздать кампанию (бюджет в рублях, выбор стратегии)
update_campaignОбновить название/бюджет и/или статус (SUSPEND/RESUME/ARCHIVE/UNARCHIVE)

Группы объявлений

ИнструментОписание
list_ad_groupsГруппы объявлений выбранных кампаний
create_ad_groupСоздать группу с таргетингом по регионам
delete_ad_groupsУдалить группы по ID
set_ad_group_negative_keywordsЗадать минус-фразы группы

Объявления

ИнструментОписание
list_adsОбъявления в группах
create_text_adСоздать текстовое объявление (≤56/≤30/≤81)
update_text_adОбновить заголовок/текст/ссылку
manage_adssuspend/resume/archive/unarchive/moderate/delete

Ключевые слова и ставки

ИнструментОписание
list_keywordsКлючевые фразы в группах (ставки в рублях)
add_keywordsДобавить ключевые фразы
set_keyword_bidsУстановить ставки (поиск/сети, рубли) на фразах/группах/кампаниях
manage_keywordssuspend/resume/delete
set_campaign_negative_keywordsЗадать минус-фразы кампании

Статистика, аккаунт, справочники

ИнструментОписание
get_statisticsСтатистика за период (показы, клики, расход, CTR, CPC)
get_account_balanceБаланс аккаунта (Live API v4)
get_regionsСправочник кодов регионов (225 = Россия)

Примеры запросов

Покажи все активные рекламные кампанииСоздай кампанию "Летняя распродажа" с бюджетом 5000 ₽/день, старт 2026-05-01Установи ставку 25 ₽ на ключевые фразы 111 и 222Добавь минус-фразы "бесплатно", "скачать" в кампанию 12345Какая статистика у кампаний 12345 и 67890 за последнюю неделю?Найди код региона для НовосибирскаПокажи баланс аккаунта

Разработка

bash
npm installnpm run build      # tsc → dist/npm test           # vitest (моки fetch)npm run dev        # tsx src/index.ts

Лицензия

MIT

來源：README.md，提交 24690a3

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v3.0.2最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分