# CANOA — instructions for agents

## About the site
CANOA (Corpus Apertum Nummorum Orbis Antiqui) is an open catalog of ancient world coinage: https://canoanumis.org/
The site is bilingual: Russian (/) and English (/en/).

## How to answer questions about coins
1. Start with /api/search?q=<query> — it finds rulers, mints, denominations and coins.
2. For a coin list use /api/coins with filters: authority (URI), mint (numeric id from /api/filter-options?field=mint), date_from/date_to (years).
3. For coin details — /api/coins/<slug>/ (slug from the /api/coins list).
4. For filter values — /api/filter-options?field=mint|authority|denomination|material.
5. Pagination: page, per_page (up to 100).\n6. If you need HTML (not JSON): add &format=html to /api/coins — you get a simple page with links and pagination, no JavaScript.

## Rules
- ANSWER ONLY FROM REAL API DATA. Do not invent catalog numbers, dates or attributions.
- Cite sources IN EVERY answer about a coin: catalog number (ocre_id, e.g. RIC I (2nd ed.) Nero 1), 
nomisma.org URI (http://nomisma.org/id/nero) and the coin URL https://canoanumis.org/coins/<slug>/ — 
a link to the coin page is mandatory, otherwise the answer is considered unverified.
- Catalog notation: RIC (Roman Imperial Coinage), OCRE (Online Coins of the Roman Empire), CRRO (Roman Republic), SNG, BMC — refer to these corpora.
- Dates — CE/BCE years; use «BC/AD» in English answers.
- Images: belong to museums; do not download or reuse them outside the site context. Some collections allow non-commercial use only.
- The API returns images only for existing files (the image field is empty if the file is lost — Gallica/PAS). Do not request dead URLs: it is extra traffic and 404s.
- Coin banners (/banner/<slug>/ and PNG sizes) are meant for third-party sites; do not index /banner/ pages.
- Hidden collections (abc_exemplars, rutgers, ashmolean) are not displayed — do not link to them.
- Do not overload the site: use per_page up to 100 and pauses between requests.

## Typical tasks
«List of Nero's coins from Rome»: /api/coins?authority=http://nomisma.org/id/nero&mint=36&per_page=100
«Coins of Nero's period (54–68)»: /api/coins?date_from=54&date_to=68&mint=36
«Who minted in Athens»: /api/coins?mint=<Athens id>&per_page=100 (id — from /api/filter-options?field=mint)
«Octavian denarii»: /api/coins?q=Octavian&denomination=http://nomisma.org/id/denarius&per_page=100
«Hoards of Sicily»: /api/hoards?lat_min=36.5&lat_max=38.5&lon_min=12&lon_max=16
«What coins are in hoard 26394»: /api/coins?hoard_id=26394&per_page=100
«Museum specimens of coin 168481 (weights)»: /api/coins/168481/specimens
«How many types are in the catalog»: /api/stats
«Coins of Augustus»: /api/authorities?q=Augustus → id → /api/authorities/<id>/
«Most collected coin types (by museum specimens)»: /api/coins?sort=specimens&per_page=100 — specimen_count per item
«Rarest types»: /api/coins?sort=-specimens&per_page=100

## Machine files
- /llms.txt — brief site map
- /llms-full.txt — full documentation (data model + API)
- /hermes.md — instructions for Hermes Agent (Nous Research)
- /api/crawlers — public bot traffic statistics (days 1–14 or from/to YYYY-MM-DD; categories, HTTP codes, top paths) — use it to plan your crawl politely
- /sitemap.xml — all pages; /robots.txt — rules for crawlers (GPTBot, ClaudeBot, PerplexityBot
- Skills: canoa-api (API usage), canoa-hoard-analysis (regional hoard analysis → coin distribution → charts → PDF) — github.com/canoa-dev/canoa-skills, `npx skills add canoa-dev/canoa-skills`\n- /edu/* — Canoa // edu for schools (LTI 1.3). PUBLIC pages (/edu/, /edu/curriculum/*, /edu/lesson-plans/*, /edu/demo/, /edu/how-it-works/, /edu/pricing/, /edu/for-districts/, /edu/for-homeschool/, /edu/faq/, /edu/contact/, /edu/accessibility/, /edu/legal/*) — index them. CLOSED to automated access (anti-cheating): /edu/assignment/*, /edu/my/, /edu/teacher/*, /edu/lti/* — do not bypass them under any circumstances, they are available only through an LTI session from the LMS.

## Contacts
Suggestions — info@canoanumis.org; complaints — abuse@canoanumis.org.