简体中文

ESG 数据

环境、设施与采掘业披露的实时查询，五块：排放（Climate TRACE 设施级温室气体源——谁名下的设施、在哪国、排了多少 tCO2e；THETIS-MRV 欧盟船舶排放申报件目录）、支付（EITI 采掘业支付逐笔归类到 IMF GFS 收入编码——谁在哪儿、向谁、交了多少）、设施与碳登记底账（EPA FRS 设施主档——ECHO/TRI/GHGRP 汇流的权威设施键；EU 碳登记库 EUTL 官方批量下载目录）、港口国监督（Paris MoU 当前滞留、禁令名单、低表现 ISM 公司与历史检查流——船×管理公司官方边直出）、航空安全（EU 航空安全禁飞名单官方下载目录——被禁/受限第三国承运人，机读 XLSX 主件+24 语言 PDF，文件本体走批线）。全部命令在你的机器上本地执行、无需任何凭证：平台侧不设配额，按各上游规则限流；重复查询在缓存有效期内由本机缓存直接应答。

命令一览

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

命令	辖域	回答什么
`esg climatetrace_owners`	GLOBAL	排放主体检索（Climate TRACE）
`esg climatetrace_sources`	GLOBAL	设施级温室气体排放（Climate TRACE）
`esg eiti_companies`	GLOBAL	采掘业申报主体检索（EITI）
`esg eiti_payments`	GLOBAL	采掘业对政府支付逐笔（EITI）
`esg epa_frs_facilities`	US	EPA 设施主档查询（FRS）
`esg euasl_datasets`	EU	EU 航空安全禁飞名单官方下载目录
`esg eutl_datasets`	EU	EU 碳登记库官方批量下载目录（EUTL）
`esg paris_mou_bans`	GLOBAL	Paris MoU 禁令船名单（内嵌管理公司）
`esg paris_mou_detentions`	GLOBAL	Paris MoU 当前滞留船快照
`esg paris_mou_inspections`	GLOBAL	Paris MoU 历史检查流窗检索
`esg paris_mou_low_performance_companies`	GLOBAL	Paris MoU 低表现 ISM 公司名单
`esg thetis_mrv_datasets`	EU	EU 船舶排放申报批量件目录（THETIS-MRV）

实时查询

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

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

`esg climatetrace_owners`

排放主体检索（Climate TRACE）

参数：

旗标	必填	说明
`--name`	是	企业主体名（先拿 id，再配 climatetrace_sources 查设施级排放）
`--limit`	否	返回行数（上限 50）
`--offset`	否	跳过行数（排序不稳定——尽量一次取够）

**注意：**候选非权威归一；上游排序跨 limit 不稳定（实测），需要更多就一次大页取足、勿细翻页；--limit 礼貌档 50（上游实测可到 1,000）。

$ esg climatetrace_owners --name "Equinor" --limit 3

{
  "reason": "Climate TRACE 主体检索：3 候选，首选 Equinor ASA（E100000000766）——候选非权威归一，行面以 owner_ids 为准；排序跨 limit 不稳定（2026-10-23 实测），翻页建议一次取足",
  "result": {
    "candidates": [
      { "trace_owner_id": "E100000000766", "owner_name": "Equinor ASA" },
      { "trace_owner_id": "E100001014692", "owner_name": "Equinor Energy AS" },
      { "trace_owner_id": "E100002013955", "owner_name": "Equinor Brasil Energia Ltda" }
    ],
    "limit_applied": 3
  },
  "evidence": [
    { "quote": "E100000000766 = Equinor ASA",
      "url": "https://api.climatetrace.org/v7/owners?name=Equinor&limit=3" }
  ]
}

怎么读：trace_owner_id（E 前缀）是行面权威锚——先在这里落 id，再去排放面逐源查；集团姊妹实体并列在候选里（Equinor ASA / Energy AS / Brasil），挑对主体再往下走。零命中=该名不在主体库，换别名再试。

`esg climatetrace_sources`

设施级温室气体排放（Climate TRACE）

参数：

