SEO 工具 MCP 服务器

一个用于 SEO API 的综合 stdio MCP（模型上下文协议）服务器。该服务器允许 LLM（大语言模型）与 DataForSEO API 功能及其他 SEO 工具进行交互。

概述

SEO 工具 MCP 服务器实现了 Claude 等 LLM 与各种 SEO API 之间的无缝集成，使得通过自然语言交互直接执行 SEO 分析、关键词研究、反向链接分析以及许多其他 SEO 相关任务成为可能。

此实现将所有主要的 DataForSEO API 端点公开为 MCP 工具，LLM 可以调用这些工具来检索特定的 SEO 数据。该服务器使用 stdio 作为其传输层，使其易于与各种 LLM 平台集成。

Related MCP server: DataForSEO MCP Server

功能

• 全面覆盖 DataForSEO API 端点

• 可选集成 Local Falcon 和其他第三方 SEO 工具

• 用于轻松集成的 stdio 传输

• 身份验证处理

• 详细的错误报告

• 带有 Zod 模式的类型安全工具定义

• 用于添加新 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 的 LLM 响应、AI 抓取器和 AI 关键词数据

Local Falcon API (可选)

1. Calculate Grid Points - 生成用于本地排名分析的网格坐标

2. Search GMB Locations - 按查询查找 Google My Business 地点

3. Get Ranking at Coordinate - 检查特定坐标处的商家排名

4. Keyword Search at Coordinate - 在特定地点测试搜索词

5. Run Grid Search - 执行完整的基于网格的本地排名分析

安装

# 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

过滤模块和工具

服务器默认公开数百个工具。当与 LLM 一起使用时，完整的工具列表会占用大量的上下文窗口空间。您可以使用环境变量来减少公开的工具数量，仅启用您需要的模块或工具。

为什么要过滤？

• 减少上下文使用

• LLM 更快地发现工具

• 响应更具针对性

按模块过滤

使用 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 - LLM 响应和 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 或其他 LLM 一起使用

此服务器实现了模型上下文协议，允许 LLM 以标准化的方式与外部系统进行交互。要将其与 Claude 一起使用，您需要根据其特定的 MCP 实现将其与您的 LLM 平台集成。

有关使用示例，请参阅 examples 目录。

开发

# Run in development mode with hot reloading
npm run dev

# Run tests
npm test

示例

查看 examples 目录以获取展示如何使用 SEO 工具 MCP 服务器的示例代码。

基本示例演示了：

• 启动服务器

• 从客户端连接到它

• 调用不同的 API 端点

• 处理结果

可用工具

服务器在所有集成的 API 类别中公开了数百个工具。以下是一些最常用工具的示例：

DataForSEO SERP API 工具

• serp_google_organic_live - 获取 Google 自然搜索结果

• serp_google_organic_task_post - 创建 Google 自然搜索任务

• serp_google_maps_live - 获取 Google 地图搜索结果

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 Optimization 工具

• 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 集成。

许可证

MIT