简体中文

企业数据

这个域回答四类问题：名单——哪些公司拿过某个官方资质（比如「专精特新小巨人」），在哪个省、哪一年评上；一家公司——它的档案与披露：资质明细、监管披露文档、客户/供应商/子公司关系；欧洲注册册——实时查瑞士、挪威、芬兰的官方公司登记与高管名单，或在法国全国企业库里按公司名、高管人名、SIREN 检索；美国上市公司——用编号或名字认出申报主体，查它的母公司，拉它拿过的联邦合同，在 SEC EDGAR 的申报原文里全文检索。每条结果都带证据引文和官方出处 URL，可以点开核对。

命令一览

本域全部命令——两条库查询加全部直查面，每条在下文都有自己的分区（回答什么 / 参数 / 真机示例 / 边界）。

命令	辖域	回答什么
`company search`	—	按条件筛企业名单（资质 / 披露 / 主体三类记录；需开通）
`company read`	—	调一家公司的完整档案，按深度分层（需开通）
`company ch_zefix_firm`	CH	ehraid → 瑞士公司登记全档（目的全文 / 历史名 / 并购边）
`company ch_zefix_firm_search`	CH	瑞士公司名 → 登记候选（Zefix，三键 ehraid/uid/chid）
`company co_rues_companies`	CO	哥伦比亚公司名 / SoQL → 商会登记主档行（RUES）
`company fdic_institutions`	US	美国银行名录检索（FDIC）
`company fi_ytj_companies`	FI	芬兰公司名 / business-id → 公司档（YTJ v3）
`company fr_recherche_search`	FR	法国企业名 / 高管名 / SIREN → 企业档（annuaire）
`company gb_contracts_finder_published_notices`	GB	英国低门槛合同公告（Contracts Finder）
`company gb_fts_release_packages`	GB	英国高门槛合同授予（Find a Tender）
`company gleif_direct_parent`	GLOBAL	LEI → 直接母公司
`company gleif_lei_records`	GLOBAL	LEI 码 → 公司身份卡
`company gleif_lei_records_search`	GLOBAL	公司名 → LEI 候选列表
`company gleif_ultimate_parent`	GLOBAL	LEI → 终极控制人
`company kr_hometax_biz_status`	KR	韩国事业者号 → 营业 / 闭业 / 未注册（国税厅）
`company no_brreg_enheter`	NO	挪威公司名 / 组织号 → 主档（Brreg）
`company no_brreg_roller`	NO	组织号 → 挪威角色名册（CEO / 董事会 / 审计，Brreg）
`company nzco_companies`	NZ	新西兰公司名 → 登记册行（公司号+NZBN 双键，Companies Office）
`company nzco_directors`	NZ	新西兰公司号 → 现任董事名册（法定全名 / 居住地址 / 任命日）
`company ror_organizations`	GLOBAL	机构名 / ROR id → 研究机构档案
`company sec_fulltext_search`	US	SEC 申报原文全文检索（EDGAR）
`company sec_submissions`	US	CIK → SEC 申报主体档案
`company ted_notices_search`	EU	欧盟招标公告检索（TED）
`company usaspending_spending_by_award`	US	美国联邦合同与拨款（按收款方）
`company vies_vat`	EU	欧盟 VAT 号官方验真（VIES）

入库检索：search 与 read

search 与 read 查的是已建好的库（开通访问后即可查询）——库里三种记录：company=公司主体、qualification=资质认定、disclosure_document=披露文档。

以下示例省略行首的可执行名——补上 agentdata （或 python -m agentdata ）即为完整命令。

search · 按条件筛名单

**回答什么：**初筛要一份北京的专精特新小巨人名单——一条命令拿回名单行，每行带入选理由、证据引文和官方出处，另附各字段计数。

$ company search --filter qtype=专精特新小巨人 --filter province=北京 --facets qtype --limit 5

响应形状（开通后可查；行内容随筛选条件变化）：

{ "domain": "company", "backend": "db", "coverage": "…",
  "rows": [ { "cursor": "company:123", "record_kind": "company",
              "entity": {"…": "…"}, "reason": "…",
              "evidence": [ { "anchor": "…", "quote": "…", "url": "…", "raw_path": "…", "sha256": "…" } ],
              "source": { "source": "…", "observed_at": "…" } } ],
  "facets": { "qtype": [ { "value": "…", "count": 123 } ] },
  "total_matched": 1968, "next_cursor": "company:456", "notes": ["…"] }

怎么读结果：

rows[].entity — 命中的记录本体（公司 / 资质 / 披露文档）
rows[].reason — 它为什么出现在结果里（入选理由）
rows[].evidence[] — 证据：原文引文（quote）、官方出处（url）、原始文件路径与内容校验值（sha256）
facets — 按你指定的字段给计数（比如各省多少家、各资质类型多少家）
total_matched / next_cursor — 命中总数与下一页游标（回填即翻页）

参数：

旗标	必填	说明
`--filter`	否	筛选条件 `K=V`，可重复传多次（可用字段见本页筛选字段表）
`--record-kind`	否	记录类型（闭集，取值见本域规格）
`--facets`	否	要计数的字段，逗号分隔（响应带 facets 计数）
`--level`	否	读取分层深度（默认 tier1；分层含义见本页读取分层）
`--limit`	否	每页行数（默认 50，上限 1000）
`--cursor`	否	翻页游标（回填上一响应的 next_cursor）
`--mode`	否	特殊模式：screen=批量筛查（须配 --input）
`--input`	否	批量筛查的输入 JSONL 文件（配 --mode screen）

未声明的字段一律报 400（拼错不会静默返回空）。「现状」列随接口实际开放的字段自动更新——标「可筛」的即能筛，标「未开放」的当前不可筛。kw 关键词检索是披露文档专属第 4 维。

filter	类型	适用记录	说明	现状
`company_registration_country`	keyword	`company`	主体注册国：中文（中国）/ ISO2（CN、TW、KY）/ 英文三形均可（与披露机关法域分列）	可筛
`registration_status`	keyword	`company`	active / unverified 两态（快照，带 as_of；细分经营状态未入库）	可筛
`industry_cn`	keyword	`company`	行业（CN 国民经济分类）	可筛
`industry_naics`	keyword	`company`	行业（US NAICS，与 industry_cn 双轨）	未开放
`established_year`	range	`company`	成立年	可筛
`employee_count / revenue_latest`	range	`company`	规模区间（覆盖随源走，未具备≠不符合）	未开放
`stock_code / us_ticker`	keyword	`company`	证券标识经 company_listing 解析回主体（不作合并键）	可筛
`isin`	keyword	`company`	国际证券识别码（同上，解析回主体）	未开放
`doc_class`	keyword	`disclosure_document`	受控词表（问询函/行政处罚决定/市场禁入/8-K…）	可筛
`issuer_agency`	keyword	`disclosure_document`	发文机关（CSRC/上交所/深交所/SEC/FCA…）	未开放
`doc_date`	range	`disclosure_document`	文档公布日（事件语义）	可筛
`disclosed_company_id`	keyword	`disclosure_document`	披露指向主体（强键优先，名称归一候选须回传依据）	可筛
`kw`	keyword	`disclosure_document`	披露文档关键词检索（命中标题层；命中窗口即 T2 引文）	可筛
`qtype`	keyword	`qualification`	资质类型（高企/小巨人/专精特新…，值数见指标）	可筛
`qualification_year`	range	`qualification`	资质年度（如小巨人批次年）	可筛
`province`	keyword	`qualification`	省级行政区（名单源直录）	可筛
`license_no`	keyword	`qualification`	许可证号（经营许可等）	可筛
`issuing_authority`	keyword	`qualification`	颁发机关	未开放
`effective_from / effective_until`	range	`qualification`	有效期区间（active/expired 投影）	未开放
`risk_*`	range	`company`	被问询/被处罚/被禁入计数	未开放
`source`	keyword	`全部`	数据源标识	可筛
`source_observed_at`	range	`全部`	观测时间（快照/事件/区间三类语义）	未开放

