openFDA 监管数据查询

要解决什么问题

药品安全、器械召回、食品执法与物质标识往往散落在 FDA 各套系统里；手工翻网页或拼零散接口，很难做可复现的批量查询与跨端点关联。openFDA 把多类监管数据集统一到 REST API，但若不熟悉端点划分、查询语法与速率限制，很容易在分页、计数（.exact）和字段缺失上踩坑。

技能如何工作

本技能围绕 openFDA 与 Python 封装（如 FDAQuery）组织工作流：

• 药品：不良事件、产品标签、NDC 目录、执法报告、Drugs@FDA 审批历史、药品短缺
• 器械：不良事件、510(k)、PMA、分类、召回、UDI、注册与列表等
• 食品 / 兽药 / 物质：食品与补充剂事件与召回；按物种的兽药不良事件；UNII、CAS 与化学结构关系

常见模式包括：多源拼出安全性概况、按日期做趋势、多产品并排比较、以及跨端点关联。实现上通常依赖内置速率限制与缓存（无密钥约 1,000 次/天，有密钥可至 120,000 次/天），并应对 API 错误与大型结果集分页。

适用边界与注意点

• 数据来自 FDA 公开集，不等于临床决策或合规结论的唯一依据；字段覆盖率因记录而异，聚合前需检查字段是否存在。
• 复杂检索应优先精确搜索与合法查询语法（见技能内 references/api_basics.md 等），避免宽泛通配导致空结果或误读。
• 多步研究、长时间跑批或需协调多工具时，更适合在可托管的研究环境里串联脚本与示例（如 scripts/fda_query.py、scripts/fda_examples.py），而不是单次对话里硬扛全量拉取。