🚀 DataForSEO MCP 服务器 TypeScript
📋 这个MCP服务器是什么?
🎯 主要目的
- SEO分析反向链接、关键词、排名、页面内SEO(搜索引擎优化)
- 内容优化内容分析和基于人工智能的内容创作
- 竞争分析SERP分析,域名比较,市场观察
- 电子商务产品数据、商家分析、购物优化
- 应用分析App Store性能、下载量、评价
- 社交媒体社交媒体监测与分析
🏗️ 建筑与功能
核心组件```
┌─────────────────┐ ┌──────────────────┐ ┌─────────────────┐
│ AI-Assistent │◄──►│ MCP Server │◄──►│ DataForSEO API │
│ (ChatGPT/Claude) │ │ (TypeScript) │ │ (12 Module) │
└─────────────────┘ └──────────────────┘ └─────────────────┘
### 交通选择
该服务器支持 **3种不同的运输方法**:
1. **📡 标准I/O传输** (本地开发)
- 通过标准输入/输出进行直接通信
- 非常适合本地测试和Claude桌面版使用
1. **🌐 可流式传输的HTTP传输** (制作)
- 基于现代HTTP的通信 **JSON-RPC 2.0**
- 支持GET/POST/DELETE请求
- 协议版本:2025-03-26
- 终点(或:研究终点): `/http` 并且 `/mcp`
1. **📡 HTTP + SSE 传输** (遗留支持)
- 服务器发送事件用于实时通信
- **JSON-RPC 2.0** 通过HTTP-POST到 `/messages`
- 对旧版客户端的向后兼容性
- 协议版本:2024-11-05
### 模块化建筑```
src/core/modules/
├── 📊 keywords-data/ # Keyword-Daten und Suchvolumen
├── 🔗 backlinks/ # Backlink-Analyse und Linkbuilding
├── 📄 onpage/ # On-Page SEO und Content-Analyse
├── 🔎 serp/ # Suchergebnisse und Rankings
├── 🏢 business-data-api/ # Geschäftsdaten und Unternehmen
├── 🛒 merchant/ # E-Commerce und Produktdaten
├── 📱 app-data/ # App Store Analytics
├── 🌐 domain-analytics/ # Domain- und Website-Analysen
├── ✍️ content-generation/ # KI-gestützte Inhaltserstellung
├── 📊 content-analysis/ # Content-Qualität und Optimierung
├── 🤖 ai-optimization/ # Automatisierte SEO-Optimierung
└── 🏪 google-business/ # Google My Business Daten
🚀 快速启动
前提条件
- Node.js ≥ 20.0.0
- DataForSEO账户 使用API访问数据
- AI助手 (ChatGPT、Claude Desktop 等)
安装```bash
Repository klonen
git clone https://github.com/dataforseo/mcp-server-typescript.git
cd mcp-server-typescript
Abhängigkeiten installieren
npm install
Projekt kompilieren
npm run build
### 配置
#### 1. 设置环境变量```bash
# DataForSEO API-Zugangsdaten
export DATAFORSEO_USERNAME="your_username"
export DATAFORSEO_PASSWORD="your_password"
# Module aktivieren (optional, alle Module sind standardmäßig aktiviert)
export ENABLED_MODULES="keywords-data,backlinks,serp,onpage"
# Prompts aktivieren (optional)
export ENABLED_PROMPTS="serp_analysis,backlink_analysis"
2. Claude Desktop 配置
Windows: `%APPDATA%\Claude\claude_desktop_config.json````json
{
"mcpServers": {
"dataforseo": {
"command": "node",
"args": ["C:\path\to\yourank-mcp\build\main\main\cli.js"],
"env": {
"DATAFORSEO_USERNAME": "your_username",
"DATAFORSEO_PASSWORD": "your_password"
}
}
}
}
### 启动服务器```bash
# CLI-Modus (für Claude Desktop)
npm run cli
# HTTP-Server (für Web-Integration)
npm run sse
# Development-Modus mit Watch
npm run dev
💡 实际案例
示例1:分析反向链接
您的提示:```
"Analysiere die Backlinks von example.com und zeige mir die wichtigsten Referenzdomains"
**发生的事情是:**
- 服务器使用了反向链接API
- 自动收集所有反向链接数据
- 创建包含顶级参考域名的结构化分析
### 示例2:搜索关键词
**您的提示:**```
"Finde Keywords für mein Restaurant in Berlin mit hohem Suchvolumen und niedriger Konkurrenz"
发生了什么:
- 服务器使用了关键词数据API
- 寻找柏林餐厅相关的关键词
- 显示搜索量、竞争程度和SEO难度
示例3:搜索结果页面(SERP)分析
您的提示:```
"Analysiere die Top-10 Suchergebnisse für 'SEO Beratung München' und zeige mir die wichtigsten Konkurrenten"
**发生的事情是:**
- 该服务器使用SERP API
- 收集所有前十名的结果
- 创建包含域名概览的竞争分析报告
## 🔧 可用的工具与API
### 关键词数据API 🔍
- **Google Ads搜索量**关键词的此类流量
- **Google Trends(谷歌趋势)**趋势分析和季节性模式
- **DataForSEO趋势**扩展了包含人口统计学信息的趋势数据
### 反向链接API 🔗
- **反向链接分析**完整的反向链接概览
- **参考域名**识别顶级链接来源
- **竞争比较**比较反向链接配置文件
- **垃圾邮件评分**评估链路质量
### SERP API 🔎
- **搜索结果**实时SERP数据适用于所有搜索引擎
- **排名位置**监控关键词排名
- **特色摘要(或精选片段)**分析代码片段优化
- **竞争分析**理解搜索引擎结果页面(SERP)景观
### 页面内API 📄
- **内容分析**文本质量和SEO优化
- **技术SEO**元标签、结构、性能
- **关键词密度**最佳关键词分布
- **内容缺口**识别改进潜力
### 业务数据API 🏢
- **企业数据**收集商业信息
- **竞争分析**识别竞争对手
- **市场概览**了解行业格局
### 内容生成API ✍️
- **KI-Content(人工智能内容)**自动内容生成
- **SEO文案**优化后的商品和描述
- **元描述(或元摘要)**SEO优化的元文本
### 域名分析API 🌐
- **技术栈**识别所使用的技术
- **性能分析**评估网站速度
- **SSL与安全**检查安全状态
### 应用数据API 📱
- **App Store 分析工具(或“App Store 数据分析”)**下载量、评分、排名
- **性能指标**分析应用程序性能
- **竞争分析**理解应用市场
### 商户API 🛒
- **产品数据**电子商务产品信息
- **价格比较**分析竞争奖项
- **产品优化**产品页面的SEO(搜索引擎优化)
### 人工智能优化API 🤖
- **自动化的SEO(搜索引擎优化)**基于人工智能的优化
- **内容评分**自动内容评估
- **性能预测**预测SEO性能
## 🔌 通过HTTP/JSON-RPC进行通信
### JSON-RPC 2.0 协议
MCP服务器通过(某种方式)进行通信 **JSON-RPC 2.0 协议** 通过HTTP。这使得人工智能助手与服务器之间能够进行标准化、可靠的通信。
#### 请求格式```json
{
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "keywords_data_google_ads_search_volume",
"arguments": {
"keywords": ["SEO", "Marketing"],
"location_code": 2276,
"language_code": "de"
}
},
"id": "unique-request-id"
}
响应格式```json
{
"jsonrpc": "2.0",
"result": {
"content": [
{
"type": "text",
"text": "{\"tasks\":[{\"result\":[{\"keyword\":\"SEO\",\"search_volume\":12000}]}]}"
}
]
},
"id": "unique-request-id"
}
#### 可用的方法
- **`tools/list`**获取所有可用工具的列表
- **`tools/call`**运行特定工具
- **`prompts/list`**获取所有可用提示的列表
- **`prompts/get`**获取特定提示
#### HTTP端点
**可流式传输的HTTP传输:**
- `POST /http` - JSON-RPC 请求的主要端点
- `POST /mcp` - JSON-RPC 请求的备用终端点
**HTTP + SSE 传输:**
- `GET /sse` - 建立SSE连接
- `POST /messages?sessionId=` - 通过SSE的JSON-RPC请求
#### 认证```bash
# Basic Authentication Header
Authorization: Basic
# Oder Umgebungsvariablen
DATAFORSEO_USERNAME=your_username
DATAFORSEO_PASSWORD=your_password
错误处理```json
{
"jsonrpc": "2.0",
"error": {
"code": -32001,
"message": "Authentication required. Provide DataForSEO credentials."
},
"id": "unique-request-id"
}
## 🔌 与AI助手的集成
### Claude Desktop(推荐)✅
**优点:**
- 原生MCP支持
- 简单的配置
- 随时可投入使用
- 所有工具均可用
**设置:**
1. 下载Claude Desktop
1. 创建配置文件(见上文)
1. 重启Claude Desktop
1. 工具即刻可用!
### ChatGPT(实验性)⚠️
**当前状态:**
- MCP支持是实验性的
- 需要特殊配置
- 并非所有功能都可用
**解决方法:**
- 使用 Claude Desktop 以获得完整功能
- 或者等待改进后的ChatGPT MCP支持
### 自定义集成 🔧
该服务器也可以集成到自有应用程序中:```typescript
import { initMcpServer } from './src/main/init-mcp-server.js';
// Server initialisieren
const server = initMcpServer('username', 'password');
// Mit Transport verbinden
await server.connect(transport);
📊 性能与扩展性
优化
- 模块化建筑仅加载所需的模块
- 智能缓存缓存API响应
- 批处理汇总多个请求
- 速率限制遵守API限制
监测
- 记录日志用于调试的详细日志
- 错误处理强大的错误处理能力
- 健康检查监控服务器状态
🛠️ 开发与扩展
项目结构```
yourank-mcp/
├── 📁 src/
│ ├── 📁 core/ # Kernfunktionalitäten
│ │ ├── 📁 client/ # DataForSEO API-Client
│ │ ├── 📁 config/ # Konfiguration & Schemas
│ │ ├── 📁 modules/ # Alle API-Module
│ │ └── 📁 utils/ # Hilfsfunktionen
│ ├── 📁 main/ # Hauptanwendung
│ └── 📁 worker/ # Worker-Prozesse
├── 📁 docs/ # Dokumentation
├── 📁 schemas/ # OpenAPI-Schemas
├── 📁 config/ # Konfigurationsdateien
└── 📁 examples/ # Beispiel-Implementierungen
### 添加新模块
1. **创建模块目录:**```bash
mkdir src/core/modules/neues-modul
- 实现模块类:```typescript
export class NeuesModul extends BaseModule {
getTools(): Record {
return {
'neues_tool': {
description: 'Beschreibung des Tools',
params: z.object({
parameter: z.string()
}),
handler: async (params) => {
// Tool-Logik implementieren
}
}
};
}
}
3. **模块注册:**```typescript
// In modules.config.ts
export const AvailableModules = {
'neues-modul': NeuesModul
};
写测试(或:做测试)```bash
Tests ausführen
npm test
Coverage-Report
npm run test:coverage
```
🔒 安全与最佳实践
API安全
- 基本身份验证安全的API访问数据
- 速率限制防止滥用
- 输入验证为所有输入定义Zod模式
- 错误处理确保错误处理
部署安全
- 环境变量敏感数据不要放在代码中
- HTTPS加密通信
- CORS(跨源资源共享)受控的跨域请求
- 记录日志日志中不包含敏感数据
📚 文档与资源
完整的文档
- 入门指南分步指南
- API概览所有可用的API
- 模式构建理解数据结构
- 示例提示实际应用
- API参考技术细节
- 常见问题解答(FAQ)常见问题
- 练习实践练习
测试提示(或测试指令)
- MCP服务器测试提示全面的测试套件
- ChatGPT集成ChatGPT专用指南
模式与配置
- OpenAPI 模式(或“OpenAPI 规范”)完整的API模式(或:完整的API规范)
- 配置所有配置文件
🤝 贡献与支持
贡献
- 创建仓库的分支
- 创建特性分支
git checkout -b feature/neues-feature) - 提交更改
git commit -am 'Neues Feature hinzufügen') - 推送分支(
git push origin feature/neues-feature) - 创建拉取请求
支持
- GitHub Issues(在GitHub上发布的问题或讨论)错误报告和功能请求
- 文件记录完整的指南在
docs/ - 示例实际应用实施于
examples/
社区
- Discord(音译:迪斯科德,意译可根据上下文调整,此处保留音译以体现专有名词特性)社区支持和讨论
- GitHub 讨论区技术问题和想法
- 维基社区创建的文档
📄 许可证
这个项目是在……的框架下进行的 Apache-2.0 许可证 获得授权。参见 许可证 以了解详情。
🙏 致谢
- DataForSEO(可译为“为SEO提供数据”或根据具体语境简化为“SEO数据服务”) 为全面的API平台
- OpenAI(开放人工智能研究所) 用于MCP-SDK
- 社区 以获取反馈和贡献
🔗 链接
- DataForSEO API官方API文档
- 模型上下文协议MCP规范
- Claude Desktop(中文可译为“克劳德桌面版”或根据具体语境简化为“克劳德桌面”,但通常直接保留原名以体现品牌特色)Claude Desktop 下载
- GitHub 仓库源代码
🚀 准备好迎接下一代SEO分析了吗?现在就开始使用DataForSEO MCP服务器!