qtype 受控词表现值 42 类。facets 建议（已开放字段）：doc_class / doc_date(年) / qtype / province / company_registration_country / registration_status。

拼错的筛选字段回 400 undeclared_field——不会静默返回空结果。

read · 调一家公司的完整档案

**回答什么：**筛名单时看中一家公司——read 用行里的 id 调出它的完整档案，要多深给多深。

$ company read --id 1476 --level tier2

参数：

旗标	必填	说明
`--id`	是	主体 id（search 结果行里的 id）
`--level`	否	读取分层深度（默认 tier1）

读取深度	拿到什么
`T1`	主体卡：法定名/注册号/注册国/成立年/行业/企业状态 + 上市状态 + 资质摘要 + 风险信号计数（被问询/被处罚）+ 来源覆盖 + 「未覆盖 ≠ 无风险」
`T2`	资质明细（qtype/机关/有效期/证据引文）；披露文档明细（doc_class/日期/标题/kw 命中窗口引文 200–500 字）；关系明细（子公司/客户/供应商 + 挂接依据与断言等级）
`T3`	证据包：官方 URL + 抓取时间 + 内容校验值（sha256）+ 原文定位锚点（表/行/段落）；披露文档走 text_ref 文本层

三档深度：tier1 概要卡、tier2 完整明细、tier3 证据包。每一档都带理由、证据引文与出处 URL（分层语义见上表）。

直查官方源

直查面不查库——装好包就能跑：命令当场访问官方公开源，返回它们当时的数据；每条结果附官方出处 URL，可以点开核对。平台侧不设配额，按各上游规则限流；重复查询在缓存有效期内由本机缓存直接应答。

以下都是真实命令的原样输出（仅节选部分行，未改动；捕获于 2026-10-23–11-02，平铺形态重捕于 2026-10-27）。数字随上游更新而变化。

以下示例省略行首的可执行名——补上 agentdata （或 python -m agentdata ）即为完整命令。

`company ch_zefix_firm`

ehraid → 瑞士公司登记全档（目的全文 / 历史名 / 并购边）

参数：

旗标	必填	说明
`--ehraid`	是	瑞士商业登记号 ehraid（search 结果行里就带）

**注意：**只接受 ehraid（ch_zefix_firm_search 行里就带）；并购未申报时两个数组为空=无此类边，不是缺数。

$ company ch_zefix_firm --ehraid 189146

{
  "reason": "Zefix 单档：Swatch AG（uid CHE103650519，EXISTIEREND，Biel/Bienne）；前继 2 / 后继 0 并购边——purpose/oldNames 全文带回",
  "result": {
    "ehraid": 189146, "name": "Swatch AG", "status": "EXISTIEREND", "legal_seat": "Biel/Bienne",
    "uid_formatted": "CHE-103.650.519", "chid_formatted": "CH-073-3002499-8", "shab_date": "2026-07-27",
    "purpose": "Herstellung von und Handel mit Uhren, Uhrenbestandteilen, Uhrwerken, Bijouterieartikeln, elektronischen Zeitmessgeräten und -anlagen und deren Komponenten, elek…",
    "old_names": [],
    "has_taken_over": [],
    "taken_over_by": []
  },
  "evidence": [
    { "quote": "purpose 德文全文照录（制造与贸易钟表、表件、机芯、饰物、电子计时器…）；前继 2 家",
      "url": "https://www.zefix.ch/ZefixREST/api/v1/firm/189146.json" }
  ]
}

怎么读：purpose 是登记目的全文，德 / 法 / 意语照录不翻译；old_names 是改名史；has_taken_over / taken_over_by 是并购边——承接的前身与让渡的后继各带对方三键，改名 / 并购不断 ehraid。

`company ch_zefix_firm_search`

瑞士公司名 → 登记候选（Zefix，三键 ehraid/uid/chid）

参数：

旗标	必填	说明
`--name`	是	公司名或片段（包含匹配——历史名也命中）
`--max-entries`	否	返回行数（上游 maxEntries，默认 100）
`--offset`	否	偏移（上游分页，配 --max-entries 走；上限以上游回显的 max_offset 为准）

**注意：**候选非权威归一——挑中后用 ch_zefix_firm --ehraid 复核全档；--offset 翻页上限以上游回显的 max_offset 为准。

$ company ch_zefix_firm_search --name "Swatch AG"

{
  "reason": "Zefix 检索：1 候选，首选 Swatch AG（uid CHE103650519，EXISTIEREND，Biel/Bienne）——包含式匹配非权威归一，三键（ehraid/uid/chid）直出",
  "result": {
    "firms": [
      { "ehraid": 189146, "uid": "CHE103650519", "uid_formatted": "CHE-103.650.519",
        "chid": "CH07330024998", "chid_formatted": "CH-073-3002499-8",
        "name": "Swatch AG", "status": "EXISTIEREND", "legal_seat": "Biel/Bienne", "shab_date": "2026-07-27",
        "cantonal_excerpt_web": "https://be.chregister.ch/cr-portal/auszug/auszug.xhtml?uid=CHE-103.650.519" }
    ],
    "has_more": false,
    "max_offset": 1435992
  },
  "evidence": [
    { "quote": "Swatch AG（ehraid 189146，uid CHE103650519，EXISTIEREND，Biel/Bienne）",
      "url": "https://www.zefix.ch/ZefixREST/api/v1/firm/189146.json" }
  ]
}

**怎么读：**包含匹配连历史名一起命中。三键各有用场：ehraid 是调 ch_zefix_firm 拿全档的钥匙；uid_formatted（CHE-103.650.519）是对瑞士公司的跨库对照键；status EXISTIEREND=存续（德语，照录）。cantonal_excerpt_web 直通州级登记摘录官方页；shab_date 是最近一次瑞士官方公报（SHAB）变更日。

`company co_rues_companies`

哥伦比亚公司名 / SoQL → 商会登记主档行（RUES）

参数：

旗标	必填	说明
`--where`	否	SoQL 过滤表达式原样透传（例 `razon_social like '%BANCOL%'`、`estado_matricula='ACTIVA'`）；面自动追加基滤只收公司（NIT）行
`--limit`	否	每页行数，1–500（默认 20）
`--offset`	否	翻页偏移，0 起
`--order`	否	排序（例 `matricula ASC`；上游不吃 NULLS 语法）