旗标	必填	说明
`--owner-ids`	否	企业 id（E 系，如 E100000000766；逗号分隔多个=并集）
`--owner-name`	否	企业名快捷通道：先解出首个候选企业（与 --owner-ids 二选一；要精确定向用后者）
`--year`	否	排放年份（默认当年；数据窗 2021 起）
`--gas`	否	温室气体口径（默认 co2e_100yr = tCO2e）
`--limit`	否	返回行数（上限 500）
`--offset`	否	跳过行数（排序不稳定——尽量一次取够）
`--sectors`	否	部门过滤，闭集：agriculture / buildings / fluorinated-gases / forestry-and-land-use / fossil-fuel-operations / manufacturing / mineral-extraction / power / transportation / waste，另有特殊值 all_no_forest（写错值上游静默回整库，本地已拦）
`--subsectors`	否	子部门 slug，上游 68 值（全表在 GET /v7/definitions/subsectors；写错值上游 400 自报）
`--gadm-id`	否	GADM 区域 id（地点族四参——gadm-id / city-id / country-group / continent 上游一次只许传一个，多传 400）
`--city-id`	否	都市圈 id（地点族四参，一次只许传一个）
`--country-group`	否	国家组 slug（如 eu / aosis / g20；地点族四参，一次只许传一个）
`--continent`	否	大洲名（如 Europe——上游口径 RUS 计入 Europe；地点族四参，一次只许传一个）

**注意：**窗口外年份上游返回 null（不是错误）；--owner-name 便捷旗标只解析首个候选——集团多主体先在 climatetrace_owners 面落 id 再用 --owner-ids。

$ esg climatetrace_sources --owner-ids E100000000766 --year 2024 --limit 4

{
  "reason": "Climate TRACE 排放面：4 源 2024 年合计 61,428,114.37 tCO2e（AGO/BRA；gas=co2e_100yr 口径）",
  "result": {
    "rows": [
      { "source_id": 53058598, "name": "Brazil_Santos_Deepwater",
        "sector": "fossil-fuel-operations", "subsector": "oil-and-gas-production",
        "source_type": "point-source", "country": "BRA", "year": 2024, "gas": "co2e_100yr",
        "emissions_tco2e": 27621187.35,
        "location": { "lat": -25.000647, "lon": -42.82633 } },
      { "source_id": 53058477, "name": "Angola_Lower Congo_Deepwater",
        "sector": "fossil-fuel-operations", "subsector": "oil-and-gas-production",
        "source_type": "point-source", "country": "AGO", "year": 2024, "gas": "co2e_100yr",
        "emissions_tco2e": 17305183.49,
        "location": { "lat": -0.6662651, "lon": 8.133333 } }
    ],
    "total_rows": 4, "limit_applied": 4
  },
  "evidence": [
    { "quote": "Equinor ASA 2024 = 61,428,114.37 tCO2e (co2e_100yr)",
      "url": "https://api.climatetrace.org/v7/sources?ownerIds=E100000000766&year=2024" }
  ]
}

怎么读：reason 直接给本页合计（例：4 源 2024 年 6,142 万 tCO2e）——跨设施加总就用它，别自己逐行累加不同 gas。--owner-ids 支持逗号并集（去重）；--year 数据窗 2021 起；--gas 默认 co2e_100yr（tCO2e），换成具体气体后行键切到 emissions_quantity 原生单位。

`esg eiti_companies`

采掘业申报主体检索（EITI）

参数：

旗标	必填	说明
`--company-name__like`	否	公司名，SQL LIKE 匹配（`%` / `_` 通配符原样透传）
`--name`	否	公司名快捷通道：自动按 `%名%` 包含匹配（与 --company-name__like 二选一；要自管通配符用后者）
`--size`	否	返回行数（上限 1000）

**注意：**候选非权威归一（like 匹配，ASCII 大小写不敏感；名字里的 % 与 _ 是 LIKE 元字符，原样生效）；同名多主体落库前以 UUID / estma_id 收窄——estma_id 是 ESTMA（加拿大透明度法）申报号，申报方含外资在加经营企业，非「仅加拿大企业」；hq_country 大多为 null（上游该列填充率仅 62/10,201）。

$ esg eiti_companies --name "Equinor" --size 3

{
  "reason": "EITI 名称检索：本页 3 候选 / 上游共 22 个匹配，首选 Equinor Angola Block 31 AS （—，申报 ?–?）——候选非权威归一",
  "result": {
    "candidates": [
      { "eiti_id_company": "eiti_id_company:01800525-17dc-5854-aaab-3e1b719d2f52", "company_name": "Equinor Angola Block 31 AS ",
        "hq_country": null, "sectors": null, "countries_of_operation": null, "estma_id": null },
      { "eiti_id_company": "eiti_id_company:1441eb64-c451-5d4b-b939-f1a3e887b2de", "company_name": "Equinor",
        "hq_country": "Norway", "sectors": "Oil & Gas", "countries_of_operation": "Iraq, Nigeria",
        "estma_id": "E042948", "first_year_reported": 2016, "last_year_reported": 2019 }
    ],
    "limit_applied": 3,
    "total_matches": 22,
    "total_matches_capped": false
  },
  "evidence": [
    { "quote": "Equinor Angola Block 31 AS （—，—）",
      "url": "https://eiti-database.eiti.org/eiti_database/view_companies.json" }
  ],
  "source": { "provider": "eiti", "execution": "local", "from_cache": false, "observed_at": "2026-10-27T10:02:51.170Z" }
}

