# Anpheros Search: príznaky, stavy a liečby s ich zdrojmi

> Jeden verejný katalóg 1 174 príznakov, stavov a liečebných postupov v 20 jazykoch, pričom každý záznam obsahuje svoj zdroj: WHO ICD-10 a ICD-11, súhrny MedlinePlus, indikácie EMA a FDA citované nezmenené; REST, FHIR, MCP a jeden JSON súbor.

Source: https://developers.anpheros.com/sk/guides/anpheros-search

**Anpheros Search je jeden verejný katalóg 1 174 príznakov, stavov a liečebných postupov, vyhľadávateľný v 20 jazykoch, kde každý záznam uvádza svoj pôvod: kódy WHO ICD-10, kódy a názvy WHO ICD-11, súhrny MedlinePlus a indikácie liečby citované nezmenené od Európskej liekovej agentúry (EMA) a amerického Úradu pre potraviny a liečivá (FDA). Poskytuje sa ako REST API, ako terminológia HL7 FHIR R4 (CodeSystem, ConceptMap, `$lookup`), ako dva nástroje MCP pre AI asistentov a ako jeden JSON súbor.** Ide o všeobecné informácie pre každého, rovnaké pre každého čitateľa: nediagnostikuje a neodporúča liečbu.

## Stručný prehľad

| | |
|---|---|
| Verzia | `2026.10.5` (každá odpoveď uvádza, ktorá) |
| Záznamy | 1 174: 274 symptómov a nálezov (`SYM-…`), 495 stavov (`CON-…`), 405 liečebných postupov (`TRT-…`); identifikátory sa nikdy znovu nepoužívajú |
| Názvy | 17 947 názvov a synoným v 20 jazykoch; oficiálny názov ICD-11 a bežné názvy v angličtine, bežné názvy v ostatných jazykoch |
| Popisy | 1 092 súhrnov zdravotných tém MedlinePlus, doslovne, v angličtine a španielčine |
| Indikácie | 766 schválených použití citovaných nezmenených: štítky EMA (EÚ) a FDA (USA), každý s produktom, dátumom a odkazom |
| Odkazy | 257, každý so svojím zdrojom: liečba → stav (`indicated_for`) a symptóm ↔ stav (`may_be_associated_with`) |
| Štandardy | WHO ICD-10, WHO ICD-11 MMS 2025-01, RxNorm, čísla produktov EMA, HL7 FHIR R4 |
| Klinické hodnotenie | zatiaľ žiadne: `clinical_review: false` v každej odpovedi |

## Zdroje a licencie

Niè v katalógu nie je napísané spoloènosou Anpheros okrem názvov v iných jazykoch. Každý záznam obsahuje zoznam `attribution` s presným textom, ktorý si kadý zdroj vyaduje, a kadá indikácia má svoju vlastnú.

| Zdroj | Pou ité pre | Licencia a atribúcia |
|---|---|---|
| WHO ICD-10 (2019) a tabu ky prevodu WHO ICD-10 → ICD-11 (2025-01) | kódy ICD-10 (názvy WHO ICD-10 sa neposkytujú, kým WHO nepotvrdí licenciu), kód ICD-11 a jeho anglický názov | © WHO; ICD-11 pod CC BY-ND 3.0 IGO, názvy reprodukované nezmenené |
| Zdravotnícke témy MedlinePlus a MedlinePlus Connect (U.S. National Library of Medicine) | zhrnutie príznaku alebo stavu, anglické synonymá, oficiálny španielsky názov; ktorá téma pokrýva ktorú kategóriu ICD-10 | verejná doména; "Zdroj: MedlinePlus, National Library of Medicine." Len zhrnutia zdravotníckych tém: žiadna encyklopédia a žiadne liekové monografie |
| Údaje o liekoch EMA (EPAR) | liečivo, názvy liekov, terapeutická indikácia, terapeutická oblas (MeSH) | opätovné použitie s uvedením zdroja pri kadom použití: "Zdroj: European Medicines Agency (EMA), *produkt* — EPAR, *dátum*. © European Medicines Agency." |
| Štítky liekov openFDA | sekcia "indikácie a použitie" amerického štítku, obchodné názvy | CC0; "Údaje poskytnuté Úradom pre potraviny a liečivá USA." |
| RxNorm (NLM) | RXCUI zložky kadej látky | text atribúcie NLM |

