Yandex Tools MCP

yandex-tools-mcp

用于 Yandex API 的 MCP 服务——面向俄罗斯市场的搜索、关键词研究、站长工具和网络分析。

English | Русский

---

English

软件包

软件包	描述	npm
yandex-wordstat-mcp	通过 Yandex Wordstat v2 API（Yandex Cloud）进行关键词研究和搜索趋势分析
yandex-search-mcp	通过 Yandex Search API 进行网络搜索
yandex-webmaster-mcp	通过 Yandex Webmaster API 进行网站分析、索引和 SEO
yandex-metrika-mcp	通过 Yandex Metrika API 获取网络分析和流量数据
yandex-direct-mcp	通过 Yandex Direct API 管理 PPC 广告系列（广告系列、广告、关键词、出价、统计数据）

快速开始

Yandex Wordstat v2（关键词研究）——Yandex Cloud Search API；使用与 Search 相同的密钥：

{
  "mcpServers": {
    "yandex-wordstat": {
      "command": "npx",
      "args": ["-y", "yandex-wordstat-mcp"],
      "env": {
        "YANDEX_SEARCH_API_KEY": "your_api_key",
        "YANDEX_FOLDER_ID": "your_folder_id"
      }
    }
  }
}

更倾向于使用托管工具？请使用 seyka.ru/developers/api/seo/wordstat 上的托管端点——无需管理 Yandex Cloud 凭据。

Yandex Search（网络搜索）：

{
  "mcpServers": {
    "yandex-search": {
      "command": "npx",
      "args": ["-y", "yandex-search-mcp"],
      "env": {
        "YANDEX_SEARCH_API_KEY": "your_api_key",
        "YANDEX_FOLDER_ID": "your_folder_id"
      }
    }
  }
}

Yandex Webmaster（网站分析和 SEO）：

{
  "mcpServers": {
    "yandex-webmaster": {
      "command": "npx",
      "args": ["-y", "yandex-webmaster-mcp"],
      "env": {
        "YANDEX_WEBMASTER_TOKEN": "your_oauth_token"
      }
    }
  }
}

Yandex Metrika（网络分析）：

{
  "mcpServers": {
    "yandex-metrika": {
      "command": "npx",
      "args": ["-y", "yandex-metrika-mcp"],
      "env": {
        "YANDEX_METRIKA_TOKEN": "your_oauth_token"
      }
    }
  }
}

Yandex Direct（PPC 广告系列管理——默认使用沙盒；设置 YANDEX_DIRECT_LIVE=1 以使用真实账户）：

{
  "mcpServers": {
    "yandex-direct": {
      "command": "npx",
      "args": ["-y", "yandex-direct-mcp"],
      "env": {
        "YANDEX_DIRECT_TOKEN": "your_oauth_token"
      }
    }
  }
}

详细设置说明请参阅各软件包的 README。

seyka.ru 上的托管版本：Yandex Search · Wordstat · Webmaster · Metrika

在线使用示例：seyka.ru

Claude Code 插件

将全部五个 MCP 安装为一个插件，并内置用于关键词研究和竞争分析的技能：

# Set your API keys
export YANDEX_SEARCH_API_KEY=your_api_key   # also used by Wordstat
export YANDEX_FOLDER_ID=your_folder_id      # also used by Wordstat
export YANDEX_WEBMASTER_TOKEN=your_oauth_token
export YANDEX_METRIKA_TOKEN=your_oauth_token
export YANDEX_DIRECT_TOKEN=your_oauth_token  # defaults to sandbox

# Run with plugin
claude --plugin-dir /path/to/yandex-tools-mcp

包含的技能：

• yandex-keyword-research — 在进行关键词研究、搜索量和趋势分析时自动触发
• yandex-competitive-analysis — 在进行竞争对手分析和 SERP 研究时自动触发

---

Русский

软件包

软件包	描述	npm
yandex-wordstat-mcp	通过 Yandex Wordstat API v2（Yandex Cloud）研究关键词
yandex-search-mcp	通过 Yandex Search API 进行网页搜索
yandex-webmaster-mcp	通过 Yandex Webmaster API 进行网站分析、索引和 SEO
yandex-metrika-mcp	通过 Yandex Metrika API 获取网站分析和流量数据
yandex-direct-mcp	通过 Yandex Direct API 管理 PPC 广告系列（广告系列、广告、关键词、出价、统计数据）