**怎么读：**姊妹实体就在候选列表里现形（Angola Block 31、上游 México 一并列出）；eiti_id_company UUID 是权威锚。total_matches 是符合条件的全部匹配数（超过一万时显示为 >10000）。7 天 TTL。

`esg eiti_payments`

采掘业对政府支付逐笔（EITI）

参数：

旗标	必填	说明
`--eiti-id-company__exact`	否	EITI 企业 id，全值精确匹配（含 `eiti_id_company:` 前缀）
`--eiti-id`	否	裸 UUID 快捷通道：自动补 `eiti_id_company:` 前缀（与 --eiti-id-company__exact 二选一）
`--company-name__like`	否	公司名，SQL LIKE 匹配（`%` / `_` 通配符原样透传）
`--name`	否	公司名快捷通道：自动按 `%名%` 包含匹配（与 --company-name__like 二选一；要自管通配符用后者）
`--size`	否	返回行数（上限 1000）

注意：eiti_id_company UUID 权威锚优先；库里无本地注册号（estma_id 是 ESTMA 申报号、仅部分申报方带）——不能拿它 join 公司注册库。total_rows 是全部匹配行数（超过一万时显示为 >10000）。

$ esg eiti_payments --name "Equinor" --size 3

{
  "reason": "EITI 支付面：本页 3 行 / 上游共 358 行（TZA；USD ~$279,962 为本页小计非全量，GFS 分类口径跨批可比）",
  "result": {
    "rows": [
      { "eiti_id_company": "eiti_id_company:4053644f-f074-5a3f-af9a-a5e7b024476b",
        "company_name": "EQUINOR TANZANIA AS", "year": 2017, "country_iso3": "TZA",
        "gov_entity": "Tanzania Revenue Authority", "revenue_stream": "Corporation tax",
        "gfs_code": "1112E1", "gfs_name": "Ordinary taxes on income, profits and capital gains",
        "payment_value": 0.0, "payment_value_usd": 0.0, "payment_in_kind": 0 },
      { "eiti_id_company": "eiti_id_company:4053644f-f074-5a3f-af9a-a5e7b024476b",
        "company_name": "EQUINOR TANZANIA AS", "year": 2017, "country_iso3": "TZA",
        "gov_entity": "Tanzania Revenue Authority", "revenue_stream": "Skills and Development Levy",
        "gfs_code": "112E", "gfs_name": "Taxes on payroll and workforce",
        "payment_value": 618888695.77, "payment_value_usd": 279961.59257131483, "payment_in_kind": 0 }
    ],
    "count": 3,
    "limit_applied": 3,
    "total_rows": 358,
    "total_rows_capped": false
  },
  "evidence": [
    { "quote": "EQUINOR TANZANIA AS 2017 → Tanzania Revenue Authority：Skills and Development Levy ($279961.59257131483)",
      "url": "https://eiti-database.eiti.org/eiti_database/view_payments_detailed" }
  ],
  "source": { "provider": "eiti", "execution": "local", "from_cache": true, "fetched_at": "2026-10-21T09:03:30.911Z" }
}

怎么读：payment_value 是本币原值、payment_value_usd 是折算值——USD 折算口径跨批不一，跨国比较走 GFS 码分组，不跨批较绝对值。reason 里的 USD 是本页小计非全量，要看更多放大 --size（单次最多 1,000 行）；名称匹配命中多实体时，先在 eiti_companies 面落 UUID 再用 --eiti-id 精确查。7 天 TTL。

`esg epa_frs_facilities`

EPA 设施主档查询（FRS）

参数：