**Názvy ICD-10 a kódy ATC sa neposkytujú.** Kým WHO nepotvrdí licenciu ICD-10, kód ICD-10 sa dodáva bez názvu WHO (`display: null`) a zobrazený oficiálny anglický názov je názov ICD-11, doslovne. Vylúèovanie ATC je na celej platforme vypnuté. Katalóg uchováva interný kód WHO ATC kadej látky, ale žiadna odpove, zdroj FHIR ani export ho neobsahuje, kým WHO Collaborating Centre for Drug Statistics Methodology neudeli povolenie. Lieèby sú identifikované poda látky (INN), RxNorm RXCUI a èísla produktu EMA.

## Vyhľadávanie (REST)

```bash
export API=https://platform.anpheros.com/v1
export KEY=sk_test_…

curl "$API/search?q=durere%20de%20cap&lang=ro"
```

`/v1/search` a `/v1/search/{id}` sú verejné: nie je potrebný žiadny API kľúč, s limitom 60 vyhľadávaní za minútu a 2 000 za deň na IP adresu, odpovedané s `Cache-Control: public` a `ETag`, a čitateľné z prehliadača na anpheros.com. S kľúčom (postačuje bezplatný sandbox kľúč) platia namiesto toho bežné API limity. Ostatné koncové body nižšie, FHIR a MCP, stále vyžadujú kľúč.

`q` zodpovedá menám a synonymám v každom jazyku (bez diakritiky, takže `durere de cap` a `Durere de cap` sú rovnaké), značkám, kódom ICD-10 a ICD-11, RxNorm RXCUIs a Anpheros ID. `type=symptom|condition|treatment` zužuje vyhľadávanie, `lang` vyberá jazyk `display`, `limit` (až 50) a `offset` ho stránkujú. Výsledky sú zoradené podľa toho, ako text zodpovedal (celé meno, začiatok mena, každé slovo, časť slova), potom abecedne: nikdy podľa popularity alebo akéhokoľvek skóre.

```json
{
  "data": [
    {
      "concept_id": "SYM-0047",
      "type": "symptom",
      "display": "Durere de cap (cefalee)",
      "display_lang": "ro",
      "system": "https://anpheros.com/fhir/CodeSystem/symptom",
      "status": "active",
      "matched": "durere de cap",
      "codes": [
        {"system": "http://hl7.org/fhir/sid/icd-10", "code": "R51", "display": null, "equivalence": "equivalent"},
        {"system": "http://id.who.int/icd/release/11/mms", "code": "MB4D", "display": "Headache, not elsewhere classified", "equivalence": "equivalent"}
      ],
      "definition": "Almost everyone has had a headache. Headache is the most common form of pain. It's a major…"
    }
  ],
  "total": 1,
  "release": "2026.10.5",
  "attribution": ["ICD-10 codes and titles © World Health Organization. …", "ICD-11 for Mortality and Morbidity Statistics, © World Health Organization, licensed under CC BY-ND 3.0 IGO."],
  "disclaimer": "General information only. Anpheros does not diagnose and does not recommend treatment. …"
}
```

Vyhľadávanie `Ozempic` nájde látku semaglutide, `acetaminophen` nájde paracetamol, `E11` nájde diabetes mellitus 2. typu.

## Univerzálne vyhľadávanie

Rovnaké `GET /v1/search` vracia aj `groups`: jedno vyhľadávacie pole pre všetko, čo Anpheros publikuje. Každá skupina je jedným druhom výsledku, v pevnom poradí, a skupina bez výsledkov sa vynechá. `types` vyberá skupiny (predvolené `symptom,condition,treatment,page,article,trial,document`); `limit` je počet položiek na skupinu.

