wereadapi

微信读书 API 文档和测试仓库。

这个仓库整理当前使用的微信读书接口，包含：

• docs/apis/*.md: 每个 API 一份 Markdown 文档
• tests/weread_api_test.py: Python 测试客户端
• .github/workflows/check.yml: 基础语法校验
• .env.example: 环境变量示例

当前支持接口

• login-getuid 获取扫码登录 uid
• confirm-url 生成扫码确认链接
• login-getinfo 查询扫码登录信息
• weblogin Web 登录
• session-init 初始化会话
• renewal Cookie 续期
• login-notify 登录通知
• shelf-sync 同步书架
• shelf-sync-book 获取迷你书架数据
• shelf-book-ids 查询书籍是否在书架
• shelf-add 添加到书架
• book-info 图书详情
• book-publicinfos 批量公开图书信息
• book-search 图书搜索页数据
• chapter-infos 章节目录
• get-progress 阅读进度
• read-init 开始阅读
• read 上报阅读进度
• bookmark-list 书签列表
• chapter-content 章节内容解密
• underlines 章节划线
• read-reviews 章节热门想法
• user 用户信息
• categories 分类列表
• category-info 分类详情
• category-books 分类图书
• recommend-books 推荐书籍
• balance 账户余额
• member-card-summary 会员卡信息
• review-list 书评列表
• review-single 书评详情
• review-add 新增书评

凭据

不要把 Cookie 写进仓库。测试脚本从环境变量读取：

$env:WEREAD_COOKIE="你的微信读书 Cookie"

安装

cd APIS/wereadapi
python -m pip install -r requirements.txt

测试

python tests/weread_api_test.py login-getuid
python tests/weread_api_test.py categories
python tests/weread_api_test.py shelf-sync
python tests/weread_api_test.py book-info --book-id 3300008485

写入类接口默认 dry-run，必须显式加 --execute 才会真实调用：

python tests/weread_api_test.py shelf-add --book-id 3300008485 --execute
python tests/weread_api_test.py review-add --book-id 3300008485 --content "不错" --execute

文档索引

见 docs/README.md。