**注意：**只收公司类（NIT）行——个体户（用生份号登记）不在这个查询面；主档无地址列（场所在另一数据集）；法定代表人只给名字不给证件号。

$ company co_rues_companies --where "razon_social like '%DIMPEL%'" --limit 3

{
  "reason": "CO RUES 登记主档：返回 1 行（offset=0 起；Socrata 无 total 回显）——matricula×NIT×CIIU（样例 DIMPEL SAS，NIT 900835212，SOCIEDADES POR ACCIONES SIMPLIFICADAS SAS）；基滤 clase_identificacion='NIT'（个体户生份号行不进面）、RL 号码列已剥离",
  "result": {
    "rows": [
      { "matricula": "2558821", "camara_comercio": "BOGOTA", "razon_social": "DIMPEL SAS",
        "clase_identificacion": "NIT", "numero_identificacion": "900835212", "digito_verificacion": "3",
        "organizacion_juridica": "SOCIEDADES POR ACCIONES SIMPLIFICADAS SAS",
        "cod_ciiu_act_econ_pri": "4741", "estado_matricula": "CANCELADA",
        "representante_legal": "PELAEZ VILLADA ALBERTO" }
    ],
    "count": 1, "limit_applied": 3
  },
  "evidence": [
    { "quote": "2558821 DIMPEL SAS — NIT 900835212-3（CANCELADA，CIIU 4741）",
      "url": "https://www.datos.gov.co/resource/c82u-588k.json" }
  ]
}

怎么读：matricula（登记号）要配 camara_comercio 才全国唯一——不同商会的号各自编号；numero_identificacion+digito_verificacion 是 NIT 税号+校验位；cod_ciiu_act_econ_pri 是主营行业代码（4741=零售）；estado_matricula 是登记状态（ACTIVA=在册 / CANCELADA=已注销——本例就是注销行，历史公司同样可查）；representante_legal 是法定代表人名字（公开 officer 信息）。--where 写 SoQL 表达式（如 razon_social like '%BANCOL%'、estado_matricula='ACTIVA'），可组合。

`company fdic_institutions`

美国银行名录检索（FDIC）

参数：

旗标	必填	说明
`--search`	否	全文检索表达式（例 `NAME:"First National" AND ST:TX`）
`--filters`	否	结构化过滤表达式（例 `ST:TX AND CITY:Dallas`；按 CERT 点查用 `CERT:628`）
`--limit`	否	返回行数（默认 5）

**注意：**CERT 精确对应一家机构；机构名（品牌口径）不作身份判定键。

$ company fdic_institutions --filters "CERT:3510"

{
  "reason": "FDIC BankFind：命中 1 行，首选 3510 Bank of America, National Association（在业，Charlotte NC）",
  "result": {
    "cert": 3510,
    "name": "Bank of America, National Association",
    "city": "Charlotte",
    "state": "NC",
    "active": true,
    "established_date": "1904-10-17",
    "end_date": null,
    "report_date": "2026-06-30"
  },
  "evidence": [
    { "quote": "FDIC CERT 3510 = Bank of America, National Association（NC）",
      "url": "https://banks.data.fdic.gov/bankfind-suite/detail/institution/3510" }
  ]
}

怎么读：active: true = 在业受保。active: false 不是「查无此行」——倒闭/退保/并购出族的机构史仍在库，end_date 给出保险关系终结日。report_date 是这条主档的报告期，name 是法定全称（不是品牌简称）。

`company fi_ytj_companies`

芬兰公司名 / business-id → 公司档（YTJ v3）

参数：

旗标	必填	说明
`--name`	否	公司名（子串语义——「Nokia」连「Nokian Vuokrakodit」也命中；历史 / 分支名同样命中）
`--business-id`	否	芬兰 business-id（形如 0205709-4；直查单档）

**注意：**大结果集没有翻页通道（上游忽略分页参数）；business-id 形如 0205709-4。

$ company fi_ytj_companies --name "Nokia"

{
  "reason": "YTJ 名称检索：「Nokia」→ 991 家（返回 63 行——分页参上游无视，页大小恒 ~63），首选 Fysios Mehiläinen Oy（0194099-3，状态 2）——name 连历史名/分支名包含式匹配",
  "result": {
    "total_results": 991,
    "companies": [
      { "business_id": "0194099-3", "latest_name": "Fysios Mehiläinen Oy", "registration_date": "1975-01-10" },
      { "business_id": "0197067-4", "latest_name": "Tikkurila Oyj", "registration_date": "1917-07-26" }
    ]
  },
  "evidence": [
    { "quote": "「Nokia」991 家命中、返回恒 ~63 行；Tikkurila Oyj（0197067-4）这类远亲也被包含式带出",
      "url": "https://avoindata.prh.fi/opendata-ytj-api/v3/companies?name=Nokia" }
  ]
}

**怎么读：**匹配是子串语义且连历史名 / 分支名：「Nokia」把理疗连锁 Fysios、涂料商 Tikkurila（诺基亚出身）都带出来——total_results 是真实总数（例 991），精确定位用完整名或 --business-id 直查。分页参数上游静默忽略——固定约 63 行一页，想收窄就换更长的名字。

`company fr_recherche_search`

法国企业名 / 高管名 / SIREN → 企业档（annuaire）

参数：

旗标	必填	说明
`--q`	是	一个检索词三用：公司名 / 高管人名（跨公司任职检索）/ SIREN 直查
`--page`	否	页码，1 起（走 while page ≤ total_pages）
`--per-page`	否	每页行数，1–25（默认 10；超 25 本地直接报错，不查上游）
`--etat-administratif`	否	状态真过滤：A=在营 / C=注销（上游默认不过滤；小写自动归一）

注意：--q 必填；人名检索是跨公司任职聚合，重名常见——落库前以 SIREN 收窄复核。

$ company fr_recherche_search --q "Dassault Aviation" --per-page 2

{
  "reason": "FR recherche：「Dassault Aviation」→ 69 家（页 1/35），首选 DASSAULT AVIATION（SIREN 712042456，A，dirigeants 13 行）——q 通吃名称/高管人名/SIREN",
  "result": {
    "total_results": 69, "total_pages": 35, "page": 1, "per_page": 2,
    "results": [
      { "siren": "712042456", "nom_complet": "DASSAULT AVIATION",
        "etat_administratif": "A", "date_creation": "1971-01-01",
        "categorie_entreprise": "GE", "tranche_effectif_salarie": "53", "tva": "FR73712042456",
        "dirigeants": [ { "type_dirigeant": "personne physique", "nom": "BOUMAZA", "prenoms": "BESMA",
          "date_de_naissance": "1976-07", "annee_de_naissance": 1976, "qualite": "Administrateur" } ],
        "siege": { "siret": "71204245600061", "est_siege": true,
          "adresse": "78 QUAI MARCEL DASSAULT 92210 SAINT-CLOUD", "code_postal": "92210" } }
    ]
  },
  "evidence": [
    { "quote": "DASSAULT AVIATION（SIREN 712042456，A，1971 年设立，GE 大企业档，dirigeants 13 行）",
      "url": "https://recherche-entreprises.api.gouv.fr/search?q=712042456" }
  ]
}

