weread-cli
为AI Agent和开发者提供的微信读书命令行工具与技能。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：weread-cli。 它的用途是：为AI Agent和开发者提供的微信读书命令行工具与技能。 完整的 Skill 内容见：https://321skill.com/skills/weread-cli/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我找一下《三体》这本书，并看看我最近读了什么。”，AI Agent会调用`weread search`和`weread shelf recent`命令，将结果整理后回复给你。或者
对AI说：“把我对《人类简史》的笔记导出成Markdown文件。”，AI会执行`weread notes export`命令并告知你文件保存的位置。
介绍
weread-cli 是一个基于微信读书官方API封装的命令行工具，旨在为开发者和AI Agent提供一个稳定、易用的本地接口。它解决了手动调用API时需记忆复杂参数和编写curl命令的痛点，将微信读书的核心功能（如搜索书籍、管理书架、导出笔记、查看阅读数据等）封装成简单的CLI命令。
用户通过npm全局安装CLI后，即可在终端直接使用weread命令。同时，配套的Skill可以指导AI Agent优先调用此CLI来执行任务，实现了人类与Agent的无缝协作。首次使用需配置从微信读书官方页面获取的API Key。
该工具非常适合两类用户：一是希望通过命令行高效管理微信读书的开发者或重度读者；二是希望将微信读书功能集成到自动化工作流或AI Agent中的技术爱好者。对于AI Agent使用者，安装配套Skill后，Agent便能理解如何调用该CLI来响应用户的读书相关请求。
使用建议：AI Agent在调用时应优先使用--json参数以获得结构化数据便于解析；对于大量输出（如导出笔记），可先写入文件再进行处理。普通用户在终端查看时，可使用默认的人类可读格式。注意，该工具依赖微信读书官方API，需遵守其使用条款。
核心特点
核心区别在于它同时提供了面向人类的稳定CLI和指导AI Agent调用的配套Skill，实现了人机协同的读书管理。与仅提供API封装或仅面向Agent的Skill不同，它将官方API封装为更健壮的本地命令，避免了Agent直接调用不稳定接口的问题。
注意事项
不适合需要操作微信读书APP内所有功能（如社交互动、复杂购买流程）的场景，其能力受限于官方开放API的范围。
常见问题
如何获取微信读书API Key？
访问 https://weread.qq.com/r/weread-skills，登录微信读书账号后即可在页面中获取。
Agent如何调用这个工具？
安装配套Skill后，Agent会优先使用本地`weread`命令，并自动处理分页、错误和字段解释。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/weread-cli/raw/index.md 读取 weread-cli 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/weread-cli/raw/index.md（查看排版版本）