SurfMap API

あなたのプロダクトに、5,000以上のサーフスポットを。

SurfMapを動かしているエンジンを、シンプルなREST APIとして公開します。名前つきのスポット、サーファーのレベル別に評価された1時間ごとの予報、そして潮汐。最初のビルダーの受け入れを始めています。

curl https://api.surf-map.com/v1/spots/kugenuma/forecast

APIが返すもの

本物のスポットデータベース

世界中の名前つきサーフスポット5,000以上。座標と国つきで、名前でも位置でも検索できます。グリッドの点ではなく、サーファーが知っている実際のブレイクです。

レベル別に評価された予報

各スポットの波、風、潮汐を1時間ごとに7日分。さらに初級・中級・上級それぞれへのシンプルな評価つき。アプリを動かしているのと同じエンジンです。

潮汐も込み

各スポットの満潮と干潮を調和定数から計算。潮汐サービスを別途契約する必要はありません。

スポットを探し、予報と潮汐を取得

シンプルなGETとAPIキー1つ。これで流れのすべてです。

サンプルデータです。レスポンスの形は実物どおり。

フォーマット
HTTPS上のJSON
認証
ヘッダーのAPIキー
バージョン
初日から/v1
単位
メートル法、時刻はUTC
更新
予報は1日2回更新
期間
7日間、1時間ごと

1回のコールで、全体像を

安定したJSONを初日からバージョン管理。予報レスポンスの形はこちらです。

GET https://api.surf-map.com/v1/spots/anchor-point/forecast

{
  "spot": { "id": "anchor-point", "name": "Anchor Point", "country": "Morocco" },
  "units": "metric",
  "hours": [
    {
      "time": "2026-08-09T08:00Z",
      "waveHeight": 1.8, "wavePeriod": 12, "waveDirection": 305,
      "windSpeed": 7, "windDirection": 71,
      "tide": { "height": 1.2, "state": "rising" },
      "rating": { "beginner": 2, "intermediate": 4, "advanced": 4 }
    }
  ]
}

SDK、MCPサーバー、ツールが読めるドキュメント

自分で全部書く人も、コーディングエージェントに任せる人も、統合にかかるのはスプリントではなく数分であるべきです。

TypeScript SDK

Nodeとサーバーレス向けの型つきクライアント。スポット検索、予報の取得、全フィールドで補完が効きます。インストール1回、ボイラープレートなし。

MCPサーバー

SurfMapをClaude CodeやCursorなどのMCPクライアントにつなげば、コーディングエージェントが構築しながらスポットを調べ、評価つき予報を取得します。

機械も読めるドキュメント

OpenAPI仕様とAPI用のllms.txtを初日から用意。アシスタントにURLをひとつ渡せば、すべてのエンドポイント、フィールド、単位を把握します。

quickstart.ts

import { SurfMap } from '@surfmap/sdk';

const surfmap = new SurfMap({
  apiKey: process.env.SURFMAP_API_KEY,
});

const [spot] = await surfmap.spots.search({
  q: 'hossegor',
});
const forecast = await surfmap.forecast.get(spot.id);

// rated 1 to 5 for each level
forecast.hours[0].rating.intermediate; // 4

.mcp.json

{
  "mcpServers": {
    "surfmap": {
      "type": "http",
      "url": "https://api.surf-map.com/mcp"
    }
  }
}

こんな方に

サーフアプリや個人プロジェクト、サイトにライブコンディションを載せたいサーフスクールやキャンプ、旅行プラットフォーム、ウォッチフェイスやダッシュボード。Magicseaweed APIの終了で行き場を失ったプロジェクトにも。私たちが欲しかった代替をつくっています。

料金

月額のプランと、わかりやすい上限。合うサイズから始めて、トラフィックが増えたら上げてください。

Starter

$39月額

最初の本番アプリに。

  • 1日500コール
  • 1分60コール
  • APIキー2本
  • 本番アプリ1つ
  • リンクつきのクレジット表記
  • メールサポート

Growth

$99月額

伸びはじめたアプリに。

  • 1日2,500コール
  • 1分120コール
  • APIキー5本
  • 複数のアプリ
  • リンクつきのクレジット表記
  • 優先メールサポート

Pro

$249月額

フルボリューム、表記はあなたのブランドだけ。

  • 1日10,000コール
  • 1分300コール
  • APIキー10本
  • アプリと社内ツール
  • クレジット表記は不要
  • 開発者への直通連絡

Scale

応相談

もっと大きな計画に、個別の条件で。

  • 1日25,000コール以上
  • 上限も条件も個別に
  • スポットデータベースのオフライン利用
  • データをプロダクトに組み込み
  • 開発者への直通連絡

アクセスは招待制で、このページに決済はありません。合うプランと、作っているものを一言添えて、メールを送ってください。アカウント、支払い、最初のキーをこちらで用意します。

contact@surf-map.com

すべてのプランに、5つの/v1エンドポイント、TypeScript SDK、MCPサーバー、OpenAPI仕様、llms.txtが含まれます。クレジット表記とは、プロダクト内に「Surf data by SurfMap」のリンクを見える形で置くことです。

SurfMap

アーリーアクセスに申し込む

アカウントを作成し、キーに名前をつければ、数分で最初のコールを送れます。質問や大きめの計画があれば、開発者本人が返信します。

キーを作成

またはメールで、作っているものを教えてください。

気象データにはOpen-Meteo(CC BY 4.0)を含みます。