医药与医疗器械，国际口径（US / EU / AU 官方源），分两节：云端 API——语料查询（search / read）与 hub REST 直调（生产库），凭令牌调用；本地免 key API——实时查询面，装好包即用、直连官方上游，每面附参数表。
本域两条云端通道都在这一节：语料查询（search / read，访问令牌 PAT）与 hub REST 直调（生产库，subject token）。
search 和 read 应答的数据集——语料持续采集自以下官方源，每行带理由、证据引文与官方出处 URL：
| 数据集 | 上游 | 装什么 |
|---|---|---|
| FDA 药品批件（drugsfda） | openFDA | 药品批准记录 |
| FDA 器械记录（UDI） | openFDA | 器械注册与列名、UDI 标识、厂商角色 |
| 橙皮书（Orange Book） | openFDA | 药品治疗等效性评价与上市状态 |
| 紫皮书（Purple Book） | FDA | 生物制品批准与状态 |
| NPPES | NPPES NPI Registry | 医师与机构 NPI 名录（taxonomy_code 跨源可比） |
| OpenPayments | CMS OpenPayments | 厂商向医师 / 医院的支付年度聚合（program_year） |
语料快照：7,577,069 行可检索（as_of 2026-10-27），随语料更新而变化。两个命令覆盖全部语料——切片名单，或深读单主体：
以下示例省略行首的可执行名——补上 agentdata （或 python -m agentdata ）即为完整命令。
两个语料面及其参数（内省自 CLI，与 CLI 参考同源）：
healthcare searchCorpus search (hosted, PAT required): filters/record_kind/level/pagination
| 旗标 | 必填 | 说明 |
|---|---|---|
--filter |
否 | 筛选条件 K=V，可重复传多次（可用字段见本页筛选字段表） |
--record-kind |
否 | 记录类型（闭集，取值见本域规格） |
--facets |
否 | 要计数的字段，逗号分隔（响应带 facets 计数） |
--level |
否 | 读取分层深度（默认 tier1；分层含义见本页读取分层） |
--limit |
否 | 每页行数（默认 50，上限 1000） |
--cursor |
否 | 翻页游标（回填上一响应的 next_cursor） |
--mode |
否 | 特殊模式：screen=批量筛查（须配 --input） |
--input |
否 | 批量筛查的输入 JSONL 文件（配 --mode screen） |
healthcare readCorpus single-record read (hosted): id + T-layer depth
| 旗标 | 必填 | 说明 |
|---|---|---|
--id |
是 | 主体 id（search 结果行里的 id） |
--level |
否 | 读取分层深度（默认 tier1） |
record_kind：qualification——官方资质/注册/登记（含机构主体行）。filter 按其分组。
未声明的字段一律报 400（拼错不会静默返回空）。「现状」列随接口实际开放的字段自动更新——标「可筛」的即能筛，标「未开放」的当前不可筛。查无永远不等于不存在——覆盖随源走。
| filter | 类型 | 适用 record_kind | 说明 | 现状 |
|---|---|---|---|---|
record_kind |
keyword | 全部 |
记录层：qualification=资质/注册/登记（含机构主体行） | 可筛 |
qtype |
keyword | qualification |
资质类型闭集（fda_* / us_* 等 25+ 值，facets 看全集） | 可筛 |
status |
keyword | qualification |
状态极性（原始值直配；负面事实绝不默认「有效」） | 可筛 |
license_no |
keyword | qualification |
证照号（NDC / 许可证号 / CCN / NPI）——事实精确锚，不作主体合并键 | 可筛 |
product_name |
keyword | qualification |
药品/产品名（contains 语义；规格走 T2 spec_note） | 可筛 |
approval_year |
range | qualification |
批准年（自 approval_date / marketing_start_date / issue_date 提取年） | 可筛 |
effective_from / effective_until |
range | qualification |
许可有效期区间（issue_date 起 / expiry_date 止；过期行不入「当前有效」投影） | 可筛 |
hospital_type |
keyword | qualification |
医院类型（CMS: Acute Care Hospitals…） | 可筛 |
ownership |
keyword | qualification |
所有制（CMS: Government / Proprietary…） | 可筛 |
taxonomy_code |
keyword | qualification |
NPPES 机构类型规范码（CMS 同码表，跨源可比） | 可筛 |
program_year |
range | qualification |
OpenPayments 项目年（2023-2025 窗口） | 可筛 |
payment_amount_usd |
range | qualification |
年度收款总额 USD（字段名自带币种，勿配非 USD 值） | 可筛 |
company_registration_country |
keyword | 全部 |
行级国别（US…；openfda/OpenPayments 行多为 null——覆盖随源走，facets 可见空值量） | 可筛 |
subject_kind |
keyword | 全部 |
company｜institution｜person（机构名录单列出口闸门，不混企业名录） | 可筛 |
source / source_observed_at |
keyword / range | 全部 |
源与观测时间（快照/事件/区间三类语义） | 未开放 |
device_class / medical_specialty |
keyword | qualification |
器械分级 Ⅰ/Ⅱ/Ⅲ / 器械面板专科 | 未开放 |
establishment_type |
keyword | qualification |
厂商角色 Manufacturer / Importer… | 未开放 |
facility_address_country |
keyword | qualification |
设施地址国（≠ 主体注册国） | 未开放 |
condition_mesh / phase / sponsor_class |
keyword / range | qualification |
临床试验维度（适应症须 MeSH 规范词） | 未开放 |
facets 建议（已开放字段）：qtype / subject_kind / company_registration_country / program_year（默认附 record_kind）。
| 层 | healthcare 域内容 |
|---|---|
T1 |
主体卡：名称/主体类型（company｜institution）/强键（有则给）/国别（美线多未解析须明示）/资质摘要（批件数·最近批准·许可证状态）+ 来源覆盖 + 「未覆盖 ≠ 无风险」 |
T2 |
qualification 明细（qtype/产品/事实键/批准或有效期/状态/证据引文——批件行带 openFDA 原文行引文）；机构画像（hospital_type/ownership/taxonomy_code）；OpenPayments 年度聚合（program_year/总额 USD/nature 分布） |
T3 |
证据包：官方 URL + 内容校验值（sha256）+ 抓取时间 + 源批次 + 分片:行号（source_row_key）；payload 无个人联系人列（入库即不含） |
每个用例三部分：任务描述、可直接运行的命令、响应摘录。语料响应摘自 OpenAPI 契约，行内容随筛选条件变化；「本地免 key API」各面块内的真机示例为真实调用输出。
**用例：**要一份机构切片（医院 / CMS 设施 / NPPES 机构），或某项目年的 OpenPayments 行——subject_kind / program_year 直接筛。
拼错的筛选字段回 400 undeclared_field——绝不静默空结果；翻页把 next_cursor 回填。
**用例：**切片里浮出的某行——T2 拉资质明细；T3（上表）是带 sha256 与文内锚点的证据包，可点回原文。
每条结果带理由、证据引文与出处 URL（分层语义见上方「读取分层」表）。
**用例：**名单圈定一家医院/药企后，实时面接着答增量问题——这家药企在招哪些试验（CT.gov）、说明书原文在哪（DailyMed）：
现状声明（先读，防误读）：本域数据有两条通道——SDK 语料查询（search/read）查的是上文语料面；hub REST 是另一条已在线通道：生产基址 https://hub.omnimay.com 下 /v1/us/* 的 REST 读面，持有 subject 令牌的调用方今日即可直调。要点见下方清单。
https://hub.omnimay.com；US 面在 /v1/us/* 下——13 个读面：六域（药品批件/器械批件/风险事件/机构/临床试验/价格）各出 list+get，另加月度聚合 timeline。Authorization: Bearer <subject JWT>（RS256；iss/aud/sub/iat/exp/jti 六 claims 全带；令牌时长默认 300s、上限 3600s；service: 前缀主体一律 403）。{"items":[…],"limit":<int>,"next_cursor":<string|null>}；limit 1..100 缺省 20；按入库时间倒序 keyset 翻页（next_cursor 原样回传）。HEALTHCARE_NOT_FOUND · 400 CURSOR_INVALID · 400/422 PARAM_INVALID · 422 PRODUCT_KIND_MISMATCH（批件跨面）· 500。_or/_not、无多值）；无计数端点、无 facets；日期区间仅风险面有（date_from/date_to）；价格不可按金额筛；未声明参数静默忽略。下面 31 个面在你的机器上直连上游官方 API：无需注册账号或 key，平台侧不设配额（按各上游规则限流），缓存有效期内重复查询由本机缓存应答；每条结果附带上游官方 URL，可点开核对原文。每面附参数表与真机示例（真实运行命令的原样输出、仅节选部分行——你运行时拿到的就是官方数据源当时的数据，数字随上游更新而变化），完整旗标另见 CLI 参考。
以下示例省略行首的可执行名——补上 agentdata （或 python -m agentdata ）即为完整命令。
healthcare au_tga_artg澳洲治疗用品登记（ARTG）检索。
辖域：AU
| 旗标 | 必填 | 说明 |
|---|---|---|
--query |
否 | 检索词（全字段 AND；按申办方精确查把名字放进双引号，如 "Sun Pharma ANZ Pty Ltd"） |
--limit |
否 | 返回行数（上限 100，默认 20） |
--skip |
否 | 跳过行数（默认 0） |
**注意：**单页上限 100（--skip 续页）；--query 是跨全字段 AND 词检索——宽词会带出全家族产品，精确场景给完整品名再查。
healthcare au_tga_manufacturers澳洲登记制造商名册（可按州过滤）。
辖域：AU
| 旗标 | 必填 | 说明 |
|---|---|---|
--state |
否 | 州过滤（如 QLD / NSW / VIC；本地按 SiteState 过滤） |
--limit |
否 | 返回行数（上限 500，默认 100） |
注意：--state 是本地后筛（上游无此参数，按 SiteState 过滤）；全册一发可取（cap 500），无需翻页拼装。
healthcare ca_dpd_companies加拿大药品数据库公司册：DIN 持有企业 × 公司码，带类型与全址。
辖域：CA
| 旗标 | 必填 | 说明 |
|---|---|---|
--limit |
否 | 返回行数（默认 200——上游一发全册无分页，这是本地切片） |
--skip |
否 | 跳过行数（默认 0，本地切片） |
healthcare ca_dpd_drug_products加拿大在册药品：DIN × 品牌名 × 企业，按上市状态闭集过滤。
辖域：CA
| 旗标 | 必填 | 说明 |
|---|---|---|
--status |
是 | 上市状态闭集，必填：1=已批 2=已上市 3=上市前撤销 4=上市后撤销 6=休眠（无 5）——未知值被上游静默无视并倾倒整库 15MB，SDK 侧先拦 |
--limit |
否 | 返回行数（默认 200，本地切片） |
--skip |
否 | 跳过行数（默认 0，本地切片） |
注意：--status 必填且只在闭集 {1, 2, 3, 4, 6} 内——上游对未知值静默无视并回整库（15MB、约 5.5 万行），SDK 在本地先拦；行内不带 company_code，join 走 company_name 或先用 ca_dpd_companies。
healthcare ca_mdall_companies加拿大医疗器械活跃许可公司册（双国册——美国厂商在册带国别码）。
辖域：CA
| 旗标 | 必填 | 说明 |
|---|---|---|
--limit |
否 | 返回行数（默认 200——上游一发全册无分页，这是本地切片） |
--skip |
否 | 跳过行数（默认 0，本地切片） |
healthcare ca_mdall_licenceMDALL 单张执照全档：制造商块 × 公司 ID × 器械分级与识别符族。
辖域：CA
| 旗标 | 必填 | 说明 |
|---|---|---|
--licence-id |
是 | MDALL 执照号，数字（如 111577；上游参数 licenceId） |
--licence-type |
否 | 执照索引：active（默认） |
--lang |
否 | 语言：eng（默认） |
注意：active 与 archived 是两个独立上游索引：查停用执照须显式 --licence-type archived（在 active 下查到的是 200 空页→not_found）；结果里回显的 type 是索引参数，licence_type 才是执照自身类型（Device Family 等）——两键并存。
healthcare ctgov_studiesClinicalTrials.gov 试验检索——按适应症 / 申办方 / 状态找试验。
辖域：US
| 旗标 | 必填 | 说明 |
|---|---|---|
--query.term |
否 | 原始检索表达式（官方 query.term 语法；按申办方查用 AREA\[LeadSponsorName\]("Pfizer")） |
--query.titles |
否 | 标题字段检索（可与 --query.term / --query.cond 等组合） |
--query.intr |
否 | 干预手段字段检索（药物 / 术式名；可与 --query.term 等组合） |
--query.cond |
否 | 适应症/病种检索（可与其他条件组合） |
--filter.advanced |
否 | 高级过滤，AREA\[字段\](值) 语法，可组合（例见下） |
--agg-filters |
否 | 分面过滤，数值枚举（例 phase:3——写 PHASE3 会零命中） |
--fields |
否 | 返回列，逗号分隔（例 NCTId,BriefTitle） |
--page-size |
否 | 每页行数（默认 20；上游未设上限） |
--page-token |
否 | 翻页令牌（回填 next_page_token） |
--sort |
否 | 排序（例 EnrollmentCount:desc） |
--count-total, --no-count-total |
否 | 是否请求命中总数（默认开） |
注意：--filter.advanced 吃 CT.gov AREA 语法（如 AREA[LeadSponsorName]("AstraZeneca")），与 --query.cond 可叠加；裸调用（不带任何参数）=全部研究的第一页，是合法上游行为。
healthcare dailymed_spls美国药品说明书结构化标签（DailyMed SPL）检索。
辖域：US
| 旗标 | 必填 | 说明 |
|---|---|---|
--search |
否 | 药品名（官方 drug_name 通道） |
--manufacturer |
否 | 标签持有方/生产商过滤（如 Pfizer） |
--setid |
否 | SPL setid 精确过滤 |
--page |
否 | 页码 |
--pagesize |
否 | 每页行数（按 100 封顶——更大值不报错但仍按 100 返回） |
--sort |
否 | 排序（如 published_date） |
注意：--pagesize 被上游静默钳到 100——回显 elements_per_page 才是真页宽，翻页进度以实际返回行数为准，勿信请求值。
healthcare epmc_search欧洲生命科学文献库（Europe PMC）检索——按机构 / 主题找文献。
辖域：GLOBAL
| 旗标 | 必填 | 说明 |
|---|---|---|
--search |
否 | 检索表达式（例 AFF:"Novartis" AND "psoriasis"——AFF 按机构过滤） |
--result-type |
否 | 返回行深（默认 lite） |
--page-size |
否 | 每页行数，1–1000（默认 25） |
--cursor-mark |
否 | 翻页游标（首页传 *） |
--sort |
否 | 排序（例 CITED desc） |
healthcare eudamed_devices_udi_di_dataEU 器械 UDI-DI → EUDAMED 登记数据。
辖域：EU
| 旗标 | 必填 | 说明 |
|---|---|---|
--primary-di |
是 | EU 器械 UDI-DI（必填） |
--page |
否 | 页码（从 0 起） |
--page-size |
否 | 每页行数（默认 5） |
--iso2-code |
否 | 返回语言（默认 en） |
注意：primaryDi 未建索引，冷调用约 50 秒是常态（上游 op 超时 90s，SDK 不烧重试）；偶发整页空返是上游瞬态——SDK 判空弃账重取一次，仍空才判 not_found；--page-size 慎放大（未建索引面更慢），翻过头=空页→not_found。
healthcare fda_crl_lettersFDA 完整回复函（CRL）：公司 × 否决性审批事件，带批准状态与来函日期。
辖域：US
| 旗标 | 必填 | 说明 |
|---|---|---|
--search |
否 | 检索表达式（例 company_name:"Firm Name"）——运行时必填：缺参本地直接报错 |
--limit |
否 | 返回行数，1–1000（上游硬墙；默认 20） |
--skip |
否 | 跳过行数（默认 0——上游无游标，深翻页靠它） |
--sort |
否 | 排序（默认 letter_date:desc） |
healthcare fda_device_510k510(k) 上市前通告：K 号 × 申请企业，带决定码与决定日期。
辖域：US
| 旗标 | 必填 | 说明 |
|---|---|---|
--search |
否 | 检索表达式（例 applicant:"Medtronic"）——运行时必填：缺参本地直接报错 |
--limit |
否 | 返回行数，1–1000（上游硬墙；默认 20） |
--skip |
否 | 跳过行数（默认 0——上游无游标，深翻页靠它） |
--sort |
否 | 排序（默认 decision_date:desc） |
healthcare fda_device_classification器械产品码分类学：器械名 × 产品码 × 器械类别，产品码可 join 510(k)/PMA/召回面。
辖域：US
| 旗标 | 必填 | 说明 |
|---|---|---|
--search |
否 | 检索表达式（例 device_name:"syringe"）——运行时必填：缺参本地直接报错 |
--limit |
否 | 返回行数，1–1000（上游硬墙；默认 20） |
--skip |
否 | 跳过行数（默认 0——上游无游标，深翻页靠它） |
--sort |
否 | 排序（本面无日期字段——无默认排序，须自己给） |
healthcare fda_device_pmaPMA 上市前批准与补充：PMA 号 × 申请企业，带决定码与决定日期。
辖域：US
| 旗标 | 必填 | 说明 |
|---|---|---|
--search |
否 | 检索表达式（例 applicant:"Medtronic"）——运行时必填：缺参本地直接报错 |
--limit |
否 | 返回行数，1–1000（上游硬墙；默认 20） |
--skip |
否 | 跳过行数（默认 0——上游无游标，深翻页靠它） |
--sort |
否 | 排序（默认 decision_date:desc） |
healthcare fda_device_recalls美国器械召回（RES 系统，含全生命周期）：召回企业 FEI 号与 K 号可作关联键。
辖域：US
| 旗标 | 必填 | 说明 |
|---|---|---|
--search |
否 | 检索表达式（例 recalling_firm:"Firm Name"——短语形态）——运行时必填：缺参本地直接报错 |
--limit |
否 | 返回行数，1–1000（上游硬墙；默认 20） |
--skip |
否 | 跳过行数（默认 0——上游无游标，深翻页靠它） |
--sort |
否 | 排序（默认 event_date_posted:desc） |
healthcare fda_device_registrations器械机构注册与列名（季更）：注册号 / FEI 号 × 企业名。
辖域：US
| 旗标 | 必填 | 说明 |
|---|---|---|
--search |
否 | 检索表达式（例 registration.name:"Firm Name"——可检字段都在 registration.* 命名空间，顶层 firm_name / fei_number 不命中）——运行时必填：缺参本地直接报错 |
--limit |
否 | 返回行数，1–1000（上游硬墙；默认 20） |
--skip |
否 | 跳过行数（默认 0——上游无游标，深翻页靠它） |
--sort |
否 | 排序（默认 registration.reg_expiry_date_year:desc） |
healthcare fda_drug_approvalsDrugs@FDA 申请档案：申请号 × 申办方，带产品清单与申报时间线。
辖域：US
| 旗标 | 必填 | 说明 |
|---|---|---|
--search |
否 | 检索表达式（openFDA 语法，例 sponsor_name:"TEVA"——公司键是 sponsor_name，applicant_name 是上游文档错觉；keyword 字段按行内存储形态区分大小写）——运行时必填：缺参本地直接报错 |
--limit |
否 | 返回行数，1–1000（上游硬墙；默认 20） |
--skip |
否 | 跳过行数（默认 0——上游无游标，深翻页靠它） |
--sort |
否 | 排序（默认 submissions.submission_status_date:desc） |
healthcare fda_drug_catalogNDC 药品目录（日更）：产品 NDC × 标签商，带上市日期与类别。
辖域：US
| 旗标 | 必填 | 说明 |
|---|---|---|
--search |
否 | 检索表达式（例 labeler_name:"pfizer" 查标签商——NDC 目录日更，NSDE 上市起止日期并入此面）——运行时必填：缺参本地直接报错 |
--limit |
否 | 返回行数，1–1000（上游硬墙；默认 20） |
--skip |
否 | 跳过行数（默认 0——上游无游标，深翻页靠它） |
--sort |
否 | 排序（默认 marketing_start_date:desc） |
healthcare fda_drug_recalls美国药品召回与执法记录（2012 起）：召回号 × 召回企业，带级别、状态与原因。
辖域：US
| 旗标 | 必填 | 说明 |
|---|---|---|
--search |
否 | 检索表达式（例 recalling_firm.exact:"Firm Name"）——运行时必填：缺参本地直接报错，不空打上游 |
--limit |
否 | 返回行数，1–1000（上游硬墙；默认 20） |
--skip |
否 | 跳过行数（默认 0——上游无游标，深翻页靠它） |
--sort |
否 | 排序（默认 report_date:desc） |
healthcare fda_drug_shortages美国药品短缺通报（openFDA）。
辖域：US
| 旗标 | 必填 | 说明 |
|---|---|---|
--search |
否 | 检索表达式（例 openfda.manufacturer_name.exact:"Fresenius Kabi USA, LLC" AND status:Current——openFDA 语法，生产商/药名/状态都写进表达式） |
--limit |
否 | 返回行数，1–1000（默认 20） |
--skip |
否 | 跳过行数（默认 0） |
--sort |
否 | 排序（默认 update_date:desc） |
注意：--limit 1-1000 是上游硬墙——更深的翻页用 --skip 累加偏移（每页仍 ≤1000），不是放大 limit。
healthcare fda_food_recalls美国食品召回与执法记录（2012 起）：召回号 × 召回企业，带级别、状态与原因。
辖域：US
| 旗标 | 必填 | 说明 |
|---|---|---|
--search |
否 | 检索表达式（例 recalling_firm.exact:"Firm Name"）——运行时必填：缺参本地直接报错 |
--limit |
否 | 返回行数，1–1000（上游硬墙；默认 20） |
--skip |
否 | 跳过行数（默认 0——上游无游标，深翻页靠它） |
--sort |
否 | 排序（默认 report_date:desc） |
healthcare fda_orangebook橙皮书批准药品：批准日期 × 持证人，带参比药品（RLD）标记。
辖域：US
| 旗标 | 必填 | 说明 |
|---|---|---|
--search |
否 | 检索表达式（例 products.application_full_name:"Teva"——持证人在 products[] 里，顶层无 applicant 字段）——运行时必填：缺参本地直接报错 |
--limit |
否 | 返回行数，1–1000（上游硬墙；默认 20） |
--skip |
否 | 跳过行数（默认 0——上游无游标，深翻页靠它） |
--sort |
否 | 排序（默认 approval_date:desc） |
healthcare gb_mhra_alert英国 MHRA 单条警示全档（公告正文+PDF 附件）。
辖域：GB
| 旗标 | 必填 | 说明 |
|---|---|---|
--slug |
是 | 警示页尾段标识（用 alerts 结果行里的 slug；粘贴整条 gov.uk 链接也自动剥前缀——带尾 .json 同样剥掉） |
healthcare gb_mhra_alerts英国 MHRA 药品与器械安全警示检索（召回/器械通告/现场安全通知）。
辖域：GB
| 旗标 | 必填 | 说明 |
|---|---|---|
--q |
否 | 检索词（公司名/产品词穿透通道——如 Abbott 命中 160 条警示；不传=整库 1,462 条最新在前） |
--count |
否 | 每页行数 1–100（默认 20；礼貌上限，上游无墙） |
--start |
否 | 偏移翻页：从第几行开始取（默认 0） |
healthcare gudid_devices美国器械登记库（GUDID）：DI / UDI → 器械登记卡。
辖域：US
| 旗标 | 必填 | 说明 |
|---|---|---|
--di |
否 | 器械标识符 DI |
--udi |
否 | 完整 UDI 字符串 |
--record-key |
否 | 记录键（GUDID 原始行键） |
**注意：**上游有 AWS WAF 人机门控，按客户端栈且按出口 IP 双维成立——2xx 非 JSON 会被 SDK 归一成带出口排查提示的报错：先查代理出口/换网络，勿盲目重试；同数据备选 openFDA UDI。
healthcare mesh_descriptor医学主题词表（MeSH）检索——把药名 / 病种名归一到标准主题词。
辖域：GLOBAL
| 旗标 | 必填 | 说明 |
|---|---|---|
--label |
是 | 要查的医学主题词（传 term/descriptor 会被上游 400——用 label） |
--match |
否 | 匹配模式（默认 contains） |
--limit |
否 | 候选上限（默认 10，最大 50） |
注意：mesh_ui（D 前缀）是跨库稳定锚——文献库/临床试验检索都认它；候选空=该写法不在表：口语形「type 2 diabetes」零命中，受控形是「Diabetes Mellitus, Type 2」——换倒序或受控形再试。
healthcare rasff_notifications欧盟 RASFF 食品与饲料安全警示检索：通报国 × 产品类别 × 风险决定。
辖域：EU
| 旗标 | 必填 | 说明 |
|---|---|---|
--subject |
否 | 警示主题自由文本（上游参数 subject；如 aflatoxin） |
--notification-reference |
否 | 警示编号精确匹配（上游参数 notificationReference；如 2026.9701） |
--ec-valid-date-from |
否 | 窗口起，dd-MM-yyyy 格式（上游参数 ecValidDateFrom；如 01-09-2026——ISO 格式被上游拒绝） |
--ec-valid-date-to |
否 | 窗口止，dd-MM-yyyy 格式（上游参数 ecValidDateTo） |
--page-number |
否 | 页码，1 基（上游参数 pageNumber；默认 1） |
--items-per-page |
否 | 每页行数 1–200（上游参数 itemsPerPage；浏览器默认 25，200 为礼貌上限） |
**注意：**会话由 SDK 内部两步握手托管（壳页铸会话→带 Cookie/Origin/Referer 的 POST，会话过期自动重铸一次）；枚举形过滤器（通报国/产品类别/风险决定等）刻意不暴露——其参数形状上游未公开且探针全被泛错误拒，先按主题/编号/日期窗过滤。
healthcare rxnav_rxcui_atcRxCUI → ATC 药理分类。
辖域：US
| 旗标 | 必填 | 说明 |
|---|---|---|
--rxcui |
是 | RxCUI 数字编号 |
**注意：**只收数字 RxCUI——药名先经 rxnav_rxcui_by_name 归一；成分名级（tty=IN）的 RxCUI 映射最稳，商品名级（BN）可查但以归一面给的为准。
healthcare rxnav_rxcui_by_name药名 / 品牌名 → RxCUI 编码（RxNorm 官方归一）。
辖域：US
| 旗标 | 必填 | 说明 |
|---|---|---|
--name |
是 | 药品名或品牌名 |
注意：仅英文词典——中文药名诚实回 not_found，不做模糊猜名；RxCUI 不可变，本机永久缓存，复跑 from_cache:true。
healthcare safety_gate_alerts欧盟 Safety Gate（原 RAPEX）非食品产品安全周报总目。
辖域：EU
| 旗标 | 必填 | 说明 |
|---|---|---|
--year |
否 | 报告年份——本地后滤非上游参数（上游恒发整份总目） |
--limit |
否 | 返回行数（默认 200，本地切片） |
--skip |
否 | 跳过行数（默认 0，本地切片） |
healthcare safety_gate_report单期 Safety Gate 周报明细：案号 × 品类 × 风险级别 × 通报国 × 原产国。
辖域：EU
| 旗标 | 必填 | 说明 |
|---|---|---|
--report-id |
是 | 报告号，数字（safety_gate_alerts 行里回显的 report_id；粘贴整条明细 URL 也能自动剥出） |
--limit |
否 | 返回行数（默认 200，本地切片） |
--skip |
否 | 跳过行数（默认 0，本地切片） |
status=有效 表示名单当期在册。subject_kind=institution（医院 / CMS 设施 / NPPES 机构）是机构名录出口，不混企业名录。