API de navigation maritime

Everything to connect is in one public repository: the OpenAPI specification, the data models, Python and JavaScript clients, an MCP server for Claude, Cursor, VS Code, Windsurf and Zed, and a GitHub Action that checks a route against the warnings in force. The endpoints stay the ones below; the kit is the way in.

• Editors and agents: add the MCP server and ask in plain words; the tools are search_warnings, warnings_near, route_check, navareas and feeds.
• Code: python/sealagom.py and js/sealagom.mjs, no dependencies beyond requests or fetch; generate any other language from openapi.yaml.
• No-code and agents: import sealagom.com/openapi.json into n8n, Make, Zapier, Pipedream, Postman, ChatGPT actions or LangChain. Send the key as X-API-Token or Authorization: Bearer.
• Routes: POST /api/v2/route/ with a route file or waypoints, or the drop link /api/v2/drop/<key>/route/ for tools that can only POST a file.
• Sky view: GET /api/v2/sky/link/?vessel= (or mmsi, warning and region, port, locode, lat and lon) gives a ready link that stands there in the sky view; POST /api/v2/sky/route/ takes a route and gives its sky link, drawn on the sea, with the RTZ and GPX. Section 20 of the README has the calls. Not for navigation.
• CI: the Action fails a build when a critical warning lies on a route kept in the repository.
• Scripts and agents paying for themselves: POST /api/agent/checkout/, crypto, the key once paid (in the profile when the e-mail already has an account).

API v2 utilise le même token, les mêmes plans et la même comptabilisation des requêtes que v1. Tout ce qui se trouve sous /api/v1/ continue de fonctionner exactement comme avant, donc les intégrations existantes n'ont pas besoin d'être modifiées. v2 ajoute :

• Une liste unique de tous les avertissements : GET /api/v2/messages/, NAVAREA et côtiers ensemble, du plus récent au plus ancien, chaque message avec sa région, son pays et son statut d'archivage.
• Filtres de message sur les endpoints de région : /api/v2/navarea/ and /api/v2/coastal/ répond comme v1 et s'appliquent aussi date_from, date_to, keyword and has_coordinates aux messages qu'ils renvoient.
• Paramètres sauvegardés sur chaque token : choisissez un token dans Profile > API > API v2 builder, construisez la réponse avec des menus et un aperçu en direct, puis enregistrez. Chaque appel /api/v2/ avec ce token renverra cette forme ; les appels /api/v1/ ignorent les paramètres sauvegardés et répondent exactement comme avant.
• prompt filter (Full API):décrivez, avec vos propres mots, les avertissements qu'un token doit renvoyer, par exemple "only space debris warnings around the USA".
• Integrate: the kit on GitHub (OpenAPI spec, clients, MCP server, Action) is the way in; a README.md per token, with its settings, plan and every parameter and field, is there for any program that wants one file.
• Settings file:instead of ticking options, ask LagoPal (with the README) for a settings file: a small JSON file with the token's endpoint, parameters and prompt. Load it on Profile > API (Load settings file); it fills the builder so you can check the live preview before saving. Download settings file gives the current settings in the same form. JSON Schema: /api/public/api-settings-schema/.

GET /api/v2/messages/

Les champs ou filtres que votre plan n'inclut pas sont omis et listés dans meta.warnings, jamais une erreur.

content est le texte tel que diffusé ; content_en is the English text (the official English version or a machine translation) for sources that broadcast in another language, such as China or Turkey, and source_language indique la langue d'origine.

Les Local Notices to Mariners de la US Coast Guard (10 districts, mis à jour hebdomadairement) sont des régions côtières intitulées US Coast Guard LNM, pays US. They are not analysed, so their automatic fields are empty; each district also has one message, number LNMxx-DISCREPANCIES, listant ses aides à la navigation présentant une anomalie.

curl "https://www.sealagom.com/api/v2/messages/?country=France&include_coordinates=true&include_ai_analysis=true" \
  -H "X-API-Token: YOUR_API_TOKEN"

{
  "count": 42,
  "page": 1,
  "page_size": 50,
  "next": null,
  "previous": null,
  "results": [
    {
      "scope": "coastal",
      "region_id": 57,
      "region_title": "FRANCE Atlantic",
      "country": "France",
      "is_archived": false,
      "archived_on": null,
      "id": 90211,
      "number": "AVURNAV 1234/26",
      "content": "BAY OF BISCAY. DRIFTING BUOY ...",
      "content_en": "BAY OF BISCAY. DRIFTING BUOY ...",
      "source_language": "en",
      "added_on": "2026-09-27T08:10:00Z",
      "coordinates": ["45-10.0N 002-05.0W"],
      "ai_analysis": { "headline": "...", "severity": "moderate", "valid_until": null }
    }
  ]
}