快速开始

Yandex Wordstat v2（关键词研究）— Yandex Cloud Search API；使用与搜索相同的密钥：

{
  "mcpServers": {
    "yandex-wordstat": {
      "command": "npx",
      "args": ["-y", "yandex-wordstat-mcp"],
      "env": {
        "YANDEX_SEARCH_API_KEY": "ваш_api_ключ",
        "YANDEX_FOLDER_ID": "ваш_folder_id"
      }
    }
  }
}

需要现成的工具？使用托管端点 seyka.ru/developers/api/seo/wordstat，无需管理 Yandex Cloud 凭据。

Yandex 搜索（网页搜索）：

{
  "mcpServers": {
    "yandex-search": {
      "command": "npx",
      "args": ["-y", "yandex-search-mcp"],
      "env": {
        "YANDEX_SEARCH_API_KEY": "ваш_api_ключ",
        "YANDEX_FOLDER_ID": "ваш_folder_id"
      }
    }
  }
}

Yandex Webmaster（网站分析和 SEO）：

{
  "mcpServers": {
    "yandex-webmaster": {
      "command": "npx",
      "args": ["-y", "yandex-webmaster-mcp"],
      "env": {
        "YANDEX_WEBMASTER_TOKEN": "ваш_oauth_токен"
      }
    }
  }
}

Yandex Metrika（网站分析）：

{
  "mcpServers": {
    "yandex-metrika": {
      "command": "npx",
      "args": ["-y", "yandex-metrika-mcp"],
      "env": {
        "YANDEX_METRIKA_TOKEN": "ваш_oauth_токен"
      }
    }
  }
}

Yandex Direct（PPC 广告系列管理——默认使用沙盒；设置 YANDEX_DIRECT_LIVE=1 以使用正式账号）：

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

各软件包的 README 中提供了详细的设置说明。

seyka.ru 托管版本：Yandex 搜索 · Wordstat · Webmaster · Metrika

在线使用示例：seyka.ru

Claude Code 插件

将全部五个 MCP 安装为一个插件，其中内置了用于关键词研究和竞争对手分析的技能：

# Установите API ключи
export YANDEX_SEARCH_API_KEY=ваш_api_ключ   # также используется Вордстатом
export YANDEX_FOLDER_ID=ваш_folder_id       # также используется Вордстатом
export YANDEX_WEBMASTER_TOKEN=ваш_oauth_токен
export YANDEX_METRIKA_TOKEN=ваш_oauth_токен
export YANDEX_DIRECT_TOKEN=ваш_oauth_токен  # по умолчанию песочница

# Запустите с плагином
claude --plugin-dir /path/to/yandex-tools-mcp

包含的技能：

• yandex-keyword-research — 自动用于关键词研究、搜索量分析和趋势分析
• yandex-competitive-analysis — 自动用于竞争对手分析和 SERP 研究

---

开发

git clone https://github.com/seyka-ai/yandex-tools-mcp.git
cd yandex-tools-mcp
bun install

在此代码库中启动 Claude Code 前，请运行 bun install。 本地 .mcp.json 使用 node 从源代码运行每个服务，因此如果未安装依赖项，所有服务都会在启动时崩溃（Cannot find package '@modelcontextprotocol/sdk'），Claude Code 会将其报告为 CONNECTION_CLOSED。Bun 会将每个软件包的依赖项安装到各自的 packages/*/node_modules 中。上方的插件设置使用 npx，无需执行此步骤。

运行所有测试（每个包含 test 脚本的软件包）：

bun run test

代码检查和格式化：

bun run lint
bun run format

发布软件包：

cd packages/yandex-wordstat-mcp && npm publish
cd packages/yandex-search-mcp && npm publish
cd packages/yandex-webmaster-mcp && npm publish
cd packages/yandex-metrika-mcp && npm publish
cd packages/yandex-direct-mcp && npm publish

许可证

MIT © Seyka AI