seo-tools

@seodesignlab/mcp-server

面向 SEODesignLab 受 x402 保护的 SEO 端点的 MCP（Model Context Protocol）服务。

向任何兼容 MCP 的 AI Agent（Claude Desktop、Cursor、VS Code Copilot 等）提供专业 SEO 工具——内容简报、关键词研究、SERP 分析、反向链接资料和页面 SEO 审核，并在 Base 上自动处理 x402 微支付。

---

工具

工具	端点	价格	描述
get_content_brief	/api/briefs/	$2.00	生成 POP 内容简报，包含关键词分析、LSI 词项和内容结构
keyword_research	/api/dataforseo/keywords/	$1.50	查询关键词的搜索量、CPC 和竞争难度
serp_analysis	/api/dataforseo/serp/	$2.00	获取前 10 个自然搜索结果及域名指标和 SERP 功能
backlink_profile	/api/dataforseo/backlinks/	$3.00	获取引荐域名、链接指标和锚文本分布
on_page_audit	/api/dataforseo/audit/	$2.50	全面的页面 SEO 审核——元数据、标题、图片、链接、速度

所有价格均以 Base 上的 USDC 计价，并通过 x402 protocol 结算。

---

快速开始

安装

npm install @seodesignlab/mcp-server
# or
npx @seodesignlab/mcp-server

环境变量

变量	默认值	描述
SEO_API_BASE	https://seodesignlab-paywall.seodesignlab.workers.dev	SEO API 的基础 URL（CF Worker 付费墙）
X402_PAY_TO	(无)	用于 x402 支付的 Base 钱包地址。设置后会自动附加支付标头。
X402_NETWORK	base	x402 结算所用的网络

---

配置

Claude Desktop

将以下内容添加到你的 claude_desktop_config.json：

{
  "mcpServers": {
    "seodesignlab-seo": {
      "command": "npx",
      "args": ["-y", "@seodesignlab/mcp-server"],
      "env": {
        "SEO_API_BASE": "https://seodesignlab-paywall.seodesignlab.workers.dev",
        "X402_PAY_TO": "0xc78e3D02622061961156a18E10bbbF07d8e94529",
        "X402_NETWORK": "base"
      }
    }
  }
}

配置文件位置：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

Cursor

将以下内容添加到 Cursor MCP 设置（项目根目录下的 .cursor/mcp.json 或全局设置）：

{
  "mcpServers": {
    "seodesignlab-seo": {
      "command": "npx",
      "args": ["-y", "@seodesignlab/mcp-server"],
      "env": {
        "SEO_API_BASE": "https://seodesignlab-paywall.seodesignlab.workers.dev",
        "X402_PAY_TO": "0xc78e3D02622061961156a18E10bbbF07d8e94529",
        "X402_NETWORK": "base"
      }
    }
  }
}

VS Code（Copilot）

将以下内容添加到 VS Code MCP 设置（.vscode/mcp.json）：

{
  "servers": {
    "seodesignlab-seo": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@seodesignlab/mcp-server"],
      "env": {
        "SEO_API_BASE": "https://seodesignlab-paywall.seodesignlab.workers.dev",
        "X402_PAY_TO": "0xc78e3D02622061961156a18E10bbbF07d8e94529",
        "X402_NETWORK": "base"
      }
    }
  }
}

---

使用示例

配置完成后，SEO 工具会自动显示在你的 AI Agent 中。只需提出要求：

内容简报

Generate a content brief for "HVAC repair Brooklyn"

→ 调用 get_content_brief → 返回 POP 简报，包含 LSI 词项、目标字数和标题结构。

关键词研究

What's the search volume and CPC for "roofing contractor Tampa"?

→ 调用 keyword_research → 返回月搜索量、CPC 和竞争分数。

SERP 分析

Show me the top 10 results for "dentist near me" in Rockville Centre

→ 调用 serp_analysis → 返回前 10 个结果及域名权威度、标题和描述。

反向链接资料

Analyze the backlink profile of seodesignlab.com

→ 调用 backlink_profile → 返回引荐域名、链接数量和域名评级。

页面 SEO 审核

Audit https://drbrattrvc.com/services/teeth-whitening/

→ 调用 on_page_audit → 返回元数据分析、标题结构、图片覆盖情况和技术问题。

---

x402 支付流程

AI Agent (Claude, Cursor, etc.)
    │
    ▼
MCP Server (this package)
    │
    ▼  Adds X-Payment-* headers
Cloudflare Worker (x402 paywall)
    │
    ├── Payment valid? ──► YES ──► Proxy to SEO API ──► Return data
    │
    └── No payment? ──► 402 + x402 settlement instructions

配置 X402_PAY_TO 后，MCP 服务会为每个请求附加支付标头。Cloudflare Worker 会验证 x402 支付，并执行以下操作之一：

1. 已付款 → 将请求转发至 Render 上的 SEO 后端，并返回结果。
2. 未付款 → 返回 402 Payment Required，其中包含价格、钱包地址和结算说明。

x402 客户端集成

在生产环境中，请将此 MCP 服务与能够自动结算微支付的 x402-compatible client 搭配使用。此服务的设计不依赖特定支付方式——无论是否使用 x402 客户端，都可以正常工作。

---

API 端点

MCP 服务会将请求代理到 SEO_API_BASE 上的以下后端端点：

POST /api/briefs/

请求：

{
  "keyword": "HVAC repair Brooklyn",
  "location": "United States",
  "language": "en"
}

**响应：**完整的 POP 内容简报，包含关键词分析、LSI 词项和推荐结构。

POST /api/dataforseo/keywords/

请求：

{
  "keyword": "roofing contractor Tampa",
  "location": "United States",
  "language": "en"
}

**响应：**搜索量、CPC、竞争情况和相关关键词。

POST /api/dataforseo/serp/

请求：

{
  "keyword": "dentist near me",
  "location": "United States",
  "language": "en"
}

**响应：**前 10 个自然搜索结果，包含标题、URL、描述和域名指标。

POST /api/dataforseo/backlinks/

请求：

{
  "domain": "seodesignlab.com"
}

响应： 引荐域名、反向链接数量、域名评级、锚文本分布。

POST /api/dataforseo/audit/

请求：

{
  "url": "https://drbrattrvc.com/services/teeth-whitening/"
}

响应： Meta 标题/描述分析、标题结构、图片 alt 覆盖率、链接数量、页面速度、内容质量、技术问题。

---

开发

# Install dependencies
npm install

# Build
npm run build

# Run locally (stdio transport)
npm run dev

# Type check
npx tsc --noEmit

使用 MCP Inspector 进行测试

npx @modelcontextprotocol/inspector node dist/index.js

---

发布

⚠️ 暂勿发布！ 请等待 Cloudflare Worker 付费墙部署并上线。

准备就绪后：

npm run build
npm publish --access public

---

许可证

MIT © SEODesignLab