FeedWatch

io.github.bruceonline2026由 GitHub 帳號 bruceonline2026 發布v0.1.0更新於 Oct 28, 2026

Monitor RSS/Atom/JSON feeds; alerts on new items AND edits to existing ones, with field-level diffs.

已驗證Streamable HTTP可網頁執行網頁搜尋與抓取安全與監控

概覽

AI 產生的概覽

遠端 MCP 端點,監控 RSS/Atom/JSON 訂閱源,在新條目出現及既有條目被修改時告警,並提供欄位級差異。

可以做什麼
  • 登記要監控的訂閱源網址(RSS、Atom 或 JSON Feed),由服務代為盯守。
  • 訂閱源出現新條目時發出提醒。
  • 偵測既有條目被修改的情況,例如新聞更正錯字或競品悄悄改價。
  • 提供欄位級差異,說明哪個欄位、從什麼值變成什麼值。
  • README 說明同一主機上提供 REST API 與 MCP 端點;清單未列出具體工具名稱。
適用情境
適合需要關注「既有內容被改動」而非僅「新增條目」的情境,例如新聞更正或競品價格變動。較適合對少量來源做持續監控,而非一次性閱讀。
執行需求
使用指定的遠端 MCP 端點,無需本機安裝。README 提到向客戶簽發 API Key 並設有限流與配額,免費層為 5 個監控點、6 小時頻率;但清單未宣告任何驗證方式、環境變數或請求標頭。
安裝前請注意
README 顯示這是處於驗證期的付費產品,涉及 API Key、配額與收款,可能需要帳號與付費安排。提交的訂閱源網址會由第三方服務抓取並保存。README 多為內部專案文件,未說明 MCP 工具介面細節。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 FeedWatch,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.bruceonline2026%2Ffeedwatch/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "feedwatch": {
      "type": "http",
      "url": "https://api.tiici.com/mcp"
    }
  }
}

README

FeedWatch MCP

RSS/Atom 变更监控 API + MCP Server 当前阶段:验证期准备(判定线:8 周内 5 个真实付费用户)

🌐 English version: README.en.md · 中文在下方


从这里开始

你想了解看这份
⭐ 现在什么状态、下一步做什么📋 工作计划与进展
整个项目长什么样📐 项目蓝图
开发要做什么💻 软件开发需求说明书
客户怎么用它📖 用户说明书
买服务器 + 部署🖥️ 服务器采购与部署手册
注册海外公司🏢 海外公司注册与维护手册
给客户签发API Key[🔑 API Key 管理与配额](docs/运营手册/API Key管理与配额.md)
自己先试用一遍🧪 内部测试指南
发布到MCP 生态🔌 MCP生态发布指南
收款开通(Payoneer)💳 Payoneer 收款链接操作手册
收款怎么配(通用)💰 收款与运营手册
为什么这么选📋 决策记录-收款与主体
改完代码要跑什么🧪 回归测试要求点清单
提交前自查(4 问 + 16 项检查)
踩过什么坑🔍 调试复盘
上线要查什么✅ 上线检查清单
状态字段什么意思🔢 状态字段语义

⚠️ 改代码前先看「回归测试要求点清单」 —— 里面有 89 项离线测试的覆盖现状、 19 项已知缺口、以及已证伪的 4 处错误「已验证」。 不要只看测试名声称覆盖了什么,要看它实际断言了什么。


一句话说明

客户把 RSS/Atom/JSON Feed 的网址交给我们,我们替他们盯着;内容变了就主动推送, 并精确告诉他哪个字段、从什么变成什么。

核心差异:竞品多数只能报"新增条目",我们能检测已有条目被修改并给出字段级 diff—— 新闻更正错字、竞品悄悄改价格,这些都不产生新条目,但恰恰是客户最需要知道的。


文档体系(四层结构)

