下载地址
https://api.skillhub.cn/api/v1/download?slug=%40user_f12a44b7%2Fhongzhua-weread将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md，安装 @user_f12a44b7/hongzhua-weread。微信读书助手 — 搜索书籍、管理书架、查看笔记划线、浏览书评、阅读统计、发现推荐好书
阅读全文 （展开查看完整说明）
概述
通过 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鉴权
- Header：
Authorization: Bearer $WEREAD_API_KEY WEREAD_API_KEY从环境变量获取，格式wrk-xxxxxxxx- 若未设置，提示用户：
export WEREAD_API_KEY=<你的apikey> - API Key 绑定用户身份（vid），需要用户身份的接口会自动注入，无需手动传 vid
请求格式
- Method：POST
- Content-Type：application/json
- Body：JSON，
api_name指定接口，其余为接口参数，每次请求必须带skill_version
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.0"}'响应格式
- JSON，回包经过字段裁剪，只返回核心字段
errcode非 0 时表示错误，给出中文提示- 发送
{"api_name": "/_list"}可查看所有可用接口及参数定义
通用规则
- 版本上报：每次请求 body 必须包含
"skill_version": "1.0.0"（取本文件顶部 version 字段的值），用于服务端检查版本更新。如果回包中出现upgrade_info字段，必须立即暂停当前操作，按照upgrade_info.message中的指引完成升级，升级完成后再重新执行用户请求，不得忽略该字段 - bookId 解析：用户输入书名时，先调
/store/search获取 bookId，再执行后续操作 - 结果展示：列表用编号展示方便选择；搜索结果重点展示书名、作者、评分
- 上下文衔接：对话中记住已查询的 bookId，后续操作无需用户重复提供
- 深度链接：在展示划线、想法、章节等内容时，拼接对应的跳转链接方便用户直接在 App 中打开，具体格式见下方「深度链接（URL Schema）」章节
深度链接（URL Schema）
在展示书籍、笔记划线、想法、章节等内容时，必须附上对应的跳转链接，方便用户点击后直接在微信读书 App 中打开对应位置。
打开书籍（跳转到上次阅读进度）
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/underlines）时，每条附上跳转链接 - 展示想法（
/review/list/mine、/book/readreviews）时，附上跳转到对应划线位置的链接
