WeRSS 微信公众号订阅助手 — 全功能 API Skill

连接信息

认证

# 获取 Token（有效期 259200 秒 = 3 天）
TOKEN=$(curl -s -X POST "http://150.158.112.193:8001/api/v1/wx/auth/login" \
  -d "username=admin&password=admin@123" \
  -H "Content-Type: application/x-www-form-urlencoded" | python -c "import sys,json; print(json.load(sys.stdin)['data']['access_token'])")

# 后续请求携带
curl -s "..." -H "Authorization: Bearer $TOKEN"

注意： 如果 token 过期返回 401，重新登录即可。账号密码永久有效。

一、文章管理 /api/v1/wx/articles

二、公众号管理 /api/v1/wx/mps

刷新所有公众号

# 获取所有公众号 ID 并逐个刷新
for offset in 0 30 60 90 120 150; do
  curl -s "http://150.158.112.193:8001/api/v1/wx/mps?limit=30&offset=$offset" \
    -H "Authorization: Bearer $TOKEN" | \
    python -c "import sys,json;[print(a['id']) for a in json.load(sys.stdin)['data']['list']]"
done | while read mp_id; do
  curl -s "http://150.158.112.193:8001/api/v1/wx/mps/update/$mp_id" \
    -H "Authorization: Bearer $TOKEN" > /dev/null
  echo "refreshed $mp_id"
done

三、消息任务（定时刷新）/api/v1/wx/message_tasks

这是实现定时刷新公众号的核心机制。

接口

工作原理

cron 触发 → add_job() → 遍历 mps_id 中的公众号 → 加入主队列
  → do_job() → WxGather.get_Articles() → 真正抓取微信文章
  → web_hook() → 发送通知（副作用）

• mps_id: "[]" （空数组）= 覆盖全部 155 个公众号
• mps_id: '[{"id":"MP_WXS_xxx","name":"xxx"}]' = 指定特定公众号
• 每个公众号增量检查耗时约 5-20 秒
• 全部 155 个完成一轮约 30 分钟

创建定时刷新任务

# 创建任务
curl -s -X POST "http://150.158.112.193:8001/api/v1/wx/message_tasks" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "定时刷新全部公众号",
    "message_type": 1,
    "message_template": "{\"msg\":\"refresh\"}",
    "web_hook_url": "http://127.0.0.1:8001/api/v1/wx/sys/article/refresh",
    "mps_id": "[]",
    "cron_exp": "0 */8 * * *",
    "status": 1
  }'

# 重载调度器以生效（必须！）
curl -s -X PUT "http://150.158.112.193:8001/api/v1/wx/message_tasks/job/fresh" \
  -H "Authorization: Bearer $TOKEN"

Cron 表达式参考

当前已配置的任务

• ID: 7ca37bac-846b-40ac-9c1a-267daf40c9a8
• Cron: 0 */6 * * * （每 6 小时）
• 覆盖: 全部 155 个公众号
• Web UI 管理: http://150.158.112.193:8001/message-tasks

网页端配置路径

1. 打开 http://150.158.112.193:8001/message-tasks/add
2. 填写：任务名称、类型选「WebHook」、消息模板填 {"msg":"refresh"}
3. WebHook 地址填 http://127.0.0.1:8001/api/v1/wx/sys/article/refresh
4. Cron 表达式选择
5. 公众号：不选 = 全部
6. 状态：启用

四、任务队列 /api/v1/wx/task-queue

监控示例

# 查看主队列（是否有积压）
curl -s "http://150.158.112.193:8001/api/v1/wx/task-queue/main/status" \
  -H "Authorization: Bearer $TOKEN" | python -m json.tool

# 查看定时任务（确认调度器工作正常）
curl -s "http://150.158.112.193:8001/api/v1/wx/task-queue/scheduler/jobs" \
  -H "Authorization: Bearer $TOKEN" | python -m json.tool

Web UI: http://150.158.112.193:8001/task-queue

五、系统信息 /api/v1/wx/sys

检查微信 Token 到期时间

curl -s "http://150.158.112.193:8001/api/v1/wx/sys/info" \
  -H "Authorization: Bearer $TOKEN" | \
  python -c "import sys,json; d=json.load(sys.stdin)['data']['wx']['expiry']; print(f'到期: {d[\"expiry_time\"]} (剩余 {d[\"remaining_seconds\"]/3600:.0f}h)')"

注意： 微信扫码会话约 3 天过期，需在网页端重新扫码续期。

六、配置管理 /api/v1/wx/configs

关键配置项

七、认证管理 /api/v1/wx/auth

八、RSS 订阅源（公开，无需认证）

九、标签管理 /api/v1/wx/tags