FeedWatch

FeedWatch MCP

RSS/Atom 変更監視 API + MCP Server 現在のフェーズ：検証準備期間（判定基準：8 週間以内に実際の有料ユーザー 5 人）

🌐 英語版：README.en.md · 中国語は以下

---

まずはこちら

知りたいこと	こちらをご覧ください
⭐ 現在の状況と次のアクション	📋 作業計画と進捗
プロジェクト全体の概要	📐 プロジェクトの青写真
開発でやること	💻 ソフトウェア開発要件仕様書
お客様の使い方	📖 ユーザーガイド
サーバーの購入 + デプロイ	🖥️ サーバー購入・デプロイマニュアル
海外法人の設立	🏢 海外法人設立・維持マニュアル
お客様への API Key 発行	[🔑 API Key 管理とクォータ](docs/运营手册/API Key管理与配额.md)
まず自分で試す	🧪 内部テストガイド
MCP エコシステムへの公開	🔌 MCP エコシステム公開ガイド
決済の受付開始（Payoneer）	💳 Payoneer 決済リンク操作マニュアル
決済の設定方法（一般）	💰 決済・運用マニュアル
この選択をした理由	📋 意思決定記録—決済と事業主体
コード変更後に実行するもの	🧪 回帰テスト要件チェックリスト
提出前の自己点検（4 問 + 16 項目の確認）
これまでに遭遇した問題	🔍 デバッグ振り返り
リリース前に確認すること	✅ リリースチェックリスト
ステータスフィールドの意味	🔢 ステータスフィールドの意味

⚠️ コードを変更する前に「回帰テスト要件チェックリスト」を確認してください —— オフラインテスト 89 項目のカバー状況、 既知の不足 19 項目、および**誤って「検証済み」とされた 4 か所（検証済みではないことが判明）**が記載されています。 テスト名に書かれたカバー範囲だけを見ず、実際に何をアサートしているかを確認してください。

---

一言で説明すると

お客様から RSS/Atom/JSON Feed の URL を受け取り、こちらで監視します。内容が変わったら能動的に通知し、 どのフィールドが何から何に変わったのかを正確にお知らせします。

主な差別化ポイント：競合の多くは「新しい項目」の通知しかできませんが、当サービスは既存項目の変更を検知し、フィールド単位の差分を提示できます。 ニュースの誤字訂正や、競合がひそかに行う価格変更は新しい項目を生みませんが、まさにお客様が最も知りたい情報です。

---

ドキュメント体系（4 層構造）

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 を選ばなかった理由」を運用マニュアルに書くことです。 プラットフォームは変わります（買収、料金改定など）が、マニュアルは自動更新されません —— 3 か月前には正しかったマニュアルが、今日では利用できないプラットフォームへ人を誘導する可能性があります。

---

クイックスタート（開発者向け）

npm install
HOST=127.0.0.1 PORT=3001 PUBLIC_URL=https://api.tiici.com \
  FEEDWATCH_BOOTSTRAP_KEY=<至少32位随机> \
  npm start
curl http://127.0.0.1:3001/health

⚠️ 127.0.0.1 にバインドし、0.0.0.0 には絶対にバインドしないでください。TLS、アクセスログ、WAF が迂回されないよう、前段に Nginx（または任意のリバースプロキシ）を配置してください。

テスト

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 管理、内部测试指南）

⏳ 未対応（完全版は作業計画を参照）

#	項目	担当	ブロックしているもの
1	Payoneer 個人アカウント + 決済リンク（⚠️ Checkout ではありません）	徐総	🔴 決済受付の前提条件
2	MCP 公式レジストリへの登録申請	徐総	配布（mcp-publisher publish）
3	GitHub Release の Publish をクリック	徐総	tag は push 済み。クリックするだけ
4	Smithery / mcp.so / mcpservers.org	徐総	各 3～5 分
6	税理士に相談（第 3 週）	徐総	今後のコンプライアンス
7	TTL を 300 に戻す	徐総	—

⏸️ 保留：海外法人の設立 —— 検証期間中は不要です。Checkout 2.0 / Stripe を使うと決めた時点で手続きしてください

📌 本プロジェクトの範囲外：www.tiici.com / game.tiici.com の証明書更新は、 WordMaster など他のサイトに関するものであり、それぞれのプロジェクト台帳で管理します。本台帳では追跡しません。

---

主要な判定基準

指標	目標
実際の有料ユーザー	5 人以上（8 週間以内）
通知の正確率／見逃し率	< 1%
コンバージョン率（無料→有料）	> 5%

⚠️ 「技術的に動作した」ことを判定基準にしないでください —— 実際に支払う人がいることが重要です。技術的に動作することは必要条件にすぎません。

---

⚠️ 後任者への 2 つの注意事項

① ドキュメントの「検証済み」という 3 文字だけを信用しないでください

今回のレビューでは、チームメンバーが「検証済み」と記載したケースが少なくとも 5 回ありましたが、後にその結論は覆されました。 信頼できる方法は、修正を一時的に元に戻し、テストが失敗するか確認することです。

② 「X は失敗する」と主張する前に、成功すべき条件で X が実際に成功することを確認してください

失敗する経路だけをテストしても、「X に問題がある」のか「ツールに問題がある」のかを区別できません。

---

問題が起きたら、まず docs/复盘/调试复盘.md を確認してください —— 実際に発生した 10 件の不具合と、その発見に至った経緯が記録されています。 同じ問題を繰り返さないために役立ちます。

完全なレビュー報告書：deliverables/gstack/pre-launch-review-feedwatch-2026-10-12.md