怎么读：siren 是法国国家键；tva 就是 VAT 号（FR+校验位+SIREN）；etat_administratif A=在营 / C=注销（--etat-administratif 是真过滤，上游默认不过滤）；dirigeants 是董事 / 高管槽（自然人带姓名+出生年月，法人槽带 siren）——把人名当 q 查就是跨公司把这些槽搜出来；siege.siret 是总部场所键（SIREN+场所序号）；categorie_entreprise GE=大企业。

`company gb_contracts_finder_published_notices`

英国低门槛合同公告（Contracts Finder）

参数：

旗标	必填	说明
`--name`	否	公司名，本地包含过滤（上游该面没有按名检索的参数——每页取满 100 行再滤）
`--stages`	否	阶段过滤：tender / award（缺省=两阶段混流；写错值上游 400 自报闭集）
`--published-from`	否	发布窗起，YYYY-MM-DD（默认回看 7 天）
`--published-to`	否	发布窗止（默认今天）
`--limit`	否	返回行数，1–100；配 --name 时为匹配数上限（每页仍取 100）
`--cursor`	否	翻页游标（续走时带上同一时间窗）

**注意：**与 Find a Tender 是双面互补不是替代——高门槛合同不在本面；窗外发布的不返回。

$ company gb_contracts_finder_published_notices --name "Suffolk" --limit 3

{
  "reason": "UK CF：「Suffolk」匹配 3 行 / 原页 100 行（buyer|suppliers contains，有下页可续走；窗 2026-10-19~2026-10-26）——门槛下面与 FTS 互补，supplier id 是 GB-COH/GB-CFS 注册键",
  "result": {
    "rows": [
      { "ocid": "ocds-b5fd17-070a79d6-…", "date": "2026-10-23T15:57:38+01:00", "tags": ["awardUpdate"],
        "buyer": "SUFFOLK COUNTY COUNCIL",
        "suppliers": ["Easy Cabs East Anglia Limited"],
        "supplier_ids": ["GB-CFS-339455"],
        "award_values": [ { "date": "2026-07-30T00:00:00+01:00", "amount": 198930, "currency": "GBP" } ],
        "tender_title": "QSB421 0900 2026-06-29 Mildenhall - Sendsory, Ipswich … - AWARD" }
    ],
    "has_more": true,
    "window": { "published_from": "2026-10-19", "published_to": "2026-10-26" },
    "matched_on": "buyer|suppliers contains"
  }
}

怎么读：award_values 给金额/币种/授予日（例：198,930 GBP）；supplier_ids 是 GB-CFS 注册键（亦有 GB-COH 公司号形态）；window 回显发布窗——默认近 7 天，拉长史须 --published-from/--published-to 自给两端。同样满页 100 再滤、cursor 续页。

`company gb_fts_release_packages`

英国高门槛合同授予（Find a Tender）

参数：

旗标	必填	说明
`--name`	否	公司名，本地包含过滤（上游该面没有按名检索的参数——每页取满 100 行再滤）
`--stages`	否	OCDS 阶段：award / tender（默认 award）
`--limit`	否	返回行数，1–100；配 --name 时为匹配数上限（每页仍取 100）
`--cursor`	否	翻页游标（回填 next_cursor）
`--updated-from`	否	更新窗起，YYYY-MM-DD 或完整 ISO 时间（裸日期自动补 T00:00:00Z）
`--updated-to`	否	更新窗止（裸日期自动补 T23:59:59Z）

**注意：**包含匹配是口径而非缺陷——当前页 0 命中不代表全库没有（cursor 续走翻页）；--stages award|tender 按阶段分面，默认 award。

$ company gb_fts_release_packages --name "NHS" --limit 3

{
  "reason": "UK FTS：「NHS」匹配 3 行 / 原页 100 行（buyer|suppliers contains，有下页可续走）——OCDS 面无名称检索参数，包含匹配是口径非缺陷",
  "result": {
    "rows": [
      { "ocid": "ocds-h6vhtk-04e32b", "date": "2026-10-26T09:34:13Z", "tags": ["award", "contract"],
        "buyer": "Velindre University NHS Trust",
        "suppliers": ["H Jenkinson & Co Ltd"],
        "supplier_ids": ["GB-FTS-187831"],
        "tender_title": "The procurement of office furniture for nVCC" }
    ],
    "next_cursor": "dXBkYXRlZFRvPTIw…",
    "has_more": true,
    "total_in_page": 100,
    "matched_on": "buyer|suppliers contains"
  }
}

怎么读：上游 OCDS 面没有名称检索参数——--name 是本地包含过滤：先取满页 100 行再滤（total_in_page 记原页行数），matched_on 写明匹配的是买方还是供应商名。supplier_ids 是 GB-FTS 注册键，ocid 是 OCDS 全局键；next_cursor 回填续页。

`company gleif_direct_parent`

LEI → 直接母公司

参数：

旗标	必填	说明
`--lei`	是	要查的 LEI 码（20 位全球法人识别码）

**注意：**只认 GLEIF 已申报的关系——没有申报母公司（含实体自报「无母公司」）时，诚实回 404「无母公司」，不推算股权。

$ company gleif_direct_parent --lei "5493001KJTIIGC8Y1R12"

{
  "reason": "GLEIF 直接母公司：5493001KJTIIGC8Y1R12 → Bloomberg L.P.",
  "result": {
    "lei": "5493001KJTIIGC8Y1R12",
    "direct_parent": { "lei": "549300B56MD0ZC402L06", "legal_name": "Bloomberg L.P.", "entity_status": "ACTIVE", "jurisdiction": "US-DE" }
  },
  "evidence": [
    { "quote": "Bloomberg L.P.（LEI 549300B56MD0ZC402L06，ACTIVE）",
      "url": "https://api.gleif.org/api/v1/lei-records/549300B56MD0ZC402L06" }
  ]
}

怎么读：direct_parent 是完整身份卡（法定名/LEI/状态/注册地），不用再回查。要终极母公司（控制链顶端）就换 gleif_ultimate_parent 命令、LEI 原样传入。入参是 LEI——没有 LEI 就先 gleif_lei_records_search 拿一个。

`company gleif_lei_records`

LEI 码 → 公司身份卡

参数：

旗标	必填	说明
`--lei`	是	要查的 LEI 码（20 位全球法人识别码，ISO 17442）

**注意：**只接受 20 位 ISO 17442 形状的合法 LEI；形状不对直接报错（exit 2），不查上游。身份卡只报官方登记，不做主体合并。

$ company gleif_lei_records --lei "5493001KJTIIGC8Y1R12"

