wewe-rss-reader

微信公众号文章阅读。当用户发来文章链接或需要查询已订阅公众号的文章时使用。

API 基础信息

• API 地址: http://localhost:4001
• wewe-rss 容器: http://localhost:4000（Web UI）
• AUTH_CODE: wewe-rss-2026

核心 API

获取单篇文章内容（最常用）

GET /api/articles/:id

返回纯文本内容（最多前15000字）。:id 是文章 URL 中 mp.weixin.qq.com/s/ 后面的部分。

示例：用户发来链接 https://mp.weixin.qq.com/s/udSpp7eMqwiRo5yVShRzLw → 调用 GET /api/articles/udSpp7eMqwiRo5yVShRzLw → 直接获得文章纯文本内容

通过 URL 订阅公众号

POST /api/subscribe
Content-Type: application/json
body: {"url": "文章链接"}

从文章链接自动识别并订阅该公众号，返回订阅结果。

列出已订阅公众号

GET /api/feeds

列出某公众号文章

GET /api/articles?feedId=MP_ID&limit=10

手动刷新订阅

POST /api/refresh/:feedId
POST /api/refresh-all

使用流程

场景1：用户发来文章链接

1. 从 URL 提取文章 ID（如 https://mp.weixin.qq.com/s/udSpp7eMqwiRo5yVShRzLw → ID 是 udSpp7eMqwiRo5yVShRzLw）
2. 直接调用 GET /api/articles/:id 获取正文
3. 即可对文章内容进行阅读理解

场景2：用户要求查询某公众号最新文章

1. GET /api/feeds 确认已订阅
2. GET /api/articles?feedId=<MP_ID>&limit=5 获取文章列表
3. 如需正文，GET /api/articles/:id

场景3：用户想订阅新公众号

1. 用户需提供该公众号的任意文章链接（不是公众号主页链接）
2. POST /api/subscribe body: {"url": "文章链接"}
3. 返回订阅成功/已存在

登录流程（微信读书授权）

微信读书账号用于抓取公众号内容。若账号已登录且有效（参考 health 检查），无需每次操作。 账号失效后会收到 "暂无可用读书账号" 错误，此时需要重新登录。

完整登录流程

# Step 1: 发起登录
POST /api/login/start
→ 返回 {"uuid": "...", "confirmUrl": "https://..."}

# Step 2: 发送二维码图片到飞书
→ 把 confirmUrl 作为图片请求 URL（或生成二维码图片）发送到飞书群
→ 通知用户扫码

# Step 3: 轮询等待登录完成（自动）
GET /api/login/status/<uuid>
→ status=authorized 表示登录成功 → 继续执行
→ status=waiting 表示等待中 → 继续轮询
→ 超过 5 分钟视为过期，报错让用户重新发起

轮询间隔：每 5 秒一次，不要快发。

自动完成：用户扫完码后，status 会自动变成 authorized，全程无需用户额外确认。

发送图片到飞书：用 message 工具将登录 URL 对应的二维码图片发送到飞书群，通知用户扫码。图片发送由调用方 agent 负责（参考飞书发送图片规范）。

Agent Rules

• 收到文章链接时，优先直接调用 /api/articles/:id 获取内容，而非要求用户提供更多信息
• 获取到正文后，直接进行阅读理解，不需要额外确认
• 如调用失败（返回空/报错），先检查 wewe-rss 容器是否运行：curl http://localhost:4001/api/health
• 如容器未运行：在 ~/.openclaw/workspace/wewe-rss/ 目录下 docker compose up -d