# CANOA — instructions for Hermes Agent

This file is a specialized guide for Hermes Agent (Nous Research) working with the CANOA catalog.

## Context
CANOA (https://canoanumis.org/) is a non-commercial open catalog of ancient world coinage (Greece, Rome, Persia, Carthage, Byzantium).
The user is a Russian-speaking ancient coinage researcher. Answer in Russian unless stated otherwise.

## Workflow (mandatory)
1. First /api/search?q=<query> — find the ruler/mint/denomination and get its URI.
2. Then /api/coins with filters (authority=URI, mint=id, date_from/date_to, denomination, material) — the coin list.
3. Details — /api/coins/<slug>/ (slug from the list).
4. ALWAYS verify data with real API calls — never invent catalog numbers, dates or attributions. The user demands verifiable data: «verify, don't invent!».

## Citation
- Catalog numbers: ocre_id in corpus notation (ric.1(2).ner.5 → «RIC I (2nd ed.) Nero 5»).
- URIs: http://nomisma.org/id/<concept> (nero, athens, denarius...).
- Coin links: https://canoanumis.org/coins/<slug>/.

## Constraints
- Images belong to museums; many licenses allow non-commercial use only. Do not reuse images outside the site.
- The API returns image only for existing files (lost PAS/Gallica — empty string); banner PNGs — /banner/<slug>/<WxH>.png(-light).
- Collections abc_exemplars, rutgers, ashm_ocre, ashm_pella are hidden on the site (rights do not allow) — do not link to them.
- The API returns at most 100 records per page (per_page); for full lists use page.\n- HTML version of the list: /api/coins?<filters>&format=html (no JS, links only) — convenient for crawlers.
- Bilingualism: pages / (RU) and /en/ (EN); label_ru/label_en fields in the API.

## Quick examples
- Nero's coins from Rome: /api/coins?authority=http://nomisma.org/id/nero&mint=36&per_page=100
- Period 54–68 CE, Rome: /api/coins?date_from=54&date_to=68&mint=36
- Athenian coinage: /api/filter-options?field=mint → find Athens → /api/coins?mint=<id>
- Denarii: /api/coins?denomination=http://nomisma.org/id/denarius&per_page=100
- Most collected types (by museum specimens): /api/coins?sort=specimens&per_page=100 — every item has specimen_count; sort=-specimens — rarest first

## Files
- /llms.txt — site map; /llms-full.txt — full API reference; /agents.md — general agent instructions; /api/crawlers — bot traffic stats (days 1–14 or from/to YYYY-MM-DD).
- /edu/ — Canoa // edu (schools, LTI 1.3): public pages are indexed (/edu/curriculum/, /edu/lesson-plans/, /edu/pricing/, /edu/faq/, /edu/contact/, /edu/for-homeschool/, /edu/legal/*); /edu/assignment/*, /edu/teacher/*, /edu/lti/* — only via an LTI session, do not bypass (anti-cheating).

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