接入微信读书官方 Skill

一个持续了半年的需求

年初我在 /read 页面上展示微信读书的书架和阅读数据。一开始是手动整理的，但很快就受不了了——于是研究怎么自动化。

最初的方案是本地登录微信读书网页版，提取 Cookie，用 Cookie 去调微信读书的内部 API。听起来简单，但实际跑起来：Cookie 老是过期：微信读书的登录态撑不了太久，隔几天就得重新提取； 阅读时长拿不全：能拿到书架，但每本书的阅读时长、每日明细这些数据，内部 API 不全；维护太累：每次 Cookie 过期，页面就变空白，得手动刷新一次数据。自动化是自动化了，但数据一直不够完整。每次看页面都忍不住想：「这里其实可以做得更好」。

官方 Skill 出现

最近，微信读书上线了官方微信读书 Skill，提供了标准化的 REST API 入口，支持查阅书架、阅读统计、笔记划线和搜索书籍等能力。最关键的是：能拿到每本书的累计阅读时长和每日阅读明细——这正是以前的方案最缺的东西。

数据更完整了

迁移后，/read 页面现在能展示：

• 所有书架书籍及状态
• 每本书的真实阅读时长
• 总体累计阅读时长

实测下来，大部分「在读」和「已读」书籍的阅读时长都能准确展示。极少数早期读完但不在阅读排行里的书，仍然显示 0m。

自动化也搞定了

API 解决了数据源问题，自动化更新交给了 CNB 的定时任务。数据源解决了，自动化更新也交给了 CNB 的定时任务。每天凌晨 3:00 自动跑一遍：拉数据、转格式、更新文件、提交并触发构建。

一点感想

自己造轮子确实能学到东西，但官方的接口一旦稳定了，迁移过去就是更负责任的选择。至少现在数据更准确、维护更简单、页面更新更及时。网站上的 /read 页面现在是我比较满意的一个角落。不为别的，就为自己每天看了多少书，能一目了然地看见。

补充（2026-07-16）：微信读书官方 Skill 已升到 1.0.4，版本号对齐后，每日定时任务的升级提示也安静了。

参考链接：

• 微信读书 Skill
• Tencent/WeChatReading