SEO Tools MCP Server

SEO 工具 MCP 服务

一个全面的 SEO API stdio MCP（模型上下文协议）服务。此服务允许大模型（大型语言模型）与 DataForSEO API 函数及其他 SEO 工具交互。

概述

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

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

功能

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

已实现的 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 等平台的商家信息数据

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

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

此服务实现了模型上下文协议，让大模型能够以标准化的方式与外部系统交互。要将其与 Claude 配合使用，您需要根据大模型平台各自的 MCP 实现方式进行集成。

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

开发

# Run in development mode with hot reloading
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 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_summary - 获取域名反向链接配置文件的摘要
• backlinks_backlinks - 获取域名的反向链接列表
• backlinks_referring_domains - 获取目标的引荐域名

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