微信读书官方开源 Skill 调研：把阅读数据接入 AI 工作流

腾讯首次以「Skill 规范包 + 授权网关」形式对外开放个人阅读数据，让 AI 助手直接查书架、统计阅读行为、整理笔记和推荐书籍。

写在前面

2026 年 5 月，微信读书官方发布了面向 AI Agent 的 WeChatReading Skills。这不是一个传统的客户端 SDK，而是一组「调用契约 + 能力规范」：Agent 按照官方 Skill 文件拼装请求，统一打到腾讯网关，返回结构化阅读数据。

对普通用户而言，这意味着你的书架、阅读时长、笔记划线不再只停留在 App 里，而是可以被 AI 读取、统计、分析和二次加工。对开发者而言，这是腾讯首次以官方身份开放个人阅读数据的 Agent 接入通道。

一、它解决什么问题

在 WeChatReading Skills 出现之前，如果你想用 AI 处理微信读书数据，基本只有两条路：

• 手动复制粘贴：把书架 / 笔记从 App 里导出来，再喂给 AI
• 第三方逆向工具：比如 wereadx、weread-exporter 等，依赖抓包或 Hook，存在封号风险

官方 Skills 直接解决了这个问题：官方授权 + 结构化 API + Agent 原生调用，不需要抓包，不需要维护 Cookie，数据权限由 API Key 控制。

二、项目概览

三、核心能力

官方 Skills 包含 7 个 Skill 文件，覆盖阅读数据的全量查询场景：

所有 Skill 都通过统一网关调用：

https://i.weread.qq.com/api/agent/gateway

请求时携带 Authorization: Bearer $WEREAD_API_KEY，Body 中指定 api_name 和 skill_version。

四、技术架构

官方 Skills 的架构非常轻量：

Agent（Claude Code / Codex / OpenClaw）↓ 读取 Skill 定义文件（.md）↓ 拼装请求参数
    ↓ 调用本地 weread CLI 或直连网关
腾讯网关（i.weread.qq.com/api/agent/gateway）↓ 验证 API Key
    ↓ 转发到微信读书服务端
    ↓ 返回结构化 JSON

关键设计决策：

1. Skill 即契约：.md 文件定义参数规则、scope 映射、返回字段，不包含业务逻辑
2. 服务端闭源：网关实现由腾讯控制，Skill 只是调用说明书
3. 版本协商：每次请求带 skill_version，服务端通过 upgrade_info 推送升级
4. 无写操作：当前只开放读取类能力，不包含添加书架、写笔记、删书评等写操作

五、与社区工具对比

两者的底层能力来自同一套官方网关，社区 CLI 只是多包了一层本地命令和参数解析。

六、实战：3 步跑通

第一步：安装 Skill

npx skills add Tencent/WeChatReading -g

第二步：获取 API Key

1. 打开 https://weread.qq.com/r/weread-skills
2. 登录你的微信读书账号
3. 复制 API Key（格式：wrk-...）
4. 设置环境变量：

export WEREAD_API_KEY="wrk-..."

第三步：验证连通性

把以下指令发给你的 Agent：

帮我搜一下三体

或者直接查看书架：

看看我的书架

Agent 会自动调用官方 Skill，通过网关获取你的阅读数据并返回。

七、风险与限制

1. 服务端闭源：网关实现由腾讯控制，Skill 只是调用说明书，无法自建服务端
2. 只有读取能力：没有添加书架、写笔记、删书评等写操作
3. API Key 绑定账号：数据仅自己可见，但 Key 泄露会导致数据暴露
4. 新项目：2026 年 5 月发布，社区生态刚开始，长期维护性待观察
5. 中文垂直域强，海外弱：主要面向微信读书中文用户，英文阅读场景覆盖有限

八、总结

WeChatReading Skills 的核心价值不是「AI 能帮你查书」，而是 腾讯首次以官方身份开放个人阅读数据的 Agent 接入通道。

三个最值得关注的点：

• 官方授权：不再需要抓包或逆向，API Key 直接绑定账号
• Agent 原生：Skill 定义文件直接指导 Agent 调用，无需二次封装
• 数据可二次加工：书架、笔记、阅读统计都可以被 AI 读取、分析、重组

如果你已经在用 Claude Code、Codex 或 OpenClaw，安装官方 Skills 是目前接入微信读书数据最稳妥的方式。先试一周，看看 AI 能否帮你发现自己的阅读盲区。

参考

• Tencent/WeChatReading GitHub
• 微信读书 Skill 官方页面
• 官方 Skill zip 下载
• shiquda/weread-cli GitHub
• 微信读书 API 分析（CSDN）
• 微信读书推出 Skill 功能报道