Trimtab AIS
Barcos en vivo en 8 puertos de contenedores de EE. UU. + comercio portuario del Censo de EE. UU. por país y producto. Gratis, sin clave API.
Documentación
Trimtab US Trade Ledger — servidor MCP para datos arancelarios y comerciales de EE. UU.
Lo que los importadores estadounidenses realmente pagaron en la frontera: gratis, sin clave API, sin registro. Recibos oficiales de aranceles por producto y origen, mensuales desde 2017, conciliados mensualmente contra los propios recibos aduaneros del Tesoro de EE. UU. (ambos libros: evaluados en la entrada y conservados después de los reembolsos — mayo y junio de 2026 fueron negativos). Además, el libro de reglas HTS actual con citas del Registro Federal, resoluciones de clasificación de la CBP, búsqueda de códigos HS, importaciones estadounidenses contenerizadas por origen × mercancía × puerta de entrada (con seguimiento de revisiones) y un archivo congelado de 2026 de movimientos de buques AIS registrados por cuenta propia. Cada respuesta lleva su método, su procedencia y sus límites, para que tu agente pueda verificar en lugar de confiar.
Publicado por Trimtabist — el observatorio independiente del comercio estadounidense. 20 estudios reglados preinscritos (nulos publicados), un registro público de correcciones y todo el proceso de recopilación abierto en trimtab-pipeline.
Punto de conexión (HTTP transmisible, sin autenticación):
https://trimtabist.com/mcp
Registro oficial de MCP: com.trimtabist/us-tariff-ledger · 13 herramientas + un enrutador de archivos ·
documentación para agentes: trimtabist.com/llms.txt ·
guías de conexión: trimtabist.com/connect
Por qué
Los datos de seguimiento de portacontenedores no significan lo que dicen. La misma etiqueta de evento puede significar "junto al muelle"
para un transportista y "esperando anclado" para otro — una diferencia de horas a días, que es
exactamente la diferencia que decide un reloj de demoras, una cita de acarreo o una promesa al
cliente. Mientras tanto, los transportistas han estado cerrando sus puertas a los lectores automatizados: varios ahora
bloquean rastreadores de IA por nombre en robots.txt, y ni uno solo de los diez principales ejecuta un portal público
para desarrolladores.
Así que el software que ahora toma decisiones de envío está argumentando a partir de documentación que no puede verificar. Este instrumento ofrece la otra mitad: física. Un buque se mueve o no se mueve; está junto a una terminal de contenedores o no lo está. El AIS lo dice, nosotros lo registramos continuamente y publicamos lo que vemos — incluido lo que no podemos ver.
Añádelo a tu agente
Claude Code:
claude mcp add --transport http trimtab-ais https://ais.trimtabist.com/mcp
Claude Desktop o cualquier cliente MCP (transporte HTTP):
{ "mcpServers": { "trimtab-ais": { "url": "https://ais.trimtabist.com/mcp" } } }
Clientes que requieren stdio:
{ "mcpServers": { "trimtab-ais": { "command": "npx", "args": ["-y", "trimtab-ais"] } } }
Úsalo desde código
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 }] }
O desde la terminal, sin instalación:
npx trimtab-ais gateway us_savannah
npx trimtab-ais vessel "ONE ORPHEUS"
npx trimtab-ais berthed "MSC DARLENE" 48
O directamente por HTTPS — es JSON-RPC simple:
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"}}}'
Las herramientas
| Herramienta | Responde |
|---|---|
gateway_conditions | Qué está sucediendo en una puerta de entrada ahora — buques en muelle y anclados, clasificados (contenedor / granel general / petrolero / servicio), con terminales de contenedores nombradas |
vessel_status | Dónde está un buque, qué está haciendo físicamente, qué terminal, desde cuándo, destino declarado |
has_vessel_berthed | Si un buque atracó dentro de una ventana de retroceso — marca de tiempo, terminal, espera de fondeo si hizo cola |
recent_events | El flujo de eventos: llegadas, fondeos, atraques, salidas y notas semánticas |
Herramientas de la serie US Trade Ledger (comercio portuario registrado por el Censo + verificaciones cruzadas):
| Herramienta | Responde |
|---|---|
list_instruments | Cada instrumento y serie de datos, con grado de procedencia y estado de confianza — empieza aquí |
describe_series | Qué mide una serie: unidad, fuente, método, cita, cobertura |
query_series | Los datos: comercio portuario mensual de EE. UU. por país y mercancía, eventos de buques, fiabilidad de ETA |
check_agreement | Registros aduaneros del Censo vs observación AIS en vivo — donde los instrumentos independientes discrepan, uno está equivocado |
search_series | Encuentra series en lenguaje natural: "importaciones desde india", "houston", "llegadas de buques" |
Puertas de entrada: us_la_longbeach us_ny_nj us_savannah us_houston us_charleston us_norfolk
us_oakland us_seattle_tacoma
Qué cubre — y qué no
Un instrumento que oculta sus puntos ciegos no es un instrumento.
- Cubierto: las ocho puertas de entrada de contenedores de EE. UU. mencionadas arriba.
- Registrado pero escaso: Chennai/Ennore/Kattupalli; JNPT, Mundra, Pipavav, Hazira, Vizhinjam, Colombo — los receptores terrestres son escasos allí, por lo que la cobertura es parcial o inexistente. Publicado, no encubierto.
- No cubierto: medio océano (solo AIS terrestre, sin satélite), carga (el AIS ve buques, nunca contenedores), tarifas, horarios o cualquier cosa que un transportista declare en lugar de hacer.
- El archivo comienza el 26 de julio de 2026, con una brecha divulgada (2026-07-26 17:20Z → 2026-07-27 12:16Z) desde el primer día del instrumento. Las duraciones que comenzaron antes de que comenzara el registro son límites inferiores, y así lo indican.
Lee el método → — fuentes, umbrales de máquina de estados, cómo se distinguen los portacontenedores de los graneleros (los códigos de tipo AIS no pueden), límites conocidos y la política de corrección. Escrito para que un extraño pueda reproducir los números o demostrar que están equivocados.
Licencia y cita
Datos CC BY 4.0, código Apache 2.0. Úsalo comercialmente, construye sobre ello, redistribúyelo — con atribución:
Trimtab AIS (ais.trimtabist.com), construido por Mrigank Singh
No es para uso regulatorio ni de seguridad de la vida; sin garantía. Si encuentras algo incorrecto, avísame — las correcciones se publican, con el tamaño del error cuantificado.
Construido y mantenido por Mrigank Singh, quien mueve contenedores para ganarse la vida — cofundador y director de operaciones de Intoglo, un agente de carga de India→EE. UU. Esta es la capa de observación en vivo del Trimtab US Trade Ledger, que mide lo que los datos comerciales realmente dicen versus lo que realmente sucede.