해상 항행 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, 국가 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 }
    }
  ]
}

토큰에 저장된 설정

• 토큰 1개, 영역 1개: 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을 반환하며, 하나의 형태당 하나의 피처로 항로 점검과 차트 오버레이에 바로 사용할 수 있습니다.
• ice_type 다음으로 좁힙니다: iceberg, sea_ice, ice_edge, icing, ice_report, icebreaker, ice_navigation, other_ice (반복하거나 쉼표로 구분). 모든 /api/v2/messages/ 파라미터도 작동하며, /api/v2/messages/?topic=ice 같은 피드입니다.
• Full API plan 또는 연간 청구되는 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=피드의 일부 분류만 유지하려면 를 사용하세요. 모든 /api/v2/messages/ 파라미터도 작동하며, /api/v2/messages/?topic=military 같은 피드입니다.
• Only warnings with an analysis are included. GET /api/v2/feeds/ (토큰 불필요) 모든 피드와 그 피드의 발효중 경고 수를 나열합니다.
• Full API plan 또는 단일 피드에 대한 연간 청구되는 피드 사용권 필요: 문의하세요.
• 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
    }
  }
}