Direct Manager — Яндекс Директа MCP

将 Claude 或 ChatGPT 连接到 Яндекс Директ，通过对话管理广告：「钱都浪费在哪里了？」→ 助手会找出 ROAS < 1 的广告系列，并建议关闭哪些。

Connect Claude or ChatGPT to Yandex Direct and manage ad campaigns in chat — analytics, wasted-spend detection, bids, budgets, negative keywords.

免费试用 — 7 天「Профи」套餐 →

网站 / Website: https://app.marketscore.ru

这是什么

marketscore-direct-mcp 是一个连接到 Direct Manager 宿主 MCP 服务器的轻量级连接器。服务器本身、对 Direct API 的访问以及所有逻辑都在服务端运行——此软件包仅用于将您的 AI 助手连接到它。

该服务拥有 两个独立的 MCP 服务器：广告服务器（Директ、VK、Авито、Wordstat）和 SEO 服务器（Вебмастер、Search Console、Метрика、Topvisor）——请参阅下面的 SEO 部分。

工作方式如下：

您： 过去 14 天我的钱都浪费在哪里了？

Claude： 发现了 3 个问题，共 12 400 ₽：广告系列「Ремонт квартир — РСЯ」花费了 4 210 ₽，没有任何转化；网站 dsp.example 的 ROAS 为 0.2；6 个关键词有花费但零询价。要关闭该网站并将这些关键词添加到否定关键词中吗？

Related MCP server: yadirect-mcp

功能

多达 116 个工具，基于 Direct API v5 和 Reports API（「Ассистент」和「Профи」套餐为 111 个，「Агентство」套餐为 116 个，包括投资组合 accounts_overview）：

• 分析与统计 — 按时间段和维度统计广告系列指标：设备、性别、年龄、РСЯ 网站、地理；搜索查询；展示份额。

• 低效支出检测 — ROAS < 1 的广告系列、无转化的支出、多余的网站和关键词。

• 管理 — 暂停/恢复、日预算和周预算、策略（包括带有目标和目标 CPA/ROAS 的转化策略）、否定关键词、关键词、出价和调整。

• 从头搭建广告系列 — 广告系列 → 广告组 → 广告，包含快速链接和 UTM。

• AI 洞察 — 预测未来 30 天的花费和转化、诊断下降（流量/CR/CPC）、解释周期对比变化及驱动因素、按金额排序的排名靠前的发现、一次调用生成现成的每周简报。

• Wordstat — 带频率的关键词选择。

• 针对代理商 — 跨所有账户的投资组合概览：每个客户的花费、利润、多余支出和剩余预算，在一个回复中。

写操作会带有单独的注释——助手和客户端在应用修改之前可以看到具体变化。Direct API 错误会被正确处理，包括「静默」错误（API 返回 200，但修改未生效）。

MarketScore SEO — 第二个用于搜索引擎优化的 MCP

同一账户还有一个 单独的 SEO MCP 服务器：它不是关于广告的，而是关于自然搜索的——将 Яндекс Вебмастер、Google Search Console、Яндекс Метрика、Topvisor 和 Wordstat 整合到一个助手中。

https://app.marketscore.ru/api/mcp/seo

这是 不同的地址和不同的订阅：SEO 套餐不包含在 Директ 套餐中，反之亦然。Директ 的工具不会出现在 SEO 地址上，反之亦然。

您： 为什么过去 28 天来自搜索的流量下降了？

Claude： 点击次数从 940 下降到 610。我只能根据同时测量了两个周期的来源进行比较：Search Console — 是，Вебмастер — 是，Topvisor 未连接，排名未独立检查。主要下降来自 /catalog 部分：18 个页面因「重复」原因从 Яндекс 搜索中消失，Вебмастер 自 8 月 3 日起就看到了这一点。要显示地址列表吗？

21 个工具，其中只有三个会进行写操作（seo_add_keywords、seo_add_competitors、seo_request_recrawl）——其余为只读：

