SEO Tools MCP Server

SEO 工具 MCP 服务

一个全面的 stdio MCP（Model Context Protocol）服务，适用于 SEO API。此服务允许大模型（大型语言模型）调用 DataForSEO API 功能及其他 SEO 工具。

注意

版本 1.1.0 修正了约 40 个端点错误，这些错误是在将封装器路径与 DataForSEO 官方文档进行比对后发现的。完整列表请参阅 CHANGELOG.md。

概览

SEO 工具 MCP 服务可将 Claude 等大模型与各种 SEO API 无缝集成，让你能够通过自然语言交互直接执行 SEO 分析、关键词研究、反向链接分析以及许多其他与 SEO 相关的任务。

此实现将所有主要的 DataForSEO API 端点作为 MCP 工具开放，大模型可调用这些工具以获取特定 SEO 数据。该服务使用 stdio 作为传输层，便于与各种大模型平台集成。

功能

• 全面覆盖 DataForSEO API 端点（此版本修复的错误请参阅 CHANGELOG.md）
• 可选集成 Local Falcon 及其他第三方 SEO 工具
• 使用 stdio 传输，便于集成
• 身份验证处理
• 详细的错误报告
• 使用 Zod schemas 定义类型安全的工具
• 可扩展的架构，便于添加新的 API 集成
• 通过环境变量选择性筛选模块和工具

注册 Data for Seo

https://dataforseo.com/?aff=200885

已实现的 API 类别

DataForSEO API

1. SERP API - 来自 Google、Bing、Yahoo 等搜索引擎的结果数据
2. Keywords Data API - 关键词研究、建议和搜索量数据
3. DataForSEO Labs API - 高级 SEO 分析、域名对比和关键词分析
4. Backlinks API - 反向链接概况、引荐域名和锚文本分析
5. OnPage API - 网站审计、内容分析和技术 SEO 检查
6. Domain Analytics API - 技术栈检测和域名数据分析
7. Content Analysis API - 内容质量评估和语义分析
8. Content Generation API - AI 驱动的内容生成工具
9. Merchant API - 来自 Amazon 和 Google Shopping 的电子商务数据
10. App Data API - 来自 Google Play 和 App Store 的移动应用数据
11. Business Data API - 来自 Google My Business、Trustpilot 等平台的商家列表数据
12. AI Optimization API - 来自 ChatGPT、Claude、Gemini 和 Perplexity 的大模型响应、AI 爬虫和 AI 关键词数据

Local Falcon API（可选）

1. 计算网格点 - 生成用于本地排名分析的网格坐标
2. 搜索 GMB 位置 - 根据查询查找 Google My Business 位置
3. 获取坐标处的排名 - 检查指定坐标处的商家排名
4. 在坐标处搜索关键词 - 在指定位置测试搜索词
5. 运行网格搜索 - 执行完整的基于网格的本地排名分析

安装

# Clone the repository
git clone https://github.com/Skobyn/dataforseo-mcp-server.git

# Change to the project directory
cd dataforseo-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

使用

使用此 MCP 服务需要提供所用服务的 API 凭据。

使用 DataForSEO 运行服务

# Set environment variables for DataForSEO authentication
export DATAFORSEO_LOGIN="your_login"
export DATAFORSEO_PASSWORD="your_password"

# Run the server
npm start

使用 DataForSEO 和 Local Falcon 运行服务

# Set environment variables for all API authentications
export DATAFORSEO_LOGIN="your_login"
export DATAFORSEO_PASSWORD="your_password"
export LOCALFALCON_API_KEY="your_localfalcon_api_key"
# Optional: Set custom Local Falcon API URL if needed
# export LOCALFALCON_API_URL="https://custom-localfalcon-url.com/api"

# Run the server
npm start

筛选模块和工具

此服务默认开放数百个工具。与大模型搭配使用时，完整工具列表会占用大量上下文窗口空间。你可以使用环境变量，仅启用所需的模块或工具，以减少开放的工具数量。

为什么要筛选？

• 减少上下文占用
• 加快大模型发现工具的速度
• 让响应更聚焦

按模块筛选

使用 ENABLED_MODULES 仅启用特定 API 类别（以逗号分隔，不区分大小写）：

export ENABLED_MODULES="SERP,BUSINESS_DATA,LABS"

可用模块：

• SERP - 搜索引擎结果
• KEYWORDS_DATA - 关键词研究
• LABS 或 DATAFORSEO_LABS - 高级 SEO 分析
• BACKLINKS - 反向链接分析
• ONPAGE - 网站审核
• DOMAIN_ANALYTICS - 域名数据
• CONTENT_ANALYSIS - 内容评估
• CONTENT_GENERATION - AI 内容生成
• MERCHANT - 电商数据
• APP_DATA - 移动应用数据
• BUSINESS_DATA - 商家信息
• AI_OPTIMIZATION - 大模型响应和 AI 数据

按单个工具筛选

使用 ENABLED_TOOLS 精细控制特定工具（以逗号分隔，不区分大小写）：

export ENABLED_TOOLS="serp_google_maps_live,business_data_google_my_business_info"

如果未设置这两个变量，则默认启用所有模块和工具。

