SiteData MCP

SiteData MCP

English | 中文

Codex、Claude Code（CC）、Cursor、WorkBuddy、OpenCode およびその他のリモート HTTP MCP 対応 AI クライアントから SiteData のランキングを直接検索し、現在のアカウントのウェブサイトやキーワードのお気に入りを管理できます。

• MCP アドレス：https://mcp.sitedata.dev/mcp
• OAuth スコープ：mcp:invoke
• SiteData アカウントでログインして認証できます。API Key の作成やコピーは不要です
• ランキングの検索には、認証アカウントに有効な SiteData 有料会員資格が必要です
• 通常のユーザーは、このリポジトリのダウンロード、依存関係のインストール、ローカルサービスの実行は不要です

SiteData MCP のインストール

プロンプト一言で自動インストール

コマンドの手動実行や設定の編集を避けたい場合は、該当クライアントのプロンプト全文を、そのクライアント内のローカルエージェントに送信してください。ユーザーはブラウザーで SiteData にログインして認証を確認するだけです。エージェントは、認証コード、コールバックアドレス、その他の設定をユーザーにコピーするよう求めてはいけません。

以下のプロンプトでは、エージェントにクライアントの実際のバージョンとコマンドのヘルプを先に確認するよう求めています。バージョンによって機能に違いがある場合は、ローカル環境で実際に利用できる機能に従い、存在しないコマンドやパラメーターを推測してはいけません。

请直接在当前这台电脑完成 SiteData MCP OAuth 2.1 + PKCE 接入。我只会在浏览器确认授权；不要让我再粘贴命令、JSON、authorization code 或回调地址。

目标客户端：Codex
连接名称："sitedata"
MCP 地址："https://mcp.sitedata.dev/mcp"
OAuth scope："mcp:invoke"
运行位置：本机 Agent

请连续执行到需要重启为止：
1. 确认当前宿主确实是 Codex，并判断它运行在 Windows 原生、WSL、macOS 还是 Linux。配置和 OAuth 必须在当前 Codex 实际运行的同一环境完成，禁止跨 Windows 用户目录和 WSL Home 写入配置。Codex 客户端与 CLI 处于同一环境时共用 MCP 配置，不要重复添加。
2. 定位当前宿主实际使用的 codex 可执行文件绝对路径并读取版本；后续所有 Codex 命令均使用该路径。如果当前宿主没有可用 CLI，但提供官方 MCP 设置或宿主 API，则在同一配置域完成等价操作，不得编造命令。
3. 把连接名称、MCP 地址和 scope 作为纯数据处理。调用进程时使用参数数组，不拼接 shell 字符串；执行 shell 前关闭 xtrace。
4. 先使用参数数组 ["mcp","get","sitedata"] 检查连接。仅当连接不存在时，使用 ["mcp","add","sitedata","--url","https://mcp.sitedata.dev/mcp"] 添加。已有唯一同名连接且 URL 逐字正确时保留；URL 不一致或同名来源不唯一时停止并准确报告，不得覆盖。SiteData 支持动态客户端注册，不要虚构或写入固定 client_id、client_secret、认证请求头或 Token。
5. 检查认证状态及是否已有等待中的授权流程。配置、探测或添加操作已经触发 OAuth 时，只等待该流程。只有明确未认证或凭据失效且没有活动流程时，才使用 ["mcp","login","sitedata","--scopes","mcp:invoke"]；本次最多发起一次 OAuth。
6. 让登录进程打开本机默认浏览器并等待我登录 SiteData、选择账户及确认授权。由当前 Codex 环境自动接收 loopback 回调；不要让我复制 authorization code、authorization URL、callback 地址或第二段提示词，也不要自行拼接授权 URL。
7. OAuth 成功后，只确认登录进程正常退出和配置已持久化；不要在旧会话再次探测状态、重复登录或调用 MCP 工具。
8. 提醒我重启当前 Codex 会话或客户端一次，然后停止。重启后列出 sitedata 工具；只有 schema 与预期一致时，才调用 sitedata_favorites，参数严格限定为 {"action":"list","kind":"all"} 验证连接，不得改用任何写操作。
9. 全程不得在对话、日志、命令回显或普通配置中暴露 access_token、refresh_token、authorization code、authorization URL、code_challenge、code_verifier、client_secret、Cookie 或 callback_uri。敏感输出只能静默处理，只汇报状态。
10. 到达重启点后只汇报：Codex 运行环境与版本、修改的配置位置、一次 OAuth 是否成功、已明确需要重启当前会话。不要回显任何凭据。

