海事导航 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 使用与 v1 相同的令牌、套餐和请求计费方式。位于 /api/v1/ 下的所有内容将完全如前般工作，因此现有集成无需更改。v2 新增：

• 所有警报的单一列表： GET /api/v2/messages/, NAVAREA 与近岸合并，按最新优先，每条消息带其区域、国家和归档状态。
• 在区域端点上的消息过滤器： /api/v2/navarea/ and /api/v2/coastal/ 像 v1 一样应答，同时也对它们返回的消息应用 date_from, date_to, keyword and has_coordinates 。
• 保存在每个令牌上的设置： 在 Profile > API > API v2 builder中选择一个令牌，通过菜单和实时预览构建响应并保存。使用该令牌的每个 /api/v2/ 调用将返回该结构；/api/v1/ 调用会忽略已保存的设置并按原样响应。
• prompt filter (Full API):用您自己的话描述一个令牌应该返回的警报，例如 “仅返回美国周边的太空碎片警报”。
• 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 列出原始语言名称。

美国海岸警卫队的 Local Notices to Mariners（10 个区，每周更新）是名为 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, 列出其助航设施存在差异的通知。

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

保存到令牌上的设置

• 一个令牌，一个形状： 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 头，标明应用了其设置的令牌。

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 计划，或冰情 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/ (无需令牌) 列出每个 feed 及其当前生效警报数量。
• Full API 计划，或单个 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/ 使用该令牌的调用随后只返回匹配的警报。一条在生效时匹配的警报在归档后仍保留匹配状态。
• 响应会添加 meta.prompt_filter 字段，包含提示、其状态（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
    }
  }
}