项目介绍
WeChatReading 是腾讯公开的微信读书 Agent Skills 集合。它通过统一的 Agent API Gateway，把搜索、书籍详情、书架、阅读进度、个人笔记与划线、阅读统计、公开点评和个性化推荐整理成可由 AI Agent 调用的工作流。仓库的能力以中文文档为主，并明确要求使用与用户身份绑定的 API Key。
核心功能
多类型书城搜索
search.md 记录了电子书、网文、有声书、作者、全文、书单、公众号和文章等搜索范围，并要求 Agent 根据用户意图选择 scope。
书籍、书架与阅读进度
book.md 和 shelf.md 说明了书籍详情、章节目录、阅读进度，以及书架中电子书、专辑/有声书和文章收藏的统计口径。
笔记、划线与书评
notes.md 区分个人笔记、划线、想法与公开点评，并提供笔记概览、划线内容、热门划线和相关想法的工作流。
阅读统计与推荐
readdata.md 提供阅读时长、天数和偏好等统计口径，discover.md 提供个性化推荐与相似书推荐。
安装与使用
按 README 的全局命令安装后，从微信读书官方入口取得 API Key，并把它设置为 WEREAD_API_KEY 环境变量；然后先做只读的接口列表或简单搜书验证。
让 AI Agent 帮你安装
把这段话发送给 Codex、Claude Code 或其他可以操作本地环境的 AI Agent。
请帮我安装腾讯 WeChatReading 微信读书 Agent Skills。项目地址：https://github.com/Tencent/WeChatReading。先阅读 README、skills/SKILL.md 和 LICENSE，核对当前版本与安装命令，然后执行 `npx skills add Tencent/WeChatReading -g`。覆盖任何现有 Skill 目录前先询问我。安装完成后先确认宿主能发现 `weread-skills`；需要 WEREAD_API_KEY 时说明它会访问哪些个人阅读数据并向我索取，不要把凭据写入仓库、日志或聊天记录。得到授权后，以 `/_list` 或简单搜书做最小只读验证，分别报告安装发现和真实接口调用结果；遇到额外权限、凭据、文件覆盖或其他风险操作时先确认。- 一个能够运行 README 所示 npx 安装命令并加载 Agent Skills 的宿主
- 微信读书账号，以及从 README 所列官方入口获取的 API Key
- 可以安全设置环境变量、避免把 API Key 写入仓库或聊天记录的环境
npx skills add Tencent/WeChatReading -g- 1安装官方 Skills
在目标 Agent 宿主的终端执行 `npx skills add Tencent/WeChatReading -g`。安装前检查是否已有同名目录，存在时先确认是否覆盖。
- 2取得并配置 API Key
按 README 提供的微信读书官方入口获取 API Key，并把它设置为 `WEREAD_API_KEY` 环境变量。不要把真实值写进代码、Git、日志或可共享的提示词。
- 3确认 Skill 被宿主发现
重启或刷新宿主后，确认它能识别 `weread-skills`。这一步只验证安装发现，不代表远程接口和个人数据访问已经可用。
- 4运行最小只读验证
先查询 `/_list` 或搜索一本公开书籍。若要查询书架、笔记、进度、统计或个性化推荐，先确认用户明确授权了对应个人数据范围。
安装后确认宿主能够发现 `weread-skills`，再发送 `{'api_name':'/_list','skill_version':'1.0.4'}` 或执行一次不涉及私有数据的搜书请求；收到接口列表或真实搜索结果才算功能验证成功。仅看到目录或 Skill 名称只代表安装发现成功。
- API Key 与微信读书用户身份绑定，应放在环境变量或宿主安全存储中
- 书架、阅读进度、个人笔记、统计和个性化推荐都可能暴露个人阅读隐私
- 每次 API 请求必须携带 skill_version 1.0.4；收到 upgrade_info 后先按提示升级
- 仓库没有截图、示例图或流程图，本页不添加正文媒体
使用场景
查书与阅读信息
用自然语言搜索书籍、作者、全文、书单或有声书，并继续查看详情、目录和阅读进度。
整理个人书架和笔记
在用户授权后查看书架构成、汇总个人笔记与划线，或导出单本书的划线和想法。
复盘阅读习惯
查询阅读时长、天数、排行和偏好，用于月度或年度阅读复盘。
发现下一本书
结合个性化推荐、相似书、评分、公开点评和热门划线筛选候选读物。
使用评价
从腾讯公开 README、Skill 入口和分能力文档看，WeChatReading 的优势是安装入口简单、能力边界清楚，并对参数平铺、版本上报和书架统计等容易出错的细节写了明确规则。它的主要代价是依赖远程服务和用户身份 API Key，而且可读取较敏感的个人阅读数据。本评价仅基于公开材料，没有安装或调用真实账号接口。
值得一试的地方
- 腾讯官方仓库，许可证、版本、安装命令和 API 入口均有公开说明
- 搜索、书架、笔记、统计、点评和推荐分别提供详细工作流与字段解释
- Skill 明确要求 API Key 走环境变量，并为升级提示和错误结果设置处理规则
- Apache-2.0 便于在遵守许可证的前提下审查、修改和再分发
使用前要知道
- 必须依赖腾讯远程 Agent API Gateway 和有效 API Key
- 书架、阅读进度、笔记、统计与推荐涉及个人阅读隐私，授权范围需要控制
- README 没有逐一声明具体 Agent 宿主兼容矩阵
- 本次没有安装或进行真实功能测试
README
WeChatReading
Overview
腾讯发布的微信读书 Agent Skills，通过统一 API Gateway 提供搜书、书架、阅读进度、笔记划线、阅读统计、公开点评与个性化推荐能力。
Getting started
- 按 README 的全局命令安装后，从微信读书官方入口取得 API Key，并把它设置为 WEREAD_API_KEY 环境变量；然后先做只读的接口列表或简单搜书验证。
- README 提供 `npx skills add Tencent/WeChatReading -g` 全局安装命令，并要求设置 WEREAD_API_KEY 环境变量。
- Skill 通过 `https://i.weread.qq.com/api/agent/gateway` 统一入口发送 JSON 请求，业务参数与 api_name、skill_version 放在同一层。
- 安装后确认宿主能够发现 `weread-skills`，再发送 `{'api_name':'/_list','skill_version':'1.0.4'}` 或执行一次不涉及私有数据的搜书请求；收到接口列表或真实搜索结果才算功能验证成功。仅看到目录或 Skill 名称只代表安装发现成功。
Configuration
npx skills add Tencent/WeChatReading -g