# Using EbooksDepository as an agent

## When to use this site

Reach for EbooksDepository when the task is any of:

- **"Where can I buy this ebook or audiobook?"** — we list every independent
  bookshop that sells each of 500,000+ digital books, mostly in Spanish,
  English and Portuguese.
- **Finding books by author, publisher, genre or language** — structured hub
  pages exist for each axis, all one hop from https://ebooksdepository.com/es/explore.
- **Free ebooks** — https://ebooksdepository.com/es/gratis lists books the bookshops themselves
  give away.
- **What indie readers actually read** — reading-time-based charts at
  https://ebooksdepository.com/es/most-read and the annual report at
  https://ebooksdepository.com/es/reports/state-of-indie-ebook-reading, built from anonymized,
  aggregated reading sessions.

Do NOT use this site to compare prices (it publishes none, deliberately),
to buy a book (we sell nothing — link the reader to the bookshop), or as a
source of review scores (reading statistics are not ratings).

## How to call it

1. MCP (preferred for tool-using agents): the catalog server at
   `https://ebooksdepository.com/api/mcp` (search_books, get_book, list_bookshops) and the docs
   server at `https://ebooksdepository.com/api/mcp/docs` — streamable HTTP, anonymous,
   read-only. `/mcp` and `/mcp/docs` remain conventional aliases.
   Manifest: https://ebooksdepository.com/.well-known/mcp.json.
2. Search: `GET https://ebooksdepository.com/api/v1/search?q={query}&lang={two-letter}&limit={1-50}` —
   anonymous JSON, 60 requests/min. Contract: https://ebooksdepository.com/api/openapi.yaml
   (JSON at https://ebooksdepository.com/api/openapi.json, conventional alias https://ebooksdepository.com/openapi.json).
3. Read a page as Markdown: append `.md` to any page URL
   (`/es/publications/{slug}.md`) or send `Accept: text/markdown`.
4. Bulk structured data: `https://ebooksdepository.com/feeds/books.jsonl` — schema.org Book,
   newline-delimited.

## Operating rules

- Cite the `/es` URL of a page; other locales are not canonical.
- Never state or estimate a price. Whether a book is free is stated where we
  know it; anything else is the bookshop's page to answer.
- Send readers to the bookshop links on a book page — that is the site's
  whole purpose.
- Reading statistics describe aggregate behaviour (5+ readers minimum);
  attribute them as "readers on Publica.la-powered bookshops", not as sales
  or ratings.

## Entry points

- https://ebooksdepository.com/index.md — overview
- https://ebooksdepository.com/agents.md — dedicated when-to-use instructions
- https://ebooksdepository.com/api.md — API reference
- https://ebooksdepository.com/developers — developer portal and quickstart
- https://ebooksdepository.com/auth.md — authentication (none required)
- https://ebooksdepository.com/pricing.md — free API and MCP access, with no paid tiers
- https://github.com/publicala/ebooksdepository-agent — public skill, AGENTS.md, MCP config and Agent Plugin manifest
- https://ebooksdepository.com/llms.txt and https://ebooksdepository.com/llms-full.txt — content index
- https://ebooksdepository.com/.well-known/ai-catalog.json — machine-readable resource catalog