Menu
微信读书助手 — 搜索书籍、管理书架、查看笔记划线、浏览书评、阅读统计、发现推荐好书
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | weread-skills |
| description | 微信读书助手 — 搜索书籍、管理书架、查看笔记划线、浏览书评、阅读统计、发现推荐好书 |
| version | 1.0.4 |
通过 Agent API Gateway 调用微信读书接口，提供搜索、书架、笔记、书评等能力。
| 能力 | 说明 | 用户示例 | 详细说明 |
|---|---|---|---|
| 搜索书籍 | 在书城搜索 | "帮我搜一下三体" | search.md |
| 书籍信息 | 查看书籍详情、章节目录、阅读进度 | "这本书有多少章" "我读到哪了" | book.md |
| 书架管理 | 查看书架 | "看看我的书架" | shelf.md |
| 阅读统计 | 阅读时长、天数、偏好分析、阅读统计摘要 | "我这个月读了多久" "今年读了几本书" | readdata.md |
| 笔记划线 | 查看个人笔记数量与内容，包括划线、想法/点评、书签数量 | "看看我在三体里的笔记" "导出我的划线" "在这本书有多少笔记" | notes.md |
| 章节热门划线 | 查看书籍/章节热门划线、划线热度及划线下想法 | "看看这章有什么热门划线" "这段话下面有什么想法" | notes.md |
| 书籍点评 | 查看书籍的公开点评 | "三体这本书有什么点评？" "看看推荐的点评" | review.md |
| 推荐好书 | 个性化推荐/相似推荐 | "给我推荐几本书" | discover.md |
根据用户意图参考对应说明文件了解接口参数、回包结构和工作流。
POST https://i.weread.qq.com/api/agent/gateway
Authorization: Bearer $WEREAD_API_KEYWEREAD_API_KEY 从环境变量获取，格式 wrk-xxxxxxxxexport WEREAD_API_KEY=<你的apikey>api_name 指定接口，其余为接口参数，每次请求必须带 skill_versioncurl -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.4"}'
正确：业务参数平铺在 body 顶层。
{"api_name":"/user/notebooks","count":100,"skill_version":"1.0.4"}
正确：下一页继续平铺 lastSort。
{"api_name":"/user/notebooks","count":100,"lastSort":1516907353,"skill_version":"1.0.4"}
错误：不要把业务参数包在 params 内。
{"api_name":"/user/notebooks","params":{"count":100,"lastSort":1516907353},"skill_version":"1.0.4"}
上面的错误写法会导致 count、lastSort 未被转发，后端按默认值返回第一页，看起来像分页失效。
errcode 非 0 时表示错误，给出中文提示{"api_name": "/_list"} 可查看所有可用接口及参数定义"skill_version": "1.0.4"（取本文件顶部 version 字段的值），用于服务端检查版本更新。如果回包中出现 upgrade_info 字段，必须立即暂停当前操作，按照 upgrade_info.message 中的指引完成升级，升级完成后再重新执行用户请求，不得忽略该字段api_name、skill_version 放在同一层；不要包在 params、data、body 等对象里。只有接口文档明确声明的数组/对象字段（如 /book/readreviews 的 reviews）才允许作为业务字段传入。readdata.md，书架先读 shelf.md），确认接口参数、字段含义、单位、计数口径和工作流；禁止仅凭字段名或经验猜测含义。/store/search 获取 bookId，再执行后续操作/shelf/sync 回答“书架有多少本书/多少条目”时，必须按 books.length + albums.length + (mp 非空 ? 1 : 0) 计算；albums[] 是专辑/有声书，也属于书架里的书，详细规则见 shelf.mddeepLink 字段作为跳转链接，展示为 [打开阅读]({deepLink})；若回包没有 deepLink，不要自行拼接 weread:// 链接updateTime、createTime、finishTime、readUpdateTime 等），展示时须转为 YYYY-MM-DD 格式（如 1748563200 展示为"2025-05-30"），不得直接展示原始数字在展示书籍、章节、划线、想法等内容时，如果回包中有 deepLink 字段，直接使用该字段值作为跳转链接。
[打开阅读]({deepLink})。deepLink 字段，如有则直接使用。deepLink 字段，不要尝试手动拼接 weread:// 链接。