旗标	必填	说明
`--registry-id`	否	FRS Registry ID——设施权威键（ECHO/TRI/GHGRP 汇流锚）
`--primary-name`	否	设施主名称——精确匹配（含空格；上游 contains/~ 算子静默回 0，模糊检索走 ECHO 面）
`--state-code`	否	州代码，两字母（小写自动转大写，如 DE）
`--city-name`	否	城市名（精确匹配；七过滤可并用=AND，至少给一个）
`--country-name`	否	国家名（精确大写形，小写自动转大写——GERMANY=110 行实测，解锁非美设施切片）
`--site-type-name`	否	设施类型（精确大写，如 STATIONARY=4,725,914 行实测）
`--epa-region-code`	否	EPA 区域（零填充两位串形 '03'；region 10=214,197 行实测）
`--start`	否	分页偏移（上游 ROWS 闭区间左端；右端由 size 本地恒算）
`--size`	否	返回行数（默认 50，礼貌档 500）

**注意：**七个过滤列（registry_id/primary_name/state_code/city_name/country_name/site_type_name/epa_region_code，后三列 0.3.20 审计新增）上游口径全为精确 = 匹配（含空格整串）、可 AND 并用、至少给一个——裸全表（约 560 万行）被礼貌墙挡下；country_name 解锁非美设施切片（FRS 非纯美库：GERMANY=110 行、UNITED STATES=3,129,491 行实测）；设施名模糊检索不在此面（上游 contains/~ 算子静默回 0 行）——先在 ECHO 面落 registry_id 再来点查。

$ esg epa_frs_facilities --registry-id 110050002260

{
  "reason": "FRS 设施主档：本页 1 行 / 全库匹配 1，首选 7-ELEVEN COVENTRY-TREATMENT PLANT（110050002260，2000 CRAWFORD PL, MOUNT LAUREL, NJ  08054 US）——registry_id 为 ECHO/TRI/GHGRP 汇流权威键",
  "result": {
    "rows": [
      { "registry_id": "110050002260", "primary_name": "7-ELEVEN COVENTRY-TREATMENT PLANT", "std_name": "7 11 COVENTRY TRTMNT PLT",
        "location_address": "2000 CRAWFORD PLACE", "city_name": "MT. LAUREL", "county_name": "TOLLAND", "state_code": "NJ",
        "state_name": "CONNECTICUT", "postal_code": "08054", "country_name": "US",
        "std_full_address": "2000 CRAWFORD PL, MOUNT LAUREL, NJ  08054 US", "site_type_name": "STATIONARY",
        "interest_status_code": null, "operating_status": null, "epa_region_code": "02",
        "parent_registry_id": null, "fips_code": null, "create_date": null }
    ],
    "count": 1
  },
  "evidence": [
    { "quote": "110050002260 = 7-ELEVEN COVENTRY-TREATMENT PLANT（2000 CRAWFORD PL, MOUNT LAUREL, NJ  08054 US）",
      "url": "https://data.epa.gov/efservice/frs_facility_site" }
  ],
  "source": { "provider": "epa_frs", "execution": "local", "from_cache": false, "observed_at": "2026-10-29T11:26:19.359Z" }
}

怎么读：registry_id 是 EPA 设施权威键——ECHO（执法/合规）、TRI、GHGRP 各面的设施行都拿它回这里对设施主档；地址认 std_full_address（标准化形）；operating_status 等列为 null 常见（上游该行未填）。本例 state_name=CONNECTICUT 与新泽西地址相互矛盾——上游辅助列（state_name/county_name）填充质量不稳，别拿它们做二次校验。

`esg euasl_datasets`

EU 航空安全禁飞名单官方下载目录

**注意：**零参数目录面——一次调用返回全部 25 件，无过滤无分页；文档 UUID 是发布时内容 id 而非稳定键，每次再公布即轮换（链接形 /document/download/<uuid>_<lang>?filename=…），对账以此清单为准、勿猜文件名；XLSX/PDF 本体不经此面下载（批线管线取）。

$ esg euasl_datasets

