简体中文

法律数据

尽调负面信号与披露关联的实时查询：制裁与出口管制名单筛查（US CSL）、竞争案（EU DG COMP · UK CMA）、美国游说披露（LDA）、英国政治资金登记册（UK EC）、国际军贸转移（SIPRI）、美国联邦公报与现行联邦法规（Federal Register · eCFR）、联邦/州判例检索（CourtListener）与英国法院判决（TNA Find Case Law）。全部命令在你的机器上本地执行、无需任何凭证：平台侧不设配额，按各上游规则限流；重复查询在缓存有效期内由本机缓存直接应答。

命令一览

本域全部直查面，每条在下文都有自己的分区（一行定位 / 参数 / 真机示例 / 边界）。

命令	辖域	回答什么
`legal afdb_debarred_entities`	GLOBAL	非洲开发银行除名名册筛查（含跨除名边）
`legal ca_sema_sanctions`	CA	加拿大 SEMA 制裁名单筛查（人/实体/船，IMO join 键）
`legal co_sic_sanctions`	CO	哥伦比亚工商监管局（SIC）企业制裁名册检索。
`legal courtlistener_opinions_search`	US	美国联邦/州判例检索（CourtListener）
`legal csl_screening_list`	US	美国制裁与出口管制名单筛查（CSL）
`legal dgcomp_cases_search`	EU	EU 竞争案件检索（DG COMP）
`legal ecfr_search`	US	美国联邦法规检索（eCFR）
`legal ecfr_titles`	US	美国联邦法规标题结构（eCFR）
`legal federalregister_documents`	US	美国联邦公报文件检索
`legal gb_cma_case`	GB	英国 CMA 单案全档（演变史+决定文件）
`legal gb_cma_cases`	GB	英国竞争与市场管理局案件检索（CMA）
`legal gb_ec_donations`	GB	英国政治捐赠检索（选举委员会）
`legal gb_ec_loans`	GB	英国政治借款检索（选举委员会）
`legal gb_gazette_notices`	GB	英国官方公报检索（The Gazette，破产码章预设）
`legal gb_tna_caselaw_judgment`	GB	英国单份判决全档（当事人×角色/法官/全文）
`legal gb_tna_caselaw_search`	GB	英国法院判决检索（国家档案馆 Find Case Law）
`legal idb_debarred_entities`	GLOBAL	美洲开发银行制裁名册检索（违规族×跨除名标）
`legal ie_revenue_defaulters`	IE	爱尔兰税务违约人名册（法院判罚/Revenue 和解两表）
`legal lda_filings`	US	美国游说申报检索（LDA）
`legal sipri_trades_search`	GLOBAL	国际军贸转移检索（SIPRI）
`legal us_occ_enforcements`	US	美国 OCC 月度执法公告（银行停止令/CMP+个人禁业令，docket 键）
`legal wb_debarred_firms`	GLOBAL	世界银行除名厂商名册（SUPP_ID 与授标流同键）

实时查询

以下均为真实运行命令的原样输出，仅节选部分行。查询是实时的——你运行时拿到的就是官方数据源当时的数据，数字随上游更新而变化。

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

`legal afdb_debarred_entities`

非洲开发银行除名名册筛查（含跨除名边）

参数：

旗标	必填	说明
`--name`	否	主体名（企业或个人）——匹配名称的任何一部分，不分大小写
`--type`	否	主体类型：FIRM 或 INDIVIDUAL（精确匹配，不分大小写）
`--basis`	否	除名依据——匹配 Basis 文本的任何一部分。册内跨行除名以银行 token 标记（WBG / ADB / IDB / EBRD），同一标记既有带空格也有带连字符两种写法，只写 token 即可
`--limit`	否	返回行数，1–100（默认 20）。整册在本地筛查，结果里的 total_matched 是确切命中数

**注意：**上游标点两态并存（CROSS DEBARMENT : WBG 带空格 vs CROSS-DEBARMENT: ADB 连字符）——--basis 是子串匹配勿写全句；人名行姓氏全大写为上游原样（如 ATABEKOV）。站点在 Cloudflare UA 指纹门后，SDK 已内置完整浏览器头套件，无需配置。

$ legal afdb_debarred_entities --name "CHINA RAILWAY" --limit 3

{
  "reason": "AfDB debarment register: 39 of 1440 rows matched (name contains \"CHINA RAILWAY\"), returning top rows — Basis carries the cross-debarment edge (WBG/ADB/IDB/EBRD tokens; To empty = ongoing); zero hits = not on the AfDB register",
  "result": {
    "rows": [
      { "Type": "FIRM", "Name": "China Railway 20th Bureau Group Corporation Ltd", "Nationality": "China",
        "From": "2026-09-24", "To": "2027-10-23", "Basis": "DEBARMENT:AFDB", "Notes": "" }
    ],
    "total_matched": 39,
    "scanned_rows": 1440,
    "limit_applied": 3,
    "params": { "name": "CHINA RAILWAY", "type": null, "basis": null }
  },
  "evidence": [
    { "quote": "China Railway 20th Bureau Group Corporation Ltd (FIRM, China) 2026-09-24→2027-10-23 · DEBARMENT:AFDB",
      "url": "https://www.afdb.org/en/projects-operations/debarment-and-sanctions-procedures" }
  ],
  "source": { "provider": "afdb", "execution": "local", "from_cache": false },
  "jurisdiction": "GLOBAL"
}

怎么读：To 为空 = 除名仍在进行（169 行如此）；Basis 就是跨除名边——四家多边开发银行互相承认的除名在此自证。--type 收窄 FIRM/INDIVIDUAL，--basis 按银行 token（WBG/ADB/IDB/EBRD）子串过滤。整册缓存 24h，此后任意次数筛查零网络。

`legal ca_sema_sanctions`

加拿大 SEMA 制裁名单筛查（人/实体/船，IMO join 键）

参数：

旗标	必填	说明
`--name`	否	被指定名称——匹配正名或别名的任何一部分，不分大小写；结果回显命中的是哪一个
`--country`	否	国家——匹配国家格子的任何一部分；该格子双语书写（Syria 与 Syrie 同中）
`--limit`	否	返回行数，1–100（默认 20）。整册在本地筛查，结果里的 total_matched 是确切命中数

**注意：**标签与值全双语照录（Country-Pays 对名标签、Syria / Syrie 值、船型值内竖线分语言半边）；个别 EntityOrShip 值带尾分号是上游数据质量，原样保留；人名行 = GivenName×LastName 组装、姓氏全大写照录。

$ legal ca_sema_sanctions --country Syria --limit 3

{
  "reason": "Canada SEMA sanctions list: 262 of 5708 listings matched, country contains \"Syria\" — bilingual cells verbatim (Syria / Syrie), schedule = the SEMA schedule reference; zero hits = not designated under SEMA",
  "result": {
    "rows": [
      { "kind": "entity", "name": "General Intelligence Directorate;", "aliases": [],
        "country": "Syria / Syrie", "ship_imo": null, "schedule": "Part 1", "item": "1",
        "date_of_listing": "2011-05-24", "matched_on": null }
    ],
    "total_matched": 262,
    "scanned_rows": 5708,
    "limit_applied": 3,
    "params": { "name": null, "country": "Syria" }
  },
  "evidence": [
    { "quote": "General Intelligence Directorate; (entity, Syria / Syrie) · listed 2011-05-24",
      "url": "https://www.international.gc.ca/world-monde/international_relations-relations_internationales/sanctions/consolidated-consolide.aspx?lang=eng" }
  ],
  "source": { "provider": "ca_sema", "execution": "local", "from_cache": false },
  "jurisdiction": "CA"
}

