SiteData MCP server

SiteData MCP

English | 中文

让 Codex、Claude Code（CC）、Cursor、WorkBuddy、OpenCode 和其他支持远程 HTTP MCP 的 AI 客户端直接查询 SiteData 排行榜，并管理当前账户的网站与关键词收藏。

• MCP 地址：https://mcp.sitedata.dev/mcp
• OAuth scope：mcp:invoke
• 使用 SiteData 账户登录授权，无需创建或复制 API Key
• 排行榜查询要求授权账户具有有效的 SiteData 付费会员
• 普通用户无需下载本仓库、安装依赖或运行本地服务

安装 SiteData MCP

一句话 Prompt 自动安装

如果不想手动执行命令或编辑配置，可以把对应客户端的提示词完整发送给该客户端中的本机 Agent。用户只需在浏览器中登录 SiteData 并确认授权；Agent 不应要求用户复制授权码、回调地址或任何配置。

下面的提示词要求 Agent 先检查客户端的实际版本和命令帮助。不同版本能力不一致时，应以本机真实能力为准，不得猜测不存在的命令或参数。

Codex 自动安装提示词

请直接在当前这台电脑完成 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 会话或客户端一次，然后停止。重

Claude Code（CC）自动安装提示词

请直接在当前这台电脑完成 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. 提醒我重启

Shortened. The full README is on GitHub.