{
  "reason": "EU 航空安全禁飞名单官方下载目录：25 件跨 24 种官方语言——机读 XLSX 主件（附件 A=运营禁令承运人、附件 B=限制条件运营）排第一，其余为各语言 PDF rendition；文档 UUID 随每次再公布轮换——收割按本清单对账勿猜文件名；文件本体走批线",
  "result": {
    "rows": [
      { "document_id": "67b75752-d144-4366-9f4a-c04157840211", "language": "en", "file_name": "air-safety-list.xlsx", "format": "xlsx", "download_path": "/document/download/67b75752-d144-4366-9f4a-c04157840211_en?filename=air-safety-list.xlsx" },
      { "document_id": "3195fabb-7575-4db9-85b9-ec5a77b481aa", "language": "bg", "file_name": "air-safety-list_bg.pdf", "format": "pdf", "download_path": "/document/download/3195fabb-7575-4db9-85b9-ec5a77b481aa_bg?filename=air-safety-list_bg.pdf" },
      { "document_id": "3195fabb-7575-4db9-85b9-ec5a77b481aa", "language": "cs", "file_name": "air-safety-list_cs.pdf", "format": "pdf", "download_path": "/document/download/3195fabb-7575-4db9-85b9-ec5a77b481aa_cs?filename=air-safety-list_cs.pdf" }
    ],
    "count": 25,
    "master": { "file_name": "air-safety-list.xlsx", "download_path": "/document/download/67b75752-d144-4366-9f4a-c04157840211_en?filename=air-safety-list.xlsx" }
  },
  "evidence": [
    { "quote": "air-safety-list.xlsx (xlsx, en)：/document/download/67b75752-d144-4366-9f4a-c04157840211_en?filename=air-safety-list.xlsx",
      "url": "https://transport.ec.europa.eu/transport-themes/eu-air-safety-list_en" }
  ],
  "source": { "provider": "euasl", "execution": "local", "from_cache": false, "observed_at": "2026-11-02T07:44:03.071Z" }
}

怎么读：master 直接给机读 XLSX 行（与首行同值）；其余 24 行是官方语言 PDF rendition（language=ISO-639-1 码；hr 版文件名带 _2 后缀、语言 token 仍是路径段）；download_path 是站内径——拼 transport.ec.europa.eu 主机即文件直链。名单本体：附件 A=被运营禁令覆盖的第三国承运人（~188 家）、附件 B=限制条件下运营（AIR KORYO / IRAN AIR）。

`esg eutl_datasets`

EU 碳登记库官方批量下载目录（EUTL）

**注意：**零参数目录面——一次调用返回全部 15 件，无过滤无分页；本面只给官方 URL 坐标，csv.gz/xlsx 文件本体不经此面下载；climate.ec.europa.eu 年度件的 URL 带文档 UUID，上游换版即变。

$ esg eutl_datasets

{
  "reason": "EUTL 官方批量下载目录：15 件——4 件 Azure 日更提取（账册/运营方/持仓 csv.gz）+ 10 件欧盟委员会年度件（合规/核实排放 2021-2025）+ 1 件交易册——下载坐标面，文件本体走批线",
  "result": {
    "rows": [
      { "name": "Accounts Daily", "url": "https://dlsclimabi.blob.core.windows.net/public-data/eutlpublic_prod/extracts/_all_extracts/account/accounts_daily.csv.gz", "cadence": "daily", "group_index": 0, "pane_index": 0, "sort_index": 0, "action": "d_accounts_dayli" },
      { "name": "Transactions", "url": "https://climate.ec.europa.eu/document/download/6be60240-c5ec-4389-a78a-b5a16d6b9849_en?filename=transactions_eutl_2026.zip", "cadence": "static", "group_index": 0, "pane_index": 0, "sort_index": 3, "action": "d_transactions" },
      { "name": "Compliance 2025", "url": "https://climate.ec.europa.eu/document/download/f7de3320-ca3d-43d1-afd4-bf0b5d3d355f_en?filename=compliance_2025_code_en.xlsx", "cadence": "yearly", "group_index": 0, "pane_index": 1, "sort_index": 0, "action": "d_compliance_" }
    ],
    "count": 15
  },
  "evidence": [
    { "quote": "Accounts Daily（daily）：https://dlsclimabi.blob.core.windows.net/public-data/eutlpublic_prod/extracts/_all_extracts/account/accounts_daily.csv.gz",
      "url": "https://union-registry-data.ec.europa.eu/api/data-download" }
  ],
  "source": { "provider": "eutl", "execution": "local", "from_cache": true, "fetched_at": "2026-10-29T03:30:55.380Z" }
}

怎么读：cadence 三档：daily=Azure 日更提取（账册/运营方/持仓 csv.gz，主机 dlsclimabi…）、yearly=欧盟委员会年度件（合规/核实排放 2021–2025，主机 climate.ec.europa.eu）、static=交易册；url 就是官方直链——本面的产出即这批下载坐标，文件本体走批线管线取。

`esg paris_mou_bans`

Paris MoU 禁令船名单（内嵌管理公司）

**注意：**486 行中 310 行带管理公司键——其余行公司列为 null（上游未挂），勿假设每行都有公司边；名单当日滚动；本面是禁令名单，单次滞留事件在 paris_mou_inspections 流里。

