# Caphras Archives — A scholar's compendium of the world of Black Desert Online

A Black Desert Online (BDO) game database, datamined from live game
files and served as HTML at https://bdo.everla.st. Every page is also available
as structured markdown for LLM / agent consumption: append `.md` to any
entity URL to get the markdown twin.

## Convention

HTML:      https://bdo.everla.st/item/733
Markdown:  https://bdo.everla.st/item/733.md

## Endpoints

### Discovery & search

- https://bdo.everla.st/llms.txt — this document
- https://bdo.everla.st/search.md?q=QUERY — FTS5 search, returns up to 50
  cross-entity results with markdown links to each
- https://bdo.everla.st/search.json?q=QUERY — same data as JSON (lighter)
- https://bdo.everla.st/sitemap.xml — full sitemap index (HTML + .md variants)

### Entity detail pages

Each appends `.md` to the HTML URL. IDs are integers.

- https://bdo.everla.st/item/<item_id>.md
- https://bdo.everla.st/npc/<npc_id>.md
- https://bdo.everla.st/skill/<skill_id>.md
- https://bdo.everla.st/knowledge/<knowledge_id>.md
- https://bdo.everla.st/quest/<quest_group>.md
- https://bdo.everla.st/legacy-quest/<quest_no_raw>.md

A known example: https://bdo.everla.st/item/733.md (Tough Whale Tendon Elixir).

## What's in each page

Entity markdown mirrors the HTML page's full content — crafting recipes,
drop tables, quest reward ladders, amity rewards, cross-entity "see
also" links, accessory enhancement ladders, etc. Entries cross-link via
markdown links so you can traverse the data graph by following them.

## Usage guidelines

- Please keep request volume reasonable — the site runs on modest
  hardware. Rate limits are generous (300 detail lookups/minute per IP)
  but not unlimited.
- Follow 301 redirects; some entity stubs redirect to their canonical
  page (e.g. knowledge-proxy items → knowledge entries).
- Names have BDO color/keybind markup stripped; everything else matches
  what the game displays.
- No authentication required. If you build something nice with this,
  we'd love to hear about it — see https://bdo.everla.st footer for contact.