怎么读：--name 同时扫正名与 aliases（matched_on 回显命中面 name/alias）；--country 是双语格子串——Syria 与 Syrie 同中。731 行船带 IMO 号（ship_imo），可直接 join THETIS-MRV/Pari MoU 船册面。整册 2.9MB 缓存 24h。

`legal co_sic_sanctions`

哥伦比亚工商监管局（SIC）企业制裁名册检索。

参数：

旗标	必填	说明
`--where`	否	SoQL 过滤表达式原样透传（例 `upper(multado) like '%ECOPETROL%'`——被罚主体名列 multado；册内 3,938 条 2013 年起）
`--limit`	否	每页行数，1–500（默认 20）
`--offset`	否	翻页偏移，0 起（本册无总数回显，翻页走偏移）
`--order`	否	排序（例 `fecha_emitida DESC`；缺省=入库序非时间序）

**注意：**公司键是被罚主体名（multado 列，name-only——册内无 NIT 列，与 co_rues_companies 主档的 NIT join 走语料线）；按名过滤写 --where 'upper(multado) like '%ECOPETROL%''（raw SoQL 透传）；本册无总数回显——翻页走 --offset，别按回显猜页数。

$ legal co_sic_sanctions --limit 3 --order "fecha_emitida DESC"

{
  "reason": "Colombia SIC sanctions register: 3 rows returned (enumerate from the head of the register; the corpus holds 3,938 firm sanctions 2013→, counted at admission) — row = multado (sanctioned party) × valor (COP) × conducta × sector; name-only key, join onto NIT via co_rues_companies on the corpus line",
  "result": {
    "rows": [
      { "radicado": "24 503714", "res_sancion": "40639", "fecha_emitida": "2026-05-29T00:00:00.000",
        "multado": "MICREDITOYA MICROFINANCIERA SAS", "valor": "353999520",
        "conducta": "Usura", "sector": "Servicios de financiación" },
      { "radicado": "23 155249", "res_sancion": "40643", "fecha_emitida": "2026-05-29T00:00:00.000",
        "multado": "COOPERATIVA DE AHORRO Y CREDITO FINCOMERCIO LTDA - FINCOMERCIO", "valor": "98333200",
        "conducta": "Falta de información para conocer las características del crédito", "sector": "Servicios de financiación" },
      { "radicado": "24 224232", "res_sancion": "40197", "fecha_emitida": "2026-05-28T00:00:00.000",
        "multado": "GABRIEL AMARANTO SUAREZ MANOTAS", "valor": "2809520",
        "conducta": "Presentar documentación falsa o adulterada al Ministerio de Comercio, Industria y Turismo, a las Cámaras de Comercio o a las entidades oficiales que la soliciten", "sector": "Turismo" }
    ],
    "count": 3,
    "limit_applied": 3,
    "params": { "$limit": 3, "$offset": 0, "$order": "fecha_emitida DESC" }
  },
  "evidence": [
    { "quote": "MICREDITOYA MICROFINANCIERA SAS — Usura (Servicios de financiación), COP 353999520, res. 40639 of 2026-05-29",
      "url": "https://www.datos.gov.co/Comercio-Industria-y-Turismo/Sanciones-impuestas-en-firme-por-la-SIC/73dx-n59j" }
  ],
  "source": { "provider": "co_sic", "execution": "local", "from_cache": false },
  "query": { "source": "raw", "upstream": { "$limit": 3, "$offset": 0, "$order": "fecha_emitida DESC" } },
  "jurisdiction": "CO"
}

怎么读：$order 是唯一排序通道（缺省=入库序非时间序——按时间倒序翻册写 --order "fecha_emitida DESC"）。七列原样无遮蔽槽：multado 含个人名=SIC 公开记录本体。24h TTL（Socrata 匿名档，与 co_secop/co_rues 同平台同档）。

`legal courtlistener_opinions_search`

美国联邦/州判例检索（CourtListener）

参数：

旗标	必填	说明
`--q`	否	全文检索词
`--case-name`	否	案件名过滤
`--court`	否	法院 id（如 calctapp / scotus）
`--judge`	否	法官名过滤
`--docket-number`	否	案号过滤
`--filed-after`	否	归档日 YYYY-MM-DD 起（含当日）
`--filed-before`	否	归档日止（含当日）
`--order-by`	否	排序（如 `score desc`）
`--cursor`	否	翻页游标（回填 next_cursor）

**注意：**全语料约 830 万判例的批量件走 S3 批线，本面是检索面非全量下载；至少给一个检索条件。

$ legal courtlistener_opinions_search --q "misappropriation of trade secrets"

{
  "reason": "CourtListener：q=misappropriation of trade secrets共 9,021 判例，本页 20 条，首选 Home Preferred Home Care, Ltd. v. Hiscox Ins. Co.（Ohio Court of Appeals，2023-03-30）——next_cursor 续页",
  "result": {
    "total": 9021,
    "count": 20,
    "rows": [
      { "cluster_id": 9388138, "docket_id": 67110914,
        "case_name": "Home Preferred Home Care, Ltd. v. Hiscox Ins. Co.",
        "court": "Ohio Court of Appeals", "court_id": "ohioctapp",
        "date_filed": "2023-03-30", "docket_number": "2022CA00122",
        "status": "Published", "judge": "King",
        "citations": ["2023 Ohio 1059"] }
    ],
    "next_cursor": "cz0zMC45MzA0OTYmcz0yNzM2OTM4JnQ9byZkPTIwMjYtMTAtMjYmcD0y …"
  },
  "evidence": [
    { "quote": "Home Preferred Home Care, Ltd. v. Hiscox Ins. Co. — Ohio Court of Appeals — 2023-03-30 — 2023 Ohio 1059",
      "url": "https://www.courtlistener.com/opinion/9388138/home-preferred-home-care-ltd-v-hiscoh-ins-co/" }
  ]
}

怎么读：citations 是判例引注（可直接写进报告的形）；court 具名到法院、--court 可用法院 id（如 scotus / calctapp）收窄；--case-name / --judge / --docket-number / --filed-after 多维过滤。上游页固定 20 条，next_cursor 回填续页。

`legal csl_screening_list`

美国制裁与出口管制名单筛查（CSL）

参数：

旗标	必填	说明
`--name`	否	主体名（子串、不分大小写；同时匹配 name 与 alt_names；必填——缺失时返回 JSON 用法错误信封）
`--source`	否	名单族过滤，子串（如 "Entity List"、"SDN"、"Sectoral"）
`--type`	否	主体类型：Entity / Individual / Vessel / Aircraft（不少行不带类型）
`--limit`	否	返回行数（默认 20，上限 100；total_matched 回显全量命中数）

**注意：**零命中=筛查通过（合法答案，非错误）；--source/--type 可按名单族/主体类型收窄；本面只覆盖美国合并名单——UN/EU/英名单不在其中。

$ legal csl_screening_list --name "Rosneft" --limit 3

{
  "reason": "CSL 合并筛查阳性：全册 26173 行（12 名单族）命中 10 条「Rosneft」，返回 3 行——matched_on=name|alt_names 命中面，零命中=筛查通过",
  "result": {
    "total_matched": 10,
    "scanned_rows": 26173,
    "limit_applied": 3,
    "rows": [
      { "name": "Open Joint-Stock Company Rosneft Oil Company",
        "alt_names": ["OJSC Rosneft Oil Company", "Rosneft Oil Company", "Rosneft"],
        "matched_on": "name",
        "matched_value": "Open Joint-Stock Company Rosneft Oil Company",
        "type": "Entity",
        "source_list": "Sectoral Sanctions Identifications List (SSI) - Treasury Department" }
    ]
  },
  "evidence": [
    { "quote": "Open Joint-Stock Company Rosneft Oil Company — SSI (Treasury)",
      "url": "https://trade.gov/consolidated-screening-list" }
  ]
}

