Skip to main content

Навык: 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-информации.

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

Внутри навыка есть скрипт:
python scripts/fda_query.py label --search 'openfda.brand_name:"Advil"' --limit 3
Примеры:
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 informationlabel
FAERS adverse eventsevent
NDC product recordsndc
Drug recalls/enforcementenforcement
Drugs@FDA approvalsdrugsfda
Drug shortagesdrugshortages
Substances / UNIIsubstance
Device adverse eventsdevice-event
Device enforcementdevice-enforcement
Food enforcementfood-enforcement

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

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