请直接在当前这台电脑完成 SiteData MCP OAuth 2.1 + PKCE 接入。我只会在浏览器确认授权；不要让我再粘贴命令、JSON、authorization code 或回调地址。

目标客户端：Claude Code
连接名称："sitedata"
MCP 地址："https://mcp.sitedata.dev/mcp"
OAuth scope："mcp:invoke"
运行位置：本机 Agent

请连续执行到需要重启为止：
1. 确认当前宿主是 Claude Code CLI 或 Claude Desktop 的 Code 页签。Claude Desktop 普通聊天窗口使用另一套连接器配置；如果当前不是 Claude Code，立即停止，不要写入错误产品。
2. 判断 Claude Code 实际运行在 Windows 原生、Git Bash、WSL、macOS 还是 Linux。配置和 OAuth 必须在同一环境完成，禁止跨 Windows 用户目录和 WSL Home 写入。
3. 定位当前宿主实际使用的 claude 可执行文件绝对路径并读取版本；后续命令始终使用该路径。
4. 把连接名称、MCP 地址和 scope 作为纯数据处理。调用进程时使用参数数组，不拼接 shell 字符串；执行 shell 前关闭 xtrace。
5. 检查 claude mcp --help、claude mcp add --help，再用 ["mcp","list"] 检查所有可见连接。仅当连接不存在且帮助确认参数可用时，使用 ["mcp","add","--transport","http","--scope","user","sitedata","https://mcp.sitedata.dev/mcp"] 添加。已有唯一同名连接且 URL 正确时保留；URL 不一致或同名来源不唯一时停止。不要虚构或写入固定 client_id、client_secret、认证请求头或 Token。
6. 检查 claude mcp login --help 和连接状态。只有明确未认证或凭据失效且没有活动流程时才登录，本次最多一次。若当前版本真实提供 mcp login，则把 sitedata 作为独立参数，并仅在帮助明确支持时请求 mcp:invoke；否则使用 Claude Code 当前真实存在的 /mcp 认证入口，不得手工实现 DCR/PKCE。
7. 让 Claude Code 打开本机默认浏览器并等待我登录 SiteData、选择账户及确认授权。由当前环境接收 loopback 回调；不要让我复制任何授权码、授权 URL 或回调地址。
8. 授权成功后，只确认流程正常结束和配置已持久化；不要在旧会话重复探测、登录或调用工具。
9. 提醒我重启当前 Claude Code 会话或客户端一次，然后停止。重启后列出工具；只有 schema 一致时，才调用 sitedata_favorites，参数严格限定为 {"action":"list","kind":"all"}，不得执行写操作。
10. 全程不得暴露 access_token、refresh_token、authorization code、authorization URL、code_challenge、code_verifier、client_secret、Cookie 或 callback_uri，只汇报状态。
11. 到达重启点后只汇报：Claude Code 运行环境与版本、修改的配置位置、一次 OAuth 是否成功、已明确需要重启当前会话。

请直接在当前 Windows 或 macOS 的 Cursor 桌面端完成 SiteData MCP 接入，并让 Cursor 根据 MCP/OAuth 元数据管理 OAuth 2.1 + PKCE。我只会在浏览器确认授权；不要手工配置 DCR、PKCE、client_id 或回调地址。

目标客户端：Cursor 桌面端
连接名称："sitedata"
MCP 地址："https://mcp.sitedata.dev/mcp"
OAuth scope："mcp:invoke"

