
SiteData MCP
io.github.shineforever由 GitHub 账号 shineforever 发布v0.1.0更新于 Oct 24, 2026
Website traffic, DR growth and payment rankings; manage website and keyword favorites via OAuth.
概览
一个远程 MCP 服务器,让助手查询 SiteData 网站排行榜,并管理已授权账户的网站与关键词收藏。
- 可以做什么
- 查询流量增长、Domain Rating 增长和支付流量排行榜,可按当前或历史月份、新网站、支付网关和标签筛选,并选择响应语言。列出、新增、更新和删除网站与关键词收藏,以及新建、重命名和删除收藏夹。排行榜查询为只读,返回完整结果,不分页。
- 适用场景
- 适合希望让 AI 客户端获取 SiteData 排行榜用于网站调研或竞品跟踪,或在对话中维护 SiteData 收藏与收藏夹的用户。适用于已有 SiteData 账户、且查询排行榜需要付费会员的用户。
- 运行要求
- 需要在支持远程 MCP 浏览器 OAuth 的客户端中添加远程 Streamable HTTP 端点。使用 SiteData 账户通过浏览器授权登录,scope 为 mcp:invoke,无需 API Key。排行榜查询要求授权账户具有有效的 SiteData 付费会员。
安装
在 SourceWeft 中
- 打开 控制台中的 SiteData MCP,将其添加到工作区。
- 连接 所需的 凭据。它们会被私密存储,绝不会在公开页面上展示。
- 为需要使用其工具的对话启用该服务。
Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。
交给智能体安装
把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。
阅读 https://sourceweft.com/mcp/io.github.shineforever%2Fsitedata-mcp/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。其他 MCP 客户端
把它添加到你客户端的 mcpServers 配置中。 客户端会在首次连接时完成 OAuth 登录。
{
"mcpServers": {
"sitedata": {
"type": "http",
"url": "https://mcp.sitedata.dev/mcp"
}
}
}README
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 自动安装提示词
Claude Code(CC)自动安装提示词
Cursor 自动安装提示词
手动安装
1. 在客户端中添加 SiteData MCP
Codex CLI
Codex 通常会自动打开浏览器开始登录;第二条命令也可用于之后重新登录。
ChatGPT 桌面端、Codex 桌面端或 IDE 扩展
- 打开 Settings → MCP servers。
- 选择 Add server。
- 类型选择 Streamable HTTP,名称填写
sitedata。 - URL 填写
https://mcp.sitedata.dev/mcp。 - 保存并按提示重启客户端或扩展。
- 选择 Authenticate 完成登录授权。
同一 Codex 宿主中的 ChatGPT 桌面端、Codex CLI 和 IDE 扩展会共享 MCP 配置。
Claude Code(CC)
然后在 Claude Code 中输入 /mcp,选择 sitedata 并完成登录授权。
Cursor
打开 Cursor Settings → Tools & MCP → New MCP Server,添加:
保存配置,在 MCP 列表中启用 sitedata,然后按提示完成浏览器授权。
WorkBuddy
在 WorkBuddy 的 MCP 设置中添加名为 sitedata 的远程 Streamable HTTP 服务,URL 填写 https://mcp.sitedata.dev/mcp,保存后完成浏览器授权。
OpenCode
在 opencode.json 中添加:
启动 OpenCode 后按提示完成授权;如果需要手动登录:
其他 AI 客户端
添加远程 Streamable HTTP MCP 服务 https://mcp.sitedata.dev/mcp。客户端必须支持远程 MCP 的浏览器 OAuth 登录。
2. 登录并授权
添加 MCP 后,客户端会打开 SiteData 授权页面:
- 如果尚未登录,请先登录 SiteData 账户。
- 确认客户端名称、请求权限和返回地址。
- 点击 Authorize / 授权。
- 浏览器返回本机
localhost或127.0.0.1回调页后,等待授权完成。 - 页面显示
Authentication complete. You may close this window.后即可关闭。 - Codex 显示
Successfully logged in.即表示连接成功。
授权绑定当前登录的 SiteData 账户。客户端不会获得你的 SiteData 密码或 API Key。
3. 发起第一次查询
直接用自然语言告诉 AI 需要查询什么,不必记住工具名称。例如:
客户端会自动选择工具。首次调用或收藏写操作可能显示 Allow / Approve 确认。
工具
工具清单优先从 SiteData 平台的 /api/v1/mcp/catalog 动态加载;平台暂时不可用时使用本仓库内置清单。动态清单是实际参数的最终依据。
sitedata_rankings
- 必填
rankingType:traffic_growth、domain_rating_growth或payment_traffic period:current或archivemonth:历史榜单月份,格式YYYY-MM;period=archive时必填newSites:只返回新发现的网站gateway:payment_traffic使用的支付网关代码locale:响应语言tagType:category、use_case、site_type、business_model或affiliate_programtagCode:标签代码,必须与tagType一起使用
sitedata_favorites
- 必填
action:list、add、update、delete、create_folder、rename_folder或delete_folder kind:all、website或keywordid:收藏或收藏夹 IDdomain:网站收藏的域名keyword:关键词收藏内容remark:收藏备注folderId:收藏夹 ID;更新收藏时传空字符串可移出收藏夹name:新建或重命名收藏夹时的名称
add、update、delete、create_folder、rename_folder 和 delete_folder 会修改账户数据。执行前应明确并核对目标。
会员与访问权限
- 账户需要有效的付费会员才能调用
sitedata_rankings。 - 没有有效会员时,工具会返回会员要求以及 SiteData 订阅/升级页面。
- 会员生效后可继续使用现有 MCP 授权,无需重新安装或登录。
- 收藏管理只使用当前授权账户的数据。
管理或撤销授权
请在发起授权的客户端中管理连接。以 Codex CLI 为例:
第一条清除 OAuth 凭据;不再需要服务器时再执行第二条。其他客户端请在各自的 MCP 设置中退出登录、撤销认证或删除服务器。
常见问题
为什么授权后会跳到 localhost 或 127.0.0.1?
这是本地客户端接收授权结果的 loopback 回调地址,属于正常流程。页面提示认证完成后即可关闭。
为什么没有打开登录页面?
浏览器中已经登录 SiteData 时,可能直接进入授权确认页。如果客户端没有打开浏览器,请使用其登录入口。例如:
授权成功后为什么看不到工具?
重启客户端或重新打开会话,然后检查 MCP 连接。Codex CLI 可执行 codex mcp list。正常情况下会看到 sitedata_rankings 和 sitedata_favorites。
为什么排行榜查询提示需要会员?
排行榜只对有效付费会员开放。请确认授权账户,并为同一账户开通或升级会员。会员生效后无需重新授权。
为什么收藏操作要求确认?
sitedata_favorites 同时包含读取和写入操作,客户端可能把整个工具标记为可写或具有删除风险。只查看数据时请明确要求 action=list;写入前请核对操作和目标。
需要创建 SiteData API Key 吗?
不需要。MCP 使用浏览器 OAuth 登录授权,不会要求你把 API Key 粘贴到客户端。
来源:README.md,提交 09d104b
工具
0版本历史
1- v0.1.0最新Oct 12, 2026
评分
已满足适用检查项的 75%
该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。
- 近 30 天内可连通必需25 分
- 已声明认证方式必需10 分
- 已列出工具15 分
请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。
- 描述必需15 分
- 图标10 分
- 文档15 分
- 许可证10 分
请在仓库或注册中心条目中声明许可证。