$ esg paris_mou_bans

{
  "reason": "Paris MoU 禁令名单：486 行，其中 310 行带 ISM 管理公司 IMO 号（如 SELAM / IMO 9418286 → Unimarin Denizcilik / 公司 IMO 5322090，10/09/2026 禁令）——船×管理公司官方边直出，公司键可比对航运公司档",
  "result": {
    "rows": [
      { "id": 7489690651, "imo_number": "9418286", "ship_name": "SELAM", "flag_code": "KN", "flag_name": "Saint Kitts and Nevis", "ban_date": "10/09/2026", "ban_occurrence": "First", "ban_order_status": { "type": "VALIDATED", "description": "Validated", "effectDate": null, "expiryDate": null, "active": true, "id": "VALIDATED" }, "ban_reason": { "type": "MULTIPLE_OF_DETENTIONS", "description": "Multiple detentions", "effectDate": null, "expiryDate": null, "multipleDetentionsReason": true, "active": true, "id": "MULTIPLE_OF_DETENTIONS" }, "minimum_duration": { "name": "THREE_MONTHS", "message": "Three months " }, "banning_authority": "Italy", "company_imo_number": "5322090", "company_name": "Unimarin Denizcilik", "company_address": null, "company_city": null, "company_country_code": "TR", "company_country_name": "Turkiye" }
    ],
    "count": 486
  },
  "evidence": [
    { "quote": "SELAM（IMO 9418286，KN）：10/09/2026 First禁令（Italy）→ Unimarin Denizcilik（公司 IMO 5322090）",
      "url": "https://portal.emsa.europa.eu/o/portlet-public/rest/ban/getBanShips.json" }
  ],
  "source": { "provider": "paris_mou", "execution": "local", "from_cache": true, "fetched_at": "2026-10-30T01:22:57.677Z" }
}

怎么读：一行=一船禁令，且内嵌 ISM 管理公司四元组（company_imo_number / company_name / 国别）——船×管理公司的官方边直出，公司 IMO 键可直接比对航运公司档；ban_order_status / ban_reason / minimum_duration 是结构化枚举（VALIDATED / MULTIPLE_OF_DETENTIONS / THREE_MONTHS），ban_occurrence（First/Second/…）标累犯层级。

`esg paris_mou_detentions`

Paris MoU 当前滞留船快照

**注意：**现行态快照当日滚动——今日 52 船明日即变（新滞留进、解除出），非历史账；范围限 Paris MoU 成员当局的港口；要滞留历史走 paris_mou_inspections 窗口检索。

$ esg paris_mou_detentions

{
  "reason": "Paris MoU 当前滞留：52 船在滞（如 SANTOS TRADER / IMO 9404431，29/10/2026 滞留于 DE Brake）——现行态快照当日滚动；船 IMO 号=资产键",
  "result": {
    "rows": [
      { "id": 7589901219, "imo_number": "9404431", "ship_name": "SANTOS TRADER", "ship_type": "Bulk carrier", "flag_code": "MH", "flag_name": "Marshall Islands", "detention_date": "29/10/2026", "detention_port": "Brake", "detention_country_code": "DE", "reporting_authority": "Germany" },
      { "id": 7592889849, "imo_number": "1111959", "ship_name": "JIN FOISON", "ship_type": "Bulk carrier", "flag_code": "SG", "flag_name": "Singapore", "detention_date": "29/10/2026", "detention_port": "Gdynia", "detention_country_code": "PL", "reporting_authority": "Poland" }
    ],
    "count": 52
  },
  "evidence": [
    { "quote": "SANTOS TRADER（IMO 9404431，MH，Bulk carrier）：29/10/2026 滞留于 DE Brake",
      "url": "https://portal.emsa.europa.eu/o/portlet-public/rest/detention/getCurrentDetentions.json" }
  ],
  "source": { "provider": "paris_mou", "execution": "local", "from_cache": true, "fetched_at": "2026-10-30T03:08:16.277Z" }
}

**怎么读：**一行=一船当前在滞：船 IMO 号（资产键）+ 船型 + 船旗 + 滞留日期/港口/主管当局——本日 52 行就是当前全球在滞全量；船 IMO 号拿去船舶档案/公司面比对资产。

`esg paris_mou_inspections`

Paris MoU 历史检查流窗检索

参数：

