trimtab-ais

Trimtab US Trade Ledger — 米国の関税・貿易データ向けMCPサーバー

米国の輸入業者が国境で実際に支払った金額を確認できます。無料で、APIキーも登録も不要です。 商品と原産地別の公式関税納付額を、2017年以降、毎月掲載しています。米国財務省独自の関税収入記録と月次で照合済みです（入国時に査定された金額と、還付後に保持された金額の両方を掲載。2026年5月と6月はマイナスでした）。さらに、連邦官報の引用を含む現行のHTSルールブック、CBPの分類裁定、HSコード検索、原産地 × 品目 × ゲートウェイ別の米国コンテナ輸入（改訂履歴を追跡）、独自に記録したAIS船舶の動きを収録した固定版の2026年アーカイブも提供します。すべての応答に、手法、出典、限界を記載しているため、エージェントはただ信頼するのではなく検証できます。

米国貿易の独立観測機関、Trimtabist が公開しています。事前登録済みの検証研究20件（帰無結果も公開）、公開訂正ログ、そして収集パイプライン全体をtrimtab-pipelineでオープンにしています。

エンドポイント（ストリーミング可能なHTTP、認証不要）：

https://trimtabist.com/mcp

公式MCPレジストリ：com.trimtabist/us-tariff-ledger · 13個のツール＋アーカイブルーター · エージェント向けドキュメント：trimtabist.com/llms.txt · 接続ガイド：trimtabist.com/connect

理由

運送会社の追跡データは、表示どおりの意味とは限りません。同じイベントラベルでも、ある運送会社では「岸壁に接岸中」、別の運送会社では「錨泊待機中」を意味することがあります。その差は数時間から数日に及び、滞船料の計時、ドレージの予約、顧客への納期約束を左右します。その一方で、運送会社は自動読み取りへの扉を閉ざしつつあります。複数の運送会社がrobots.txtでAIクローラーを名指しでブロックしており、上位10社のうち公開開発者ポータルを運営している会社は1社もありません。

そのため、いま輸送の判断を下すソフトウェアは、検証できない書類を根拠に議論しています。このツールは、もう一方の側面、つまり物理的な事実を提供します。船は動いているか、そうでないかのどちらかです。コンテナターミナルに接岸しているか、そうでないかのどちらかです。AISがそれを示し、私たちは継続的に記録し、把握した内容を公開します。確認できないことも含めてです。

エージェントに追加する

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 }] }

または、シェルからインストール不要で使用できます：

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	到着、錨泊、停泊、出発、および意味に関する注記を含むイベントストリーム

US Trade Ledgerの系列ツール（国勢調査局が記録した港湾貿易データと照合データ）：

ツール	確認できる内容
list_instruments	出典の信頼度と信頼状態を含む、すべての計測手段とデータ系列。まずはこちらをご覧ください
describe_series	1つの系列が測定する内容：単位、出典、手法、引用、対象範囲
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日に開始し、初日に公表済みの欠落期間が1つあります（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の共同創業者兼COOです。これは、貿易データが実際に示す内容と現実に起きていることを比較するTrimtab US Trade Ledgerの、リアルタイム観測レイヤーです。