{
  "reason": "GLEIF 归一：LEI 5493001KJTIIGC8Y1R12 → Bloomberg Finance L.P.（ACTIVE）",
  "result": {
    "lei": "5493001KJTIIGC8Y1R12",
    "legal_name": "Bloomberg Finance L.P.",
    "entity_status": "ACTIVE",
    "jurisdiction": "US-DE",
    "registration_country": "US",
    "hq_city": "New York",
    "bic": null,
    "mic": null,
    "legal_form": { "id": "T91T", "other": null },
    "creation_date": "2007-06-05",
    "expiration": { "date": null, "reason": null },
    "successor_entities": [],
    "registration": { "status": "ISSUED", "last_update": "2026-01-05T14:20:40Z", "next_renewal_date": "2027-01-25T16:50:02Z", "registered_as": "4348344" }
  },
  "evidence": [
    { "quote": "LEI 5493001KJTIIGC8Y1R12 = Bloomberg Finance L.P.（ACTIVE，US-DE）",
      "url": "https://api.gleif.org/api/v1/lei-records/5493001KJTIIGC8Y1R12" }
  ]
}

**怎么读：**GLEIF 官方登记的身份卡。entity_status 是公司运营状态（ACTIVE=在营）；registration.status 是 LEI 本身的登记状态（ISSUED=有效发放）——两栏是两回事，LEI 登记 LAPSED 而公司仍在营是常见组合。next_renewal_date 是下次年审日，逾期未续的 LEI 参考价值打折。registration.registered_as 是国别注册号对照键（例中=特拉华档案号 4348344）——跨注册册 join 用它不用名。bic/mic 与 legal_form.id（GLEIF ELF 码，例中 T91T）是 LOU 录到才有值的槽，缺=null 非查错。successor_entities 是并购后继 LEI 列表——上游名字恒空，逐个 LEI 回查本面即可（实锚：Nestlé Canada 的后继=8945002SOXKVMWPWUH46）。

`company gleif_lei_records_search`

公司名 → LEI 候选列表

参数：

旗标	必填	说明
`--filter-entity-legal-name`	是	公司法定名称或其片段（包含匹配；官方参数 `filter\[entity.legalName\]`）
`--filter-entity-jurisdiction`	否	辖域过滤（官方参数 `filter\[entity.jurisdiction\]`；ISO 3166 国码或区域码，如 CH、US-MO）
`--filter-entity-status`	否	实体状态过滤（官方参数 `filter\[entity.status\]`；ACTIVE/INACTIVE/NULL——实体生命周期，非 registration.status）
`--page-number`	否	页码，1 基（官方参数 `page\[number\]`；翻页界=result.page.lastPage）
`--page-size`	否	候选数上限，1–200（默认 10）

**注意：**候选≠定论：零命中是合法结果（不是错误）；入库前用 gleif_lei_records 复核。--page-size 单次最多 200 行。辖域参是过滤非转换——宽名窄辖域组合才是正用法。

$ company gleif_lei_records_search --filter-entity-legal-name "Bloomberg Finance L.P." --filter-entity-jurisdiction US-DE --page-size 3

{
  "reason": "GLEIF 名称反查：2 候选（辖域 US-DE 过滤），首选 Bloomberg Finance L.P.（LEI 5493001KJTIIGC8Y1R12，ACTIVE）——法定名包含匹配非模糊容错，候选非权威归一，落库前以 gleif_lei_records 复核",
  "result": {
    "total": 2,
    "page": { "currentPage": 1, "perPage": 3, "from": 1, "to": 2, "total": 2, "lastPage": 1 },
    "candidates": [
      { "lei": "5493001KJTIIGC8Y1R12", "legal_name": "Bloomberg Finance L.P.", "entity_status": "ACTIVE", "jurisdiction": "US-DE", "registration_country": "US", "registered_as": null },
      { "lei": "254900JY1M565T6QM850", "legal_name": "Bloomberg Finance Singapore L.P.", "entity_status": "ACTIVE", "jurisdiction": "US-DE", "registration_country": "US", "registered_as": null }
    ],
    "limit_applied": 3
  }
}

怎么读：匹配是法定名包含语义，非模糊容错——拼准关键词比变体全列更有效。total 是全部匹配数，不是返回条数。--filter-entity-jurisdiction 按辖域收窄（ISO 国码或区域码，如 CH、US-MO）、--filter-entity-status 按实体状态收窄（ACTIVE/INACTIVE/NULL）。候选行带 registered_as 国别注册号——LOU 录到才有值（例中两家未录=null；实锚：US-MO 辖域 Nestlé Purina=00007498），跨注册册 join 用它不用名；page.lastPage 是诚实翻页界，配 --page-number 走全量。

`company gleif_ultimate_parent`

LEI → 终极控制人

参数：

旗标	必填	说明
`--lei`	是	要查的 LEI 码（20 位全球法人识别码）

**注意：**只认 GLEIF 已申报的关系——无申报终极母公司时诚实回 404，不推算股权。

$ company gleif_ultimate_parent --lei "5493001KJTIIGC8Y1R12"

{
  "reason": "GLEIF 终极母公司：5493001KJTIIGC8Y1R12 → Bloomberg Inc.",
  "result": {
    "lei": "5493001KJTIIGC8Y1R12",
    "ultimate_parent": { "lei": "549300RMUDWPHCUQNE66", "legal_name": "Bloomberg Inc.", "entity_status": "ACTIVE", "jurisdiction": "US-DE" }
  },
  "evidence": [
    { "quote": "Bloomberg Inc.（LEI 549300RMUDWPHCUQNE66，ACTIVE）",
      "url": "https://api.gleif.org/api/v1/lei-records/549300RMUDWPHCUQNE66" }
  ]
}

**怎么读：**接上一面：Bloomberg Finance L.P. 的直接母公司是 Bloomberg L.P.，终极控制人是再往上的 Bloomberg Inc.——两面的差距就是控制链的层数。输出同样是完整身份卡（不用再回查）；要一层一层自己走链，就反复调 gleif_direct_parent。

`company kr_hometax_biz_status`

韩国事业者号 → 营业 / 闭业 / 未注册（国税厅）

参数：

旗标	必填	说明
`--biz-no`	是	韩国事业者登记号，10 位数字，连字符可省（124-81-00998 与 1248100998 等价）——运行时必填

**注意：**单号单发——批量核查逐个调用（礼貌限速）；这是状态查询不是名录源（「列出所有公司」做不到）；未注册=号码本身不存在或打错，与「闭业」是两回事。

$ company kr_hometax_biz_status --biz-no 124-81-00998

{
  "reason": "KR hometax：1248100998 → 营业（부가가치세 일반과세자 입니다.）——未注册也是 result=S 合法答案（VIES INVALID 同族）；txprNm 匿名恒 null",
  "result": {
    "status": { "biz_no": "1248100998", "state": "active", "registered": true,
      "tax_type": "부가가치세 일반과세자 입니다.",
      "english_status": "The business registration number is registered" }
  },
  "evidence": [
    { "quote": "1248100998：부가가치세 일반과세자 입니다.｜英文：The business registration number is registered",
      "url": "https://hometax.go.kr/wqAction.do?actionId=ATTABZAA001R08" }
  ]
}

