Goodreads
Overview
World's largest book community (Amazon-owned). Search books, get book details with ratings and reviews, and explore author profiles.
Workflows
Find a book and read reviews
searchBooks(q) → pick result → bookIdgetBook(bookId) → title, rating, description, genresgetReviews(bookId) → community reviews with ratings
Explore an author's work
searchBooks(q) → pick result → authorIdgetAuthor(authorId) → bio, bibliography with bookId per bookgetBook(bookId) → full detail on any book
Operations
| Operation |
Intent |
Key Input |
Key Output |
Notes |
| searchBooks |
find books by title/author/ISBN |
q |
bookId, title, author, authorId, averageRating |
entry point; 20 results/page |
| getBook |
full book detail |
bookId ← searchBooks |
title, author, ratingValue, description, genres, pageCount, isbn |
LD+JSON + DOM |
| getReviews |
community reviews |
bookId ← searchBooks |
name, rating, text, date |
up to 30 reviews from page |
| getAuthor |
author profile + bibliography |
authorId ← searchBooks |
name, bio, born, books[] |
books include bookId |
Quick Start
# Search for a book
openweb goodreads exec searchBooks '{"q": "dune"}'
# Get book details
openweb goodreads exec getBook '{"bookId": "44767458-dune"}'
# Get reviews for a book
openweb goodreads exec getReviews '{"bookId": "44767458-dune"}'
# Get author profile
openweb goodreads exec getAuthor '{"authorId": "58.Frank_Herbert"}'
1---2name: goodreads3description: Goodreads4---5# Goodreads67## Overview8World's largest book community (Amazon-owned). Search books, get book details with ratings and reviews, and explore author profiles.910## Workflows1112### Find a book and read reviews131. `searchBooks(q)` → pick result → `bookId`142. `getBook(bookId)` → title, rating, description, genres153. `getReviews(bookId)` → community reviews with ratings1617### Explore an author's work181. `searchBooks(q)` → pick result → `authorId`192. `getAuthor(authorId)` → bio, bibliography with `bookId` per book203. `getBook(bookId)` → full detail on any book2122## Operations2324| Operation | Intent | Key Input | Key Output | Notes |25|-----------|--------|-----------|------------|-------|26| searchBooks | find books by title/author/ISBN | q | bookId, title, author, authorId, averageRating | entry point; 20 results/page |27| getBook | full book detail | bookId ← searchBooks | title, author, ratingValue, description, genres, pageCount, isbn | LD+JSON + DOM |28| getReviews | community reviews | bookId ← searchBooks | name, rating, text, date | up to 30 reviews from page |29| getAuthor | author profile + bibliography | authorId ← searchBooks | name, bio, born, books[] | books include bookId |3031## Quick Start3233```bash34# Search for a book35openweb goodreads exec searchBooks '{"q": "dune"}'3637# Get book details38openweb goodreads exec getBook '{"bookId": "44767458-dune"}'3940# Get reviews for a book41openweb goodreads exec getReviews '{"bookId": "44767458-dune"}'4243# Get author profile44openweb goodreads exec getAuthor '{"authorId": "58.Frank_Herbert"}'45```
spike-faye-lei