跳到导航

怎样只用公众号列表生成 RSS,并迁移旧阅读器订阅?

只想在阅读器里追新文章,用 wechat_mp.v2.fetch_account_articles 返回的公众号文章列表里的标题、链接和已有摘要生成 wechat.xml,把 wechat.xml 放到阅读器能访问的 HTTPS 地址,再订阅这个地址。每次刷新只为实际翻过的列表页付费。想在阅读器里看更多正文,再给入选文章走正文摘录版 RSS。

先为一个公众号生成列表快照

  1. 按增量检查,用已确认的 username 调用 wechat_mp.v2.fetch_account_articles,传 raw:false。
  2. 保存成功扫描的 state.json 和 coverage.json,在 coverage.json 里核对账号、页数和停止原因。
  3. 试迁时选两篇旧文章和一篇当前文章,记下每篇文章在列表里的 app_msg_id、idx。
  4. 需要每天更新时,用同一个账号从第一页开始,按本轮游标逐页查看,并设页数上限。

一次读取失败时保留已发布的订阅源不动,等下一次扫描成功后再更新。

如果团队只想知道「今天发了什么」,用列表标题、原文链接和已有摘要就能生成订阅项。比如新文标题是《安装手册更新》,读者在 RSS 里点开这一条,就进入微信原文。需要直接在阅读器里看到正文摘录时,再给入选文章走正文摘录订阅。

把选中文章转成 RSS 输入

  1. 从双源 RSS 指南保存 make_feed.py。make_feed.py 接收一个含 items 的 JSON 文件。
  2. 把下方适配器保存为 wechat_feed_input.py。wechat_feed_input.py 从上一节的 state.json 取指定的文章键,生成 make_feed.py 需要的 items 输入。
  3. 运行 wechat_feed_input.py,参数依次填状态文件、订阅源首页的 HTTPS 地址和要发布的文章键:
python3 wechat_feed_input.py state.json https://feeds.example.com/ 11801:1 11802:1 11803:1 > wechat-items.json &&
python3 make_feed.py wechat-items.json wechat.xml
import json
import sys
from pathlib import Path
from urllib.parse import urlsplit
state_path, homepage, *selected = sys.argv[1:]
if not selected or len(set(selected)) != len(selected):
raise SystemExit("Supply one or more distinct app_msg_id:idx keys")
state = json.loads(Path(state_path).read_text(encoding="utf-8"))
account = state["username"]
articles = {f"{row['app_msg_id']}:{row['idx']}": row for row in state["articles"]}
items = []
for key in selected:
if key not in articles:
raise SystemExit(f"Article key unavailable: {key}")
row = articles[key]
link = urlsplit(row["url"])
if link.scheme != "https" or link.hostname != "mp.weixin.qq.com" or link.username:
raise SystemExit(f"Verify the source link for {key}")
items.append({
"id": f"wechat:{account}:{key}",
"title": row["title"],
"url": row["url"],
"excerpt": row.get("digest") or "",
})
print(json.dumps({
"title": f"WeChat: {account}",
"link": homepage,
"description": "Selected article listing excerpts",
"items": items,
}, ensure_ascii=True, indent=2))

wechat_feed_input.py 把 digest 按原响应传给阅读器,文章没有 digest 时省略。wechat_feed_input.py 不输出发布时间,避免把查到文章的日期当作发文日期。需要按时间筛选时,先核对 create_time 的实际时间单位和时区,再填写生成器支持的 published_at。

旧订阅怎么试迁?

  1. 保留旧订阅的 OPML 和能取得的旧 feed XML。
  2. 比较两篇同时出现在旧源和 wechat.xml 里的文章的 link 和 guid。wechat_feed_input.py 默认用账号和文章键生成稳定 ID。若目标阅读器依赖旧 ID,确认两边指向同一篇原文后,把本次输入里的 id 换成对应的旧 guid,并保存这份对应关系供后续生成继续使用。
  3. 链接里有私人访问令牌时,只在自己的本地记录里保留。
  4. 把 wechat.xml 放到你自己的 HTTPS 地址,先在阅读器里新增一个测试订阅。阅读器支持导入 OPML 时,复制下面的 OPML,替换 xmlUrl。

OPML 只记录订阅地址,已读状态能否迁移取决于具体阅读器。

<opml version="2.0">
<head><title>WeChat trial subscription</title></head>
<body>
<outline text="WeChat research" type="rss"
xmlUrl="https://feeds.example.com/wechat.xml" />
</body>
</opml>

试迁三篇文章,看到什么才切换?

发布新源后看到的情况怎么判断和处理
两篇旧文和当前文章都能打开点开一条,确认进入原公众号文章。只有摘要的条目,能看到摘要和原文链接就够了。
相同三篇重新生成后又出现在未读里先比较同一订阅地址下两次 XML 的 guid 和 link。如果 XML 没变,再看阅读器是否把旧地址和测试地址当作两个独立订阅。
加入一篇新文并刷新,只有这篇新文新增切换到新订阅。若想保留旧源中的历史或已读标记,先确认阅读器的迁移能力并备份,再停用旧源。

例如订阅 5 个公众号,每天各检查一页,30 天就是 150 次列表请求。翻页和正文详情按实际次数另计。见 BeatAPI 价格页。

RSS 规范 · OPML 规范