按模块订阅及 404 错误

DataForSEO 通常按模块授予访问权限，而不是提供一个全有或全无的订阅。这意味着某些端点可能正常工作，而其他端点则返回 404。

重要的解读规则：

• 对 SERP、App Data、DataForSEO Labs App Store 或 Content Generation 等已知实时端点返回 404，可能意味着当前账户未启用相应模块
• 这不一定是 MCP 服务出错或端点路径错误
• 即使同一大类中的付费实时端点不可用，位置或语言等免费发现端点仍可能正常工作

现在，服务会将已知的模块范围 404 响应规范化为更清晰的消息：

• DataForSEO module not enabled: <module> ...

发生这种情况时，请在 DataForSEO 控制面板中启用该模块，或改用当前账户已启用模块中的工具。

与 Claude 或其他大模型配合使用

此服务实现了 Model Context Protocol，允许大模型以标准化方式与外部系统交互。要与 Claude 配合使用，你需要根据 LLM 平台各自的 MCP 实现进行集成。

请参阅 examples 目录中的用法示例。

开发

# Run in development mode with hot reloading
npm run dev

# Run tests
npm test

示例

查看 examples 目录中的示例代码，了解如何使用 SEO Tools MCP Server。

基础示例演示了：

• 启动服务
• 从客户端连接到服务
• 调用不同的 API 端点
• 处理结果

可用工具

该服务在所有集成的 API 类别中提供了数百种工具。以下是一些最常用工具的示例：

DataForSEO SERP API 工具

• serp_google_organic_live - 获取 Google 自然搜索结果
• serp_google_organic_task_post - 创建 Google 自然搜索任务
• serp_google_maps_live - 获取 Google Maps 搜索结果

DataForSEO Keywords Data 工具

• keywords_google_ads_search_volume - 获取关键词的搜索量
• keywords_google_ads_keywords_for_site - 获取域名的关键词建议
• keywords_google_trends_explore - 探索关键词随时间变化的趋势

DataForSEO Labs 工具

• labs_google_keyword_ideas - 根据种子关键词获取关键词创意
• labs_google_related_keywords - 获取相关关键词
• labs_google_domain_rank_overview - 获取域名排名概览

DataForSEO Backlinks 工具

• backlinks_summary - 获取域名反向链接配置的摘要
• backlinks_backlinks - 获取域名的反向链接列表
• backlinks_referring_domains - 获取目标的引用域名
• backlinks_history - 获取目标的历史反向链接数据
• backlinks_timeseries_summary - 获取反向链接的时间序列数据
• backlinks_bulk_new_lost_backlinks - 获取多个目标的新增和丢失反向链接
• backlinks_bulk_new_lost_referring_domains - 获取多个目标的新增和丢失引用域名
• backlinks_bulk_pages_summary - 获取多个目标的页面摘要

DataForSEO AI 优化工具

• ai_chatgpt_models - 获取可用的 ChatGPT 模型列表
• ai_chatgpt_llm_responses_live - 获取 ChatGPT 的实时响应
• ai_chatgpt_scraper_locations - 获取 ChatGPT 抓取工具可用的位置
• ai_chatgpt_scraper_languages - 获取 ChatGPT 抓取工具可用的语言
• ai_claude_models - 获取可用的 Claude 模型列表
• ai_claude_llm_responses_live - 获取 Claude 的实时响应
• ai_gemini_models - 获取可用的 Gemini 模型列表
• ai_gemini_llm_responses_live - 获取 Gemini 的实时响应
• ai_perplexity_models - 获取可用的 Perplexity 模型列表
• ai_perplexity_llm_responses_live - 获取 Perplexity 的实时响应
• ai_keyword_data_search_volume_live - 获取 AI 关键词搜索量数据
• ai_keyword_data_locations_and_languages - 获取 AI 关键词数据可用的位置和语言

Local Falcon 工具（如已配置）

• localfalcon_calculate_grid_points - 计算基于某个坐标的网格点
• localfalcon_search_gmb_locations - 搜索 Google My Business 位置
• localfalcon_get_ranking_at_coordinate - 获取特定坐标处的商家排名
• localfalcon_keyword_search_at_coordinate - 在特定位置搜索关键词
• localfalcon_run_grid_search - 执行完整的本地排名网格搜索

完整工具列表

如需查看所有可用工具及其参数的完整列表，请查看 src/api 目录中的实现。

扩展服务

此服务采用可扩展设计。若要支持其他 SEO API：

1. 在 src/api/ 中为集成创建新目录
2. 实现客户端处理和工具注册
3. 将集成添加到 src/index.ts
4. 添加用于身份验证的环境变量处理

请参阅 src/api/localfalcon/ 中的 Local Falcon 集成模板。

安全性

• 凭据（DATAFORSEO_LOGIN、DATAFORSEO_PASSWORD、LOCALFALCON_API_KEY）仅从环境变量读取。切勿提交这些凭据。
• 将 .env.example 复制为 .env，并填入你自己的凭据。
• .gitignore 会排除 .env、.env.*.local 以及其他存储密钥的路径。
• 贡献前，请运行 npm audit 并修复所有高危和严重漏洞。

许可证

MIT