怎么读：state 四态：active（营业，tax_type 带课税类型原文）/ closed（闭业，closed_date 是闭业日）/ unregistered（国税厅无此号——合法答案不是错误）/ error（上游形状异常，原样带回）。号可带连字符（124-81-00998）也可 10 位裸号。查询是匿名的——不泄露业主姓名。

`company no_brreg_enheter`

挪威公司名 / 组织号 → 主档（Brreg）

参数：

旗标	必填	说明
`--navn`	否	公司名（上游真参数名是 navn——写成 name 会 400）
`--organisasjonsnummer`	否	9 位组织号（直查单档，优先于 --navn）
`--page`	否	页码，0 起（仅 --navn 检索时有效）
`--size`	否	每页行数（默认 20，上限 100）

注意：--navn 是上游真参数名（写成 name 直接 400）；有组织号就 --organisasjonsnummer 直查优先；检索分页 --page（0 起）--size（上限 100）。

$ company no_brreg_enheter --navn "Equinor" --size 3

{
  "reason": "Brreg 名称检索：命中 179 家，首选 EQUINOR ASA（923609016）——navn 是挪威语原名参数（?name= 400）",
  "result": {
    "enheter": [
      { "organisasjonsnummer": "923609016", "navn": "EQUINOR ASA",
        "organisasjonsform": { "kode": "ASA", "beskrivelse": "Allmennaksjeselskap" },
        "naeringskode1": { "kode": "06.100", "beskrivelse": "Utvinning av råolje" },
        "antall_ansatte": 21231,
        "konkurs": false, "under_avvikling": false,
        "registrert_i_foretaksregisteret": true, "registrert_i_mva_registeret": true }
    ]
  },
  "evidence": [
    { "quote": "EQUINOR ASA（923609016，ASA，雇员 21,231，行业 06.100 原油开采）",
      "url": "https://data.brreg.no/enhetsregisteret/api/enheter/923609016" }
  ]
}

怎么读：organisasjonsnummer 是挪威国家键——调 no_brreg_roller 查角色就用它；naeringskode1 是行业码；antall_ansatte 是雇员数；负面位独立各查（konkurs 破产 / under_avvikling 清盘中）；两个注册位=同时登记在企业登记册 / 增值税册。

`company no_brreg_roller`

组织号 → 挪威角色名册（CEO / 董事会 / 审计，Brreg）

参数：

旗标	必填	说明
`--organisasjonsnummer`	是	9 位组织号（enheter 结果行里就带）

**注意：**只接受组织号（no_brreg_enheter 行里就带）；STYR 组节选 1 席（实捕 13 席）——真实输出更长，此处仅节选。

$ company no_brreg_roller --organisasjonsnummer 923609016

{
  "reason": "Brreg 角色面：923609016 → 3 组 15 席（Anders Opedal; Jarle Kjell Roth; Finn Bjørn Ruyter…）——人名+出生日期可收（公开面无人份证号）；avregistrert=true=已退任",
  "result": {
    "organisasjonsnummer": "923609016",
    "rollegrupper": [
      { "type_kode": "DAGL", "type_beskrivelse": "Daglig leder",
        "roller": [ { "kode": "DAGL", "person": { "navn": "Anders Opedal", "fodselsdato": "1968-05-04", "er_doed": false }, "avregistrert": false } ] },
      { "type_kode": "STYR",
        "roller": [ { "kode": "LEDE", "person": { "navn": "Jarle Kjell Roth", "fodselsdato": "1960-04-26" } } ] },
      { "type_kode": "REVI",
        "roller": [ { "kode": "REVI", "enhet_organisasjonsnummer": "976389387" } ] }
    ]
  },
  "evidence": [
    { "quote": "DAGL 1 席 Anders Opedal（1968-05-04）；STYR 13 席；REVI 1 席=法人审计（组织号 976389387）",
      "url": "https://data.brreg.no/enhetsregisteret/api/enheter/923609016/roller" }
  ]
}

**怎么读：**结果键是 rollegrupper（按组出，不是平铺 roller）；person 槽带 navn + fodselsdato（公开面无国民号，出生日期用于同名区分），法人槽走 enhet_organisasjonsnummer——例中 REVI 组就是一家审计公司；avregistrert: true=该角色已退任。

`company nzco_companies`

新西兰公司名 → 登记册行（公司号+NZBN 双键，Companies Office）

参数：

旗标	必填	说明
`--q`	是	名称子串（必填；登记册名称索引里公司号也能命中）
`--entity-types`	否	过滤器表单自己的 checkbox 码：ALL（默认）/ LTD / UNLTD / COOP=新西兰本国、ASIC / NON_ASIC=海外注册
`--start`	否	翻页行偏移，0 起（首页省略不发）
`--limit`	否	页容，只有 5 与 15 两值真机见过（默认 15；其余上游不承诺，本地拒绝）

**注意：**搜索面是登记册 UI（无公开 API 契约），按礼貌限速走；查不到不是错误——零命中返回空页（count=0）；要现任董事就拿着公司号调 nzco_directors。

$ company nzco_companies --q "air new zealand"

{
  "reason": "NZ Companies Office: 'air new zealand' → 15 companies (rows 1..15, 15/page, more pages)",
  "result": {
    "rows": [
      { "name": "AIR NEW ZEALAND HOLIDAYS LIMITED", "company_number": "116030", "nzbn": "9429032058956",
        "status": "Removed", "entity_type": "NZ Limited Company",
        "address": "Air New Zealand House, 185 Fanshawe Street, Auckland 1010, New Zealand" },
      { "name": "AIR NEW ZEALAND CONSULTING LIMITED", "company_number": "1837975", "nzbn": "9429034008171",
        "status": "Removed", "entity_type": "NZ Limited Company", "address": null },
      { "name": "AIR NEW ZEALAND ASSOCIATED COMPANIES LIMITED", "company_number": "102153", "nzbn": "9429040422305",
        "status": "Registered", "entity_type": "NZ Limited Company", "address": null }
    ],
    "count": 15, "start": 0, "limit": 15, "has_next": true
  },
  "evidence": [
    { "quote": "116030 AIR NEW ZEALAND HOLIDAYS LIMITED — NZBN 9429032058956 (Removed)",
      "url": "https://app.companiesoffice.govt.nz/companies/app/ui/pages/companies/search" }
  ]
}

怎么读：company_number（公司号）与 nzbn（16 位新西兰商业号）是双官方键——后者是跨政府部门统一 join 键；status 是登记册自己的词（Registered=在册 / Removed=已除名，没有 "Active" 这个词，照录不翻译）；has_next 由翻页器自身的偏移推出（上游不给 total）；--entity-types 用过滤器表单自己的 checkbox 码（LTD/UNLTD/COOP=新西兰本国、ASIC/NON_ASIC=海外注册）；翻页 --start 是行偏移、--limit 只有 5 和 15 两个真机见过的页容，其余上游不承诺（直接报 usage_error）。

`company nzco_directors`

新西兰公司号 → 现任董事名册（法定全名 / 居住地址 / 任命日）

参数：

旗标	必填	说明
`--company-number`	是	新西兰公司号，纯数字（104799=Air New Zealand Limited；先用 nzco_companies 查号）

