Guides

Task-oriented walkthroughs for the things people actually do with public Goodreads data.

Each guide is built around a job rather than a command: reading books, works, editions and the people behind them, querying the local graph offline, crawling into a store, serving the data to a model, living with robots.txt, and shaping the output. They assume you have run the quick start.

Books, works and editions Read a printing, the work behind it, every edition of it, and the people, series, genres, lists and quotes attached. The store and the graph Everything goodread reads is folded into a local SQLite graph you can walk, search, query with SQL and export as JSONL or RDF. Crawling Walk out from a set of seeds, follow the edges, build a store, and pick up where you stopped. robots.txt and what it costs Which surfaces goodread will not read, what you lose, the routes around, and what --no-robots actually means. The MCP server Serve public Goodreads data to a model over stdio, with eleven read tools and three deliberate omissions. Output formats Render records as a table, JSON, CSV, RDF or your own template, and script against the exit codes.