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 |
| 阅读热力图 | 生成 GitHub 风格 SVG 阅读热力图 | "生成阅读热力图" "更新热力图" | heatmap.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.3"}'
正确：业务参数平铺在 body 顶层。
{"api_name":"/user/notebooks","count":100,"skill_version":"1.0.5"}
正确：下一页继续平铺 lastSort。
{"api_name":"/user/notebooks","count":100,"lastSort":1516907353,"skill_version":"1.0.5"}
错误：不要把业务参数包在 params 内。
{"api_name":"/user/notebooks","params":{"count":100,"lastSort":1516907353},"skill_version":"1.0.5"}
上面的错误写法会导致 count、lastSort 未被转发，后端按默认值返回第一页，看起来像分页失效。
errcode 非 0 时表示错误，给出中文提示{"api_name": "/_list"} 可查看所有可用接口及参数定义"skill_version": "1.0.3"（取本文件顶部 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.mdupdateTime、createTime、finishTime、readUpdateTime 等），展示时须转为 YYYY-MM-DD 格式（如 1748563200 展示为"2025-05-30"），不得直接展示原始数字在展示书籍、章节、划线等内容时，如果回包字段足以构造链接，应附上对应的跳转链接，方便用户点击后直接在微信读书 App 中打开对应位置。想法/点评不一定都有划线位置，只有具备 chapterUid 和 range 时才生成划线位置链接。
weread://reading?bId={bookId}
| 参数 | 说明 | 来源 |
|---|---|---|
bookId | 书籍 ID | 各接口返回的 bookId |
示例：
weread://reading?bId=3300045871
使用场景：
weread://reading?bId={bookId}&chapterUid={chapterUid}
| 参数 | 说明 | 来源 |
|---|---|---|
bookId | 书籍 ID | 各接口返回的 bookId |
chapterUid | 章节 UID | /book/chapterinfo 返回的 chapters[].chapterUid |
示例：
weread://reading?bId=3300045871&chapterUid=107
使用场景：
weread://bestbookmark?bookId={bookId}&chapterUid={chapterUid}&rangeStart={rangeStart}&rangeEnd={rangeEnd}&userVid={userVid}
| 参数 | 说明 | 来源 |
|---|---|---|
bookId | 书籍 ID | 各接口返回的 bookId |
chapterUid | 章节 UID | 划线/想法所属的 chapterUid |
rangeStart | 划线起始位置 | range 字段中 - 前面的数字 |
rangeEnd | 划线结束位置 | range 字段中 - 后面的数字 |
userVid | 用户 VID | API Key 鉴权后自动关联的用户 ID（从 /shelf/sync 等接口的上下文获取，或省略） |
range 解析：划线接口返回的
range格式为"起始-结束"（如"900-2004"），拆分后分别填入rangeStart和rangeEnd。
示例：
weread://bestbookmark?bookId=3300045871&chapterUid=107&rangeStart=900&rangeEnd=2004&userVid=583802764
使用场景：
/book/bookmarklist）时，每条划线附上跳转链接（range 字段可直接解析）/book/bestbookmarks）时，每条附上跳转链接；/book/underlines 只是划线热度统计，不含划线文本/review/list/mine、/book/readreviews）时，只有返回内容包含 chapterUid 和 range 时才附上跳转到对应划线位置的链接；整本书评或无法定位到划线的点评不强制生成该链接