> ## Documentation Index
> Fetch the complete documentation index at: https://docs.velesagent.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Навык: FDA Database

> Поиск официальной информации FDA/openFDA о лекарствах: label, NDC, recalls, adverse events, Drugs@FDA, shortages и substances.

# Навык: FDA Database

`fda-database` нужен для вопросов о лекарствах и таблетках, где важны официальные данные FDA/openFDA:

* label-информация: показания, предупреждения, противопоказания, дозировки, adverse reactions;
* NDC-записи: продукт, упаковка, дозированная форма, путь введения, labeler;
* recalls/enforcement;
* Drugs\@FDA approvals;
* drug shortages;
* FAERS adverse-event reports;
* substance/UNII lookup.

Для научной литературы используйте `entrez-search` как fallback, а не как основной источник label-информации.

***

## Как запускается

Внутри навыка есть скрипт:

```bash theme={null}
python scripts/fda_query.py label --search 'openfda.brand_name:"Advil"' --limit 3
```

Примеры:

```bash theme={null}
python scripts/fda_query.py ndc --search 'generic_name:"IBUPROFEN"' --limit 5
python scripts/fda_query.py enforcement --search 'product_description:"metformin"' --limit 5
python scripts/fda_query.py event --search 'patient.drug.medicinalproduct:"metformin"' --count patient.reaction.reactionmeddrapt.exact
python scripts/fda_query.py drugshortages --search 'status:"Currently in Shortage"' --limit 10
```

***

## API-ключ

API-ключ не обязателен.

* Без ключа действуют более низкие лимиты openFDA.
* Опциональный ключ можно сохранить как `skills.fda-database.env.OPENFDA_API_KEY`.
* Скрипт читает `OPENFDA_API_KEY`, а также совместимый `FDA_API_KEY`.

***

## Обязательные правила для медицинских ответов

Перед персональным советом о лекарствах агент должен:

1. выполнить поиск по памяти через `memory_search`;
2. прочитать `docs/myhealth`, если такой путь есть в workspace;
3. проверить данные через `fda-database`;
4. использовать несколько источников для важных safety-утверждений, когда это возможно;
5. явно говорить о неопределённости и направлять к врачу/фармацевту для назначения, отмены, изменения дозировки, взаимодействий, беременности/лактации и опасных симптомов.

FAERS/openFDA adverse-event reports нельзя трактовать как доказательство причинно-следственной связи. Это только сигналы постмаркетинговой безопасности.

***

## Основные endpoints

| Сценарий                        | Endpoint             |
| ------------------------------- | -------------------- |
| Label / prescribing information | `label`              |
| FAERS adverse events            | `event`              |
| NDC product records             | `ndc`                |
| Drug recalls/enforcement        | `enforcement`        |
| Drugs\@FDA approvals            | `drugsfda`           |
| Drug shortages                  | `drugshortages`      |
| Substances / UNII               | `substance`          |
| Device adverse events           | `device-event`       |
| Device enforcement              | `device-enforcement` |
| Food enforcement                | `food-enforcement`   |

***

## Что не нужно использовать по умолчанию

* `drug-labels-search` из OpenClaw Medical Skills не подходит как базовый вариант, потому что требует Valyu API key с кредитами.
* RxNav/RxNorm полезен для нормализации названий и RxCUI, но не для drug-drug interaction checks: interaction API был прекращён в 2024 году.
* FAERS нельзя использовать для расчёта частоты побочных эффектов или доказательства, что лекарство вызвало событие.