前言¶

微信读书里的书架、划线和阅读时长，平时只能在 App 里翻。想在对话里问「这个月读了多久」「把某本书的笔记列出来」，要么自己抓接口，要么反复截图。下面介绍 SkillHub 上的「微信读书」Skill：把搜索、书架、笔记、书评、阅读统计和推荐接到 Agent，用自然语言驱动，背后走微信读书 Agent API Gateway。

这是什么¶

「微信读书」是 SkillHub 社区 Skill，坐标 @user_b4de96af/wxds123，分类为 knowledge-management，发布者为 user_b4de96af，当前 SkillHub 页面标注版本为 v1.0.0。简介写明：微信读书助手，支持搜索书籍、管理书架、查看笔记划线、浏览书评、阅读统计、发现推荐好书。

Skill 本体是通用 SKILL.md 格式：Agent 读取说明后，按文档调用 https://i.weread.qq.com/api/agent/gateway，并遵守参数平铺、skill_version 上报等约定。标签 requires_api_key=true 表示必须配置微信读书侧 API Key。

SkillHub 页面数据（以抓取为准）：评分 100000，下载 11522 次。

核心功能¶

以下能力与安装包内 SKILL.md「支持的能力」表一致，按用户意图选用对应参考文档（如 search.md、shelf.md、notes.md 等）。

接口统一为 POST JSON，api_name 指定具体路径；用户只说书名时，应先 /store/search 解析 bookId 再后续操作。回包可带 weread:// 深度链接，便于在 App 内打开书籍、章节或划线位置。

安装与启用¶

1、安装 SkillHub CLI¶

若尚未安装，可按 SkillHub 官方安装说明执行：

command -v skillhub && skillhub --version

未安装时（完整包或仅 CLI，以官方文档为准）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

2、安装本 Skill¶

安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 且可能不被识别。

skillhub install @user_b4de96af/wxds123 --dir <你的 skills 目录>

常见路径示例（来自 SkillHub 安装文档）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

也可将官方页面给出的提示词发给 AI，让其按 https://skillhub.cn/install/skillhub.md 完成安装。

3、配置 API Key¶

Skill 要求环境变量 WEREAD_API_KEY，格式为 wrk-xxxxxxxx，请求头为 Authorization: Bearer $WEREAD_API_KEY。未设置时，Agent 应提示用户：

export WEREAD_API_KEY=<你的apikey>

Key 绑定微信读书用户身份（vid），需要用户身份的接口由网关注入，无需手传 vid。

4、调用约定（Agent 侧）¶

• 网关：POST https://i.weread.qq.com/api/agent/gateway
• Body 为 JSON，业务参数与 api_name、skill_version 平铺在同一层，不要包在 params 内
• 每次请求必须带 skill_version；安装包内 SKILL.md 顶部 version 为 1.0.3，应与请求中的 skill_version 一致
• 若响应含 upgrade_info，需先按指引升级再继续

典型用法¶

对话式（推荐给终端用户）¶

在已启用 Skill 的 Agent 中，可直接用自然语言，例如：

• 「帮我搜一下三体」
• 「看看我的书架」
• 「我这个月读了多久」
• 「看看我在三体里的笔记」
• 「三体这本书有什么点评？」
• 「给我推荐几本书」

Agent 会按 SKILL.md 与各 *.md 能力说明选择 api_name 并整理回包。

直连网关（排查或脚本）¶

搜索示例如下（skill_version 需与当前 Skill 文档版本一致）：

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.3"}'

查看可用接口列表：

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": "/_list", "skill_version": "1.0.3"}'

适用场景与注意¶

适合谁

• 已在微信读书重度记笔记、管书架，希望用 Cursor / Claude Code 等 Agent 做检索与汇总的人
• 需要把阅读数据、划线、点评纳入对话工作流，而不是单独开 App 翻找的人

限制与注意

• 必须持有有效的 WEREAD_API_KEY，且 Key 与账号绑定；无 Key 无法调用网关
• 依赖微信读书 Agent API Gateway 与 Skill 文档版本；SkillHub 列表版本与包内 SKILL.md 的 version 可能不一致，以实际安装包为准配置 skill_version
• 分页参数（如 lastSort）必须平铺在 body 顶层，错误嵌套会导致一直返回第一页
• 展示回包时需按 Skill 规范转换时间戳、阅读时长，并优先参考各能力说明文件的字段含义，避免按字段名直译

结尾¶

「微信读书」Skill 把书城搜索、书架、笔记划线、书评、阅读统计和推荐收敛到一套 Agent 可读的 SKILL.md 与网关调用规范，适合在对话里查自己的阅读数据。安装与详情见 SkillHub：

• 页面：https://www.skillhub.cn/skills/user_b4de96af/wxds123
• API 入口：https://api.skillhub.cn/user_b4de96af/wxds123