seo-tools

@seodesignlab/mcp-server

SEODesignLab の x402 で保護された SEO エンドポイント向けの MCP（Model Context Protocol）サーバーです。

コンテンツブリーフ、キーワード調査、SERP 分析、バックリンクプロファイル、オンページ監査などのプロフェッショナルな SEO ツールを、Base 上での x402 マイクロペイメント処理を自動化し、MCP 対応のあらゆる AI エージェント（Claude Desktop、Cursor、VS Code Copilot など）に提供します。

---

ツール

ツール	エンドポイント	価格	説明
get_content_brief	/api/briefs/	$2.00	キーワード分析、LSI 用語、コンテンツ構成を含む POP コンテンツブリーフを生成します
keyword_research	/api/dataforseo/keywords/	$1.50	キーワードの検索ボリューム、CPC、競合難易度を取得します
serp_analysis	/api/dataforseo/serp/	$2.00	ドメイン指標と SERP 機能を含む、オーガニック検索結果上位 10 件を取得します
backlink_profile	/api/dataforseo/backlinks/	$3.00	参照ドメイン、リンク指標、アンカーテキストの分布を取得します
on_page_audit	/api/dataforseo/audit/	$2.50	メタ情報、見出し、画像、リンク、速度を含む、オンページ SEO の完全な監査を行います

すべての価格はBase 上の USDCで、x402 プロトコルを介して決済されます。

---

クイックスタート

インストール

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	(none)	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 エージェントに自動的に表示されます。次のように尋ねるだけです。

コンテンツブリーフ

Generate a content brief for "HVAC repair Brooklyn"

→ get_content_brief を呼び出し → LSI 用語、目標文字数、見出し構成を含む POP ブリーフを返します。

キーワード調査

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 を呼び出し → 参照ドメイン、リンク数、ドメインレーティングを返します。

オンページ監査

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 クライアントとの統合

本番環境では、マイクロペイメントを自動決済できる x402 対応クライアントとこの MCP サーバーを組み合わせてください。このサーバーは決済方式に依存しないよう設計されており、x402 クライアントの有無にかかわらず動作します。

---

API エンドポイント

MCP サーバーは、SEO_API_BASE にある次のバックエンドエンドポイントにリクエストをプロキシします。

POST /api/briefs/

リクエスト：

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

レスポンス： キーワード分析、LSI 用語、推奨構成を含む、完全な POP コンテンツブリーフです。

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

レスポンス： タイトル、URL、説明文、ドメイン指標を含む、オーガニック検索結果上位 10 件です。

POST /api/dataforseo/backlinks/

リクエスト：

{
  "domain": "seodesignlab.com"
}

レスポンス： 参照ドメイン、被リンク数、ドメイン評価、アンカーテキストの分布。

POST /api/dataforseo/audit/

リクエスト：

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

レスポンス： メタタイトル／メタディスクリプションの分析、見出し構造、画像の 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