请按 Cursor 当前实际能力连续执行：
1. 确认宿主确实是 Windows 或 macOS 的 Cursor 桌面端，并确认 Cursor、当前 Agent 和工作区处于同一可验证配置域。WSL、SSH、Dev Container、原生 Linux 和 Cloud Agents 不能证明本机桌面端已完成接入。
2. 优先使用 Cursor 的 Customize → MCP 设置。只有 agent mcp --help 明确证明相关 CLI 和参数存在时才使用 CLI。检查所有来源中的 identifier、URL、启用状态和连接状态；同名候选不唯一时停止并请我选择作用域。如果 Agent 不能操作 Cursor UI，在需要 UI 时暂停，不得声称已操作。
3. 只有目标不存在时，才把下面的 URL-only 配置合并到确认生效的 mcp.json。已有唯一同名条目时先确认 URL 逐字一致并保留未知字段；URL 不一致、含固定 auth/headers、来源为 team/marketplace 或字段含义不明时停止。不得跨系统、用户或环境写入，不覆盖其他服务器，不写固定认证参数：
{
  "mcpServers": {
    "sitedata": {
      "url": "https://mcp.sitedata.dev/mcp"
    }
  }
}
4. 保存后确认 sitedata 已启用且生效来源正确。只有 CLI 帮助明确提供 enable 时才使用 CLI，否则在 Customize → MCP 中启用。
5. 使用当前版本真实提供的登录入口。只有 agent mcp --help 明确提供 login 时才通过 CLI 登录，否则在 Customize → MCP 中登录。让 Cursor 从 MCP 受保护资源元数据发现授权服务器和 mcp:invoke scope，并通过动态客户端注册管理 OAuth。
6. 已有有效连接直接复用；已有活动授权流程只等待当前流程。只有明确未认证且没有活动流程时才登录，本次最多一次。浏览器登录、账户选择、2FA/CAPTCHA 和最终授权由我完成。不得复制或回显授权 URL、code、callback、state、verifier 或 Token。
7. 授权成功后刷新 MCP 列表；无法热加载时提示我保存工作，再由我重启 Cursor 或新建会话一次。不要杀进程或重复登录。
8. 刷新或重启后确认 sitedata_rankings 和 sitedata_favorites 已加载。先核对 endpoint，再只允许调用 sitedata_favorites，参数严格限定为 {"action":"list","kind":"all"} 验证连接，不得使用写操作。工具或 schema 不一致时停止。
9. 全程不得复制、回显或持久化 access_token、refresh_token、authorization code、authorization URL、request_id、code_challenge、code_verifier、client_secret、Cookie 或 callback_uri。
10. 只有 identifier、source、URL、配置、启用状态、OAuth、工具可见性和只读收藏查询均已验证，才报告安装完成；否则准确说明阻塞步骤，不回显收藏内容或凭据。

手動インストール

1. クライアントに SiteData MCP を追加する

Codex CLI

codex mcp add sitedata --url https://mcp.sitedata.dev/mcp
codex mcp login sitedata --scopes mcp:invoke
codex mcp list

通常、Codex はブラウザーを自動的に開いてログインを開始します。2 つ目のコマンドは、後で再ログインする場合にも使用できます。

ChatGPT デスクトップ版、Codex デスクトップ版、または IDE 拡張機能

1. Settings → MCP servers を開きます。
2. Add server を選択します。
3. 種類に Streamable HTTP を選択し、名前に sitedata を入力します。
4. URL に https://mcp.sitedata.dev/mcp を入力します。
5. 保存し、クライアントまたは拡張機能の再起動を求められた場合は、その指示に従います。
6. Authenticate を選択し、ログイン認証を完了します。

同じ Codex ホスト上の ChatGPT デスクトップ版、Codex CLI、IDE 拡張機能では、MCP 設定が共有されます。

Claude Code（CC）

claude mcp add --transport http --scope user sitedata https://mcp.sitedata.dev/mcp

次に、Claude Code で /mcp を入力し、sitedata を選択してログイン認証を完了します。

Cursor

Cursor Settings → Tools & MCP → New MCP Server を開き、次を追加します。

{
  "mcpServers": {
    "sitedata": {
      "url": "https://mcp.sitedata.dev/mcp"
    }
  }
}

設定を保存し、MCP の一覧で sitedata を有効にしてから、指示に従ってブラウザーで認証を完了します。

WorkBuddy

WorkBuddy の MCP 設定で、sitedata という名前のリモート Streamable HTTP サービスを追加し、URL に https://mcp.sitedata.dev/mcp を入力します。保存後、ブラウザーで認証を完了します。

OpenCode

opencode.json に次を追加します。

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "sitedata": {
      "type": "remote",
      "url": "https://mcp.sitedata.dev/mcp",
      "enabled": true
    }
  }
}

OpenCode を起動し、指示に従って認証を完了します。手動でログインする場合は、次を実行します。

opencode mcp auth sitedata

その他の AI クライアント

https://mcp.sitedata.dev/mcp を、リモート Streamable HTTP MCP サービスとして追加します。クライアントは、リモート MCP のブラウザー OAuth ログインに対応している必要があります。

2. ログインして認証する

MCP を追加すると、クライアントが SiteData の認証ページを開きます。

1. まだログインしていない場合は、SiteData アカウントにログインします。
2. クライアント名、要求された権限、リダイレクト先を確認します。
3. Authorize / 認証 をクリックします。
4. ブラウザーがローカルの localhost または 127.0.0.1 のコールバックページに戻ったら、認証が完了するまで待ちます。
5. ページに Authentication complete. You may close this window. と表示されたら、閉じてかまいません。
6. Codex に Successfully logged in. と表示されれば、接続成功です。