| Skupina | Čo vyhľadáva | Zdroj |
|---|---|---|
| `symptom`, `condition`, `treatment` | vyššie uvedený katalóg | WHO, MedlinePlus, EMA, FDA (priradenie každej položky) |
| `article` | lekársku literatúru, vyhľadávanú naživo v Europe PMC: keď je termín v katalógu, podľa jeho anglického názvu v názvoch článkov (takže "migrenă" nájde články o migréne) | Europe PMC (EMBL-EBI); iba názov, autori, časopis, rok, DOI a príznak otvorenia prístupu, nikdy abstrakt; článok sa otvorí v Europe PMC |
| `trial` | klinické štúdie, ktoré sú v náborovej fáze, čoskoro začnú alebo stále prebiehajú, vyhľadávané naživo v ClinicalTrials.gov: uznávaná podmienka alebo symptóm ako študovaná podmienka, uznávaný liek ako intervencia | ClinicalTrials.gov (U.S. National Library of Medicine), verejná doména; názov, stav, podmienky, krajiny, fázy a dátumy; záznam sa otvorí v ClinicalTrials.gov |
| `document` | oficiálne dokumenty nájdených liekov: informácie o produkte EMA (súhrn charakteristík produktu a písomná informácia pre používateľa) v jazyku, o ktorý sa žiadalo, keď ich EMA publikuje, inak v angličtine, a štítok FDA v DailyMed | EMA a FDA, prepojené, nikdy skopírované; každé s priradením EMA alebo FDA |
| `page` | verejné stránky anpheros.com (aplikácia, návody, vysvetlenia, transparentnosť), developers.anpheros.com, platform.anpheros.com a verejné komunitné miestnosti | Anpheros; indexované z našich vlastných sitemapov, iba názov, popis a krátky úryvok; komunitné stránky bez príspevkov alebo mien |

Každá položka má rovnaký tvar:

```json
{
  "type": "page",
  "id": "https://anpheros.com/ro/aplicatie/card-de-urgenta",
  "title": "Card de urgență medical pe telefon: grupa sanguină, alergii, medicamente",
  "snippet": "…",
  "url": "https://anpheros.com/ro/aplicatie/card-de-urgenta",
  "source": "anpheros.com",
  "source_attribution": "© Anpheros. Content from Anpheros public websites.",
  "codes": null,
  "date": "2026-10-17",
  "lang": "ro"
}
```

Položka katalógu používa ID záznamu ako `id`, jej bežný názov ako `title`, začiatok jej súhrnu z MedlinePlus ako `snippet`, jej kódy ICD-11 alebo RxNorm v `codes` a `https://platform.anpheros.com/v1/search/{id}` ako `url`. Stránky sú v jazyku, o ktorý sa žiadalo (angličtina, keď daný jazyk nemá zodpovedajúcu stránku); v rámci skupiny výsledky, ktoré sa zhodujú v názve, predchádzajú zhodám v texte. Externé zdroje sa vyhľadávajú naživo s krátkym časovým limitom a cachujú sa na hodiny: ak jeden neodpovie včas, jeho skupina sa vynechá a zvyšok vyhľadávania stále odpovedá.

## Jedna položka

```bash
curl "$API/search/TRT-0310"                                           # any type, no key needed
curl "$API/terminology/conditions?q=asthma&lang=de" -H "Authorization: Bearer $KEY"
curl "$API/terminology/treatments/TRT-0310" -H "Authorization: Bearer $KEY"
```

