Readwise & Reader Skill
Access your Readwise highlights and Reader saved articles.
Setup
Get your API token from: https://readwise.io/access_token
Set the environment variable:
bash
export READWISE_TOKEN="your_token_here"
Or add to ~/.clawdbot/clawdbot.json under "env".
Readwise (Highlights)
List books/sources
bash
node {baseDir}/scripts/readwise.mjs books [--limit 20]
Get highlights from a book
bash
node {baseDir}/scripts/readwise.mjs highlights [--book-id 123] [--limit 20]
Search highlights
bash
node {baseDir}/scripts/readwise.mjs search "query"
Export all highlights (paginated)
bash
node {baseDir}/scripts/readwise.mjs export [--updated-after 2024-01-01]
Reader (Saved Articles)
List documents
bash
node {baseDir}/scripts/reader.mjs list [--location new|later|archive|feed] [--category article|book|podcast|...] [--limit 20]
Get document details
bash
node {baseDir}/scripts/reader.mjs get <document_id>
Save a URL to Reader
bash
node {baseDir}/scripts/reader.mjs save "https://example.com/article" [--location later]
Search Reader
bash
node {baseDir}/scripts/reader.mjs search "query"
Notes
- •Rate limits: 20 requests/minute for Readwise, varies for Reader
- •All commands output JSON for easy parsing
- •Use
--helpon any command for options