• 搜索数据 — seo_overview（点击次数、展示次数、点击率、平均排名、前三/前十和周期对比），seo_search_queries（按设备和区域划分的 Вебмастер 和 Search Console 查询和页面），seo_positions（来自 Topvisor 的最后一次检查），seo_indexation（Яндекс 搜索中有多少页面、哪些被排除以及原因），seo_metrika（来自搜索的访问者行为和目标达成情况），seo_landing_pages（按着陆页面划分的访问和询价）。

• 与网站协作 — seo_audit（索引、技术、页面内和竞争情况分析，每个结论都附有来源），seo_page_analysis（页面速度、Core Web Vitals 和页面内信号），seo_opportunities（接近排名前三的查询、点击率低的页面、有展示但无点击、同类相食），seo_sitemaps（Яндекс 和 Google 是否看到网站地图），seo_url_inspection（Google 对特定 URL 的判定），seo_request_recrawl（将 URL 发送至 Яндекс 重新抓取），seo_text_check（现成俄语文本中的 AI 模板、官腔和过度堆砌）。

• 需求 — seo_keyword_demand：从 Wordstat 获取频率、相似短语、噪音标记和季节性。

• 关键词与检查 — seo_keywords（正在检查排名的关键词），seo_add_keywords（将短语加入检查），seo_positions_plan（检查计划、启动成本和 Topvisor 余额）。

• 竞争对手 — seo_competitors（我们与竞争对手的位置对比），seo_add_competitors（将竞争对手网站添加到项目中）。

• 项目 — seo_projects（账户中的网站）和 seo_sources（已连接哪些、哪些已过期以及当来源停止工作时确切有哪些信息将不再可用）。

此处与同 API 的包装器不同之处：

• 响应带有出处。 每个数字都有来源和采集日期。对 Вебмастер 的访问被撤销会显示为来源拒绝，而不是零流量：「没有数据」和「没有问题」是不同的响应，模型不应混淆它们。

• 未完成的检查会被列出。 如果某个来源静默或未确认网站权限，审计会返回一个列表，说明「具体哪些内容未被检查以及原因」，并给出一个上限评估，而不是低估为「一切正常」。

• 写入边界按金额划定。 付费启动排名检查、更改计划、删除关键词和竞争对手的操作有意未集成到聊天中——这些会从 Topvisor 余额中扣款，成本应在扣款前在屏幕上可见。两个写入工具会使下一次排名检查的成本增加，助手必须在调用前说明这一后果。

• 我们不承诺的内容： 不会爬取整个网站——每次调用只检查一个页面；不检查文本独特性（我们没有来源）；若未连接 Topvisor，不会虚构排名。

SEO 套餐（单独订阅，7 天免费试用）：「Старт」— 590 ₽/月（1 个网站，2 次审计，20 个 Wordstat 查询），«Профи» — 1 490 ₽/月（5 个网站，10 次审计，200 个 Wordstat），«Агентство» — 9 900 ₽/月（20 个网站，60 次审计，2 000 个 Wordstat）。所有 21 个工具在任何有效的 SEO 套餐上均可使用。排名检查通过您自己的 Topvisor 账户余额运行——我们不加价。

更多详情：https://app.marketscore.ru/seo

安装

Claude（桌面版、网页版、Code）和 ChatGPT — 通过链接

添加远程 MCP 连接器：

https://app.marketscore.ru/api/mcp        реклама: Яндекс Директ, VK, Авито, Wordstat
https://app.marketscore.ru/api/mcp/seo    органика: Вебмастер, Search Console, Метрика, Topvisor

助手将打开登录页面——通过 OAuth 授权。Яндекс 令牌不会传递给助手。两个地址可以同时添加：它们是具有独立订阅的独立连接器。

本地 MCP 客户端（Cursor、VS Code、Cline、Zed）— 通过桥接

npx -y marketscore-direct-mcp

MCP 客户端配置示例：

{
  "mcpServers": {
    "direct-manager": {
      "command": "npx",
      "args": ["-y", "marketscore-direct-mcp"]
    }
  }
}

套餐与访问