怎么读：matched_on 写明命中面——正文叫「Rosneft Oil Company」也能经 alt_names 别名池命中全称行，别只看首选行；total_matched 是全册命中总数（本例 10 条，跨 SDN/SSI 等多族）。source_list 具名到名单族与主管机关。全册 CSV 缓存 24h、本地扫描——不打上游接口。

`legal dgcomp_cases_search`

EU 竞争案件检索（DG COMP）

参数：

旗标	必填	说明
`--query`	否	原始 ES bool 查询，JSON 文本（例 `{"bool":{"must":\[{"term":{"caseInstrument":"SA"}}\]}}`）
`--name`	否	当事人/案件名快捷通道：查 caseTitle 等三个字段（与 --query 二选一；要裸 DSL 用 --query）
`--instrument`	否	案件类型：AT 反垄断 / M 并购 / SA 国家援助 / DMA 数字市场法
`--text`	否	附加全文条件（缺省=不加）
`--page`	否	页码
`--limit`	否	返回行数，1–100（更大值不报错、仍按 100 返回）

**注意：**命中=案名/当事方含关键词（宽召回，须人工复核）；返回的是案件卡，裁决书等原文从每行附带的官方链接进入案件页获取。--limit 上限 100——更大的数静默按 100 返回（上游实测）。

$ legal dgcomp_cases_search --name "Google" --limit 3

{
  "reason": "DG COMP：命中 20 案（当事方名/案名含「Google」），返回 3 行——SA 案 title=受益企业名（补贴事件流）",
  "result": {
    "total": 20,
    "rows": [
      { "case_number": "SA.124330", "title": "SPOT - Google", "instrument": "SA", "member_state": "BEL",
        "decision_date": null, "initiation_date": "2026-07-23",
        "url": "https://competition-cases.ec.europa.eu/search?caseNumber=SA.124330" },
      { "case_number": "M.4731", "title": "GOOGLE / DOUBLECLICK", "instrument": "M",
        "decision_date": "2008-03-10",
        "url": "https://competition-cases.ec.europa.eu/search?caseNumber=M.4731" }
    ],
    "limit_applied": 3
  },
  "evidence": [
    { "quote": "SA.124330 SPOT - Google（SA，—）",
      "url": "https://competition-cases.ec.europa.eu/search?caseNumber=SA.124330" }
  ],
  "source": { "provider": "dgcomp", "execution": "local", "from_cache": true, "fetched_at": "2026-10-21T03:05:32.900Z" }
}

怎么读：--instrument AT/M/SA 按案型过滤（反垄断 / 并购 / 国家补贴）——SA 案型即补贴事件流。case_number 是稳定键，裁决书原文从每行附带的官方链接进入案件页取。7 天 TTL。

`legal ecfr_search`

美国联邦法规检索（eCFR）

参数：

旗标	必填	说明
`--q`	否	主题词（必填——缺失时返回 JSON 用法错误信封）
`--page`	否	页码（默认 1）
`--limit`	否	返回行数（默认 20，上限 100）
`--date`	否	时点检索 YYYY-MM-DD——取该日仍在效力的条文版本（缺省=现行文本；例：石棉现行 1,436 条，2024-01-01 时点只剩 339 条）

注意：--q 必填（缺失返回 JSON 用法错误信封，不是报错崩溃）；--limit 上限 100；命中数是节级非全文级——要联邦公报逐日发布流的全文检索走 federalregister_documents。

$ legal ecfr_search --q asbestos --limit 3

{
  "reason": "eCFR 现行态：全库命中 1436 节（页 1/479），返回 3 行——coords=法典七级坐标；starts_on~ends_on=该版条款生效窗（节级变化语义，非全文检索）；现行全文流走 legal fulltext（FR 日报）",
  "result": {
    "rows": [
      { "coords": "40 CFR Part 763 Subpart E Appendix D to Subpart E of Part 763",
        "hierarchy": { "title": "40", "subtitle": null, "chapter": "I", "subchapter": "R", "part": "763", "subpart": "E",
                       "subject_group": null, "section": null, "appendix": "Appendix D to Subpart E of Part 763" },
        "headings": { "title": "Protection of Environment", "subtitle": null, "chapter": "Environmental Protection Agency",
                      "subchapter": "Toxic Substances Control Act", "part": "<strong>Asbestos</strong>",
                      "subpart": "<strong>Asbestos</strong>-Containing Materials in Schools", "subject_group": null, "section": null,
                      "appendix": "Transport and Disposal of <strong>Asbestos</strong> Waste\n" },
        "type": "Appendix", "starts_on": "2019-08-16", "ends_on": "2019-08-22",
        "change_types": ["effective_cross_reference"], "removed": false, "reserved": false,
        "structure_index": 340276, "score": 44.185383,
        "excerpt": "activities from receipt of the containerized <strong>asbestos</strong> waste at the generation site until it has<span class=\"elipsis\">…</span>pickup site, the estimated quantity of <strong>asbestos</strong> waste, types of containers used, and the<span class=\"elipsis\">…</span>operator to transfer responsibility for the <strong>asbestos</strong> waste. A copy of the form signed by the" }
    ],
    "count": 3, "limit_applied": 3, "total": 1436, "total_pages": 479, "current_page": 1,
    "description": "Changes to sections matching 'asbestos'"
  },
  "evidence": [
    { "quote": "40 CFR Part 763 Subpart E Appendix D to Subpart E of Part 763｜Appendix｜Asbestos｜生效 2019-08-16~2019-08-22",
      "url": "https://www.ecfr.gov/current/title-40" },
    { "quote": "40 CFR Part 763 Subpart E Appendix D to Subpart E of Part 763｜Appendix｜Asbestos｜生效 2019-07-17~2019-08-15",
      "url": "https://www.ecfr.gov/current/title-40" }
  ],
  "source": { "provider": "ecfr", "execution": "local", "from_cache": false, "observed_at": "2026-10-29T11:26:37.266Z" }
}

怎么读：命中是节级版本流——同一条文多次修订会出多行，每行一个生效窗（上面 evidence 两行就是同一附录的先后两版）；coords 是法典坐标、hierarchy/headings 是同一坐标的结构化与人类可读两形（命中词带 <strong> 高亮）；excerpt 是带高亮与省略号的原文窗口；--date 时点检索（如 2024-01-01）只取当日仍在效力的版本——asbestos 从现行 1,436 节缩到 339 节。

`legal ecfr_titles`

美国联邦法规标题结构（eCFR）

注意：目录面零参数——50 册一次全量返回，无过滤无分页；本面是册级目录，按节查条文走 ecfr_search。

$ legal ecfr_titles

{
  "reason": "eCFR 目录：50 册（现行 49），日更水位 as_of=2026-10-27——册号+册名+最近修正/发布日；search 按节级查现行态走 ecfr_search",
  "result": {
    "count": 50,
    "active": 49,
    "as_of": "2026-10-27",
    "titles": [
      { "number": 1, "name": "General Provisions", "latest_amended_on": "2022-12-29", "latest_issue_date": "2026-08-10", "up_to_date_as_of": "2026-10-27", "reserved": false },
      { "number": 35, "name": "Reserved", "latest_amended_on": null, "latest_issue_date": null, "up_to_date_as_of": null, "reserved": true },
      { "number": 41, "name": "Public Contracts and Property Management", "latest_amended_on": "2026-10-26", "latest_issue_date": "2026-10-26", "up_to_date_as_of": "2026-10-27", "reserved": false }
    ]
  },
  "evidence": [
    { "quote": "Title 1 General Provisions（修正 2022-12-29，整合至 2026-10-27）", "url": "https://www.ecfr.gov/current/title-1" }
  ],
  "source": { "provider": "ecfr", "execution": "local", "from_cache": true, "fetched_at": "2026-10-29T10:08:43.673Z" }
}

