Skip to main content
Glama
deenesjakoruzh
theYahia

yandex-direct-mcp

by theYahia
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

🗄 仓库已归档

开发已迁移至 theYahia/YaAll —— 一个将所有 Yandex 层集中存放的构建：Yandex 官方 MCP 服务器、 面向 Direct 和 Metrika 的 MCP、YaGEO 技能和 Wordstat 网关。

此处内容的当前版本：mcp/yandex-direct-mcp/

此处不再更新任何内容。问题和 pull request 请提交到 YaAll。

Archived — development moved to theYahia/YaAll, a single repository bundling the whole Yandex stack. The current version of this package now lives at mcp/yandex-direct-mcp/. Please open issues and pull requests there.

@theyahia/yandex-direct-mcp

用于 Yandex.Direct API 的 MCP 服务器 —— 可从任何 MCP 客户端（Claude、Cursor 等）管理上下文广告：广告系列、广告组、广告、关键词、出价、否定关键词、统计、余额。20 个工具。

npm License: MIT

金额 —— 以卢布为单位（预算、输入和输出的出价）；服务器会自动转换为 API 的微单位。支持沙箱用于安全测试，以及代理模式（Client-Login）。

Related MCP server: yandex-direct-mcp

安装

Claude Desktop

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

Claude Code

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

配置（环境变量）

变量

必填

用途

YANDEX_DIRECT_TOKEN

是

Yandex.Direct OAuth 令牌

YANDEX_DIRECT_SANDBOX

否

1 — 在沙箱中工作（隔离数据，无实际花费）。使用相同令牌，仅 URL 不同

YANDEX_DIRECT_LOGIN

否

代理令牌的客户端登录名（Client-Login 标头）。如果令牌是代理令牌，则为必填

如何获取令牌

OAuth 令牌是为在 Yandex OAuth 中注册的、具有 Direct API 访问权限的应用程序签发的。详情请参阅注册应用程序并获取令牌。API 访问权限需要在 Direct 界面中申请。

⚠️ 注意：真实花费

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_ads

suspend/resume/archive/unarchive/moderate/delete

关键词和出价

工具

描述

list_keywords

广告组中的关键词短语（出价以卢布为单位）

add_keywords

添加关键词短语

set_keyword_bids

在短语/广告组/广告系列上设置出价（搜索/网络，卢布）

manage_keywords

suspend/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 за последнюю неделю?
Найди код региона для Новосибирска
Покажи баланс аккаунта

开发

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

许可证

MIT

Install Server
A
license - permissive license
A
quality
F
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
0dRelease cycle
2Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Related MCP Servers

  • yandex-marketing-mcp

    skiddgoddamn
    A
    license
    B
    quality
    B
    maintenance
    MCP server for managing Yandex Direct advertising, Yandex Metrica analytics, Wordstat keyword research, and Yandex Webmaster SEO tools, with self-configuring OAuth; provides 153 tools for complete ad and search workflows from AI assistants.
    100
    15
    MIT

  • yandex-direct-mcp

    nikolaymokh-dev
    A
    license
    B
    quality
    B
    maintenance
    A hardened MCP server for managing Yandex.Direct advertising campaigns with read-only defaults, write and finance capabilities optional, using OAuth authentication.
    26
    MIT

  • yandex-mcp

    SvechaPVL
    A
    license
    Not graded
    quality
    D
    maintenance
    MCP server for Yandex Direct, Metrika, Wordstat, and Webmaster APIs, providing 132 tools to manage advertising campaigns, analytics, keyword research, and reporting through any MCP-compatible client.
    58
    MIT

View all related MCP servers

Related MCP Connectors

  • marketscore-direct-mcp

    MCP for Yandex Direct: manage ad campaigns & analytics from Claude or ChatGPT

  • HasData

    All HasData scraping tools in one MCP server: Google, TikTok, Instagram, maps, e-commerce and more.

  • Yandex Metrika MCP

    Read-only Yandex Metrika MCP. Query visits, sources, geo, devices and more in plain language.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/theYahia/yandex-direct-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server