`GET /v1/terminology/conditions` a `GET /v1/terminology/treatments` zoznamujú alebo vyhľadávajú jeden typ, ako napríklad [`/v1/terminology/symptoms`](https://developers.anpheros.com/sk/guides/symptom-data-api); `GET /v1/search/{id}` vracia akúkoľvek položku v rovnakom tvare. Položka má `codes`, `labels` (oficiálny názov a bežné názvy, každý so svojou `review`), `synonyms`, `definition` (súhrn MedlinePlus s témou, z ktorej pochádza), `links`, `attribution`, `disclaimer` a `release`; liečba má tiež `substance` a `indications`. Výňatok:

```json
{
  "concept_id": "TRT-0310",
  "type": "treatment",
  "display": "Semaglutide",
  "codes": [
    {"system": "http://www.nlm.nih.gov/research/umls/rxnorm", "code": "1991302", "display": "semaglutide"},
    {"system": "https://www.ema.europa.eu/en/medicines/product-number", "code": "EMEA/H/C/004174", "display": null}
  ],
  "synonyms": [{"lang": "en", "text": "Ozempic"}, {"lang": "en", "text": "Rybelsus"}, {"lang": "en", "text": "Wegovy"}],
  "indications": [
    {
      "region": "EU",
      "product": "Kayshild",
      "product_id": "EMEA/H/C/006426",
      "text": "Kayshild is indicated in conjunction with diet and exercise for the treatment of adults with non-cirrhotic metabolic dysfunction-associated steatohepatitis (MAS…",
      "url": "https://www.ema.europa.eu/en/medicines/human/EPAR/kayshild",
      "document_date": "09/04/2026",
      "review": "source_quoted",
      "attribution": "Source: European Medicines Agency (EMA), Kayshild — EPAR, 09/04/2026. © European Medicines Agency.",
      "note": "Indication approved in the European Union (EMA)."
    }
  ],
  "clinical_review": false,
  "release": "2026.10.5"
}
```

Indikácie sú citované presne tak, ako ich zdroj publikuje (výňatok vyššie je tu skrátený, nie v API), najprv EÚ, potom USA, každá skupina v abecednom poradí podľa produktu. Schválené použitia sa líšia medzi krajinami, takže každé uvádza, kde je schválené.

## Prepojenia medzi záznamami

Prepojenie existuje iba vtedy, keď sa objaví v citovanom zdroji a uvádza, o aký zdroj ide a prečo:

- **`indicated_for` (liečba → stav), 249 prepojení.** EMA uvádza terapeutickú oblasť (MeSH heading) pre každý liek. Prepojenie sa vytvorí, keď je daná hlavička MeSH hlavičkou témy MedlinePlus presne jednej kategórie ICD-10, kategória nie je reziduálna („Iné…“, „…nešpecifikované“), oba názvy zdieľajú slovo a žiadna špecifickejšia hlavička rovnakého lieku sa neuplatňuje („Diabetes Mellitus“ ustupuje „Diabetes Mellitus, Type 2“). Z pohľadu stavu je rovnaké prepojenie `indicated_treatment` a zoznam je abecedný.
- **`may_be_associated_with` (symptóm ↔ stav), 8 prepojení.** Vytvorené, keď MedlinePlus uvádza tieto dve témy ako súvisiace a každá téma pomenúva presne tento symptóm alebo stav: napríklad kašeľ a akútna bronchitída, pálenie záhy a gastroezofageálna refluxná choroba, bolesť hlavy a migréna. Neznamená to, že osoba so symptómom má daný stav.

## FHIR terminológia

| Zdroj | Obsah |
|---|---|
| `CodeSystem/anpheros-condition` | stavy, s vlastnosťami `icd10` a `icd11` a názvami ako označenia |
| `CodeSystem/anpheros-treatment` | látky, s vlastnosťami `rxnorm` a `ema_product` (bez ATC) |
| `ConceptMap/anpheros-condition-to-icd10`, `ConceptMap/anpheros-condition-to-icd11` | stav → WHO kódy, s ekvivalenciou |
| `ConceptMap/anpheros-treatment-to-rxnorm` | látka → RxNorm ingredient |
| `CodeSystem/$lookup` | jeden koncept podľa `system` a `code`, v `displayLanguage` |

```bash
curl "https://platform.anpheros.com/fhir/R4/CodeSystem/\$lookup?system=https://anpheros.com/fhir/CodeSystem/condition&code=CON-0129&displayLanguage=de" \
  -H "Authorization: Bearer $KEY"
```

Symptómy si zachovávajú vlastný CodeSystem, ValueSet a ConceptMaps, popísané v [Symptom data API](https://developers.anpheros.com/sk/guides/symptom-data-api). Popisy, indikácie a odkazy sú dostupné iba cez REST API, spolu s ich zdrojmi.

## Pre AI asistentov (MCP)

[Anpheros MCP server](https://developers.anpheros.com/sk/guides/mcp) má dva nástroje pre katalóg: `search_health_terms` (query, optional type, language, limit) a `get_health_term` (an id such as `SYM-0047`, `CON-0129` or `TRT-0310`). Asistent, ktorý odpovedá na otázku o symptóme alebo lieku, môže namiesto svojej vlastnej pamäte uviesť odkaz na záznam, jeho kódy a zdroje. Nástroje vracajú rovnaké vyhlásenie o obmedzení zodpovednosti ako API.

## Celý katalóg ako jeden súbor

`https://platform.anpheros.com/site/search/anpheros-search-catalog.json` (približne 7 MB) obsahuje každý publikovaný záznam v každom jazyku, s kódmi, popismi, citovanými indikáciami, odkazmi, zdrojmi a atribúciou každého záznamu. Je to súbor, z ktorého sú zostavené stránky anpheros.com/search, a je opätovne generovaný pri každom vydaní.

## Ako bol zostavený katalóg

1. **Symptómy.** 86 konceptov z [Symptom Engine](https://developers.anpheros.com/sk/guides/symptom-engine), plus 188 nových: podkategórie kapitoly XVIII ICD-10, ktoré nie sú reziduálne (napríklad R06.0 dyspnoe, R43.0 strata čuchu) a kategórie R65, R75, R78, R83–R87 a R89. Úmrtia (R95–R99) sú vynechané.
2. **Stavy.** Každá 3-znakový kategória ICD-10 mimo kapitol XVIII a XX–XXII bola odoslaná do MedlinePlus Connect, služby Národnej lekárskej knižnice, ktorá mapuje kód na zdravotnú tému. Kategória vstúpi do katalógu, keď jej téma pokrýva maximálne tri kategórie; 495 tak urobilo. Súhrn témy sa stáva popisom. Názov MedlinePlus sa stáva bežným anglickým názvom iba vtedy, keď pomenúva to isté ako názov WHO.
3. **Liečby.** Každý liek s jednou účinnou látkou autorizovaný centrálne EMA, ktorého terapeutická oblasť zodpovedá téme stavu (soli sú zlúčené: acetát abirateronu je abirateron), plus 33 bežných liekov, ktoré sú autorizované národne a majú štítok FDA. Zložka RxNorm pochádza z RxNav.
4. **Názvy v 20 jazykoch.** Anglické názvy sú zdrojové názvy (`review: source`) a španielsky názov je španielsky názov MedlinePlus, ak existuje. Ostatné názvy sú preklady Anpheros vytvorené pomocou AI z anglických názvov a automaticky skontrolované na skript, zátvorky a číslice (`review: ai_reviewed`). Názvy liečebných postupov existujú v 15 jazykoch. V japončine, kórejčine, čínštine, arabčine a hindčine boli názvy napísané iba pre 80 široko používaných látok; inde je uvedený medzinárodný názov (INN).

## Limity

- Žiaden lekár neskúmal katalóg. Žiaden profesionálny lekársky prekladateľ neskúmal preložené názvy.
- Indikácie EMA sú v angličtine. Oficiálne verzie v iných jazykoch EÚ sú v informáciách o produkte EMA a zatiaľ nie sú v katalógu; Anpheros ich nebude prekladať.
- Indikácie FDA opisujú schválenie v Spojených štátoch. Údaje EMA pokrývajú iba centrálne autorizované lieky, takže mnohé staršie lieky majú iba označenie FDA alebo zatiaľ žiadnu indikáciu.
- Odkazy sledujú vlastné klasifikácie zdrojov (terapeutická oblasť EMA, súvisiace témy MedlinePlus): je ich málo a nie sú úplným zoznamom použití alebo príčin.
- "Čo ľudia hlásia" (anonymné počty od používateľov Anpheros, minimálne 20 osôb) zatiaľ nie je súčasťou katalógu.

## Súvisiace

- [Anpheros Symptom Engine: metodika](https://developers.anpheros.com/sk/guides/symptom-engine)
- [API pre dáta o symptómoch](https://developers.anpheros.com/sk/guides/symptom-data-api)
- [Kódové systémy FHIR](https://developers.anpheros.com/sk/guides/fhir-code-systems)
- [API pre lekársku terminológiu: LOINC, SNOMED, ICD-10, RxNorm](https://developers.anpheros.com/sk/guides/medical-terminology-api)
- [FHIR MCP server pre AI agentov](https://developers.anpheros.com/sk/guides/mcp)

## Stručné súhrny (Slovensky)

`https://platform.anpheros.com/site/search/anpheros-search-summaries.en.json` obsahuje stručné anglické súhrny pre väčšinu záznamov (záznam, ktorého citovaný text sa zmenil, dostane nový po ďalšom AI prechode), kľúčované podľa ID záznamu. Každý z nich je napísaný AI výlučne z citovaných polí samotného záznamu (súhrn MedlinePlus, citované indikácie, zdrojové odkazy, varovné signály), vete po vete, s uvedením poľa, na ktoré sa veta odvoláva, a skontrolovaný oproti týmto poliam. Súhrny, ktoré opakovali názov WHO ICD-10, boli vynechané.
