
SiteData MCP
io.github.shineforeverPublished by GitHub account shineforeverv0.1.0Updated Oct 24, 2026
Website traffic, DR growth and payment rankings; manage website and keyword favorites via OAuth.
Overview
A remote MCP server that lets an assistant query SiteData website rankings and manage the signed-in account's website and keyword favorites.
- What you can do
- Query traffic growth, Domain Rating growth and payment traffic rankings, filtered by current or archived month, new sites, payment gateway and tags, in a chosen response language. List, add, update and delete website and keyword favorites, and create, rename or delete favorite folders. Read-only ranking queries return full results without pagination.
- When to use it
- Useful when you want an AI client to pull SiteData leaderboards for site research or competitor tracking, or to keep your SiteData favorites and folders up to date from a chat session. It suits users who already have a SiteData account and, for rankings, a paid membership.
- Requirements
- A remote Streamable HTTP endpoint added to a client that supports browser OAuth for remote MCP servers. Sign-in with a SiteData account through browser authorization with the mcp:invoke scope; no API key is needed. Ranking queries require an active paid SiteData membership on the authorized account.
Installation
In SourceWeft
- Open SiteData MCP in the dashboard and add it to a workspace.
- Connect the required credentials. They are stored privately and never shown on public pages.
- Enable the server for the chats that should use its tools.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Use with an agent
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/io.github.shineforever%2Fsitedata-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Other MCP clients
Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.
{
"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 粘贴到客户端。
Source: README.md at commit 09d104b
Tools
0Version history
1- v0.1.0LatestOct 12, 2026
Score
75% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
- Reached in the last 30 daysRequired25 pts
- Auth declaredRequired10 pts
- Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
- DescriptionRequired15 pts
- Logo10 pts
- Documentation15 pts
- License10 pts
Declare a license in the repository or the registry entry.