Maritime Navigation API

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 χρησιμοποιεί το ίδιο token, τα ίδια plans και την ίδια λογιστική αιτημάτων όπως το v1. Όλα κάτω από /api/v1/ συνεχίζει να λειτουργεί ακριβώς όπως πριν, οπότε οι υπάρχουσες ενσωματώσεις δεν χρειάζονται αλλαγή. Το v2 προσθέτει:

• Μια λίστα με κάθε προειδοποίηση: GET /api/v2/messages/, NAVAREA και coastal μαζί, με τις νεότερες πρώτες, κάθε μήνυμα με την περιοχή, τη χώρα και την κατάσταση αρχείου.
• Φίλτρα μηνυμάτων στα endpoints περιοχής: /api/v2/navarea/ and /api/v2/coastal/ απαντούν όπως το v1 και επίσης εφαρμόζουν date_from, date_to, keyword and has_coordinates στα μηνύματα που επιστρέφουν.
• Ρυθμίσεις αποθηκευμένες σε κάθε token: επιλέξτε ένα token στο Profile > API > API v2 builder, χτίστε την απάντηση με μενού και ζωντανή προεπισκόπηση, και αποθηκεύστε. Κάθε κλήση /api/v2/ με εκείνο το token επιστρέφει εκείνο το σχήμα; οι κλήσεις /api/v1/ αγνοούν τις αποθηκευμένες ρυθμίσεις και απαντούν ακριβώς όπως πριν.
• prompt filter (Full API):περιγράψτε τις προειδοποιήσεις που πρέπει να επιστρέψει ένα token με δικά σας λόγια, για παράδειγμα "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/

Πεδία ή φίλτρα που το πλάνο σας δεν περιλαμβάνει παραλείπονται και αναγράφονται σε meta.warnings, ποτέ σφάλμα.

content είναι το κείμενο όπως εκπέμφθηκε; 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 ονομάζει την αρχική γλώσσα.

Οι US Coast Guard Local Notices to Mariners (10 districts, ενημερώνονται εβδομαδιαία) είναι παράκτιες περιοχές με τίτλο US Coast Guard LNM, country US. They are not analysed, so their automatic fields are empty; each district also has one message, number LNMxx-DISCREPANCIES, που καταγράφει τους aids to navigation με μια απόκλιση.

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

Ρυθμίσεις αποθηκευμένες σε ένα token

• Ένα token, ένα σχήμα: 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.
• Επιλογές εμφανίζονται όλες, Συμπεριλαμβάνονται αυτές με Full API, με το πλάνο που χρειάζεται η κάθε μία. Η αποθήκευση απαιτεί ενεργό API πλάνο.
• Το URL υπερισχύει: οποιοσδήποτε παράμετρος βάλεις στο URL αντικαθιστά την αποθηκευμένη τιμή για εκείνη την κλήση; ?settings=off κάνει μια απλή κλήση.
• Σχετικοί περίοδοι: "τελευταίες 30 ημέρες" στέλνει date_from ως σήμερα μείον 30 ημέρες σε κάθε κλήση.
• Οι απαντήσεις φέρουν ένα X-API-Token-Settings header που αναφέρει το token του οποίου οι ρυθμίσεις εφαρμόστηκαν.

Ice feed: 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 επιστρέφει ένα GeoJSON FeatureCollection, ένα feature ανά σχήμα, έτοιμο για ελέγχους διαδρομής και επικαλύψεις χαρτογράφησης.
• ice_type περιορίζει: iceberg, sea_ice, ice_edge, icing, ice_report, icebreaker, ice_navigation, other_ice (επανάλαβε ή διαχώρισε με κόμμα). Κάθε παράμετρος του /api/v2/messages/ επίσης λειτουργεί, και /api/v2/messages/?topic=ice είναι το ίδιο feed.
• Πλάνο Full API, ή άδεια ice feed (ετήσια, τιμολογούμενη): επικοινώνησε μαζί μας.

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

Themed feeds: 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 για FeatureCollection και ?category=για να κρατήσεις μόνο κάποιες από τις κατηγορίες ενός feed. Κάθε παράμετρος του /api/v2/messages/ επίσης λειτουργεί, και /api/v2/messages/?topic=military είναι το ίδιο feed.
• Only warnings with an analysis are included. GET /api/v2/feeds/ (no token needed) απαριθμεί κάθε feed με το πόσες από τις προειδοποιήσεις του είναι ενεργές.
• Πλάνο Full API, ή άδεια feed για ένα μεμονωμένο feed (ετήσια, τιμολογούμενη): επικοινώνησε μαζί μας.
• 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.

Φόρτωση ροών…

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/ οι κλήσεις με εκείνο το token επιστρέφουν μόνο τις ταιριαστές προειδοποιήσεις. Μια προειδοποίηση που ταιρίαζε όσο ήταν σε ισχύ παραμένει ταιριαστή ακόμη και μετά την αρχειοθέτησή της.
• Η απάντηση προσθέτει meta.prompt_filter με το prompt, την κατάσταση του ("matching αμέσως μετά την αποθήκευση, ready αργότερα) και πόσες προειδοποιήσεις ταίριαξαν. ?prompt_filter=off το παρακάμπτει για μια κλήση.
• 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
    }
  }
}