连接器需要一个 Direct Manager 账户。注册时 — 免费试用 7 天「Профи」套餐（包括 Claude/ChatGPT 中的 AI 助手）。之后：

• 「Ассистент」— 990 ₽/月： 完整的 MCP 工具集（111 个工具），用于 AI 聊天工作，最多 3 个 Директ 账户。无 Web 仪表盘——仅限助手。

• 「Профи」— 1 990 ₽/月： 同样的 111 个工具 加上 带有分析和自动驾驶功能的 Web 仪表盘，最多 5 个 Директ 账户。

• 「Агентство」— 9 900 ₽/月： 116 个工具（加上投资组合概览 accounts_overview），最多 20 个账户。

• SEO — 独立的套餐轴线（590 / 1 490 / 9 900 ₽/月）和独立的连接器地址。Директ 套餐不提供对 SEO 工具的访问，反之亦然。

无有效套餐时，服务器返回 0 个工具。注册：https://app.marketscore.ru/register · 套餐：https://app.marketscore.ru/pricing · SEO：https://app.marketscore.ru/seo

与 Direct API 的开源包装器有何不同

存在一些自托管的 MCP 包装器（例如 mcp-yandex-direct）。诚实的比较：

安全性

• 授权 — OAuth 2.1：Яндекс 令牌不会传递给助手，也不存储在客户端配置中，而是存储在服务端。

• Direct Manager 账户密码更改会撤销所有已颁发的 MCP 访问权限。

• 写操作带有注释，并在 MCP 客户端侧确认。

• 个人数据存储在俄罗斯境内的服务器上（符合 152-FZ 法规）。

常见问题

这是免费的吗？ 前 7 天是免费的（注册时可试用「Профи」套餐）。之后需要「Ассистент」套餐（990 ₽/月，仅 MCP）或更高。

Директ 令牌到哪里去了？ 它在 OAuth 连接时被授予 Direct Manager 服务，并存储在其服务器上。助手和 MCP 客户端看不到该令牌。

助手会不会搞乱账户？ 写工具有单独的标记，MCP 客户端在调用它们之前会请求确认。自动驾驶不会自行触及广告系列暂停和预算——仅根据您的命令执行。

能与 ChatGPT、Cursor、VS Code 一起使用吗？ 可以：Claude 和 ChatGPT 通过 URL 直接连接，Cursor/VS Code/Cline/Zed 通过此软件包（npx -y marketscore-direct-mcp）连接。

与免费的 MCP 包装器有何不同？ 除了 API 访问之外，还提供 AI 洞察层、审计、仪表盘、Telegram 机器人和投资组合概览；Яндекс 令牌不存储在配置中。详见上表。

没有订阅能用吗？ 不能——没有有效套餐时，服务器返回 0 个工具。

你们能做 SEO 吗？ 可以，通过单独的 MCP 服务器：https://app.marketscore.ru/api/mcp/seo — 基于 Яндекс Вебмастер、Google Search Console、Метрика、Topvisor 和 Wordstat 的 21 个工具。其订阅独立于 Директ 套餐，提供 7 天免费试用。

Docker

docker build -t marketscore-direct-mcp .
docker run -i --rm -v ~/.mcp-auth:/root/.mcp-auth marketscore-direct-mcp

OAuth URL 会打印到标准输出——容器内不会打开浏览器，请手动点击链接。mcp-remote 令牌存储在 ~/.mcp-auth 中——请挂载卷以避免每次启动时重新授权。

有用链接

• 什么是 Yandex Direct 的 MCP 服务器：https://app.marketscore.ru/blog/mcp-server-yandex-direct

• 2026 年 Yandex Direct 的 AI 工具：https://app.marketscore.ru/blog/ii-dlya-yandex-direkta-instrumenty-2026

• 通过 Claude 和 ChatGPT 管理 Direct：https://app.marketscore.ru/blog/upravlenie-yandex-direct-cherez-claude-chatgpt

• Yandex Webmaster 的 MCP 服务器：https://app.marketscore.ru/blog/mcp-server-yandex-webmaster

