ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified

weread

微信读书(WeRead)数据查询与笔记管理技能。获取书架、搜索书籍、查看阅读进度/时长、获取笔记划线、热门书评、章节信息、随机笔记抽取和批量导出。当用户提到"微信读书"、"WeRead"、"书架"、"读书进度"、"划线"、"笔记"、"书评"、"在读"、"读完"、"阅读时长"、"读书回顾"、"导出笔记"时使用。

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/chenyqthu/weread
Or

微信读书 Skill

通过微信读书 Web API 获取用户的阅读数据。依赖 Cookie 认证。

前置:Cookie 配置

Cookie 存储路径: ~/.weread/cookie(纯文本单行)。

所有 API 命令依赖此文件。Cookie 不存在或过期时,命令会报错并提示重新登录。

获取 Cookie(三选一)

方式 1 — 浏览器自动提取(推荐):

  1. browser 工具打开 https://weread.qq.com(profile=openclaw 或 user)
  2. 确认已登录(页面显示用户头像/书架)
  3. 执行 JavaScript 提取 cookie:document.cookie
  4. 将结果写入 ~/.weread/cookie

方式 2 — 手动粘贴:

python3 ~/.openclaw/workspace/skills/weread/scripts/weread_login.py paste

方式 3 — 直接写入: 用户提供 cookie 字符串后直接写入 ~/.weread/cookie

验证 Cookie

python3 ~/.openclaw/workspace/skills/weread/scripts/weread_api.py verify

Cookie 过期时 API 返回 errcode -2012,提示用户重新登录。

命令参考

脚本目录: skills/weread/scripts/(相对于 workspace) 执行示例使用绝对路径: python3 ~/.openclaw/workspace/skills/weread/scripts/weread_api.py

命令说明示例
shelf获取书架(书名、作者、进度、阅读时长)python3 ~/.openclaw/workspace/skills/weread/scripts/weread_api.py shelf
search <keyword>搜索书架中的书籍(模糊匹配书名/作者)python3 ~/.openclaw/workspace/skills/weread/scripts/weread_api.py search 心理学
info <bookId>获取书籍详情(评分、字数、出版信息)python3 ~/.openclaw/workspace/skills/weread/scripts/weread_api.py info 123456
progress <bookId>获取阅读进度python3 ~/.openclaw/workspace/skills/weread/scripts/weread_api.py progress 123456
detail <bookId>获取详细阅读信息(时长明细、完成日期)python3 ~/.openclaw/workspace/skills/weread/scripts/weread_api.py detail 123456
bookmarks <bookId>获取划线记录python3 ~/.openclaw/workspace/skills/weread/scripts/weread_api.py bookmarks 123456
reviews <bookId>获取我的笔记/想法python3 ~/.openclaw/workspace/skills/weread/scripts/weread_api.py reviews 123456
best-reviews <bookId> [count]获取热门书评python3 ~/.openclaw/workspace/skills/weread/scripts/weread_api.py best-reviews 123456 5
chapters <bookId>获取章节信息python3 ~/.openclaw/workspace/skills/weread/scripts/weread_api.py chapters 123456
verify验证 Cookie 是否有效python3 ~/.openclaw/workspace/skills/weread/scripts/weread_api.py verify

辅助脚本

脚本说明示例
random_review.py随机抽取读书笔记(加权,更长更优先)python3 ~/.openclaw/workspace/skills/weread/scripts/random_review.py --count 2 --min-length 50
export_notes.py全量导出笔记到 ~/.weread/python3 ~/.openclaw/workspace/skills/weread/scripts/export_notes.py
export_notes.py --stats显示笔记统计信息python3 ~/.openclaw/workspace/skills/weread/scripts/export_notes.py --stats
weread_login.py paste手动粘贴 Cookie 登录python3 ~/.openclaw/workspace/skills/weread/scripts/weread_login.py paste

典型工作流

查看书架概况

python3 ~/.openclaw/workspace/skills/weread/scripts/weread_api.py shelf

返回所有书籍的 bookId、书名、作者、进度百分比、阅读时长、是否读完。

Metadata

Author@chenyqthu
Stars3840
Views0
Updated2026-04-06
View Author Profile
AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill
Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-chenyqthu-weread": {
      "enabled": true,
      "auto_update": true
    }
  }
}
Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.