**注意：**公司号用纯数字（104799=Air New Zealand Limited，先用 nzco_companies 查号）；不存在的号回 404（upstream_not_found）；离任董事不在这个面。

$ company nzco_directors --company-number 104799

{
  "reason": "NZ Companies Office: AIR NEW ZEALAND LIMITED (104799, Registered) → 8 current directors — names and residential addresses are the register's statutory public record",
  "result": {
    "company_name": "AIR NEW ZEALAND LIMITED", "company_number": "104799", "status": "Registered",
    "rows": [
      { "name": "Neal Anthony BARCLAY", "appointment_date": "01 May 2025",
        "address": "17 Bradey Road, Rd 1, Porirua, 5381, New Zealand" },
      { "name": "Claudia Isobel BATTEN", "appointment_date": "28 Oct 2021",
        "address": "1 Hadfield Road, Rd 1, Waikanae, 5391, New Zealand" },
      { "name": "Dean John BRACEWELL", "appointment_date": "20 Apr 2020",
        "address": "114 Lucerne Road, Remuera, Auckland, 1050, New Zealand" }
    ],
    "count": 8
  },
  "evidence": [
    { "quote": "Neal Anthony BARCLAY — appointed 01 May 2025, 17 Bradey Road, Rd 1, Porirua, 5381, New Zealand",
      "url": "https://app.companiesoffice.govt.nz/companies/app/ui/pages/companies/104799/directors" }
  ]
}

怎么读：页面 H1 带公司名+号+状态三确认（号对不上就直接拒绝返回行，防止跨公司错挂）；只回现任董事——离任/ceased 区是另一套标记天然不进；appointment_date 是登记册自己的写法（"01 May 2025"，不转 ISO）；居住地址是 NZ 法定公开字段，隐私法修改后登记册可能部分遮蔽——照录所现，不补全不推断。

`company ror_organizations`

机构名 / ROR id → 研究机构档案

参数：

旗标	必填	说明
`--query`	否	机构名关键词（每页固定 20 行）
`--ror-id`	否	ROR id（0+8 位；裸 id 或完整 URL 均可）
`--page`	否	页码（配 --query）
`--all-status`	否	把非 active（inactive / withdrawn）机构也纳入结果——上游缺省只回 active，其余两态静默隐藏

**注意：**候选非权威归一，落库前以 --ror-id 精确档复核；每页固定 20 条（--page 翻页）；零命中是合法答案——换别名再试。

$ company ror_organizations --query "Broad Institute"

{
  "reason": "ROR 名称检索：「Broad Institute」 → Broad Institute（United States，funder）——候选非权威归一（每页固定 20 条）",
  "result": {
    "candidates": [
      { "ror_id": "05a0ya142", "name": "Broad Institute",
        "aliases": ["Broad Institute of MIT and Harvard", "El Instituto Broad"],
        "type": "funder", "country": "United States", "country_code": "US", "status": "active",
        "established": 2004, "website": "http://www.broadinstitute.org/",
        "external_ids": { "fundref": "100013114", "grid": "grid.66859.34", "isni": "0000 0004 0546 1623", "wikidata": "Q4971893" } }
    ]
  }
}

怎么读：ror_id 是稳定机构键，后续资助、论文关联都挂它。type 是机构类型（funder=资助方，还有 education / company / healthcare 等）；external_ids 是跨库挂接的桥——fundref 接资助库、isni 接文献库、grid 是旧版机构号。

`company sec_fulltext_search`

SEC 申报原文全文检索（EDGAR）

参数：

旗标	必填	说明
`--q`	是	检索词（EDGAR 全文检索语法；短语用引号）
`--forms`	否	申报表型过滤（如 8-K,10-K）
`--startdt`	否	起始日 YYYY-MM-DD（只给一端时自动补 2001-01-01）
`--enddt`	否	截止日 YYYY-MM-DD（只给一端时自动补今天）
`--limit`	否	返回行数，1–100（上游单页即 100 条命中，超出部分本地切片）

**注意：**正文层 2001 年起才有；更早的申报不在全文检索范围。

$ company sec_fulltext_search --q "rare earth" --forms 10-K --limit 2

{
  "reason": "EDGAR FTS：3145 命中（2001+ 正文级），返回 2 行——adsh 与 sec 批线语料同键",
  "result": {
    "total": 3144,
    "total_relation": "eq",
    "hits": [
      { "adsh": "0001580695-19-000462", "cik": "0001445942",
        "company": "Texas Mineral Resources Corp.",
        "form_type": "10-K", "file_date": "2019-11-27",
        "doc_url": "https://www.sec.gov/Archives/edgar/data/1445942/000158069519000462/ex10-17.htm" },
      { "adsh": "0000950123-11-023641", "cik": "0001489137",
        "company": "Molycorp, Inc.",
        "form_type": "10-K", "file_date": "2011-03-09",
        "doc_url": "https://www.sec.gov/Archives/edgar/data/1489137/000095012311023641/d79946e10vk.htm" }
    ]
  }
}

怎么读：total 是命中总数；total_relation: eq = 精确计数，gte = 超过计数上限（至少这么多）。每行 doc_url 直通原文档；adsh 是申报批次键，与 SEC 官方批量档案同键。例中命中的 Texas Mineral Resources Corp. 可用 sec_submissions --cik 接着查现名——那面的改名史例子就来自这里。

`company sec_submissions`

CIK → SEC 申报主体档案

参数：

旗标	必填	说明
`--cik`	是	SEC 申报主体号 CIK（1–10 位数字；search 结果行里就带）

**注意：**CIK 精确对应一个申报主体（照录上游 10 位零填充形）；tickers 空数组=无登记交易面，不是缺数据。

$ company sec_submissions --cik "0001445942"

{
  "reason": "SEC 归一：CIK 1445942 → DyTb, LLC（无 ticker——非上市或未登记交易面），Non-accelerated filer<br>Smaller reporting company",
  "result": {
    "cik": "0001445942",
    "name": "DyTb, LLC",
    "entity_type": "operating",
    "tickers": [],
    "exchanges": [],
    "ein": "870294969",
    "sic": { "code": "1040", "description": "Gold and Silver Ores" },
    "filer_category": "Non-accelerated filer<br>Smaller reporting company",
    "state_of_incorporation": "DE",
    "fiscal_year_end": "0831",
    "former_names": [
      { "name": "Texas Mineral Resources Corp.", "from": "2016-04-14", "to": "2026-07-28" },
      { "name": "Texas Rare Earth Resources Corp.", "from": "2011-02-08", "to": "2016-03-18" }
    ],
    "business_address": { "city": "STILLWATER", "state_or_country": "OK", "state_or_country_name": "OK", "country": null },
    "recent_filings_count": 558,
    "filings_total": 558,
    "last_filing_date": "2026-08-20"
  },
  "evidence": [
    { "quote": "CIK 0001445942 = DyTb, LLC（EIN 870294969，SIC 1040 Gold and Silver Ores）",
      "url": "https://data.sec.gov/submissions/CIK0001445942.json" }
  ]
}