認証は、現在ログインしている SiteData アカウントに紐づきます。クライアントが SiteData のパスワードや API Key を取得することはありません。

3. 最初の検索を行う

必要な検索内容を自然言語で AI に伝えるだけでかまいません。ツール名を覚える必要はありません。例：

通过 SiteData 查询本月新出现的网站流量增长榜

通过 SiteData 查询 2026-07 的 Domain Rating 增长榜

通过 SiteData 列出我收藏的域名

把 example.com 添加到我的网站收藏，并备注“竞品”

クライアントがツールを自動的に選択します。初回の呼び出しや、お気に入りへの書き込み操作では、Allow / Approve の確認が表示される場合があります。

ツール

ツール一覧は、SiteData プラットフォームの /api/v1/mcp/catalog から動的に読み込まれます。プラットフォームを一時的に利用できない場合は、このリポジトリに組み込まれた一覧が使用されます。実際のパラメーターについては、動的に取得した一覧が最終的な基準となります。

sitedata_rankings

• 必須の rankingType：traffic_growth、domain_rating_growth、または payment_traffic
• period：current または archive
• month：過去のランキングの月。形式は YYYY-MM です。period=archive の場合は必須です
• newSites：新たに発見されたウェブサイトのみを返します
• gateway：payment_traffic で使用する決済ゲートウェイコード
• locale：レスポンスの言語
• tagType：category、use_case、site_type、business_model、または affiliate_program
• tagCode：タグコード。tagType と併せて指定する必要があります

sitedata_favorites

• 必須の action：list、add、update、delete、create_folder、rename_folder、または delete_folder
• kind：all、website、または keyword
• id：お気に入りまたはお気に入りフォルダーの ID
• domain：ウェブサイトのお気に入りのドメイン
• keyword：お気に入りに登録するキーワード
• remark：お気に入りのメモ
• folderId：お気に入りフォルダーの ID。お気に入りの更新時に空文字列を指定すると、フォルダーから削除されます
• name：お気に入りフォルダーの作成時または名前の変更時に指定する名前

add、update、delete、create_folder、rename_folder、delete_folder はアカウントのデータを変更します。実行前に対象を明確にして確認してください。

会員資格とアクセス権

• sitedata_rankings の呼び出しには、有効な有料会員資格が必要です。
• 有効な会員資格がない場合、ツールは会員資格の要件と SiteData のサブスクリプション／アップグレードページ を返します。
• 会員資格が有効になった後は、既存の MCP 認証を引き続き使用できます。再インストールや再ログインは不要です。
• お気に入りの管理には、現在認証されているアカウントのデータのみが使用されます。

認証の管理または取り消し

接続は、認証を開始したクライアントで管理してください。Codex CLI の場合は、次のとおりです。

codex mcp logout sitedata
codex mcp remove sitedata

1 つ目のコマンドは OAuth 認証情報を削除します。サーバーが不要になった場合にのみ、2 つ目のコマンドを実行してください。その他のクライアントでは、それぞれの MCP 設定からログアウト、認証の取り消し、またはサーバーの削除を行ってください。

よくある質問

認証後に localhost または 127.0.0.1 に移動するのはなぜですか？

これは、ローカルクライアントが認証結果を受け取るためのループバックコールバックアドレスです。正常な動作です。ページに認証完了と表示されたら閉じてかまいません。

ログインページが開かないのはなぜですか？

ブラウザーで SiteData にすでにログインしている場合、認証確認ページに直接移動することがあります。クライアントがブラウザーを開かない場合は、クライアントのログイン機能を使用してください。例：

codex mcp login sitedata --scopes mcp:invoke

授权成功后为什么看不到工具？

重启客户端或重新打开会话，然后检查 MCP 连接。Codex CLI 可执行 codex mcp list。正常情况下会看到 sitedata_rankings 和 sitedata_favorites。

为什么排行榜查询提示需要会员？

排行榜只对有效付费会员开放。请确认授权账户，并为同一账户开通或升级会员。会员生效后无需重新授权。

为什么收藏操作要求确认？

sitedata_favorites 同时包含读取和写入操作，客户端可能把整个工具标记为可写或具有删除风险。只查看数据时请明确要求 action=list；写入前请核对操作和目标。

需要创建 SiteData API Key 吗？

不需要。MCP 使用浏览器 OAuth 登录授权，不会要求你把 API Key 粘贴到客户端。