怎么读：number+name 是册号册名（引用 CFR 时的卷号，如 40=环境保护）；latest_amended_on=最近修正日、latest_issue_date=最近发布日（两个日期语义不同）；as_of 是全库整合水位（eCFR 每日整合一次）；第 35 册是 reserved 预留空册（日期列全 null）——现行实际 49 册。

`legal federalregister_documents`

美国联邦公报文件检索

参数：

旗标	必填	说明
`--q`	是	检索词（带引号的短语=精确匹配）
`--startdt`	否	发布日 YYYY-MM-DD 起（只给一端时自动补 1994-01-01）
`--enddt`	否	发布日止（只给一端时自动补今天）
`--order`	否	结果顺序：relevance / newest / oldest / executive_order_number（第四值按总统令号排）
`--doc-type`	否	文件类型，闭集：RULE / PRORULE / NOTICE / PRESDOCU（上游对错值静默回 0 行——本地先拦）
`--agencies`	否	机构 slug（如 environmental-protection-agency；全表在 GET /api/v1/agencies）
`--cfr-title`	否	CFR 卷号（如 40=环境保护）
`--cfr-part`	否	CFR 条号或区间（如 763 或 1-50；须配 --cfr-title）
`--page`	否	页码
`--limit`	否	返回行数（上限 50——平台自限，上游允许到 1000）

**注意：**覆盖 1994 年起；--limit 礼貌档 50（上游可到 1000）；引号短语走精确匹配。

$ legal federalregister_documents --q "sanctions" --limit 3

{
  "reason": "Federal Register：10000 命中（1994+ 全文级），返回 3 行——document_number 是稳定键，单档 raw_text_url 供语料批线取全文",
  "result": {
    "total": 10000,
    "rows": [
      { "document_number": "2026-19678", "title": "Sanctions Penalties Regulations", "type": "Rule",
        "publication_date": "2026-09-25",
        "abstract": "The Department of the Treasury's Office of Foreign Assets Control (OFAC) is adding the Sanctions Penalties Regulations…",
        "citation": null }
    ],
    "limit_applied": 3
  },
  "evidence": [
    { "quote": "Sanctions Penalties Regulations — Rule, 2026-09-25",
      "url": "https://www.federalregister.gov/documents/2026-19678" }
  ]
}

怎么读：document_number 是稳定键（引用与取全文都挂它）；type 是文种（Rule / Proposed Rule / Notice…）；日期窗 --startdt/--enddt 单端会自动补另一端（1994-01-01 / 今天）。

`legal gb_cma_case`

英国 CMA 单案全档（演变史+决定文件）

参数：

旗标	必填	说明
`--slug`	是	案件页尾段标识（用 cases 结果行里的 slug；直接粘贴整条 gov.uk 链接也会自动剥掉前缀）

**注意：**单案面必须给 --slug——slug 从 gb_cma_cases 列表行拿（整条 gov.uk 链接贴进来也行，前缀自动剥）；空库外 slug 返回零行。

$ legal gb_cma_case --slug google-beatthatquote-com

{
  "reason": "UK CMA 单案：Google / BeatThatQuote.com——1 段演变（最近：First published.），1 份决定/通告 PDF；首次发布 2011-07-01T10:00:00+01:00",
  "result": {
    "slug": "google-beatthatquote-com",
    "content_id": "99eb6c35-f8f3-4e6a-bb0f-d31bdae4e7c6",
    "title": "Google / BeatThatQuote.com",
    "description": "OFT closed case: Completed acquisition by Google Inc. of BeatThatQuote.com Limited.",
    "document_type": "cma_case",
    "first_published_at": "2011-07-01T10:00:00+01:00",
    "public_updated_at": "2011-07-01T10:00:00+01:00",
    "updated_at": "2026-10-14T11:55:15+01:00",
    "withdrawn": false,
    "change_history": [
      { "note": "First published.", "public_timestamp": "2011-07-01T09:00:00Z" }
    ],
    "attachments": [
      { "title": "Google-BeatThatQuote.pdf",
        "url": "https://assets.digital.cabinet-office.gov.uk/media/555de311ed915d7ae200005f/Google-BeatThatQuote.pdf",
        "content_type": "application/pdf", "content_id": "bd0691a5-fa72-4e07-8ebf-9eb5d8639568" }
    ],
    "body_html": "<p>Full text of the decision: <span id=\"attachment_bd0691a5-fa72-4e07-8ebf-9eb5d8639568\" class=\"attachment-inline\"><a href=\"https://assets.digital.cabinet-office.gov.uk/media/555de311ed915d7ae200005f/Google-BeatThatQuote.pdf\">Google-BeatThatQuote.pdf</a></span></p>",
    "organisations": ["Competition and Markets Authority"],
    "url": "https://www.gov.uk/cma-cases/google-beatthatquote-com"
  },
  "evidence": [
    { "quote": "Google-BeatThatQuote.pdf（application/pdf）",
      "url": "https://assets.digital.cabinet-office.gov.uk/media/555de311ed915d7ae200005f/Google-BeatThatQuote.pdf" }
  ],
  "source": { "provider": "gb_cma", "execution": "local", "from_cache": false, "observed_at": "2026-10-30T07:35:12.802Z" }
}

怎么读：content_id 是稳定 UUID 键（列表行不带，入库挂它）；change_history 按新→旧排、[0] 就是最近进展（本案只有 First published 一段）；attachments 是决定/通告 PDF 族——本案 Google-BeatThatQuote.pdf 直链可开；body_html 是案件页摘要原文。本案是 OFT 时代移交档案（description 自称 OFT closed case）——2014 年竞争职能并入 CMA 前的旧案照样收录。

`legal gb_cma_cases`

英国竞争与市场管理局案件检索（CMA）

参数：

旗标	必填	说明
`--q`	否	案件检索词（打案名/描述；不传=枚举全库约 2,600 案——案名就是当事公司对，如「Google / BeatThatQuote.com」）
`--count`	否	每页行数 1–100（默认 20；这 100 是我方的礼貌上限，上游本身没有墙）
`--start`	否	偏移翻页：从第几行开始取（默认 0）

**注意：**上游参数极简：只收 --q/--count/--start（organisations/order 等组合参上游 422）；列表行不带 content_id（上游 _id 是页面路径非 UUID，勿当键用）。

$ legal gb_cma_cases --q google --count 5

{
  "reason": "UK CMA 案库：命中 24 案，返回 5 行（检索词「google」）——案名=当事公司对（并购/调查案），单案详情走 gb_cma_case（slug=行内 slug）",
  "result": {
    "total": 24,
    "rows": [
      { "slug": "google-beatthatquote-com", "title": "Google / BeatThatQuote.com",
        "public_timestamp": "2011-07-01T09:00:00Z",
        "organisations": ["Competition and Markets Authority"],
        "url": "https://www.gov.uk/cma-cases/google-beatthatquote-com" },
      { "slug": "googles-mobile-platform", "title": "Google's mobile platform",
        "public_timestamp": "2026-08-14T11:08:23Z",
        "organisations": ["Competition and Markets Authority"],
        "url": "https://www.gov.uk/cma-cases/googles-mobile-platform" }
    ],
    "count": 5, "limit_applied": 5
  },
  "evidence": [
    { "quote": "Google / BeatThatQuote.com — 2011-07-01", "url": "https://www.gov.uk/cma-cases/google-beatthatquote-com" }
  ]
}

怎么读：slug 是单案联结键——agentdata legal gb_cma_case --slug <行内 slug> 取全档（content_id 稳定 UUID 只在详情面；change_history 按新→旧排、[0] 就是最近进展；attachments 为决定/通告 PDF 族）。--count 礼貌档 1-100；省略 --q 即全库枚举（~2,591 案活数）。

`legal gb_ec_donations`

英国政治捐赠检索（选举委员会）

参数：

