--- name: www.book-bot.app description: www.book-bot.app provides two skills: a book search against Anna's Archive returning metadata and URLs, and a paid premium action endpoint requiring a 0.50 USDC payment on the Base network. Together they support a search-then-act pattern for book discovery and retrieval. host: www.book-bot.app --- # www.book-bot.app Book-Bot is a book discovery and retrieval service built on top of Anna's Archive. It serves agents that need to find books by title or author and then obtain download links (EPUBs) or invoke premium actions. The host is split into a free search tier and a paid premium tier gated by on-chain USDC payment on Base. ## When to use this host Use this host when an agent needs to search for books by title or author against Anna's Archive and optionally retrieve EPUBs or invoke premium book actions. The search skill is free; the premium action requires the agent to be capable of authorizing exact 0.50 USDC payments on the Base network (eip155:8453) within a 5-minute window — do not route here if the agent lacks on-chain payment capability. This host is not suitable for bulk catalog enumeration, streaming content, or general web search. It does not expose a standalone free download-link endpoint; download-link resolution is handled through the premium action after a search. ## Capabilities ### Book Discovery Searches Anna's Archive by title and optional author, returning up to 10 candidate books with metadata and URLs that can be passed downstream for download-link resolution. - **`search-books`** — Searches Anna's Archive for books by title and optional author, returning up to 10 matching results with metadata and URLs for downstream download-link resolution. ### Premium Paid Actions Executes a gated Book-Bot premium action after an exact 0.50 USDC payment on Base (eip155:8453), returning the action result. - **`execute-bookbot-premium-action`** — Executes a premium Book-Bot action on the book-bot.app platform after an exact 0.50 USDC (USD Coin v2) payment on Base (eip155:8453). ## Workflows ### Search and Retrieve Book *Use when an agent needs to locate a specific book and then obtain its download link or invoke a premium action on it.* 1. **`search-books`** — Search by title and optional author to get a list of candidate books with their result URLs. 2. **`execute-bookbot-premium-action`** — Pass the selected book's URL and authorize a 0.50 USDC payment on Base to invoke the premium action (e.g., download-link resolution) for the chosen result. ## Skill reference ### `search-books` **Book Search API** — Searches Anna's Archive for books by title and optional author, returning up to 10 matching results with metadata and URLs for downstream download-link resolution. *Use when:* Use when an agent needs to find book candidates by title (and optionally author) before fetching a download link; each result URL can be passed directly to /api/books/download-link to retrieve an EPUB. *Not for:* Do not use to retrieve a download link directly; pass the returned result URLs to /api/books/download-link for that step. Not suitable for streaming or bulk catalog enumeration. **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). Narrows results when provided. **Returns:** Returns a books array of up to 10 entries, each with an Anna's Archive md5 URL, cover thumbnail, title, author, and format/size/year details string. **Example:** `{"bookName": "Harry Potter and the Sorcerer's Stone", "author": "J. K. Rowling"}` --- ### `execute-bookbot-premium-action` **BookBot Premium Action** — Executes a premium Book-Bot action on the book-bot.app platform after an exact 0.50 USDC (USD Coin v2) payment on Base (eip155:8453). *Use when:* Use when an agent needs to invoke a paid Book-Bot premium action and is prepared to authorize an exact 0.50 USDC payment on the Base network within a 5-minute timeout window. *Not for:* Do not use if the agent cannot authorize USDC payments on Base (eip155:8453), or if the required action is available via a free Book-Bot endpoint. **Inputs:** - `X-PAYMENT` (string, required) — x402 payment header containing the exact USDC v2 payment authorization for 500000 atomic units (0.50 USDC) on Base (eip155:8453), paying to 0x26b354827942a0802552e433d357c78d78d2e987. **Returns:** Returns the result of the premium Book-Bot action after the 0.50 USDC payment on Base is verified; exact response fields depend on the action performed. **Example:** `{"method":"POST","url":"https://www.book-bot.app/api/x402","headers":{"X-PAYMENT":"","Content-Type":"application/json"}}` ---