用途:通过本地 weread CLI 访问个人微信读书数据,覆盖搜书、书籍详情、书架、阅读统计、笔记划线、公开评论与推荐等场景。CLI 负责认证、请求结构、skill_version、JSON 解析、升级检查与统一错误处理,不建议自行拼写 curl 请求。
主要能力:搜索(book/fiction/audio/author/fulltext/list/mp/article 等 scope);书籍解析与详情、章节、阅读进度;书架列表与最近阅读;阅读统计(weekly/monthly/annually/overall);笔记总览、笔记最多书籍、单本导出、书签、个人想法、章节划线、热门划线、想法与评论;公开评论列表与单条评论;个性化推荐、相似书籍、好友阅读动态;以及 weread api list / api call 原始接口兜底。
使用方式:先运行 weread doctor 检查认证与 CLI 健康状态;若命令缺失或 auth_configured 为 false,按 references/first-use.md 引导配置。智能体默认加 --json,仅在用户明确需要终端可读输出时用人类可读格式。大输出(书架、笔记本、书签、导出)先写入文件再在对话中总结,笔记导出默认用 --output <path>。分页默认保持浅层,仅在用户明确要求完整导出或排名时翻页,按 JSON 返回的游标传参(如 --max-idx、--last-sort、--synckey、--session-id)。
适用场景:查询个人书架与阅读时长、整理某本书的笔记与划线、导出 Markdown 笔记、查看公开书评、获取推荐与好友动态。
限制:需先完成认证;错误以 JSON 返回,missing_auth 需配置密钥,upgrade_required 须先升级再继续,upstream_timeout 与 network_error 可重试,api_error、http_error、invalid_json 仅在安全时重试。时间字段为秒,进度为整数百分比(100 表示读完)。具体收费、价格与平台支持情况暂未提供。