SEO 工具 MCP 服务器

一个全面的 stdio MCP（Model Context Protocol）服务器，用于 SEO API。此服务器允许大型语言模型（LLMs）与 DataForSEO API 功能和其他 SEO 工具进行交互。

概述

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

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

特性

• 全面覆盖 DataForSEO API 端点
• 可选集成 Local Falcon 和其他第三方 SEO 工具
• 使用 stdio 传输以便于集成
• 身份验证处理
• 详细的错误报告
• 使用 Zod 模式定义类型安全的工具
• 可扩展架构，支持添加新的 API 集成

实现的 API 类别

DataForSEO API

1. SERP API - 来自 Google、Bing、Yahoo 等搜索引擎的结果数据
2. 关键词数据 API - 关键词研究、建议和搜索量数据
3. DataForSEO Labs API - 高级 SEO 分析、域名比较和关键词分析
4. 反向链接 API - 反向链接配置文件、引用域名和锚文本分析
5. OnPage API - 网站审核、内容分析和技术 SEO 检查
6. 域名分析 API - 技术栈检测和域名数据分析
7. 内容分析 API - 内容质量评估和语义分析
8. 内容生成 API - AI 驱动的内容生成工具
9. 商户 API - 来自 Amazon 和 Google Shopping 的电子商务数据
10. 应用数据 API - 来自 Google Play 和 App Store 的移动应用数据
11. 商业数据 API - 来自 Google 我的商家、Trustpilot 等的商业列表数据

Local Falcon API（可选）

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

安装

# 克隆仓库
git clone https://github.com/Skobyn/dataforseo-mcp-server.git

# 切换到项目目录
cd dataforseo-mcp-server

# 安装依赖项
npm install

# 构建项目
npm run build

使用

要使用此 MCP 服务器，您需要获取想要使用的服务的 API 凭证。

使用 DataForSEO 运行服务器

# 设置 DataForSEO 认证的环境变量
export DATAFORSEO_LOGIN="your_login"
export DATAFORSEO_PASSWORD="your_password"

# 运行服务器
npm start

使用 DataForSEO 和 Local Falcon 运行服务器

# 设置所有 API 认证的环境变量
export DATAFORSEO_LOGIN="your_login"
export DATAFORSEO_PASSWORD="your_password"
export LOCALFALCON_API_KEY="your_localfalcon_api_key"
# 可选：如果需要，设置自定义 Local Falcon API URL
# export LOCALFALCON_API_URL="https://custom-localfalcon-url.com/api"

# 运行服务器
npm start

与 Claude 或其他 LLM 结合使用

此服务器实现了 Model Context Protocol，允许 LLM 以标准化的方式与外部系统进行交互。要将其与 Claude 结合使用，您需要根据其特定的 MCP 实现将其集成到您的 LLM 平台上。

请参阅示例目录中的使用示例。

开发

# 以开发模式运行并启用热重载
npm run dev

示例

查看 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_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_summary - 获取域名反向链接概况
• backlinks_backlinks - 获取域名的反向链接列表
• backlinks_referring_domains - 获取目标的引用域名

Local Falcon 工具（如果已配置）

• localfalcon_calculate_grid_points - 计算基础坐标周围的网格点
• localfalcon_search_gmb_locations - 搜索 Google 我的商家地点
• 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