---
name: book-bot.app
description: book-bot.app provides two search endpoints: one that queries audiobookbay.lu for audiobooks by title, author, or narrator, and one that queries Anna's Archive for ebooks and print books by title and author. Both return metadata and URLs intended to be passed to separate downstream endpoints for magnet links or download links.
host: book-bot.app
---

# book-bot.app

book-bot.app is a search aggregator for book discovery across two distinct sources: audiobookbay.lu for audiobooks and Anna's Archive for general book formats. It serves agents that need to locate a specific title or author and retrieve identifiers (slugs or URLs) required by downstream resolution endpoints. It does not itself return downloadable files or magnet links.

## When to use this host

Use book-bot.app when an agent needs to locate an audiobook on audiobookbay.lu or a book on Anna's Archive and retrieve the identifiers required for downstream link resolution. Do not use this host to fetch actual magnet links or download links directly — those require separate endpoints (/api/audiobooks/details and /api/books/download-link respectively) that are not part of this host's exposed skills. This host is not suitable for browsing by genre, ISBN, or subject keyword alone, and cannot search ebook or print formats via the audiobook skill. If the agent already has a slug or Anna's Archive URL, skip this host entirely and call the resolution endpoint directly.

## Capabilities

### Audiobook Discovery

Searches audiobookbay.lu for audiobooks matching a title, author, or narrator query, returning slugs and metadata needed to fetch magnet links from a separate details endpoint.

- **`search-audiobooks`** — Searches audiobookbay.lu for audiobooks by title, author, or narrator and returns up to ~12 result entries with slugs, metadata, and cover images.

### Book Discovery

Searches Anna's Archive for books by title and optional author, returning result URLs, cover thumbnails, and format/size metadata needed to resolve download links from a separate endpoint.

- **`search-books-on-annas-archive`** — Searches Anna's Archive for books by title and optional author, returning up to 10 results with metadata and URLs usable for download-link resolution.

## Skill reference

### `search-audiobooks`

**Audiobook Search** — Searches audiobookbay.lu for audiobooks by title, author, or narrator and returns up to ~12 result entries with slugs, metadata, and cover images.

*Use when:* Use when an agent needs to find audiobooks matching a title, author, or narrator query and retrieve slugs to pass to the audiobook details endpoint for magnet links.

*Not for:* Do not use to fetch magnet links or full audiobook details directly; pass the returned slug to /api/audiobooks/details instead. Not suitable for ebook or print book searches.

**Inputs:**

- `query` (string, required) — Search query string — title, author, or narrator. Between 1 and 200 characters.
- `page` (integer) — Page number of results to return, defaults to 1. Minimum 1, maximum 20.

**Returns:** Returns an audiobooks array of up to ~12 objects each containing a slug, title, detail page URL, cover thumbnail, category array, language, and keyword tags.

**Example:** `{"query": "Agatha Christie murder mystery audiobook", "page": 1}`

---

### `search-books-on-annas-archive`

**Book Search on Anna's Archive** — Searches Anna's Archive for books by title and optional author, returning up to 10 results with metadata and URLs usable for download-link resolution.

*Use when:* Use when an agent needs to find a book by title (and optionally author) and retrieve Anna's Archive result URLs, cover thumbnails, and format/size details to pass downstream to a download-link endpoint.

*Not for:* Do not use for fetching the actual download link or file; pass the returned URL to /api/books/download-link for that. Not suitable for browsing by genre, ISBN, or subject keyword alone.

**Inputs:**

- `bookName` (string, required) — The title of the book to search for. Must be at least 1 character.
- `author` (string) — The author of the book. Optional filter to narrow results.

**Returns:** Returns a books array of up to 10 entries, each with an Anna's Archive URL, cover thumbnail, title, author string, and format/size/year details string.

**Example:** `{"bookName": "The Pragmatic Programmer: Your Journey To Mastery, 1999 Edition", "author": "Andrew Hunt"}`

---