siftivo
Search books, authors and series, get recommendations, and manage your own reading shelves.
- 0.1.0
- Version
- remote
- Transport
- 12
- Tools
Security review
Review passedReviewed 56m ago.
- tools: 12 tools scanned
- metadata: scanned
No findings.
Tools (12)
search_books
Keyword search over the Siftivo book catalog. Matches titles, authors, and descriptions. Returns works with the ids other Siftivo tools accept.
get_book
Full detail for one book: synopsis, authors, series position, genres, and its page on siftivo.com. Accepts a work id, an edition id, or a slug.
what_to_read_next
Given one book, what to read after it: the next books in its series, more by the same author, and books that read like it. This is the same set the book page on siftivo.com shows.
get_author
An author, their biography, and the works Siftivo holds for them. Accepts an author id or slug.
get_series
A series and its works in reading order. Accepts a series id or slug.
get_reading_index
The weekly Siftivo Reading Index: the fiction and nonfiction books moving most in cultural circulation this week, ranked.
recommend_from_description
Describe what someone is in the mood for, in their own words, and get books that match. It suits a theme, subject or feeling ("books about grief", "cozy mysteries set in Cornwall"), and matches on meaning rather than on a title or an author name.
recommend_from_titles
Give Siftivo a few books someone liked, by title, and get books like them. Titles are resolved against the catalog first; anything that does not resolve is reported back rather than guessed at.
get_my_library
The signed-in reader's own Siftivo library: what they want to read, are reading, finished, or set down, with their ratings.
add_to_library
Put a book on one of the signed-in reader's shelves, move it to a different shelf, rate it, or record how far through it they are. The workId is one returned by search_books, get_book or recommend_from_titles. "Finished it, four and a half stars" is one call with readingStatus FINISHED and rating 4.5. Each field given replaces what the reader had there before, so send a rating or a note only when they asked for that one to change. Omitting readingStatus leaves the book on the shelf it is already on.
get_my_book
Whether the signed-in reader has this book on a shelf, and if so which shelf, their rating and how far through they are. Answers "have I read this?" without pulling the whole library.
remove_from_library
Take a book off the signed-in reader's shelves entirely, discarding its shelf, progress and notes. The reader's rating for the book stays. This is removal rather than a shelf change: add_to_library with a new readingStatus moves a book between shelves instead.