旗标	必填	说明
`--query`	是	捐赠方/登记主体名（包含匹配；必填）
`--from`	否	窗口起 YYYY-MM-DD（默认登记起点 2001-02-16）
`--to`	否	窗口止（默认今天）
`--start`	否	偏移量
`--limit`	否	返回行数，1–50（更大值不报错、仍按 50 返回）

**注意：**捐助人名是法人全称口径（J C Bamford Excavators Ltd ≠ 品牌名 JCB）——试查须双形；--limit 上限 50（上游硬钳），更深的翻页用 --start 偏移。

$ legal gb_ec_donations --query "J C Bamford" --limit 3

{
  "reason": "UK EC 政治捐款：167 笔（「J C Bamford」，窗口 2001-02-16~2026-10-27；上限 50 行——上游 rows 硬钳 2026-10-26 实测）",
  "result": {
    "total": 167,
    "rows": [
      { "donor_or_lender": "J C Bamford Excavators Ltd",
        "recipient": "Conservative and Unionist Party", "recipient_registration": "00561597",
        "value_gbp": 10000.0, "date": "2026-04-22", "type_description": "Cash", "ec_ref": "C0840321" },
      { "donor_or_lender": "J C Bamford Excavators Ltd",
        "recipient": "Conservative and Unionist Party", "recipient_registration": "00561597",
        "value_gbp": 5000.0, "date": "2026-04-01", "type_description": "Cash", "ec_ref": "C0838114" }
    ],
    "date_range": { "from": "2001-02-16", "to": "2026-10-27" }
  },
  "evidence": [
    { "quote": "捐款 J C Bamford Excavators Ltd → Conservative and Unionist Party £10000.0（2026-04-22）",
      "url": "https://search.electoralcommission.org.uk/" }
  ],
  "source": { "provider": "ukec", "execution": "local", "from_cache": false, "observed_at": "2026-10-27T10:03:01.338Z" }
}

怎么读：--from/--to 窗口缺省=登记册全史（2001-02-16 起）；ec_ref 是官方回查锚。24h TTL（季报节奏）。

`legal gb_ec_loans`

英国政治借款检索（选举委员会）

参数：

旗标	必填	说明
`--query`	是	出借方/借款方名（包含匹配；必填）
`--start`	否	偏移量
`--limit`	否	返回行数，1–50（更大值不报错、仍按 50 返回）

**注意：**贷款人名同样是法人全称口径（须双形试查）；--limit 上限 50（上游硬钳），更深翻页用 --start 偏移。

$ legal gb_ec_loans --query "J C Bamford" --limit 3

{
  "reason": "UK EC 零命中：「J C Bamford」无政治贷款记录（空结果是合法答案）",
  "result": {
    "total": 0,
    "rows": []
  },
  "evidence": [],
  "source": { "provider": "ukec", "execution": "local", "from_cache": false, "observed_at": "2026-10-27T10:03:02.907Z" }
}

怎么读：零命中是合法答案不是故障——查贷款没查到，与没捐过款是两回事，别把两个面合并解读。上游贷款端点不接日期窗口参数（捐款面才有 --from/--to）。24h TTL。

`legal gb_gazette_notices`

英国官方公报检索（The Gazette，破产码章预设）

参数：

旗标	必填	说明
`--text`	否	全文包含词（公告正文与标题）
`--noticetypes`	否	公告码，逗号或 + 拼接（如 2410,2432）——事件过滤只认公告码；注意 noticecode= 这个形近参数被上游无视，别处抄来的命令要换成这个
`--insolvency`	否	公司破产码章预设（13 码：清盘决议/清算人任命/管理人/停业等），与 --noticetypes 并集
`--start-date`	否	发表窗起 YYYY-MM-DD
`--end-date`	否	发表窗止 YYYY-MM-DD
`--page`	否	页码（默认 1）
`--page-size`	否	每页行数 1–100（默认 20；100 是上游硬帽）
`--sort`	否	排序：latest-date（默认）或 oldest-date

**注意：**必须给至少一个过滤条件（--text/--noticetypes/--insolvency/日期窗）——裸搜索等于 4,887,099 条全库枚举，本地直接拒绝；全量件走官方 bulk-download 批线，本面是定向检索面。page-size 上游硬帽 100。

$ legal gb_gazette_notices --text "acme" --insolvency --page-size 5

{
  "reason": "The Gazette: 25 notices match, 5 rows on page 1, text \"acme\", codes 2404+…+2702 — title = the company name on corporate insolvency codes (2432 liquidator, 2410 administrator, 2431 cessation); placed_by = liquidator/administrator or the edition; geo = the registered office",
  "result": {
    "total": 25,
    "count": 5,
    "page": 1,
    "page_size": 5,
    "rows": [
      { "notice_id": "L-56774-157", "notice_code": "2431", "category": "Resolutions for Winding-up",
        "title": "Resolutions for Winding-up", "placed_by": "User Migration", "status": "published",
        "published": "2002-12-06T00:00:00", "place_lat": null, "place_long": null,
        "url": "https://www.thegazette.co.uk/notice/L-56774-157",
        "content": "<div><p>Name of Company: ACME …" }
    ],
    "params": { "text": "acme", "results-page": 1, "results-page-size": 5, "noticetypes": "2404+2408+2410+2411+2414+2421+2422+2423+2424+2431+2432+2607+2702" }
  },
  "evidence": [
    { "quote": "Resolutions for Winding-up — 2002-12-06 — company name inside the notice content (a legacy migration row)", "url": "https://www.thegazette.co.uk/notice/L-56774-157" }
  ],
  "source": { "provider": "gazette", "execution": "server", "from_cache": false },
  "jurisdiction": "GB"
}

怎么读：事件过滤只认公告码：--insolvency 一键展开公司破产码章 13 码（清算人任命 2432、管理人 2410、清盘决议 2431…），也可 --noticetypes 自拼。现代行 title 就是公司名、placed_by 是清算人；2002 存量迁移行 title=类目名、placed_by="User Migration"，公司名要到 content 里找（示例即此形）。total 上游回的是字符串，本地已转数。

`legal gb_tna_caselaw_judgment`

英国单份判决全档（当事人×角色/法官/全文）

参数：

旗标	必填	说明
`--document-uri`	是	判决标识（search 行内 uri 三形均可：旧式 ewhc/admin/2026/2298、新版 d-、tna.；粘贴整条链接也会自动剥壳）

**注意：**同一 Open Justice Licence 门：定向取档可，批量喂给计算分析须先申请（免费）许可；text 是抽取文本非排版原件——引用入报告时以行内 data_url 的官方 XML 为准。

$ legal gb_tna_caselaw_judgment --document-uri ewhc/admin/2026/2298

{
  "reason": "UK judgment dossier: [2026] EWHC 2298 (Admin) (EWHC-KBD-Admin, judged 2026-09-07) — 2 parties (claimant 1/defendant 1) · 1 judges · body 32786 chars; licence = Open Justice (reuse compliant, bulk analysis requires an application)",
  "result": {
    "uri": "ewhc/admin/2026/2298",
    "neutral_citation": "[2026] EWHC 2298 (Admin)",
    "title": "Barclays Bank UK PLC & Ors, R (on the application of) v Financial Ombudsman Service Limited",
    "case_number": "AC-2024-LON-003318",
    "court_code": "EWHC-KBD-Admin",
    "date": "2026-09-07",
    "parties": [
      { "name": "BARCLAYS BANK UK PLC", "role": "claimant" },
      { "name": "FINANCIAL OMBUDSMAN SERVICE LIMITED", "role": "defendant" }
    ],
    "judges": ["MR JUSTICE DEXTER DIAS"],
    "text": "1. This is the judgment of the court. …",
    "text_length": 32786
  },
  "evidence": [
    { "quote": "claimant: BARCLAYS BANK UK PLC", "url": "https://caselaw.nationalarchives.gov.uk/ewhc/admin/2026/2298" }
  ]
}

