weread

name	weread
description	WeChat Reading (微信读书) CLI tool for fetching notes and highlights. Use when: (1) user asks about weread/微信读书 notes or highlights, (2) fetching today's or recent reading notes, (3) exporting book highlights, (4) managing reading bookshelf, (5) any task involving reading notes from WeChat Reading.

weread-cli

CLI tool for fetching notes and highlights from WeChat Reading (微信读书).

Quick Start

# Login via WeChat QR code
weread login

# List books with notes
weread list

# Get highlights from a book
weread get <bookId>

Commands

Authentication

weread login     # Open browser for QR code login
weread logout    # Clear saved cookies
weread whoami    # Check login status

Fetching Data

# List all books with notes
weread list [--json]

# Get book highlights and reviews
weread get <bookId> [options]
  --json, -j       JSON output
  --highlights, -H Only show highlights
  --reviews, -R    Only show reviews
  --since, -s      Filter by date (today, yesterday, YYYY-MM-DD)

# List books from shelf (sorted by recent read time)
weread shelf [-n <limit>] [--json]

Practical Examples

1. Get Today's/Yesterday's Notes

Fetch notes created after a specific date:

# Today's highlights from a book
weread get CB_3x2HoH --since today


weread get CB_3x2HoH --since yesterday


weread get CB_3x2HoH --since 2024-01-15