海上航行 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と同じトークン、プラン、リクエスト課金を使用します。の下にあるすべてはこれまで通り動作するので、既存の統合に変更は不要です。v2で追加されたもの： /api/v1/ はこれまで通り完全に動作します。v2の追加点：

• すべての警報を1つのリストにまとめる: 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):トークンが返すべき警報をあなた自身の言葉で記述してください。例：「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/

Fields or filters your plan does not include are left out and listed in -> プランに含まれないフィールドやフィルタは省略され、次に列挙されます meta.warnings, never an error. -> 、エラーにはなりません。

content is the text as broadcast; -> は放送されたままの本文です； 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 names the original language. -> は原文の言語名を示します。

The US Coast Guard Local Notices to Mariners (10 districts, updated weekly) are coastal regions titled -> 米国沿岸警備隊の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 , listing its aids to navigation with a discrepancy. -> 、航行標識の不一致を一覧表示します。

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

Settings saved on a token -> トークンに保存された設定

• One token, one shape: -> 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.
• Every option is shown, -> すべてのオプションが表示され、 Full API ones included, with the plan each needs. Saving needs an active API plan. -> Full APIの項目も含まれ、それぞれに必要なプランが表示されます。保存するには有効なAPIプランが必要です。
• URL wins: -> URLが優先： any parameter you put in the URL replaces the saved value for that call; -> URLに入れた任意のパラメータは、その呼び出しに対する保存値を置き換えます； ?settings=off プレーンコールを行います。
• 相対期間: "last 30 days" は送信します 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 を返します。形状ごとに1フィーチャーで、航路チェックやチャートオーバーレイにそのまま使えます。
• 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 プラン、または 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/?topic=military は同じフィードです。
• Only warnings with an analysis are included. GET /api/v2/feeds/ AI解析を持つ警報のみが含まれます。
• (トークン不要) ですべてのフィードと、そのフィードに現在効力がある警報数を一覧表示します。
• 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.

Full API プラン、または単一フィード用フィードライセンス（年額、請求書発行）：お問い合わせください。

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/ トークン上に欲しい内容を平易な言葉で書いてください（Full API プラン）。保存すると、AIモデルが効力中のすべての警報をそのプロンプトに照らしてチェックします。新しい警報は到着後約10分以内にチェックされます。
• そのトークンでのコールは、それに一致する警報のみを返します。効力中に一致した警報はアーカイブ後も一致したままです。 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
    }
  }
}