怎么读：parties 是官方角色边（as="#claimant" 直译成 claimant/defendant，公司与人名混列）——比从案名猜「A v B」可靠；text 是判决正文的纯文本抽取（text_length 为全长，示例截断）；--document-uri 收 search 行内 uri 三形，粘贴整条链接也会自动剥壳。

`legal gb_tna_caselaw_search`

英国法院判决检索（国家档案馆 Find Case Law）

参数：

旗标	必填	说明
`--query`	否	全文检索词（引号短语=按词序匹配）
`--court`	否	法院码，可重复（如 uksc ewhc；也可用裁判所码）
`--tribunal`	否	裁判所码，可重复（court 的别名段，如 eat）
`--party`	否	当事人名，整词匹配（如 Barclays——半截词不中）
`--judge`	否	法官名，整词匹配
`--order`	否	排序：date/-date（默认新在前）/updated/-updated/transformation/-transformation
`--page`	否	页码（总页数看结果里的 total_pages）
`--per-page`	否	每页行数 1–50（默认 50=上游缺省，也是我方礼貌档）
`--minimum-availability`	否	表示层下限：metadata/document/full-text（默认 full-text）

注意：Open Justice Licence：允许含商用的复用，但未申请（免费）许可前禁止批量计算分析——本面是定向检索面，请勿全库枚举爬取；官方限 1000 请求/滚动 5 分钟，我方按其一半设礼貌档。

$ legal gb_tna_caselaw_search --party Barclays --per-page 3

{
  "reason": "UK caselaw library (TNA Find Case Law): page 1/18, 3 rows — row = case name (party string)/court/judgment date/neutral citation; the full judgment text goes through gb_tna_caselaw_judgment (uri = the row's uri)",
  "result": {
    "total_pages": 18,
    "license": "https://caselaw.nationalarchives.gov.uk/open-justice-licence",
    "rows": [
      { "uri": "d-2d120c68-0546-4435-8b8c-4190ae3b3c68",
        "neutral_citation": "[2026] EWHC 2298 (Admin)",
        "fcid": "t68nwv3m",
        "title": "Barclays Bank UK PLC & Ors, R (on the application of) v Financial Ombudsman Service Limited",
        "court": "High Court (Administrative Court)",
        "published": "2026-09-07T00:00:00+00:00",
        "contenthash": "586fea31a748b820a69ff380bb445583a729d980209e79bc3f476eb798412f06",
        "data_url": "https://caselaw.nationalarchives.gov.uk/ewhc/admin/2026/2298/data.xml" }
    ],
    "count": 3
  },
  "evidence": [
    { "quote": "[2026] EWHC 2298 (Admin) Barclays Bank UK PLC & Ors, R (on the application of) v Financial Ombudsman Service Limited (High Court (Administrative Court), 2026-09-07)", "url": "https://caselaw.nationalarchives.gov.uk/ewhc/admin/2026/2298" }
  ]
}

怎么读：neutral_citation 是官引号（可直接写进报告的形）；uri 是单份联结键，三形并存（旧式 ewhc/admin/2026/2298、新版 d-<uuid>、tna.<fcid>）；--party/--judge 是整词匹配（Barclays 命中、半截词不中）；--court 可重复传多院码收窄；total_pages 由 feed 头直出，--page 翻页；行内 contenthash 可校验版本是否变过。

`legal idb_debarred_entities`

美洲开发银行制裁名册检索（违规族×跨除名标）

参数：

旗标	必填	说明
`--q`	否	全字段全文检索（册方原生的 q 参数）
`--filters`	否	按字段取值过滤，JSON 文本，字段→取值精确匹配（册方原生的 filters 参数），如 {"To": "Ongoing"} 或 {"Entity": "Firm"}
`--limit`	否	每次返回行数，1–100（默认 20）——册方是实时查询，这就是每页行数
`--offset`	否	首行之前跳过的行数（册方原生的 offset 参数）；结果里带册方给出的总行数
`--sort`	否	排序，如 "From desc"（册方原生的 sort 参数）

**注意：**活册 total 1,343（census 期 2,603 = 累计史口径勿混）；/dataset/download/<id>/csv 回的是数据集元数据非行数据——行数据走 datastore_search；Country / Prohibited Practice 列上游带前导空格，SDK 在映射层 strip 后给你。

$ legal idb_debarred_entities --q SHANDONG --limit 3

{
  "reason": "IDB sanctioned-firms register: 5 rows total, 3 returned (q \"SHANDONG\") — Entity=Firm rows are the company roster; Source carries cross-debarment markers (ADB/WBG cross debarment); page through offset",
  "result": {
    "rows": [
      { "_id": 43939, "Title": "Shandong Hualong Landscaping Engineering Co., Ltd.", "Entity": "Firm",
        "Nationality": "China", "Country": "China",
        "From": "2015-06-09 00:00:00.000000000", "To": "Ongoing",
        "Prohibited Practice": "Fraud", "Source": "WBG cross debarment", "rank": 0.0573 }
    ],
    "total": 5,
    "limit_applied": 3,
    "offset": 0
  },
  "evidence": [
    { "quote": "Shandong Hualong Landscaping Engineering Co., Ltd. (Firm, China) 2015-06-09→Ongoing · Fraud · WBG cross debarment",
      "url": "https://www.iadb.org/en/transparency/sanctioned-firms-and-individuals" }
  ],
  "source": { "provider": "idb", "execution": "local", "from_cache": false },
  "query": { "source": "raw", "upstream": { "resource_id": "cd0bd9ac-18c6-44bc-8592-9be468c2efd9", "limit": 3, "offset": 0, "include_total": "true", "q": "SHANDONG" } },
  "jurisdiction": "GLOBAL"
}

怎么读：本批除名线里唯一的服务端检索面——--q 全文、--filters JSON 精确（如 '{"To": "Ongoing"}'）、--offset 翻页、include_total 恒发（total 精确回显）。From 到达即纳秒文本（2015-06-09 00:00:00.000000000），照录。

`legal ie_revenue_defaulters`

爱尔兰税务违约人名册（法院判罚/Revenue 和解两表）

参数：

旗标	必填	说明
`--part`	否	名单部别：1 = 法院判罚（罪名/罚金/刑期/罪数），2 = Revenue 和解（五行金额+未缴）——两部是两张不同的表，结果里的 kind 回显本次行结构（默认 1）
`--year`	否	发布年（与 --month 成对给；不给=索引最新一季）
`--month`	否	季度名：march/june/september/december（与 --year 成对给）

**注意：**姓名地址是法定公示内容（Section 977 TCA 1997 季刊义务）——法定登记册照录口径，非泄漏数据；名单是「法院确认/超门槛和解」子集，不在册≠无税务问题；--year+--month 须成对给。

$ legal ie_revenue_defaulters --part 1

{
  "reason": "Irish Revenue defaulters june 2026 part 1: 55 rows — statutory quarterly publication, part 1 = court-determined penalties (fine + sentence + charges); quarters on the index: march 2026, june 2026",
  "result": {
    "quarter": "june 2026",
    "part": 1,
    "kind": "court_penalties",
    "count": 55,
    "rows": [
      { "issue_type": "PENALTIES DETERMINED BY A COURT RELATING TO THE NON-DECLARATION OR UNDER-DECLARATION OF TAX",
        "name": "COLLINS, FIONNUALA", "address": "39 THE CHANTRIES, BALBRIGGAN, CO. DUBLIN",
        "occupation": "NOT KNOWN", "sentence_imposed": null, "fine_amount": 24172, "charges": null },
      { "issue_type": "FAILURE TO LODGE INCOME TAX RETURN(S)",
        "name": "COSS, JOHN", "address": "PALLAS, PORTLAOISE, CO. LAOIS",
        "occupation": "HAIRDRESSER", "sentence_imposed": "6 MONTHS IMPRISONMENT", "fine_amount": 0, "charges": 1 }
    ],
    "available_quarters": ["march 2026", "june 2026"],
    "params": { "csv_path": "/en/corporate/press-office/list-of-defaulters/2026/defaulters-list-part-1-june-2026.csv" }
  },
  "evidence": [
    { "quote": "COLLINS, FIONNUALA (NOT KNOWN) · fine €24,172", "url": "https://www.revenue.ie/en/corporate/press-office/list-of-defaulters/index.aspx" }
  ],
  "source": { "provider": "ie_revenue", "execution": "server", "from_cache": false },
  "jurisdiction": "IE"
}

