Yandex Direct Manager

Direct Manager — MCP 服务，用于 Яндекс Директ

将 Claude 或 ChatGPT 连接到 Яндекс Директ，通过对话管理广告：“钱都白白花到哪里去了？”→ 助手会找出 ROAS < 1 的广告系列，并建议停掉哪些系列。

将 Claude 或 ChatGPT 连接到 Yandex Direct，通过聊天管理广告系列——分析、检测浪费的支出、出价、预算、否定关键词。

免费试用「专业版」套餐 7 天 →

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

---

这是什么

marketscore-direct-mcp 是连接到托管 MCP 服务 Direct Manager 的轻量连接器。服务本身、Direct API 访问权限和所有逻辑都由服务端运行——这个包只是将您的 AI 助手连接到该服务。

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

使用示例：

您： 过去 14 天里，哪些地方白白花了我的钱？

Claude： 发现了 3 个问题，共浪费 12 400 ₽：「Ремонт квартир — РСЯ」广告系列花费 4 210 ₽，却没有任何转化；dsp.example 投放平台的 ROAS 为 0.2；6 个关键词有支出却没有带来任何咨询。要停用该投放平台，并将这些关键词添加为否定关键词吗？

功能

基于 Direct API v5 和 Reports API 提供多达 116 个工具（「助手」和「专业版」套餐提供 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（点击、展示、CTR、平均排名、前 3 名/前 10 名和周期对比）、seo_search_queries（网站管理员工具和 Search Console 中按设备和地区划分的查询和页面）、seo_positions（Topvisor 最近一次检查结果）、seo_indexation（有多少页面出现在 Yandex 搜索中，哪些页面被排除以及原因）、seo_metrika（来自搜索的访客行为和目标达成情况）、seo_landing_pages（按入口页面划分的访问量和申请量）。
• 网站工作 — seo_audit（分析索引、技术、页面内因素和页面竞争情况，并为每项结论标注来源）、seo_page_analysis（页面速度、Core Web Vitals 和页面内信号）、seo_opportunities（接近排名前列的查询、CTR 偏低的页面、有展示但无点击的页面、关键词蚕食）、seo_sitemaps（Yandex 和 Google 是否能看到网站地图）、seo_url_inspection（Google 对特定地址的判定）、seo_request_recrawl（提交地址以便 Yandex 重新抓取）、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（Desktop、网页、Code）和 ChatGPT — 通过链接

添加远程 MCP 连接器：

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

助手会打开登录页面，请通过 OAuth 完成授权。助手不会收到 Yandex 令牌。可以同时添加两个地址：它们是相互独立的连接器，订阅也彼此独立。

本地 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 个 Direct 账户。没有 Web 仪表板，仅提供助手。
• **「专业版」— 1 990 ₽/月：**同样包含 111 个工具，另加带分析功能和自动驾驶功能的 Web 仪表板，最多支持 5 个 Direct 账户。
• **「代理机构」— 9 900 ₽/月：**116 个工具（另加组合账户概览 accounts_overview），最多支持 20 个账户。
• SEO 是独立的套餐体系（590 / 1 490 / 9 900 ₽/月），并使用独立的连接器地址。Direct 套餐不提供 SEO 工具的访问权限，反之亦然。

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

与 Direct API 开源封装的区别

目前有面向 Direct API 的可自托管 MCP 封装（例如 mcp-yandex-direct）。以下是客观比较：

	Direct Manager（此连接器）	可自托管封装
安装	通过链接登录 OAuth	获取 Direct 令牌并将其填入配置
AI 分析、审计、自动驾驶	有（预测、诊断、简报、主要发现）	无，仅提供原始 API 调用
Web 仪表板和 Telegram 机器人	有	无
账户组合	有（概览所有客户）	无
价格	订阅（免费试用 7 天）	免费，但需要自行配置和托管
Yandex 令牌的存放位置	存储在服务端，不在客户端配置中	本地存储在客户端配置中

安全性

• 使用 OAuth 2.1 授权：Yandex 令牌不会传给助手，也不会存放在客户端配置中，而是保存在服务端。
• 更改 Direct Manager 账户密码会撤销所有已授予的 MCP 访问权限。
• 写入操作会标注注释，并由 MCP 客户端确认。
• 个人数据存储在俄罗斯境内的服务器上（152-ФЗ）。

常见问题

免费吗？ 前 7 天免费（注册时可试用「专业版」套餐）。之后需订阅「助手」套餐（990 ₽/月，仅 MCP）或更高套餐。

Direct 令牌会存放在哪里？ 通过 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 机器人和账户组合概览；Yandex 令牌不会存放在配置中。详情请参阅上表。

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

支持 SEO 吗？ 支持，提供独立的 MCP 服务：https://app.marketscore.ru/api/mcp/seo，包含 21 个工具，基于 Yandex Webmaster、Google Search Console、Metrica、Topvisor 和 Wordstat。该服务需单独订阅，不包含在 Direct 套餐中，并提供 7 天试用。

Docker

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

OAuth URL 会打印到 stdout，容器内不会打开浏览器，请手动访问链接。mcp-remote 令牌存储在 ~/.mcp-auth 中，请挂载 volume，以免每次启动时都要重新授权。

实用链接

• 什么是用于 Yandex Direct 的 MCP 服务：https://app.marketscore.ru/blog/mcp-server-yandex-direct
• Yandex Direct 的 AI 工具 — 2026 年版：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

---

English

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 索引状态及排除原因、增长机会（接近首页的查询、低 CTR 页面、有展示但无点击、关键词蚕食）、每条发现都附带来源和日期的完整 SEO 审计、单页技术分析（PageSpeed、Core Web Vitals、页面信号）、两个搜索引擎中的站点地图状态、Google URL 检查、Yandex 重新抓取请求、竞争对手排名、Topvisor 关键词管理、来自 Metrica 的着陆页转化，以及确定性的俄语文本检查。只有三个工具会写入数据；付费排名检查特意不开放给聊天使用。每个回答都附带来源信息 — 被撤销的来源会显示为来源错误，而不会显示为零流量。单独订阅（590 / 1 490 / 9 900 ₽/月，7 天试用）：https://app.marketscore.ru/seo

定价： 需要 Direct Manager 账户；注册后可免费试用 Pro 版 7 天。Assistant — 990 ₽/月（111 个工具，仅聊天，3 个 Direct 账户）；Pro — 1 990 ₽/月（111 个工具 + Web 控制面板，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 审计、Yandex Direct AI 管理器、广告 AI。

许可证

MIT — 详见 LICENSE。连接器为开源；Direct Manager 服务是付费 SaaS。