Dataforseo MCP Server

SEO工具MCP服务器

一个用于SEO API的全面的stdio MCP（模型上下文协议）服务器。该服务器允许LLM（大型语言模型）与DataForSEO API函数和其他SEO工具进行交互。

概述

SEO Tools MCP Server实现了Claude等LLM与各种SEO API之间的无缝集成，从而可以直接通过自然语言交互执行SEO分析、关键字研究、反向链接分析和许多其他与SEO相关的任务。

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

特性

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

实施API类别

搜索引擎优化API数据

1. SERP API -来自谷歌、必应、雅虎等的搜索引擎结果数据
2. 关键词数据API -关键词研究、建议和搜索量数据
3. DataForSEO实验室API -高级SEO分析、域名比较和关键字分析
4. 反向链接API -反向链接配置文件、引用域和锚文本分析
5. 第页API -网站审计、内容分析和技术SEO检查
6. 域分析API -技术栈检测和领域数据分析
7. 内容分析API -内容质量评估和语义分析
8. 内容生成API -基于人工智能的内容生成工具
9. 商户API -来自亚马逊和谷歌购物的电子商务数据
10. 应用程序数据API -来自Google Play和app Store的移动应用数据
11. 业务数据API -来自Google My Business、Trustpilot等的企业列表数据

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

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

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

发展

# Run in development mode with hot reloading
npm run dev

例子

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

基本示例演示了：

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

可用工具

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

DataForSEO SERP API工具

• serp_google_organic_live -获取谷歌自然搜索结果
• serp_google_organic_task_post -创建Google自然搜索任务
• serp_google_maps_live -获取谷歌地图搜索结果

DataForSEO关键词数据工具

• keywords_google_ads_search_volume -获取关键字的搜索量
• keywords_google_ads_keywords_for_site -获取域的关键字建议
• keywords_google_trends_explore -探索随时间推移的关键字趋势

DataForSEO 实验室 工具

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

DataForSEO反向链接工具

• backlinks_summary -获取域反向链接配置文件的摘要
• backlinks_backlinks -获取域的反向链接列表
• backlinks_referring_domains -获取目标的引用域

本地猎鹰工具（如已配置）

• 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/ 对于模板。

许可证

麻省理工学院