**怎么读：**本例与下文 sec_fulltext_search 正好接力：全文检索「rare earth」命中的 Texas Mineral Resources Corp.，CIK 回查发现 2026-07 已改名 DyTb, LLC——申报史跨名连续，改名不断 CIK。former_names 是曾用名链（含起止日）；filings_total 是申报总数（recent_filings_count 只是近端窗计数）；sic 是行业代码；state_of_incorporation 是注册州（DE=特拉华）。

`company ted_notices_search`

欧盟招标公告检索（TED）

参数：

旗标	必填	说明
`--query`	是	TED 检索表达式（必填；例 `organisation-name-buyer=Siemens* AND organisation-country-buyer=DEU`，尾随 `*` = 前缀匹配）
`--fields`	否	返回字段，逗号分隔（eForms 字段名；写错会 400 并附完整字段清单，照抄正确名即可）
`--limit`	否	每页公告数，1–250（默认 10）
`--page`	否	页码

**注意：**每页 1–250 行（--limit）；名称前缀不合并母子集团——落库前以 VAT/LEI 收窄到目标主体。

$ company ted_notices_search --query "organisation-name-buyer=Siemens* AND organisation-country-buyer=DEU" --limit 3

{
  "reason": "TED v3：「organisation-name-buyer=Siemens* AND organisation-country-buyer=DEU」3 行（满页，可能还有）——名称前缀拼 buyer 面（尾通配），母子集团不合并，落库前以 VAT/LEI 收窄",
  "result": {
    "has_more": true,
    "notices": [
      { "publication_number": "671086-2023", "publication_date": "2023-11-03",
        "title": "Germany – Customer survey services – Befragungssoftware …",
        "notice_type": "cn-standard",
        "buyer": "SBK Siemens-Betriebskrankenkasse", "buyer_country": ["DEU"],
        "total_value": 661000,
        "xml_url": { "MUL": "https://ted.europa.eu/en/notice/671086-2023/xml" } }
    ]
  }
}

怎么读：--query 是上游专家语法原名直传：organisation-name-buyer=Siemens* 尾通配=前缀匹配，AND 组合国别（ISO-3）/CPV。publication_number 是稳定键，xml_url 直指官方原始件。has_more: true = 还有下页。

`company usaspending_spending_by_award`

美国联邦合同与拨款（按收款方）

参数：

旗标	必填	说明
`--recipient-search-text`	是	收款方名称
`--award-type-codes`	否	奖项类型代码，逗号分隔（默认 A,B,C,D=合同；拨款用 02/03 等）
`--start-date`	否	时间窗起，YYYY-MM-DD（只给一端时另一端自动补全）
`--end-date`	否	时间窗止，YYYY-MM-DD
`--fields`	否	返回列，逗号分隔（默认 6 列）
`--limit`	否	每页行数，1–100（默认 10）
`--page`	否	页码（has_more 为真就继续翻）
`--subawards, --no-subawards`	否	是否包含子奖项（默认关）

**注意：**时段给一端即可（另一端自动补全），收窄史窗时两端同给。默认查 A,B,C,D 合同类——拨款用 --award-type-codes 02,03…。落库前以 CIK/UEI 收窄到目标主体。

$ company usaspending_spending_by_award --recipient-search-text "Lockheed Martin" --start-date 2007-10-01 --end-date 2007-12-31 --limit 2

{
  "reason": "USAspending：「Lockheed Martin」A,B,C,D 型 2 行，受款时段 2007-10-01~2007-12-31（page_metadata.hasNext=还有更多，--page 续页）——名称拼接受款人，母子集团不合并，落库前以 CIK/UEI 收窄",
  "result": {
    "awards": [
      { "award_id": "Z201", "recipient_name": "LOCKHEED MARTIN INTEGRATED SYSTEMS, LLC",
        "award_amount": 1074770.37, "start_date": "2006-09-28", "end_date": "2011-09-27",
        "awarding_agency": "Department of Defense",
        "generated_internal_id": "CONT_AWD_Z201_9700_W91QUZ04D0004_9700" }
    ],
    "has_more": true,
    "date_range": { "startdt": "2007-10-01", "enddt": "2007-12-31" }
  }
}

怎么读：awards[] 每行是一笔奖项：金额、起止日、发包机关（例中是国防部）。时段语义要读对：窗口匹配的是与奖项时段有交集的合同（例中 2006 年签的长期合同因此命中 2007Q4 窗），不是「始于窗内」。has_more: true = 还有更多（--page 续页）。名称匹配不合并母子集团——Lockheed Martin 各子公司各自入账，要定位到具体主体用 CIK/UEI。

`company vies_vat`

欧盟 VAT 号官方验真（VIES）

参数：

旗标	必填	说明
`--vat`	是	带成员国前缀的 VAT 号（例 DE811907980）

**注意：**号必须带成员国前缀（如 DE811907980）；名址披露与否按成员国政策而定，不是所有国家都给。

$ company vies_vat --vat DE811907980

{
  "reason": "VIES 校验：DE811907980 有效（DE，成员国遮蔽名址（--- → null，非缺数）)",
  "result": {
    "valid": true,
    "user_error": "VALID",
    "country_code": "DE",
    "vat_number": "DE811907980",
    "name": null,
    "address": null,
    "request_date": "2026-10-23T04:18:21.887Z",
    "approximate": { "name": "---", "matchName": 3 }
  }
}

怎么读：valid: true 是官方确认有效；无效同样是合法答案（ok: true、valid: false）——不是查询失败。名址两栏为 null 是成员国隐私遮蔽（原始回包的 "---" 被如实映射），不是缺数据；approximate 块是模糊匹配参考。request_date 可作审计留痕。

使用边界

国别字段三形并存：主体国别以中文/ISO2/英文三种形态同时存在，跨源合并以强键为准，名称匹配带国别约束。
关系=披露直接证明：只收录公告原文陈述的关系（客户/供应商/子公司），不扩写推断完整供应链；关系成立时点以披露期间为准。
资质历史不删：同一资质多批次多年度行并存；「有效」= 最近一次公示状态，复核到期以新公示为准。
负面事实独立标注：处罚/取消资格等负面极性不进「有效」状态。
证券键不作合并键：股票代码/ticker 经 company_listing 解析回主体，不用于判定「同一家企业」。

企业数据#

命令一览#

入库检索：search 与 read#

search · 按条件筛名单#

read · 调一家公司的完整档案#

直查官方源#

company ch_zefix_firm#

company ch_zefix_firm_search#

company co_rues_companies#

company fdic_institutions#

company fi_ytj_companies#

company fr_recherche_search#

company gb_contracts_finder_published_notices#

company gb_fts_release_packages#

company gleif_direct_parent#

company gleif_lei_records#

company gleif_lei_records_search#

company gleif_ultimate_parent#

company kr_hometax_biz_status#

company no_brreg_enheter#

company no_brreg_roller#

company nzco_companies#

company nzco_directors#

company ror_organizations#

company sec_fulltext_search#

company sec_submissions#

company ted_notices_search#

company usaspending_spending_by_award#

company vies_vat#

使用边界#