• 用于 SEO 的神经网络——真正自动化了什么：https://app.marketscore.ru/blog/nejroset-dlya-seo-avtomatizaciya

• 为什么 Search Console 中的点击次数不一致：https://app.marketscore.ru/blog/search-console-kliki-ne-shodyatsya

中文

Direct Manager 是一个用于 Yandex Direct（俄罗斯搜索广告）的 AI/MCP 服务。此软件包是托管式 Direct Manager MCP 服务器的轻量连接器：它允许 Claude、ChatGPT 或任何 MCP 客户端读取广告系列分析并在聊天中执行操作（暂停、出价、预算、否定关键词）以管理 Yandex Direct 帐号。

安装（远程，Claude/ChatGPT）： 添加连接器 URL https://app.marketscore.ru/api/mcp 并通过 OAuth 登录。

安装（本地 MCP 客户端 — Cursor、VS Code、Cline、Zed）：

{
  "mcpServers": {
    "direct-manager": {
      "command": "npx",
      "args": ["-y", "marketscore-direct-mcp"]
    }
  }
}

工具： 基于 Direct API v5 和 Reports API 提供多达 116 种工具——按设备/性别/年龄/投放位置/地理位置分析的广告系列、搜索查询、展示份额、浪费支出检测（ROAS < 1）、广告系列管理（暂停、预算、策略、否定关键词、出价）、从头构建广告系列、AI 洞察（支出预测、下降诊断、变更说明、每周简报）、Wordstat 关键词研究，以及面向代理商的跨账户概况概览。

SEO MCP（独立服务器）： https://app.marketscore.ru/api/mcp/seo — 基于 Yandex Webmaster、Google Search Console、Yandex Metrica、Topvisor 和 Wordstat 提供 21 种自然搜索工具：搜索表现及期间比较、查询与页面、Yandex 索引状态及排除原因、增长机会（接近顶部查询、低点击率页面、有展示无点击、关键词自相残杀）、每个发现均附来源和日期的完整 SEO 审计、单页面技术分析（PageSpeed、Core Web Vitals、页面内信号）、两大搜索引擎中的站点地图状态、Google URL 检查、Yandex 重新抓取请求、竞争对手排名、Topvisor 中的关键词管理、Metrica 中的着陆页转化率，以及确定性俄语文本检查。只有三种工具会写入内容；付费排名检查被刻意排除在聊天之外。每个答案都带有来源——被撤销的来源会显示为来源故障，而绝不会显示为零流量。需要单独订阅（590/1 490/9 900 ₽/月，7 天试用）：https://app.marketscore.ru/seo

定价： 需要一个 Direct Manager 账户；注册包含 7 天免费 Pro 试用。Assistant — 990 ₽/月（111 种工具，仅聊天，3 个 Direct 账户）；Pro — 1 990 ₽/月（111 种工具 + 网页仪表板，5 个账户）；Agency — 9 900 ₽/月（116 种工具，含概况概览，20 个账户）。SEO 是独立的计划维度，使用独立的连接器 URL。没有激活计划时，服务器不显示任何工具。

常见问题解答：

是免费的吗？ 前 7 天免费（注册时获得 Pro 试用）；之后需要订阅。

我的 Yandex 令牌去了哪里？ 它保留在 Direct Manager 服务上——助手和 MCP 客户端永远不会看到它，也不会存储在任何本地配置中。

助手会破坏我的广告账户吗？ 写入工具会单独标注，MCP 客户端在运行前会请求确认。

关键词：Yandex Direct、Яндекс Директ、MCP、Model Context Protocol、MCP 服务器、PPC、广告管理、广告系列分析、ROAS、否定关键词、Wordstat、Claude、ChatGPT、Cursor、AI 营销、SEO MCP、Yandex Webmaster、Яндекс Вебмастер、Google Search Console、Yandex Metrica、Topvisor、SEO 审计、ИИ-менеджер для Яндекс Директа、ИИ для рекламы。

许可证

MIT — 见 LICENSE。连接器是开放的；Direct Manager 服务是付费 SaaS。