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.

已驗證Streamable HTTP可網頁執行網頁搜尋與抓取資料與分析

概覽

AI 產生的概覽

一個遠端 MCP 伺服器,讓助理查詢 SiteData 網站排行榜,並管理已授權帳戶的網站與關鍵字收藏。

可以做什麼
查詢流量成長、Domain Rating 成長與支付流量排行榜,可依目前或歷史月份、新網站、支付閘道與標籤篩選,並選擇回應語言。列出、新增、更新與刪除網站及關鍵字收藏,以及建立、重新命名與刪除收藏夾。排行榜查詢為唯讀,回傳完整結果,不分頁。
適用情境
適合想讓 AI 用戶端取得 SiteData 排行榜以進行網站研究或競品追蹤,或在對話中維護 SiteData 收藏與收藏夾的使用者。適用於已有 SiteData 帳戶,且查詢排行榜需要付費會員的使用者。
執行需求
需要在支援遠端 MCP 瀏覽器 OAuth 的用戶端中加入遠端 Streamable HTTP 端點。使用 SiteData 帳戶透過瀏覽器授權登入,scope 為 mcp:invoke,無需 API Key。排行榜查詢要求授權帳戶具有有效的 SiteData 付費會員。
安裝前請注意
授權會綁定目前登入的 SiteData 帳戶,並可存取其收藏。收藏工具整體可寫入:add、update、delete、create_folder、rename_folder 與 delete_folder 會修改或刪除帳戶資料,執行前應核對操作與目標。排行榜存取依賴付費會員,可能涉及訂閱或升級費用。用戶端可能在首次呼叫或寫入操作時要求確認。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 SiteData MCP,將其新增到工作區。
  2. 連接 所需的 憑證。它們會被私密儲存,絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

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,只需在浏览器确认授权自己添加 MCP,并按客户端提示完成授权

一句话 Prompt 自动安装

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

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

Codex 自动安装提示词
text
请直接在当前这台电脑完成 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 是否成功、已明确需要重启当前会话。不要回显任何凭据。
Claude Code(CC)自动安装提示词
text
请直接在当前这台电脑完成 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 是否成功、已明确需要重启当前会话。
Cursor 自动安装提示词
text
请直接在当前 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
bash
codex mcp add sitedata --url https://mcp.sitedata.dev/mcpcodex mcp login sitedata --scopes mcp:invokecodex mcp list

Codex 通常会自动打开浏览器开始登录;第二条命令也可用于之后重新登录。

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)
bash
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,添加:

json
{  "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 中添加:

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

启动 OpenCode 后按提示完成授权;如果需要手动登录:

bash
opencode mcp auth sitedata
其他 AI 客户端

添加远程 Streamable HTTP MCP 服务 https://mcp.sitedata.dev/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 需要查询什么,不必记住工具名称。例如:

text
通过 SiteData 查询本月新出现的网站流量增长榜
text
通过 SiteData 查询 2026-07 的 Domain Rating 增长榜
text
通过 SiteData 列出我收藏的域名
text
把 example.com 添加到我的网站收藏,并备注“竞品”

客户端会自动选择工具。首次调用或收藏写操作可能显示 Allow / Approve 确认。

工具

工具清单优先从 SiteData 平台的 /api/v1/mcp/catalog 动态加载;平台暂时不可用时使用本仓库内置清单。动态清单是实际参数的最终依据。

工具能力权限提示
sitedata_rankings查询流量增长、Domain Rating 增长和支付流量排行榜;支持当前/历史月份、新网站、支付网关及标签筛选只读;要求有效付费会员;返回完整结果,不分页
sitedata_favorites查询、新增、更新、删除网站/关键词收藏及收藏夹工具整体可写且可能删除数据;执行前检查 action

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 为例:

bash
codex mcp logout sitedatacodex mcp remove sitedata

第一条清除 OAuth 凭据;不再需要服务器时再执行第二条。其他客户端请在各自的 MCP 设置中退出登录、撤销认证或删除服务器。

常见问题

为什么授权后会跳到 localhost 或 127.0.0.1?

这是本地客户端接收授权结果的 loopback 回调地址,属于正常流程。页面提示认证完成后即可关闭。

为什么没有打开登录页面?

浏览器中已经登录 SiteData 时,可能直接进入授权确认页。如果客户端没有打开浏览器,请使用其登录入口。例如:

bash
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 粘贴到客户端。

來源:README.md,提交 09d104b

工具

0
該伺服器需要登入,因此 SourceWeft 無法在沒有帳號的情況下讀取其工具,也未收錄。已連接帳號所能看到的內容可能因帳號及其權限而異。

版本歷史

1
  1. v0.1.0最新Oct 12, 2026

評分

已滿足適用檢查項的 75%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。