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 sử dụng cùng token, các gói và tính toán yêu cầu như v1. Mọi thứ dưới /api/v1/ vẫn hoạt động chính xác như trước, nên các tích hợp hiện tại không cần thay đổi. v2 bổ sung:

• Một danh sách tất cả cảnh báo: GET /api/v2/messages/, NAVAREA và ven bờ cùng nhau, mới nhất trước, mỗi thông báo kèm vùng, quốc gia và trạng thái lưu trữ.
• Bộ lọc thông báo trên các endpoint vùng: /api/v2/navarea/ and /api/v2/coastal/ trả lời giống v1 và cũng áp dụng date_from, date_to, keyword and has_coordinates cho các thông báo mà chúng trả về.
• Cài đặt lưu trên mỗi token: chọn một token trên Profile > API > API v2 builder, xây dựng phản hồi với các menu và xem trước trực tiếp, rồi lưu. Mọi gọi /api/v2/ với token đó trả về dạng đã lưu; các gọi /api/v1/ bỏ qua cài đặt đã lưu và trả lời hoàn toàn như trước.
• prompt filter (Full API):mô tả bằng lời của bạn các cảnh báo mà một token nên trả về, ví dụ "chỉ cảnh báo mảnh vỡ không gian quanh 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/

Các trường hoặc bộ lọc mà gói của bạn không bao gồm sẽ bị bỏ và được liệt kê trong meta.warnings, không bao giờ là một lỗi.

content là văn bản như đã phát; 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 ghi tên ngôn ngữ gốc.

Các Local Notices to Mariners của US Coast Guard (10 districts, cập nhật hàng tuần) là các vùng ven bờ có tiêu đề US Coast Guard LNM, country US. They are not analysed, so their automatic fields are empty; each district also has one message, number LNMxx-DISCREPANCIESliệt kê các aids to navigation có sự khác biệt.

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

Cài đặt lưu trên một token

• Một token, một hình dạng: 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.
• Mọi tùy chọn đều được hiển thị, Bao gồm cả các tùy chọn Full API, kèm theo gói mà từng tùy chọn yêu cầu. Việc lưu cần có gói API đang hoạt động.
• URL thắng: bất kỳ tham số nào bạn đưa vào URL thay thế giá trị đã lưu cho cuộc gọi đó; ?settings=off thực hiện một cuộc gọi đơn thuần.
• Khoảng thời gian tương đối: "last 30 days" gửi date_from như ngày hôm nay trừ 30 ngày trên mọi cuộc gọi.
• Các phản hồi mang một X-API-Token-Settings header đặt tên token mà cài đặt của nó đã được áp dụng.

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 trả về một GeoJSON FeatureCollection, một feature cho mỗi hình dạng, sẵn sàng cho kiểm tra hành trình và lớp phủ bản đồ.
• ice_type thu hẹp nó: iceberg, sea_ice, ice_edge, icing, ice_report, icebreaker, ice_navigation, other_ice (lặp lại hoặc phân tách bằng dấu phẩy). Mọi tham số /api/v2/messages/ cũng hoạt động, và /api/v2/messages/?topic=ice là cùng một feed.
• Gói Full API, hoặc giấy phép feed băng (hàng năm, xuất hoá đơn): liên hệ chúng tôi.

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 cho một FeatureCollection và ?category=để chỉ giữ một số danh mục của một feed. Mọi tham số /api/v2/messages/ cũng hoạt động, và /api/v2/messages/?topic=military là cùng một feed.
• Only warnings with an analysis are included. GET /api/v2/feeds/ (không cần token) liệt kê mọi feed cùng với số lượng cảnh báo đang còn hiệu lực của nó.
• Gói Full API, hoặc giấy phép feed cho một feed duy nhất (hàng năm, xuất hoá đơn): liên hệ chúng tôi.
• 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.

Đang tải các feed…

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/ các cuộc gọi với token đó sau đó chỉ trả về các cảnh báo khớp. Một cảnh báo đã khớp khi đang còn hiệu lực sẽ vẫn coi là khớp sau khi nó được lưu trữ.
• Phản hồi thêm vào meta.prompt_filter với prompt, trạng thái của nó (matching ngay sau khi lưu, ready sau đó) và có bao nhiêu cảnh báo khớp. ?prompt_filter=off bỏ qua nó cho một cuộc gọi.
• 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
    }
  }
}