旗标	必填	说明
`--period-min`	是	窗起 dd/mm/yyyy（上游参 periodMin；日/月/年严格序——写错序上游静默回 0 行；必填）
`--period-max`	是	窗止 dd/mm/yyyy（上游参 periodMax；窗≤3 年本地墙——超窗上游静默空回；必填）
`--psc-inspection-regime`	否	检查制度（上游参 pscInspectionRegime；1=PSC 默认制度，唯一活值——0→200 毒空/2→HTTP 500，非 1 本地墙拒附证据）
`--page`	否	页码（上游参 page；翻页开关——本面恒发，不带则上游无视 limit 整窗倾倒）
`--start`	否	页内行偏移（上游参 start；page+start+limit=start 偏移翻页，page1/page2 实测零重叠）
`--limit`	否	返回行数（默认 50，礼貌档 500；上游 1000 全量兑现）
`--ism-company-name`	否	ISM 管理公司名过滤（上游参 ismCompanyName）
`--ism-company-imo-number`	否	ISM 公司 IMO 号过滤，7 位零填充（上游参 ismCompanyImoNumber，如 0052193；零填充/非填充两形上游均收，透传不规范化）

注意：--period-min / --period-max 必填且严格 dd/mm/yyyy 日序——错序静默回 0 行，窗最长 3 年（本地墙）；--psc-inspection-regime 1 是唯一活值——0 上游回 200 毒空、2 回 HTTP 500，非 1 本地墙拒附证据（0.3.20 审计实测）；翻页走 --page（本面恒发）或 --start，--limit 默认 50、礼貌档 500（上游 1000 全量兑现）。

$ esg paris_mou_inspections --period-min 01/01/2026 --period-max 01/10/2026 --psc-inspection-regime 1

{
  "reason": "Paris MoU 历史检查流：窗 01/01/2026–01/10/2026 本页 50 行 / 全窗 13,181——窗统计：13181 检/12175 船/517 滞留/1900 ISM 缺陷；首行 AAL DAMMAM（IMO 9963554）01/10/2026 @Canada Trois Rivieres 3 缺陷——id 键可逐检深查（getInspectionDetail）",
  "result": {
    "rows": [
      { "id": 7540826008, "imo_number": "9963554", "ship_name": "AAL DAMMAM", "ship_type": "General cargo/multipurpose", "flag_code": "PT", "flag_name": "Portugal", "age": 2, "inspection_date": "01/10/2026", "inspection_type": "Initial inspection", "member_state": "Canada", "port_name": "Trois Rivieres", "port_and_ms": "Canada - Trois Rivieres", "ndeficiencies": 3, "results_desc": "" },
      { "id": 7531600985, "imo_number": "8317978", "ship_name": "AB MOLY", "ship_type": "General cargo/multipurpose", "flag_code": "SL", "flag_name": "Sierra Leone", "age": 43, "inspection_date": "01/10/2026", "inspection_type": "More detailed inspection", "member_state": "Romania", "port_name": "Braila", "port_and_ms": "Romania - Braila", "ndeficiencies": 6, "results_desc": "" }
    ],
    "count": 50,
    "total": 13181,
    "resume": { "ships": 12175, "inspections": 13181, "detentions": 517, "ism_deficiencies": 1900, "non_ism_deficiencies": 40110, "bans": 14 },
    "paging": { "page": 1, "start": 0, "limit": 50 }
  },
  "evidence": [
    { "quote": "AAL DAMMAM（IMO 9963554，PT）：01/10/2026 @Canada Trois Rivieres——3 缺陷（Initial inspection）",
      "url": "https://portal.emsa.europa.eu/o/portlet-public/rest/inspection/getPublicInspections.json" }
  ],
  "source": { "provider": "paris_mou", "execution": "local", "from_cache": false, "observed_at": "2026-10-30T03:10:13.697Z" }
}

怎么读：reason 自带窗统计（本窗 13,181 检 / 12,175 船 / 517 滞留 / 1,900 ISM 缺陷）——评估一个窗口的风险面直接用它；result.resume 是同数据的结构化形态（还带 non_ism_deficiencies / bans）；一行=一次检查，id 键可逐检深查（上游 getInspectionDetail）；--ism-company-imo-number / --ism-company-name 可把流收窄到指定管理公司。

`esg paris_mou_low_performance_companies`

Paris MoU 低表现 ISM 公司名单

**注意：**名单只含 LOW 档公司——更高风险表现级别不在此面；effect_date 是入榜日期（可远早于当下，首例 2012——长年低表现），expiry_date 为 null=仍在榜；地址列部分为 null。