docs/├── 架构/         【第 1 层】顶层设计│   └── 项目蓝图.md                整个项目 + 架构 + 外部资源 + 阶段路线│├── 需求/         【第 2 层】做什么│   ├── 软件开发需求说明书.md功能清单 + 验收标准 + 需求来源│   └── 用户说明书.md                客户视角的产品说明与使用场景│├── 运营手册/     【第 3 层】怎么操作│   ├── 服务器采购与部署手册.md       选型对比 + Vultr 注册购买 + Linux 部署│   ├── 海外公司注册与维护手册.md     香港公司注册 + 银行开户 + 后续维护│   ├── 内部测试指南.md              ⭐ 8 步实测流程(含MCP 与安全验证)│   ├── API Key管理与配额.md          ⭐ 签发 Key + 各项限流 + 配额口径核对│   ├── MCP生态发布指南.md            ⭐ 官方注册表 + 5 个目录收录方式│   ├── Payoneer收款链接操作手册.md   ⭐ 验证期收款开通(注意:非 Checkout)│   ├── 收款与运营手册.md            付费时机 + 收款配置 + 排障(第三部分已废弃)│   └── 部署配置与待办-Windows方案.md (已弃用,保留参考)│├── 决策/         【第 4 层】为什么这么选│   └── 决策记录-收款与主体.md       平台选型 + 主体时间线 + 被排除项(含 v2 纠错)│└── 复盘/         【第 5 层】经验沉淀    ├── 回归测试要求点清单.md         ⭐ 89 项测试覆盖现状 + 19 项缺口 + 最小回归集    ├── 调试复盘.md                 10 个缺陷 + 5 条交付规范 + 失误归因    ├── 上线检查清单.md             三阶段 checklist + B1–B6    ├── 状态字段语义.md             三状态正交表 + 错误码判读    └── 事故复盘/        └── 2026-10-13-www站点500事故复盘.md

分层判断标准

层回答什么问题变更频率
架构整个项目长什么样很少(季度级)
需求做什么功能、验收标准中(月级)
运营手册怎么一步步做高(跟着平台变化)
决策为什么这么选、为什么排除别的低(决策后很少变)
复盘踩过什么坑、教训是什么追加式

⚠️ 常见错误:把"为什么选 A 不选 B"写进运营手册。 平台会变(被收购、改费率),手册不会自动更新 —— 一份三个月前正确的手册,今天可能把人导向一个用不了的平台。


快速开始(开发者)

bash
npm installHOST=127.0.0.1 PORT=3001 PUBLIC_URL=https://api.tiici.com \  FEEDWATCH_BOOTSTRAP_KEY=<至少32位随机> \  npm startcurl http://127.0.0.1:3001/health

⚠️ Bind to 127.0.0.1, never 0.0.0.0. Put Nginx (or any reverse proxy) in front so TLS, access logs and WAF are not bypassed.

测试

bash
npm test              # 87 项离线测试(5 个套件)npm run test:live     # 28 项真实源测试(需出网)

技术栈

运行时      Node.js 22 ESM依赖        fast-xml-parser(唯一运行时依赖)HTTP        node:http 原生(零框架)部署        Linux + Nginx + systemd / Windows + IIS测试        自建轻量断言框架(无 jest/vitest)规模        2143 行 / 7 模块测试规模    87 项离线全绿,全部经「回退法证伪」

为什么零框架依赖:便于跨环境(Linux/Windows)部署,减少供应链风险。


目录结构

