Quick Start

快速开始

1. 获取 API Key

方式一：网页版 打开 https://weread.qq.com/r/weread-skills → 获取 API Key → 微信扫码登录 → 复制 wrk-xxx Key

方式二：App 微信读书 App → 设置 → 底部获取 API Key → 扫码或复制 wrk-xxx

export WEREAD_API_KEY=wrk-xxxxxxxx

2. 安装 Skill

推荐（跨平台，兼容 Hermes / OpenClaw / Workbuddy / Claude Code 等）：

npx skills add https://github.com/dongwei6688/weread-notes-export-skill --skill weread-notes-export

手动安装：

git clone https://github.com/dongwei6688/weread-notes-export-skill.git
# 把克隆下来的目录放进 Agent 的 skills 目录即可

3. 导出笔记

# 查看统计
python3 scripts/export_weread_notes.py --stats

# 导出一本书
python3 scripts/export_weread_notes.py --book "原则"

# 导出全部
python3 scripts/export_weread_notes.py --all

配置

环境变量	必需	说明
WEREAD_API_KEY	✅	微信读书 API Key（格式 wrk-xxx）
WEREAD_NOTES_DIR	❌	笔记输出目录（默认 ~/.weread-notes/）