goodreadslisted

# Goodreads Skill Full read + write access to Goodreads via RSS feeds and Playwright browser automation. ## Scripts ```bash # Read-only (RSS + scraping, no login required) R=scripts/goodreads-rss.py # Write (Playwright browser automation, requires one-time login) W=scripts/goodreads-write.sh ``` ## Setup See `references/SETUP.md` for installation and first-time login instructions. **Quick start:** ```bash # Install dependencies pip install playwright playwright-stealth playwright install chromium # Login to Goodreads (one-time, opens browser) ./scripts/goodreads-write.sh login ``` ## User Configuration Replace `<USER_ID>` with your Goodreads user ID in all commands below. > **How to find your user ID:** Go to your Goodreads profile page. The URL will be like: > `goodreads.com/user/show/12345678-yourname` — the number is your user ID. For write commands with RSS verification, set: ```bash export GOODREADS_USER_ID="<YOUR_USER_ID>" ``` --- ## Read Commands ### 1. View shelf ```bash python3 $R shelf <USER_ID> --shelf <shelf> [--limit N] [--sort <sort>] ``` | `--shelf` | Meaning | |---|---| | `currently-reading` | Currently reading | | `read` | Already read | | `to-read` | Want to read | | `<custom>` | Custom shelf | | `--sort` | Meaning | |---|---| | `date_read` | Date finished (default for `read`) | | `date_added` | Date added to shelf | | `rating` | Personal rating | | `title` | Book title | | `author` | Author name | | `avg_rating` | Average Goodreads rating