エージェントのコーディング用、新しいMapbox CLI

新しい「Mapbox 」CLIをインストールできるようになりました。これは、あらゆるアプリケーションに位置情報を追加できるオープンソースのコマンドラインツールであり、Codex、Claude Code、Cursorといったコーディングエージェントにも同様の機能を提供します。

CLI を使用すると、ターミナル上でMapbox を利用できるようになり、トークンの管理、住所のジオコーディング、到着予定時刻（ETA）の取得、地図の表示といった詳細な処理を自動的に行います。

macOS または Linux にインストールします（Windows については、https://github.com/、mapbox 、mapbox-cli をご参照ください）
curl -fsSL https://cli.mapbox.com/install.sh | sh

# 認証 - これにより、ブラウザが起動し、 ログインやアカウント作成の ログインやアカウント作成のサポート）
mapbox auth login

# ログイン状態の確認 状態 ユーザー
mapbox auth whoami

# 利用可能なコマンドを確認する
mapbox --help

# 検索 「 「coffee」と「travel」を含む検索 の時間 徒歩
mapbox 検索実行 --q coffee --poi-category coffee \
  --proximity -73.9742,40.7644 \
  --eta-type ナビゲーション --navigation-profile 徒歩 --origin -73.9742,40.7644 \
  --limit 5 -o json \
| jq -r '.features[].properties|"\(.eta|round) min  \(.name)"'

2分  Sip and Co
3分  スターバックス
4分  Blank Street
4分  スターバックス
5分  Zibetto Espresso Bar

# 静的マップを表示する
mapbox static get-image streets-v12 "pin-l-restaurant+f74e4e(-122.4194,37.7749)" \
  -122.4194 37.7749 15 0 0 800 600 "@2x" .png --usernamemapbox > map.png
ファイル map.png
map.png: PNG画像データ、1600 x 1200

エージェント向けに開発されました

コーディングエージェントは、解析可能な出力、任意のコマンドを学習する方法、変更内容を安全にプレビューする方法、そして明確なエラー表示を提供することで、人間の操作なしにCLIを操作することができます。2つのエージェントスキルにより、その操作はスムーズになります。インストール方法は以下の通りです：

#Mapbox CLI を説明するスキルを作成してくださいのコマンドを説明するスキルを作成する
mapbox generate-skills

#Mapbox エージェントスキルをインストールする
mapbox agent-skills install

対話型ターミナルでは、CLIの出力は人間が読みやすい形式ですが、エージェントはデフォルトでAPIのレスポンス全体をJSON形式で受け取ります。また、 -o json JSONを明示的に要求するには。 

mapbox geocoder forward --q "1600 Pennsylvania Avenue NW, Washington, DC" --limit 1 -o json
{
  "attribution": "NOTICE: © 2026 Mapbox and its suppliers. All rights reserved. Use of this data is subject to the Mapbox Terms of Service (https://www.mapbox.com/about/maps/). This response and the information it contains may not be retained.",
  "features": [
    {
      "geometry": {
        "coordinates": [
          -77.036574,
          38.897684
        ],
        "type": "Point"
      },
      "id": "dXJuOm1ieGFkcjo0ZDQzYzljYy03OGI1LTQwOGUtYTAxNC0zZjQ5MmIzNWU0YjY",
      "properties": {
        "context": {
          "address": {
            "address_number": "1600",
            "mapbox_id": "dXJuOm1ieGFkcjo0ZDQzYzljYy03OGI1LTQwOGUtYTAxNC0zZjQ5MmIzNWU0YjY",
            "name": "1600 Pennsylvania Avenue Northwest",
            "street_name": "Pennsylvania Avenue Northwest"
          },
...

～を通り過ぎて --スキーマ コマンドの引数を指定すると、その引数、型、必須フィールド、許容値、および送信されるリクエストがJSON形式で返されます。認証情報は不要で、API呼び出しも行われません。出力はCLIが実行するのと同じコマンド定義に基づいているため、インストールされているバージョンと一致します。

その --dry-run 変更を伴うコマンドの引数では、パラメータが解決され、読み込まれます --データ そして --ファイル、実際の呼び出しと同じ検証を行います。トークンを伏せた状態でリクエストを出力し、APIには送信しません。

エラーは以下の場所に書き込まれます stderr JSONオブジェクトとして。これには、機械可読なエラーコード、簡単な修正方法、および以下のリストが含まれます： 次のアクション 実行するためです。エージェントは、メッセージ本文全体を解析することなく、エラーコードに基づいて処理を行うことができます。

エージェントがプロンプトに基づいてサンフランシスコを構築する様子をご覧ください

Claude Codeは、Mapbox のCLIを使用して、1つのプロンプトごとにサンフランシスコのライブ3Dマップを作成します。最初はフェリー・ビルディング周辺の平面地図から始まり、その後、3Dの建物、ファサード、車線レベルの道路が追加されていきます。スタイルの変更ごとに、 --dry-run Mapbox アカウントで「ライブスタイル」を編集する前に。その後、道路を走る車や、歩いたり自転車に乗ったりする人々によって、街に活気があふれてきます。そして、光が夜へと移り変わる中、トランスアメリカ・ピラミッドからセールスフォース・タワーへと飛び立つシーンで締めくくられます。

エージェントは各ステップを自ら選択し、ターミナルからビルド全体を実行しました。スタイリングとジオコーディングにはMapbox のCLIを使用し、ルート設定にはDirections APIを活用しました。

このワークフローは、Codex、Cursor、Copilotでも同様に機能します。

オープンソースで、今後もさらに追加される予定です

Mapbox のCLIは、GitHubでMITライセンスのもと公開されています。今後のリリースでは、Mapbox の公開APIの大部分に対応範囲を拡大する予定です。また、Homebrewのサポート、シェルのオートコンプリート、バージョン通知の追加に加え、長時間実行されるワークフローへの対応も強化される予定です。 

ターミナルでMapbox のAPIを使いたいですか？ワークフローを簡素化したいですか？それとも、開発者やエージェントに向けたアイデアをお持ちですか？GitHubでイシューを作成してください。プルリクエストも大歓迎です。

ぜひ今日お試しください

Mapbox のCLIが本日より利用可能になりました。ドキュメントをお読みになり、インストールして、サインインしてください。その後、現在取り組んでいるプロジェクトに対してコマンドを実行するか、新しいプロジェクトを作成してみてください。