怎么读：****--part 选的是两张不同的表：part 1 = 法院判罚（罪名/罚金/刑期/罪数），part 2 = Revenue 和解（五行金额 + 未缴额），kind 回显本次行结构。罚金 0 是事实 0 非「无数据」；part 2 的 unpaid 空 = 已缴讫。不给年月=自动取索引上最新一季；索引只挂当年件，老年份在归档页、本面刻意不枚举。

`legal lda_filings`

美国游说申报检索（LDA）

参数：

旗标	必填	说明
`--client-name`	否	被游说企业名（包含匹配）
`--registrant-name`	否	游说机构名
`--filing-year`	否	申报年（1999 起）
`--page`	否	页码（上游每页固定最多 25 行）
`--ordering`	否	排序（默认 -dt_posted）
`--limit`	否	返回行数，1–25（更大值不报错、仍按 25 返回）

**注意：**中间商申报的 client 名含「OBO」（on behalf of）——按品牌名检索会漏子实体申报，须双名试查；--limit 上限 25（上游硬钳），更深翻页用 --page 逐页走。

$ legal lda_filings --client-name "Google" --limit 3

{
  "reason": "LDA 游说面：命中 1626 申报，返回 3 行（被游说企业「Google」）——income/expenses 只在季报型（RR/RA 注册型恒 null）；翻页用 page（每页上限 25，上游硬钳）",
  "result": {
    "rows": [
      { "filing_uuid": "81e6f7a8-2f6b-49c4-a04f-f39bff79adcc", "filing_type": "Q3", "filing_year": 2026,
        "income": "30000.00",
        "registrant": { "name": "JGB & ASSOCIATES, LLC", "state": "VA" },
        "client": { "client_id": 59919, "name": "CORNERSTONE GOVERNMENT AFFAIRS OBO GOOGLE CLIENT SERVICES LLC",
                    "state": "DC", "country": "US" },
        "issues": ["Labor Issues/Antitrust/Workplace", "Copyright/Patent/Trademark"] }
    ],
    "total": 1626,
    "limit_applied": 3
  },
  "evidence": [
    { "quote": "3rd Quarter (July 1 - Sep 30) CORNERSTONE GOVERNMENT AFFAIRS OBO GOOGLE CLIENT SERVICES LLC ← JGB & ASSOCIATES, LLC income=$30000.00",
      "url": "https://lda.gov/filings/public/filing/81e6f7a8-2f6b-49c4-a04f-f39bff79adcc/print/" }
  ],
  "source": { "provider": "lda", "execution": "local", "from_cache": true, "fetched_at": "2026-10-21T03:05:44.014Z" }
}

怎么读：--registrant-name 切视角、--filing-year 收窄申报年（1999 起）；income/expenses 只在季报型（Q1–Q4）。申报件直链 document_url。7 天 TTL。

`legal sipri_trades_search`

国际军贸转移检索（SIPRI）

参数：

旗标	必填	说明
`--filters`	否	原始过滤条件，JSON 文本（例 `\[{"field":"Recipient","listData":\[8\]}\]`；国别只认数字 id）
`--supplier`	否	供应国快捷通道：英文全名（如 United States；与 --filters 二选一，国名自动解析为数字 id）
`--recipient`	否	接收国快捷通道：英文全名（如 Angola；与 --filters 二选一，国名自动解析为数字 id）
`--type`	否	口径：delivered=交付量（TIV）/ orders=订单量
`--page`	否	页码
`--limit`	否	返回行数（上限 100）

**注意：**国名用英文全称（United States / Soviet Union）；零命中是合法答案不是故障（如 United States→Angola 历史上无大笔移交）——换供应国再试；行级 order_year_est/units_est 是 SIPRI 估计旗。--limit 上限 100。

$ legal sipri_trades_search --supplier "Soviet Union" --recipient "Angola" --limit 5

{
  "reason": "SIPRI 军贸（delivered）：供应商 Soviet Union × 受让 Angola 返回 5 行（型号级，Est 位=估计值；trades 是国别面非公司面——公司级宇宙在 Top-100 XLSX 批线件）",
  "result": {
    "rows": [
      { "trade_id": 1902, "supplier": "Soviet Union", "recipient": "Angola",
        "order_year": 1975, "order_year_est": true, "delivery_year": 1976,
        "units": 74, "units_est": true,
        "designation": "BTR-60PB", "description": "armoured personnel carrier", "category": "Armoured vehicles" },
      { "trade_id": 1903, "supplier": "Soviet Union", "recipient": "Angola",
        "order_year": 1977, "order_year_est": true, "delivery_year": 1978,
        "units": 200, "units_est": true,
        "designation": "BRDM-2", "description": "armoured reconnaissance vehicle", "category": "Armoured vehicles" }
    ],
    "limit_applied": 5,
    "resolved_countries": {
      "supplier": { "entity_id": 1150759, "name": "Soviet Union" },
      "recipient": { "entity_id": 1150549, "name": "Angola" }
    }
  },
  "evidence": [
    { "quote": "1976 Soviet Union → Angola：BTR-60PB ×74(est)",
      "url": "https://www.sipri.org/databases/armstransfers" }
  ],
  "source": { "provider": "sipri", "execution": "local", "from_cache": false, "observed_at": "2026-10-27T10:03:05.875Z" }
}

**怎么读：**国别视角，非公司视角（buyer/seller=国名）——定位是地缘风险信号；--type delivered/orders 切口径。resolved_countries 是国名解析到的上游实体号。30 天 TTL。

`legal us_occ_enforcements`

美国 OCC 月度执法公告（银行停止令/CMP+个人禁业令，docket 键）

参数：

旗标	必填	说明
`--year`	否	年份 2005–今年（逐年新闻发布列表页的范围；默认今年）
`--month`	否	月份全名 January–December——选该月的执法公告（不给 = 该年最新一份）
`--all`	否	走该年每一份执法公告（行上带各自的 release_nr）

**注意：**月份选择跨纪元：2026+ 标题自带 "for October 2026"，2020/2010 标题无月——回落到列表页日期列推断；点不存在的月报会列出该年各公告实际对应的月。年份下限 2005（逐年列表页实证范围）；1989+ 的存量在 EASearch 数据库，SDK 刻意不碰（docket 号是官方 join 键）。发布件不可变（TTL 30d），逐年列表页月增（TTL 12h）。行数随月份公告规模浮动（2026-10 是 4 行小月；2020-02 表式 20 行）。

$ legal us_occ_enforcements --year 2026 --month October