Paramètres enregistrés sur un token

• Un token, une forme : each token keeps its own endpoint and parameters. Need a second shape (say France coastal with coordinates, and a worldwide feed)? Create a second token.
• Toutes les options sont affichées, Comprend les Full API, avec le plan nécessaire pour chacun. L'enregistrement nécessite un plan API actif.
• L'URL l'emporte : tout paramètre passé dans l'URL remplace la valeur enregistrée pour cet appel ; ?settings=off effectue un appel simple.
• Périodes relatives : "les 30 derniers jours" envoie date_from comme aujourd'hui moins 30 jours pour chaque appel.
• Les réponses contiennent un X-API-Token-Settings en-tête indiquant le token dont les réglages ont été appliqués.

Flux glace : GET /api/v2/ice/

• Every warning about ice at sea, from NAVAREA, coastal and NAVTEX sources: icebergs and iceberg limits, sea ice, ice edge, vessel icing and freezing spray, ice reports, icebreaker operations and ice navigation rules. An model reads each warning that mentions ice and keeps only those really about it, with its kind in ice.type.
• Positions, shapes (iceberg limit lines, ice areas) and the analysis are included by default. ?output=geojson retourne un GeoJSON FeatureCollection, une feature par forme, prêt pour les contrôles de route et les superpositions de cartes.
• ice_type la restreint : iceberg, sea_ice, ice_edge, icing, ice_report, icebreaker, ice_navigation, other_ice (répétez ou séparez par des virgules). Tous les paramètres /api/v2/messages/ fonctionnent aussi, et /api/v2/messages/?topic=ice est le même flux.
• Plan Full API, ou licence flux glace (annuelle, facturée) : contactez-nous.

curl "https://www.sealagom.com/api/v2/ice/?output=geojson&ice_type=iceberg,ice_edge" -H "X-API-Token: YOUR_API_TOKEN"

Flux thématiques : GET /api/v2/feeds/<feed>/

• Ready-made feeds built from the category the analysis gives every warning: military exercises and firing, rocket launches and space debris, cable and pipeline work, offshore works and rigs, surveys, wrecks and drifting hazards, aids to navigation, search and rescue, security and restricted areas.
• Same output as the ice feed: positions, shapes and the analysis by default, the category in feed.category, ?output=geojson pour une FeatureCollection et ?category=pour ne conserver que certaines catégories d'un flux. Tous les paramètres /api/v2/messages/ fonctionnent aussi, et /api/v2/messages/?topic=military est le même flux.
• Only warnings with an analysis are included. GET /api/v2/feeds/ (pas de token requis) liste chaque flux avec le nombre d'avis en vigueur.
• Plan Full API, ou licence de flux pour un seul flux (annuelle, facturée) : contactez-nous.
• Free and without a token, for feed readers and scripts: RSS at /feeds/warnings.xml, /feeds/navarea/<id>.xml and /feeds/coastal/<id>.xml; the same three as Atom (.atom) and JSON Feed 1.1 (.json); plain text at /feeds/warnings.txt. The newest 100 warnings, text only, a warning keeps its id when it is updated. Region pages carry the feed links in their head, so a reader finds the feed from the page address.

Chargement des flux…

curl "https://www.sealagom.com/api/v2/feeds/military/?output=geojson&navarea_id=3" -H "X-API-Token: YOUR_API_TOKEN"

prompt filter

• Write what you want in plain words on the token (Full API plan). When you save, a model checks every warning in force against it; each new warning is checked within about 10 minutes of arriving.
• /api/v2/messages/ les appels avec ce token renvoient alors seulement les avis correspondants. Un avis qui correspondait pendant qu'il était en vigueur reste correspondant après son archivage.
• La réponse ajoute meta.prompt_filter avec le prompt, son statut (matching juste après l'enregistrement, ready puis) et combien d'avis ont été retenus. ?prompt_filter=off l'ignore pour un appel.
• The filter can miss or over-include a warning. Use it to narrow a feed, not as the only safety check; the official broadcast stays the authority.

# Token with saved settings: nothing else needed
curl "https://www.sealagom.com/api/v2/messages/" -H "X-API-Token: YOUR_API_TOKEN"

# Same token, override the period for one call
curl "https://www.sealagom.com/api/v2/messages/?date_from=2026-09-01" -H "X-API-Token: YOUR_API_TOKEN"

# Token with the prompt "only space debris warnings around the USA"
{
  "count": 3,
  "results": [ ... ],
  "meta": {
    "prompt_filter": {
      "prompt": "only space debris warnings around the USA",
      "status": "ready",
      "matched": 3
    }
  }
}