us-tariff-ledger

Trimtab 美国贸易账簿 — 美国关税与贸易数据 MCP 服务

美国进口商在边境实际支付了多少费用——免费，无需 API 密钥，无需注册。 按商品和原产地统计的官方关税收入，自 2017 年以来按月记录，并每月与美国财政部自己的海关收入核对（两种口径：入境时评估的金额，以及扣除退款后实际留存的金额——2026 年 5 月和 6 月为负值）。此外还包括当前 HTS 规则手册及《联邦公报》引文、CBP 分类裁定、HS 编码搜索、按原产地 × 商品 × 门户统计的美国集装箱进口数据（带修订记录），以及一份冻结的 2026 年档案，收录自行记录的 AIS 船舶动态。每条响应都会说明其方法、出处和局限，让你的 Agent 能够核验，而非盲信。

由美国贸易独立观测站 Trimtabist 发布。 20 项预注册的规则研究（公布了零结果）、公开的更正日志，以及完整的数据采集流水线，均已在 trimtab-pipeline 开源。

端点（可流式传输的 HTTP，无需身份验证）：

https://trimtabist.com/mcp

官方 MCP 注册表：com.trimtabist/us-tariff-ledger · 13 个工具 + 一个档案路由器 · 面向 Agent 的文档：trimtabist.com/llms.txt · 连接指南：trimtabist.com/connect

为什么

承运商的跟踪数据并不总是名副其实。同一个事件标签，对一家承运商可能表示“靠在码头旁”，对另一家则可能表示“在锚地等待”——差异可达数小时甚至数天，而这恰恰会决定滞期费计时、拖车预约或对客户的承诺。与此同时，承运商纷纷对自动化读取工具关上大门：现在有几家承运商会在 robots.txt 中直接按名称屏蔽 AI 爬虫，而且排名前十的承运商没有一家提供公开的开发者门户。

因此，如今做出航运决策的软件，只能依据无法核验的文书信息进行判断。本工具提供另一半：物理事实。船要么在移动，要么没有；要么靠在集装箱码头旁，要么没有。AIS 会说明情况，我们会持续记录并公布所见——包括无法确认的部分。

将它添加到你的 Agent

Claude Code：

claude mcp add --transport http trimtab-ais https://ais.trimtabist.com/mcp

Claude Desktop 或任何 MCP 客户端（HTTP 传输）：

{ "mcpServers": { "trimtab-ais": { "url": "https://ais.trimtabist.com/mcp" } } }

需要 stdio 的客户端：

{ "mcpServers": { "trimtab-ais": { "command": "npx", "args": ["-y", "trimtab-ais"] } } }

在代码中使用

npm i trimtab-ais

import { gatewayConditions, vesselStatus, hasVesselBerthed } from 'trimtab-ais';

const la = await gatewayConditions('us_la_longbeach');
// → { gateways: [{ at_berth: { by_class: { container: 8, tanker: 3, ... } },
//                  at_anchor: { ... }, container_terminals: { "LA Pier 400 (APM)": [...] } }],
//     as_of, method, coverage, source, attribution }

await vesselStatus('MSC DARLENE');
// → moored, container, 366 m, LA Terminal Island (Fenix/Everport), since 2026-07-26T14:47Z

await hasVesselBerthed('EVER MEGA', 72);
// → { berthed: true, events: [{ at, gateway, terminal, queue_wait_min }] }

也可以通过 Shell 使用，无需安装：

npx trimtab-ais gateway us_savannah
npx trimtab-ais vessel "ONE ORPHEUS"
npx trimtab-ais berthed "MSC DARLENE" 48

也可以直接通过 HTTPS 使用——它采用普通的 JSON-RPC：

curl -X POST https://ais.trimtabist.com/mcp -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"gateway_conditions","arguments":{"gateway":"us_ny_nj"}}}'

工具

工具	可回答的问题
gateway_conditions	门户当前情况如何——靠泊和锚泊的船舶，按类型分类（集装箱／散货-杂货／油轮／服务船），并注明集装箱码头名称
vessel_status	船舶位置、当前实际状态、所在码头、该状态持续时间以及申报目的地
has_vessel_berthed	船舶是否在回溯时间范围内靠泊——时间戳、码头，以及排队时的锚地等待时间
recent_events	事件流：到港、抛锚、靠泊、离港以及语义说明

美国贸易账簿系列工具（普查局记录的港口贸易数据 + 交叉核验）：

工具	可回答的问题
list_instruments	所有仪器和数据系列，包括出处评级和信任状态——请从这里开始
describe_series	单个系列的测量内容：单位、来源、方法、引文和覆盖范围
query_series	数据：按国家和商品划分的美国港口月度贸易、船舶事件、ETA 可靠性
check_agreement	普查局海关记录与实时 AIS 观测之间的对比——独立仪器出现分歧时，其中一方必有误
search_series	用日常语言查找系列：“印度进口”“休斯敦”“船舶到港”

门户：us_la_longbeach us_ny_nj us_savannah us_houston us_charleston us_norfolk us_oakland us_seattle_tacoma

涵盖范围——以及未涵盖的内容

隐藏自身盲区的仪器，就称不上仪器。

• **已覆盖：**上述 8 个美国集装箱门户。
• **有记录但覆盖较少：**金奈／埃诺尔／卡图帕利；JNPT、蒙德拉、皮帕瓦夫、哈齐拉、维津贾姆、 科伦坡——当地的陆基接收器很少，因此覆盖有限，甚至没有覆盖。已公开说明，不会掩盖。
• **未覆盖：**远洋区域（仅使用陆基 AIS，不含卫星数据）、货物（AIS 能看到船只，无法看到 箱子）、运价、船期，或承运人声明但并未实际执行的任何内容。
• **档案始于 2026 年 7 月 26 日，**存在一个已披露的数据缺口（2026-07-26 17:20Z → 2026-07-27 12:16Z）， 来自仪器运行的第一天。录制开始前已持续的时长均为下限，且会明确标注。

阅读方法说明 →——数据来源、状态机阈值、 如何区分集装箱船和散货船（AIS 类型代码无法做到）、已知局限和更正政策。说明编写得足够详尽， 让陌生人也能复现这些数字，或证明它们有误。

许可与引用

数据采用 CC BY 4.0 许可，代码采用 Apache 2.0 许可。可用于商业用途、基于其构建或重新分发——但须注明出处：

Trimtab AIS (ais.trimtabist.com)，由 Mrigank Singh 构建

不得用于监管或生命安全相关用途；不提供任何担保。如果发现内容有误， 请告诉我——更正内容会予以发布，并量化误差大小。

---

由 Mrigank Singh 构建并维护。他以运输集装箱为生——是 Intoglo 的联合创始人兼首席运营官。Intoglo 是一家印度至美国的货运代理公司。这是 Trimtab US Trade Ledger 的实时观测层，用于衡量贸易数据实际显示的内容与实际发生的情况之间的差异。