{
  "reason": "OCC 2026 enforcement actions: 4 rows from 1 release(s) (NR 2026-93), form=sentences — docket No. AA-ENF-* is the official key (joins the EASearch database, 1989+, out of SDK scope); cmp_amount is scaled from the \"$750 million\" wording; IAP = institution-affiliated party (individual prohibition orders — names published by statute, the co_sic precedent)",
  "result": {
    "year": 2026,
    "form": "sentences",
    "count": 4,
    "rows": [
      { "kind": "bank", "multi": false, "action_types": "Cease and Desist Order and Civil Money Penalty",
        "name": "American Express National Bank", "city": "Sandy", "state": "Utah",
        "violations": "deficiencies in the bank’s Bank Secrecy Act compliance program, failure to timely file suspicious activity reports, …",
        "action_docs": ["https://www.occ.gov/static/enforcement-actions/eaAA-ENF-2026-46.pdf",
                        "https://www.occ.gov/static/enforcement-actions/eaAA-ENF-2026-47.pdf"],
        "cmp_amount": 350000000, "related_release": "2026-87", "dockets": ["AA-ENF-2026-46", "AA-ENF-2026-47"],
        "release_nr": "NR 2026-93", "release_title": "OCC Announces Enforcement Actions for October 2026" },
      { "kind": "bank", "multi": false, "action_types": "Civil Money Penalty",
        "name": "Bank of America, National Association", "city": "Charlotte", "state": "North Carolina",
        "action_docs": ["https://www.occ.gov/static/enforcement-actions/eaAA-ENF-2026-41.pdf"],
        "cmp_amount": 750000000, "dockets": ["AA-ENF-2026-41"], "release_nr": "NR 2026-93", "…": "…" },
      { "kind": "iap", "action_types": "Order of Prohibition", "name": "Jennifer Hamblin",
        "role": "Vault Teller at a Cincinnati, Ohio, branch of Fifth Third Bank, N.A., Cincinnati, Ohio",
        "reason": "embezzling customer funds. The Bank suffered a loss of approximately $292,000",
        "city": "Cincinnati", "state": "Ohio", "cmp_amount": null,
        "dockets": ["AA-ENF-2026-43"], "release_nr": "NR 2026-93", "…": "…" }
    ],
    "releases_in_year": [
      { "nr": "NR 2026-3", "title": "OCC Announces Enforcement Actions for January 2026", "date": "01/15/2026", "path": "/news-issuances/news-releases/2026/nr-occ-2026-3.html" },
      "… 8 more …",
      { "nr": "NR 2026-93", "title": "OCC Announces Enforcement Actions for October 2026", "date": "10/22/2026", "path": "/news-issuances/news-releases/2026/nr-occ-2026-93.html" }
    ],
    "selected": [{ "nr": "NR 2026-93", "title": "OCC Announces Enforcement Actions for October 2026", "path": "/news-issuances/news-releases/2026/nr-occ-2026-93.html" }],
    "params": { "year": 2026, "month": "October", "release_path": ["/news-issuances/news-releases/2026/nr-occ-2026-93.html"] }
  },
  "evidence": [
    { "quote": "American Express National Bank (Sandy, Utah) · CMP $350,000,000 · dockets AA-ENF-2026-46/AA-ENF-2026-47 · NR 2026-93",
      "url": "https://www.occ.gov/news-issuances/news-releases/2026/nr-occ-2026-93.html" },
    { "quote": "Bank of America, National Association (Charlotte, North Carolina) · CMP $750,000,000 · dockets AA-ENF-2026-41 · NR 2026-93",
      "url": "https://www.occ.gov/news-issuances/news-releases/2026/nr-occ-2026-93.html" }
  ],
  "source": { "provider": "occ", "execution": "local", "from_cache": false, "observed_at": "2026-11-03T07:38:02.471Z" },
  "jurisdiction": "US"
}

怎么读：****kind 三形：bank（句式银行行动，action_types×机构×州×违规事由×cmp_amount×dockets×action_docs 处罚书 PDF）、iap（个人禁业令：name/role/reason——法定公示口径，co_sic 先例）、order（≤2020 表式行：ea_no/who/state/date/order_type，who 单元格里名+行+市挤一格、按最后一个逗号切开）。cmp_amount 从 "million/billion" 措辞缩放（"$750 million"→750000000）。多实体变体（「against three subsidiary banks of X : B1 ; B2 ; and B3」共担一段违规）按银行爆炸成多行，holder/holder_city/holder_state 三字段挂母体，缩写 docket（"55, 56, and 57"）照录。不给 --month = 该年最新一份执法公告；--all 走全年每一份。

`legal wb_debarred_firms`

世界银行除名厂商名册（SUPP_ID 与授标流同键）

参数：

旗标	必填	说明
`--name`	否	供应商名称——匹配名称的任何一部分，不分大小写
`--country`	否	国家——匹配国名的任何一部分，或两字母国码精确匹配（China 与 CN 同中）
`--type`	否	供应商类型：F 企业、I 个人、U 未注明、C 集团（精确匹配，不分大小写）
`--limit`	否	返回行数，1–100（默认 20）。整册在本地筛查，结果里的 total_matched 是确切命中数

**注意：**册内 DNB/REGISTER 标识字段全空——join 只能走 name×country；行数随活册再生成漂移（admission 1,546→验收 1,540）；Cross Debarment: AfDB 与 afdb 面同名行互证（两册 To 同为 2027-10-23）。访问用的 apikey 是页面内嵌浏览器公开常量，非注册凭证。

$ legal wb_debarred_firms --name "CHINA RAILWAY" --country CN --limit 3

{
  "reason": "World Bank debarred-firms register: 1 of 1540 rows matched (name contains \"CHINA RAILWAY\", country contains \"CN\") — DEBAR_REASON cites the procurement-guidelines clause; DEBAR_TO_DATE 2999-12-31 = indefinite; zero hits = not on the WB register",
  "result": {
    "rows": [
      { "SUPP_ID": 1136471, "SUPP_NAME": "CHINA RAILWAY 20TH BUREAU GROUP CORPORATION LTD", "SUPP_TYPE_CODE": "F",
        "LAND1": "CN", "COUNTRY_NAME": "China",
        "SUPP_ELIG_STAT": "X-DEBARRED", "DEBAR_FROM_DATE": "2026-10-16", "DEBAR_TO_DATE": "2027-10-23",
        "DEBAR_REASON": "Cross Debarment: AfDB", "INELIGIBLY_STATUS": "Ongoing" }
    ],
    "total_matched": 1,
    "scanned_rows": 1540,
    "limit_applied": 3,
    "params": { "name": "CHINA RAILWAY", "country": "CN", "type": null }
  },
  "evidence": [
    { "quote": "CHINA RAILWAY 20TH BUREAU GROUP CORPORATION LTD (China) 2026-10-16→2027-10-23 · Cross Debarment: AfDB",
      "url": "https://www.worldbank.org/en/projects-operations/procurement/debarred-firms" }
  ],
  "source": { "provider": "wb", "execution": "local", "from_cache": false },
  "jurisdiction": "GLOBAL"
}

怎么读：--country 双通道：名称子串或 LAND1 码精确（China/CN 同中）。DEBAR_TO_DATE 2999-12-31 = 无限期哨兵照录。SUPP_ID 是世行供方号——与 wb_procnotices 授标流的 awarded_firms[].supp_id 同键，中标×除名交叉对照就在这两面之间。

使用边界

命中是线索，不是结论：任何命中都应按结果中的官方 URL 复核后，再写入尽调结论。

法律数据#

命令一览#

实时查询#

legal afdb_debarred_entities#

legal ca_sema_sanctions#

legal co_sic_sanctions#

legal courtlistener_opinions_search#

legal csl_screening_list#

legal dgcomp_cases_search#

legal ecfr_search#

legal ecfr_titles#

legal federalregister_documents#

legal gb_cma_case#

legal gb_cma_cases#

legal gb_ec_donations#

legal gb_ec_loans#

legal gb_gazette_notices#

legal gb_tna_caselaw_judgment#

legal gb_tna_caselaw_search#

legal idb_debarred_entities#

legal ie_revenue_defaulters#

legal lda_filings#

legal sipri_trades_search#

legal us_occ_enforcements#

legal wb_debarred_firms#

使用边界#