$ esg paris_mou_low_performance_companies

{
  "reason": "Paris MoU 低表现 ISM 公司：65 家（25 国/地区），100% 带 IMO 公司号（如 Apeejay Shipping Ltd / IMO 0052193，India，LOW，08/10/2012 入榜）——滚动 6 月窗公司风险属性名单",
  "result": {
    "rows": [
      { "id": 18885, "imo_number": "0052193", "name": "Apeejay Shipping Ltd", "address": "Apeejay House, 15, Park Street", "city": "Kolkata", "country_code": "IN", "country_name": "India", "performance": "LOW", "effect_date": "08/10/2012", "expiry_date": null, "status": "ACTIVE" },
      { "id": 22066, "imo_number": "0099721", "name": "JADROLINIJA RIJEKA", "address": null, "city": null, "country_code": "HR", "country_name": "Croatia", "performance": "LOW", "effect_date": "01/11/2023", "expiry_date": null, "status": "ACTIVE" }
    ],
    "count": 65
  },
  "evidence": [
    { "quote": "Apeejay Shipping Ltd（IMO 0052193，India，LOW，入榜 08/10/2012）",
      "url": "https://portal.emsa.europa.eu/o/portlet-public/rest/companyperformance/getLowPerformance6MonthsISMCompanies.json" }
  ],
  "source": { "provider": "paris_mou", "execution": "local", "from_cache": true, "fetched_at": "2026-10-30T01:23:12.938Z" }
}

**怎么读：**一行=一家 ISM 管理公司：公司 IMO 号（7 位零填充，如 0052193）+ 地址 + 国别 + performance / effect_date / status——65 家滚动 6 月窗名单，尽调航运公司风险属性直接用；公司 IMO 键与其他 Paris MoU 面（bans/inspections 的 ISM 列）互查。

`esg thetis_mrv_datasets`

EU 船舶排放申报批量件目录（THETIS-MRV）

**注意：**零参数目录面——一次调用返回全部 8 期当前件，无过滤无分页；版本号随上游再生成滚动跳变（本期捕获时 2025 已 v76、2024 已 v254），对账以此清单为准、勿猜文件名；XLSX 本体不经此面下载。

$ esg thetis_mrv_datasets

{
  "reason": "THETIS-MRV 排放申报件目录：8 个申报期（2018-2025）× 8 件版本化发布件——最新 2025 v76（29-10-2026 05:27:07 再生成）；版本账本滚动跳变，收割按清单对账勿猜文件名；XLSX 本体走批线",
  "result": {
    "rows": [
      { "reporting_period": 2025, "version": 76, "generation_date": "29-10-2026 05:27:07", "file_name": "2025-v76-29102026-EU MRV Publication of information", "download_path": "/api/public-emission-report/reporting-period-document/binary/2025/76" },
      { "reporting_period": 2024, "version": 254, "generation_date": "28-10-2026 05:21:34", "file_name": "2024-v254-28102026-EU MRV Publication of information", "download_path": "/api/public-emission-report/reporting-period-document/binary/2024/254" }
    ],
    "count": 8,
    "reporting_periods": [2025, 2024, 2023, 2022, 2021, 2020, 2019, 2018]
  },
  "evidence": [
    { "quote": "2025 v76（29-10-2026 05:27:07）：2025-v76-29102026-EU MRV Publication of information",
      "url": "https://mrv.emsa.europa.eu/api/public-emission-report/downloadable-files" }
  ],
  "source": { "provider": "thetis_mrv", "execution": "local", "from_cache": true, "fetched_at": "2026-10-29T09:07:36.581Z" }
}

怎么读：一期一行=该申报期当前发布件：版本号+再生成时间+文件名+下载径；reporting_periods 数组给全部在架期（2018–2025）；download_path 是相对径——拼 mrv.emsa.europa.eu 主机即文件直链。

使用边界

跨批比较按 GFS 码分组：USD 折算口径在不同发布批次间不一致，绝对值不可直接比（详见上方各面边界）。

ON THIS PAGE

ESG 数据#

命令一览#

实时查询#

esg climatetrace_owners#

esg climatetrace_sources#

esg eiti_companies#

esg eiti_payments#

esg epa_frs_facilities#

esg euasl_datasets#

esg eutl_datasets#

esg paris_mou_bans#

esg paris_mou_detentions#

esg paris_mou_inspections#

esg paris_mou_low_performance_companies#

esg thetis_mrv_datasets#

使用边界#