Searches the library by title, author, series, publisher and tags. Calibre-Web returns every match in a single response, so broad queries on a large library are truncated client-side — totalFound reports the real match count. Book entries include per-format download URLs and a cover URL; fetch the cover image itself with get_cover.

Lists books from one of the Calibre-Web views: new (recently added, default), hot (most downloaded), rated (best rated), discover (random selection), read / unread (per-user reading state), or all (the full library ordered by title, optionally narrowed to titles starting with a letter). Page size is a server-side setting; pass the returned pagination.nextOffset as offset to fetch the next page. The discover view is random and not paginated.

Lists the shelves visible to the configured user: every public shelf plus the user’s own private ones. Use the returned id with get_shelf_books. isPublic is only reported on English-locale instances (Calibre-Web marks public shelves with a localized title suffix).

Lists the books on a shelf, in the shelf’s own order. Shelf ids come from list_shelves. Book entries include per-format download URLs and a cover URL; fetch the cover image itself with get_cover.

Fetches the cover of a book and returns it as an image. Book ids come from the other tools (books with id null have no cover). Calibre-Web serves the full-size cover; images over 1 MB are refused to protect the context window — use the coverUrl from the book entry instead.

Returns the total number of books, authors, categories (tags) and series in the library.