🚀 DataForSEO MCP 服务器 TypeScript

一个功能强大的 模型上下文协议（MCP）服务器 为DataForSEO API开发的（该API用TypeScript编写）。此服务器作为智能“翻译器”，连接AI助手（如ChatGPT、Claude）与DataForSEO的各种SEO和营销数据源。

](https://github.com/dataforseo/mcp-server-typescript) ![License](LICENSE) ](package.json)

📋 这个MCP服务器是什么？

Der（在德语中通常作为冠词“这”或“那”的意思，但单独使用时可能根据上下文有不同含义，此处若作为独立词汇翻译可能略显生硬，需结合具体语境） DataForSEO MCP 服务器 这是一个专门的服务器，使AI助手能够直接访问超过 12种不同的SEO和营销API 访问DataForSEO。它将自然语言转换为精确的API调用，并将结构化数据转换回易于理解的回复。

🎯 主要目的

SEO分析反向链接、关键词、排名、页面内SEO（搜索引擎优化）
内容优化内容分析和基于人工智能的内容创作
竞争分析SERP分析，域名比较，市场观察
电子商务产品数据、商家分析、购物优化
应用分析App Store性能、下载量、评价
社交媒体社交媒体监测与分析

🏗️ 建筑与功能

核心组件

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   AI-Assistent  │◄──►│   MCP Server     │◄──►│  DataForSEO API │
│ (ChatGPT/Claude) │    │  (TypeScript)    │    │   (12 Module)   │
└─────────────────┘    └──────────────────┘    └─────────────────┘

交通选择

该服务器支持 3种不同的运输方法:

📡 标准I/O传输 （本地开发）

- 通过标准输入/输出进行直接通信 - 非常适合本地测试和Claude桌面版使用

🌐 可流式传输的HTTP传输 （制作）

- 基于现代HTTP的通信 JSON-RPC 2.0 - 支持GET/POST/DELETE请求 - 协议版本：2025-03-26 - 终点（或：研究终点）： /http 并且 /mcp

📡 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 等）

安装

# 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. 设置环境变量

# 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 macOS:（可译为“苹果操作系统”或保持原样，因为“macOS”是苹果公司为其操作系统使用的专有名词，直接翻译可能失去其品牌特色） ~/Library/Application Support/Claude/claude_desktop_config.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"
      }
    }
  }
}

启动服务器

# 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。这使得人工智能助手与服务器之间能够进行标准化、可靠的通信。

请求格式

{
  "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"
}

响应格式

{
  "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请求

认证

# Basic Authentication Header
Authorization: Basic 

# Oder Umgebungsvariablen
DATAFORSEO_USERNAME=your_username
DATAFORSEO_PASSWORD=your_password

错误处理

{
  "jsonrpc": "2.0",
  "error": {
    "code": -32001,
    "message": "Authentication required. Provide DataForSEO credentials."
  },
  "id": "unique-request-id"
}

🔌 与AI助手的集成

Claude Desktop（推荐）✅

优点：

原生MCP支持
简单的配置
随时可投入使用
所有工具均可用

设置：

下载Claude Desktop
创建配置文件（见上文）
重启Claude Desktop
工具即刻可用！

ChatGPT（实验性）⚠️

当前状态：

MCP支持是实验性的
需要特殊配置
并非所有功能都可用

解决方法：

使用 Claude Desktop 以获得完整功能
或者等待改进后的ChatGPT MCP支持

自定义集成 🔧

该服务器也可以集成到自有应用程序中：

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

添加新模块

mkdir src/core/modules/neues-modul

实现模块类：

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
        }
      }
    };
  }
}

模块注册：

// In modules.config.ts
export const AvailableModules = {
  'neues-modul': NeuesModul
};

写测试（或：做测试）

# 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平台
Anthropic（公司名，可译为“安萨里克”或根据官方中文名翻译，若无官方中文名则保持音译） 用于上下文协议模型
OpenAI（开放人工智能研究所） 用于MCP-SDK
社区以获取反馈和贡献

🔗 链接

DataForSEO API官方API文档
模型上下文协议MCP规范
Claude Desktop（中文可译为“克劳德桌面版”或根据具体语境简化为“克劳德桌面”，但通常直接保留原名以体现品牌特色）Claude Desktop 下载
****源代码

______________________________________________________________________

Yourank MCP

快速接入

详细介绍

🚀 DataForSEO MCP 服务器 TypeScript

📋 这个MCP服务器是什么？

🎯 主要目的

🏗️ 建筑与功能

核心组件

交通选择

模块化建筑

🚀 快速启动

前提条件

安装

配置

1. 设置环境变量

2. Claude Desktop 配置

启动服务器

💡 实际案例

示例1：分析反向链接

示例2：搜索关键词

示例3：搜索结果页面（SERP）分析

🔧 可用的工具与API

关键词数据API 🔍

反向链接API 🔗

SERP API 🔎

页面内API 📄

业务数据API 🏢

内容生成API ✍️

域名分析API 🌐

应用数据API 📱

商户API 🛒

人工智能优化API 🤖

🔌 通过HTTP/JSON-RPC进行通信

JSON-RPC 2.0 协议

请求格式

响应格式

可用的方法

HTTP端点

认证

错误处理

🔌 与AI助手的集成

Claude Desktop（推荐）✅

ChatGPT（实验性）⚠️

自定义集成 🔧

📊 性能与扩展性

优化

监测

🛠️ 开发与扩展

项目结构

添加新模块

写测试（或：做测试）

🔒 安全与最佳实践

API安全

部署安全

📚 文档与资源

完整的文档

测试提示（或测试指令）

模式与配置

🤝 贡献与支持

贡献

支持

社区

📄 许可证

🙏 致谢

🔗 链接

目录标签

接入字段

权限和风险

来源信息

继续浏览同类 MCP