前言¶
很多人把阅读记录、划线和书架留在微信读书里，但和 AI 协作时仍要手动复制书名、翻 App 查进度。通用网页搜索也拿不到你账号下的书架和笔记。下面介绍 SkillHub 上的「微信读书官方Skills」：把搜书、书架、笔记划线、书评、阅读统计和推荐发现封装成 Agent 可调用的 Skill，用自然语言驱动，数据走微信读书 Agent API Gateway。
这是什么¶
一句话定位：微信读书助手 Skill，通过统一网关调用微信读书接口，让 Agent 完成书城搜索、个人书架与阅读数据相关操作。
- 上架坐标：
@user_0b9d349a/weread-skills-official - SkillHub 页面：https://www.skillhub.cn/skills/user_0b9d349a/weread-skills-official
- 版本：SkillHub 展示为 v1.0.0；Skill 包内
SKILL.md会声明更高版本号，调用接口时 body 中的skill_version须与已安装 Skill 文档一致。 - 来源：SkillHub 标记为 community，发布者
user_0b9d349a；能力说明与腾讯 WeChatReading 仓库中的skills/SKILL.md同源（简介、网关地址、能力表一致）。 - 分类：life-service；标签含
requires_api_key=true，使用前需配置微信读书 API Key。
核心功能¶
以下能力与 SkillHub 简介及 SKILL.md「支持的能力」表一致，Agent 按意图选用对应说明文件（如 search.md、shelf.md、notes.md 等）再发起网关请求。
| 能力 | 说明 |
|---|---|
| 搜索书籍 | 书城搜索，可按用户意图搜书名等 |
| 书籍信息 | 详情、章节目录、阅读进度 |
| 书架管理 | 查看书架（含电子书、有声书等条目规则见 Skill 文档） |
| 笔记划线 | 个人笔记、划线、想法/书签；章节热门划线 |
| 阅读统计 | 阅读时长、天数、偏好与统计摘要 |
| 书籍点评 | 浏览书籍公开点评 |
| 推荐好书 | 个性化或相似推荐 |
接口统一入口：
POST https://i.weread.qq.com/api/agent/gateway
鉴权：Authorization: Bearer $WEREAD_API_KEY，Key 格式为 wrk-xxxxxxxx，绑定微信读书用户身份；需要用户身份的接口由服务端注入，无需在参数里手写 vid。
安装与启用¶
通过 SkillHub 安装（推荐与上架页一致）¶
SkillHub 安装说明见 https://skillhub.cn/install/skillhub.md。先确认本机是否有 skillhub CLI；没有则按该文档用官方安装脚本安装。安装 Skill 时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 且 Agent 可能无法加载。
command -v skillhub && skillhub --version
skillhub install user_0b9d349a/weread-skills-official --dir <你的 Agent skills 目录>
常见 skills 目录（摘自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下.agents/skills/
也可将下面提示词交给 Agent，让其按 skillhub.md 完成安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_0b9d349a/weread-skills-official`。
从腾讯仓库安装（可选）¶
腾讯 WeChatReading 仓库 README 提供的另一条安装方式：
npx skills add Tencent/WeChatReading -g
若你主要从 SkillHub 获取该 Skill，以坐标 user_0b9d349a/weread-skills-official 为准；两种方式装好后都需完成下一节 API Key 配置。
配置 API Key¶
- 在 https://weread.qq.com/r/weread-skills 获取个人 API Key。
- 设置环境变量：
export WEREAD_API_KEY=wrk-xxxxxxxx
未设置时，Skill 会提示用户先导出该变量。Key 与账号绑定，勿提交到仓库或日志。
典型用法¶
自然语言（安装并配置 Key 之后）¶
与 Agent 对话即可，仓库 README 中的示例如下：
帮我搜一下三体
看看我的书架
我这个月读了多久
导出我在这本书里的划线
给我推荐几本书
这本书有什么热门划线
三体有什么点评
Agent 加载 Skill 后，会根据意图选择 api_name 并调用网关；用户只给书名时，通常先 /store/search 解析 bookId 再执行后续接口（见 Skill 通用规则）。
直接调用网关（核对连通性）¶
请求为 JSON，api_name 与业务参数与 skill_version 平铺在 body 顶层，不要包在 params 内：
curl -X POST "https://i.weread.qq.com/api/agent/gateway" \
-H "Authorization: Bearer $WEREAD_API_KEY" \
-H "Content-Type: application/json" \
-d '{"api_name": "/store/search", "keyword": "三体", "count": 10, "skill_version": "1.0.5"}'
skill_version 请改为当前已安装 SKILL.md 顶部 version 字段的值。回包 errcode 非 0 表示错误；可发送 {"api_name": "/_list"} 查看可用接口列表。若回包含 upgrade_info，须按指引升级 Skill 后再继续。
适用场景与注意¶
适合谁
- 已在微信读书长期沉淀书架、划线与阅读时长，希望用 Cursor / Claude Code 等 Agent 做检索、汇总、选书，而不反复开 App 抄数据。
- 愿意自行申请并保管
WEREAD_API_KEY的开发者或个人用户。
限制与注意
- 依赖微信读书 Agent API Gateway 与有效 API Key；SkillHub 侧为 community 分发，版本号以你本地安装的
SKILL.md为准，与 SkillHub 页展示的 v1.0.0 可能不一致，以网关要求的skill_version为准。 - 所有个人数据请求经你的 Key 鉴权，仅在可信环境中配置环境变量。
- Skill 对展示格式、分页参数、书架计数等有详细约束（如时间戳转日期、阅读时长单位秒等），Agent 应遵循
SKILL.md与分能力说明文件，避免误读字段。
SkillHub 当前展示评分 100000、下载约 46707 次（以页面统计为准），可作为选 Skill 时的参考，不代表接口 SLA。
结尾¶
「微信读书官方Skills」把微信读书账号内的搜索、书架、笔记、统计、点评与推荐收敛到一套 Agent Skill 与统一网关之上，适合把阅读数据接进日常 AI 工作流。安装与详情见 SkillHub：https://www.skillhub.cn/skills/user_0b9d349a/weread-skills-official ，API 入口说明亦见 https://api.skillhub.cn/user_0b9d349a/weread-skills-official 。