06MCP/├── web/index.html         对外落地页(部署到 /)├── docs/│   ├── 工作计划与进展.md            ⭐ 当前状态 + 每日台账 + 下一步│   ├── 架构/项目蓝图.md                整体架构 + 外部资源 + 阶段路线│   ├── 需求/                          功能清单 + 实现状态 + 客户说明│   ├── 运营手册/                ⭐ 内部测试 / Key 管理 / MCP 发布 / 收款 / 部署│   ├── 决策/                      收款平台与主体决策(v2 含纠错)│   └── 复盘/                ⭐ 提交前自查清单 / 回归测试要求点 / 调试复盘 / 上线清单 / 状态语义├── src/                        7 模块 2242 行├── scripts/                    ~2100 行 / 7 套件│   ├── selfcheck-silent.js    ★ 三个高发模式的 12 项自动检查(npm test 第一道)│   ├── selftest / regression*.js       92 项离线断言│   ├── e2e.js                 端到端(含回退证伪用例)│   └── livefeed-test.js       28 项真实源测试(需出网)├── deploy/                     Linux/Windows/落地页/云防火墙部署脚本├── server.json                 MCP 官方注册表清单├── smithery.yaml               Smithery 一键安装配置├── web/index.html              对外落地页└── deliverables/gstack/        审查与发布报告(不随仓库公开)

当前状态

📋 完整台账见 docs/工作计划与进展.md(每日工作 + 下一步 8 项)

✅ 已就绪

产品        https://api.tiici.com/ 落地页 + REST API + MCP 端点,全部线上源码        2242 行 / 7 模块(零 Web 框架)测试        16 项模式自查+ 140 项断言全绿 + 28 项真实源 = 2000 行 / 7 套件安全        15 个缺陷全修(每个都做回退证伪)+ 三层防护              云防火墙 / ufw / Nginx+TLS,3001 公网实测不可达服务器      Vultr 167.179.112.40(Tokyo / $5/月 / Ubuntu 24.04.5)运行        feedwatch.service active+enabled,Node v22.23.3,实测 RSS 93 MB证书        api.tiici.com 已签发(至 2027-01-13,自动续期 dry-run 已验证)配额        免费层 5 个监控点 / 6h 频率(**申报与实际强制一致**)分发        GitHub 公开仓库 + tag v0.1.0 + server.json 通过官方 validate依赖        fast-xml-parser 5.11.2(OSV 漏洞清零)文档        15 份(含回归测试要求点清单、API Key 管理、内部测试指南)

⏳ 待办(完整版见工作计划)

#事项负责阻塞什么
1Payoneer 个人账户 + 收款链接(⚠️ 非 Checkout)徐总🔴 收款前置条件
2提交 MCP 官方注册表徐总分发(mcp-publisher publish)
3点 GitHub Release Publish徐总tag 已推送,只需点一下
4Smithery / mcp.so / mcpservers.org徐总各 3-5 分钟
6咨询税务师(第 3 周)徐总后续合规
7TTL 调回 300徐总—

⏸️暂缓:海外公司注册 —— 验证期不需要,确定要接 Checkout 2.0 / Stripe 时再办

📌 不在本项目范围:www.tiici.com / game.tiici.com 的证书续签属于 WordMaster 等其他站点,归各自项目台账管理,本台账不跟进。


核心判定线

指标目标
真实付费用户≥ 5 个(8 周内)
推送准确率/漏报率< 1%
转化率(免费→付费)> 5%

⚠️ 不要用"技术跑通"当判定 —— 要有人掏钱。技术跑通只是必要条件。


⚠️ 两条给后续接手者的提醒

① 不要只看文档里的「已验证」三个字

本次审查里,团队成员至少 5 次写了「已验证」而结论后来被推翻。 可靠的方式是:临时把修复改回去,看测试会不会红。

② 声称「X 会失败」前,先证明 X 在应该成功时确实成功

只测失败路径无法区分「X 有问题」和「工具有问题」。


遇到问题先看 docs/复盘/调试复盘.md —— 那里记录了 10 个真实缺陷与它们被发现的经过, 避免重复踩坑。

完整审查报告:deliverables/gstack/pre-launch-review-feedwatch-2026-10-12.md

來源:README.md,提交 6a74489

工具

0
SourceWeft 尚未讀取此伺服器的工具。

版本歷史

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

評分

已滿足適用檢查項的 50%

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

  • 近 30 天內可連通必需25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式必需10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

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

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