Goodreads MCP server for AI agents
Let Claude, ChatGPT or your own agent read and act on Goodreads: 23 typed functions through one MCP server. No Goodreads API key needed.
- Site
- goodreads.com
- Functions
- 23
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for Goodreads alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/goodreadsOne MCP server for Goodreads and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes. Functions that need a login use the person's own account: how sign-in works.
Functions
Open a function to see its arguments, what it returns and how to call it.
getAuthorReads one author's bio, genre, influences, website, rating/review/follower stats and a preview of their books off their page.Arguments
Name Type Required idOrUrlstringYes Returns
GoodreadsAuthorinterface GoodreadsAuthorBook { legacyId: string; title: string; url: string; averageRating?: number; ratingsCount?: number; publishedYear?: number; } interface GoodreadsAuthor { legacyId: string; name: string; url: string; image?: string; born?: string; website?: string; genres: string[]; influences: string[]; bio?: string; memberSince?: string; averageRating?: number; ratingsCount?: number; reviewsCount?: number; worksCount?: number; followersCount?: number; books: GoodreadsAuthorBook[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/goodreads/getAuthorCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.goodreads.getAuthor("3389.Stephen_King");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.goodreads.getAuthor("3389.Stephen_King"))curl -X POST https://api.bowmark.ai/v1/sites/goodreads/getAuthor \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"idOrUrl":"3389.Stephen_King"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.goodreads.getAuthor("3389.Stephen_King");getAuthorBooksLists an author's full bibliography, 30 books a page.Arguments
Name Type Required idOrUrlstringYes pagenumberNo Returns
GoodreadsAuthorBook[]interface GoodreadsAuthorBook { legacyId: string; title: string; url: string; averageRating?: number; ratingsCount?: number; publishedYear?: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/goodreads/getAuthorBooksCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.goodreads.getAuthorBooks("3389.Stephen_King");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.goodreads.getAuthorBooks("3389.Stephen_King"))curl -X POST https://api.bowmark.ai/v1/sites/goodreads/getAuthorBooks \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"idOrUrl":"3389.Stephen_King"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.goodreads.getAuthorBooks("3389.Stephen_King");getBookReads one book's full record off its page.Arguments
Name Type Required idOrUrlstringYes Returns
GoodreadsBookinterface GoodreadsBook { legacyId: string; title: string; titleComplete?: string; url: string; authorName?: string; authorUrl?: string; format?: string; pageCount?: number; isbn?: string; language?: string; publisher?: string; genres: string[]; description?: string; averageRating?: number; ratingsCount?: number; textReviewsCount?: number; /** The series this book belongs to, with its position; pass its url to getSeries. Empty for a standalone book. */ series: { title: string; url: string; position?: string }[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/goodreads/getBookCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.goodreads.getBook("2767052");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.goodreads.getBook("2767052"))curl -X POST https://api.bowmark.ai/v1/sites/goodreads/getBook \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"idOrUrl":"2767052"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.goodreads.getBook("2767052");getBookEditionsLists the editions of a book (publisher, date, format, pages, ISBN, language, rating), 10 a page.Arguments
Name Type Required idOrUrlstringYes pagenumberNo Returns
GoodreadsBookEdition[]interface GoodreadsBookEdition { legacyId: string; title: string; url: string; published?: string; publisher?: string; format?: string; pages?: number; isbn?: string; isbn10?: string; language?: string; averageRating?: number; ratingsCount?: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/goodreads/getBookEditionsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.goodreads.getBookEditions("2767052");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.goodreads.getBookEditions("2767052"))curl -X POST https://api.bowmark.ai/v1/sites/goodreads/getBookEditions \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"idOrUrl":"2767052"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.goodreads.getBookEditions("2767052");getBookQuotesLists the quotes readers have attached to one book, with the quote text, its page and the like count, 30 a page.Arguments
Name Type Required idOrUrlstringYes pagenumberNo Returns
GoodreadsBookQuote[]interface GoodreadsBookQuote { id: string; text: string; authorName?: string; likes?: number; tags: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/goodreads/getBookQuotesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.goodreads.getBookQuotes("2767052");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.goodreads.getBookQuotes("2767052"))curl -X POST https://api.bowmark.ai/v1/sites/goodreads/getBookQuotes \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"idOrUrl":"2767052"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.goodreads.getBookQuotes("2767052");getBookReviewsReads a page of member reviews for one book.Arguments
Name Type Required idOrUrlstringYes pageNumbernumberNo Returns
GoodreadsReviewRow[]interface GoodreadsReviewRow { id: string; text: string; createdAt?: number; reviewerName?: string; reviewerUrl?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/goodreads/getBookReviewsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.goodreads.getBookReviews("2767052");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.goodreads.getBookReviews("2767052"))curl -X POST https://api.bowmark.ai/v1/sites/goodreads/getBookReviews \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"idOrUrl":"2767052"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.goodreads.getBookReviews("2767052");getListReads one curated Listopia list.Arguments
Name Type Required idOrUrlstringYes Returns
GoodreadsListBook[]interface GoodreadsListBook { legacyId: string; rank: number; title: string; url: string; authorName?: string; authorUrl?: string; averageRating?: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/goodreads/getListCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.goodreads.getList("1.Best_Books_Ever");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.goodreads.getList("1.Best_Books_Ever"))curl -X POST https://api.bowmark.ai/v1/sites/goodreads/getList \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"idOrUrl":"1.Best_Books_Ever"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.goodreads.getList("1.Best_Books_Ever");getMemberProfileReads a member's PUBLIC profile summary.Arguments
Name Type Required idOrUrlstringYes Returns
GoodreadsMemberProfileinterface GoodreadsMemberProfile { name: string; username?: string; location?: string; booksCount?: number; friendCount?: number; shelfCounts: Record<string, number>; favoriteGenres: string[]; // true when the member's own privacy setting restricts this page to // signed-in visitors, shelfCounts/favoriteGenres are empty because the // site never sent them, not because the member has none. private: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/goodreads/getMemberProfileCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.goodreads.getMemberProfile("1-otis-chandler");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.goodreads.getMemberProfile("1-otis-chandler"))curl -X POST https://api.bowmark.ai/v1/sites/goodreads/getMemberProfile \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"idOrUrl":"1-otis-chandler"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.goodreads.getMemberProfile("1-otis-chandler");getMemberShelfLists the books on one of a member's shelves (read, currently-reading, want-to-read, or a custom shelf).Arguments
Name Type Required idOrUrlstringYes shelfstringNo pageNumbernumberNo Returns
GoodreadsShelfBook[]interface GoodreadsShelfBook { legacyId?: string; // absent only when the book has no cover title: string; url: string; reviewUrl?: string; authorName?: string; authorUrl?: string; coverUrl?: string; // the member's own 1-5 rating on this shelf; 0 means not rated userRating: number; reviewSnippet?: string; shelves: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/goodreads/getMemberShelfCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.goodreads.getMemberShelf("1-otis-chandler", "read");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.goodreads.getMemberShelf("1-otis-chandler", "read"))curl -X POST https://api.bowmark.ai/v1/sites/goodreads/getMemberShelf \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"idOrUrl":"1-otis-chandler","shelf":"read"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.goodreads.getMemberShelf("1-otis-chandler", "read");getNewsFeedReads the signed-in caller's home feed.Arguments
None.
Returns
GoodreadsUpdate[]interface GoodreadsUpdate { actorName: string; actorUrl?: string; action: string; bookTitle?: string; bookUrl?: string; bookId?: string; author?: string; url?: string; timestamp?: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/goodreads/getNewsFeedCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.goodreads.getNewsFeed();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.goodreads.getNewsFeed())curl -X POST https://api.bowmark.ai/v1/sites/goodreads/getNewsFeed \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.goodreads.getNewsFeed();getOwnProfileReads the signed-in caller's own profile.Arguments
None.
Returns
GoodreadsMemberProfile & { memberId: string }interface GoodreadsMemberProfile { name: string; username?: string; location?: string; booksCount?: number; friendCount?: number; shelfCounts: Record<string, number>; favoriteGenres: string[]; // true when the member's own privacy setting restricts this page to // signed-in visitors, shelfCounts/favoriteGenres are empty because the // site never sent them, not because the member has none. private: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/goodreads/getOwnProfileCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.goodreads.getOwnProfile();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.goodreads.getOwnProfile())curl -X POST https://api.bowmark.ai/v1/sites/goodreads/getOwnProfile \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.goodreads.getOwnProfile();getSeriesReads a book series' reading order.Arguments
Name Type Required idOrUrlstringYes Returns
GoodreadsSeriesinterface GoodreadsSeriesBook { number?: string; legacyId: string; title: string; url: string; author?: string; averageRating?: number; ratingsCount?: number; numPages?: number; } interface GoodreadsSeries { seriesId: string; title: string; url: string; books: GoodreadsSeriesBook[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/goodreads/getSeriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.goodreads.getSeries("73758-the-hunger-games");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.goodreads.getSeries("73758-the-hunger-games"))curl -X POST https://api.bowmark.ai/v1/sites/goodreads/getSeries \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"idOrUrl":"73758-the-hunger-games"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.goodreads.getSeries("73758-the-hunger-games");getSimilarBooksLists the books Goodreads suggests next to one book.Arguments
Name Type Required idOrUrlstringYes Returns
GoodreadsSimilarBook[]interface GoodreadsSimilarBook { legacyId: string; title: string; url: string; imageUrl?: string; authorName?: string; averageRating?: number; ratingsCount?: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/goodreads/getSimilarBooksCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.goodreads.getSimilarBooks("2767052");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.goodreads.getSimilarBooks("2767052"))curl -X POST https://api.bowmark.ai/v1/sites/goodreads/getSimilarBooks \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"idOrUrl":"2767052"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.goodreads.getSimilarBooks("2767052");listGenreBooksBrowses one genre shelf, the books Goodreads itself files under that genre tag, newest/most-popular first.Arguments
Name Type Required genrestringYes Returns
GoodreadsBookRow[]interface GoodreadsBookRow { legacyId: string; title: string; url: string; authorName?: string; authorUrl?: string; averageRating?: number; ratingsCount?: number; textReviewsCount?: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/goodreads/listGenreBooksCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.goodreads.listGenreBooks("science-fiction");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.goodreads.listGenreBooks("science-fiction"))curl -X POST https://api.bowmark.ai/v1/sites/goodreads/listGenreBooks \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"genre":"science-fiction"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.goodreads.listGenreBooks("science-fiction");rateBookSets the signed-in caller's own star rating (1-5) on a book.Arguments
Name Type Required idOrUrlstringYes rating1 | 2 | 3 | 4 | 5Yes Returns
{ legacyId: string; rating: number }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/goodreads/rateBookCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.goodreads.rateBook("2767052", 5);import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.goodreads.rateBook("2767052", 5))curl -X POST https://api.bowmark.ai/v1/sites/goodreads/rateBook \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"idOrUrl":"2767052","rating":5}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.goodreads.rateBook("2767052", 5);searchAuthorsFinds Goodreads authors by name; returns each match's id, url, books-on-shelf count and location.Arguments
Name Type Required querystringYes Returns
GoodreadsAuthorSearchRow[]interface GoodreadsAuthorSearchRow { legacyId: string; name: string; url: string; memberUrl?: string; location?: string; booksCount?: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/goodreads/searchAuthorsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.goodreads.searchAuthors("stephen king");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.goodreads.searchAuthors("stephen king"))curl -X POST https://api.bowmark.ai/v1/sites/goodreads/searchAuthors \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"stephen king"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.goodreads.searchAuthors("stephen king");searchBooksRuns the site's book search and returns title, author, url and (when the card shows one) average rating per row.Arguments
Name Type Required querystringYes Returns
GoodreadsBookRow[]interface GoodreadsBookRow { legacyId: string; title: string; url: string; authorName?: string; authorUrl?: string; averageRating?: number; ratingsCount?: number; textReviewsCount?: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/goodreads/searchBooksCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.goodreads.searchBooks("the hunger games");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.goodreads.searchBooks("the hunger games"))curl -X POST https://api.bowmark.ai/v1/sites/goodreads/searchBooks \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"the hunger games"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.goodreads.searchBooks("the hunger games");searchQuotesRuns the public quotes search and returns quote text with its attributed author or book.Arguments
Name Type Required querystringYes Returns
GoodreadsQuote[]interface GoodreadsQuote { id: string; text: string; authorName?: string; authorUrl?: string; bookTitle?: string; bookUrl?: string; likes?: number; tags: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/goodreads/searchQuotesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.goodreads.searchQuotes("courage");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.goodreads.searchQuotes("courage"))curl -X POST https://api.bowmark.ai/v1/sites/goodreads/searchQuotes \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"courage"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.goodreads.searchQuotes("courage");writeReviewPosts a text review (with an optional star rating) on a book as the signed-in caller.Arguments
Name Type Required idOrUrlstringYes textstringYes rating1 | 2 | 3 | 4 | 5No Returns
{ legacyId: string; rating?: number; posted: true }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/goodreads/writeReviewCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.goodreads.writeReview("2767052", "A quiet test review.");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.goodreads.writeReview("2767052", "A quiet test review."))curl -X POST https://api.bowmark.ai/v1/sites/goodreads/writeReview \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"idOrUrl":"2767052","text":"A quiet test review."}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.goodreads.writeReview("2767052", "A quiet test review.");
addToShelfAdds a book to one of the signed-in caller's shelves (want-to-read, currently-reading, read, or a custom shelf), creating the shelf if it does not…Arguments
Name Type Required idOrUrlstringYes shelfstringNo Returns
{ legacyId: string; shelf: string; shelved: true }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/goodreads/addToShelfCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.goodreads.addToShelf("<idOrUrl>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.goodreads.addToShelf("<idOrUrl>"))curl -X POST https://api.bowmark.ai/v1/sites/goodreads/addToShelf \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"idOrUrl":"<idOrUrl>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.goodreads.addToShelf("<idOrUrl>");followUserFollows another member as the signed-in caller.Arguments
Name Type Required idOrUrlstringYes Returns
{ memberId: string; following: true }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/goodreads/followUserCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.goodreads.followUser("<idOrUrl>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.goodreads.followUser("<idOrUrl>"))curl -X POST https://api.bowmark.ai/v1/sites/goodreads/followUser \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"idOrUrl":"<idOrUrl>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.goodreads.followUser("<idOrUrl>");removeFromShelfRemoves a book from one of the signed-in caller's shelves.Arguments
Name Type Required idOrUrlstringYes shelfstringYes Returns
{ legacyId: string; shelf: string; shelved: false }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/goodreads/removeFromShelfCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.goodreads.removeFromShelf("<idOrUrl>", "<shelf>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.goodreads.removeFromShelf("<idOrUrl>", "<shelf>"))curl -X POST https://api.bowmark.ai/v1/sites/goodreads/removeFromShelf \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"idOrUrl":"<idOrUrl>","shelf":"<shelf>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.goodreads.removeFromShelf("<idOrUrl>", "<shelf>");unfollowUserStops following another member as the signed-in caller.Arguments
Name Type Required idOrUrlstringYes Returns
{ memberId: string; following: false }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/goodreads/unfollowUserCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.goodreads.unfollowUser("<idOrUrl>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.goodreads.unfollowUser("<idOrUrl>"))curl -X POST https://api.bowmark.ai/v1/sites/goodreads/unfollowUser \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"idOrUrl":"<idOrUrl>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.goodreads.unfollowUser("<idOrUrl>");
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/goodreads/<function> - OpenAPI
/v1/sites/goodreads/openapi.json