fuel-prices

⛽ Fuel Prices API：米国のガソリンスタンド価格をリアルタイムでクリーンな JSON 形式で取得

Fuel Prices API を利用する、最も効率的で信頼性が高く、開発者に優しい方法です。

アクターページ： apify.com/johnvc/fuelprices 入力スキーマ： apify.com/johnvc/fuelprices/input-schema

Fuel Prices API は、米国内の任意の場所（カナダの一部地域にも対応）について、投稿された最新のガソリンスタンド価格とスタンドのメタデータを、クリーンで構造化された JSON 形式で返します。ZIP コード、市区町村名、GPS 座標で検索すると、スタンドごとに 1 件のレコードが返されます。レコードには、スタンド名、住所全体、検索地点からの距離、現金価格とクレジットカード価格および投稿時刻、価格の単位、評価が含まれます。燃料の種類（レギュラー、ミッドグレード、プレミアム、ディーゼル、E85、または無鉛 88）を選択し、データの新しさで絞り込めます。

動画での解説

クイックスタート

前提条件

• Python 3.11 以降
• Apify アカウントと API キー（こちらから無料のキーを取得）

1. リポジトリをクローンする

   git clone https://github.com/johnisanerd/Apify-Fuel-Prices-Scraper.git
   cd Apify-Fuel-Prices-Scraper
   

2. UV で依存関係をインストールする

   # Install UV if you do not have it:
   curl -LsSf https://astral.sh/uv/install.sh | sh
   
   # Install project dependencies:
   uv sync
   

3. API キーを設定する

   cp .env.example .env
   # Edit .env and add your Apify API key
   # Get your free API key at: https://apify.com?fpr=9n7kx3
   

4. サンプルを実行する

   uv run python fuel-prices-scraper.py
   

代替方法：API キーを直接設定する

export APIFY_API_TOKEN="your_api_key_here"
uv run python fuel-prices-scraper.py

Fuel Prices API を使う理由

スタンド単位の詳細情報。 各結果は 1 つのガソリンスタンドを表し、スタンド名、住所全体、検索地点からの距離、現金価格とクレジットカード価格、価格の単位、評価が含まれるため、スタンドを直接比較できます。

好きな方法で検索。 ZIP コード、市区町村名、または地図からそのまま貼り付けた GPS 座標で検索できます。座標は最寄りの地域に対応付けられます。

燃料の種類とデータの新しさを指定。 レギュラー、ミッドグレード、プレミアム、ディーゼル、E85、無鉛 88 を選択し、新しさのフィルターを使って、最近投稿された価格だけに絞り込めます。

結果に対してのみ支払い。 料金は返されたスタンドごとに発生します。初期費用、サブスクリプションはなく、結果が返されなかった実行には料金がかかりません。市区町村や ZIP コードでの一般的な検索なら、費用は数セントです。

簡単に自動化。 Python から数行で呼び出すか、MCP ツールとして読み込めば、Claude や Cursor などのアシスタントが必要に応じて最新の燃料価格を取得できます。

機能

主な機能

• 米国内の場所（カナダの一部地域にも対応）を ZIP コード、市区町村、または座標で検索
• 燃料の種類を選択：レギュラー、ミッドグレード、プレミアム、ディーゼル、E85、無鉛 88
• データの最大経過日数で 新しさを絞り込み
• 現金価格とクレジットカード価格および価格ごとの投稿時刻
• スタンドのメタデータ：名前、住所、距離、評価

データ品質

• スタンドごとに 1 件のレコードを一貫した構造で提供
• 現金価格とクレジットカード価格を別々に報告し、それぞれに投稿時刻を付記
• 住所の構成要素全体（住所 1 行目／2 行目、市区町村、地域、郵便番号）
• ランキングや比較に使える 距離と評価
• すべての検索で一貫した JSON の形式

使用例

基本的な例

API を最も安価に試す方法：ZIP コードを 1 つ指定して、レギュラー燃料を検索します。

{
  "search": "11507"
}

応用例

ディーゼルを市区町村で検索し、最も新しいデータだけを取得します。

{
  "search": "New York, NY",
  "fuel": 4,
  "lang": "en",
  "maxAge": 3
}

座標で検索

地図から GPS 座標をそのまま貼り付けます。

{
  "search": "36.0816642, -115.0534345",
  "fuel": 1
}

入力パラメーター

パラメーター	型	必須	デフォルト	説明
search	string	はい	-	場所の検索クエリ：ZIP コード、市区町村名、または lat, lng 座標。
fuel	integer	いいえ	1	燃料の種類：1 レギュラー、2 ミッドグレード、3 プレミアム、4 ディーゼル、5 E85、12 無鉛 88。
lang	string	いいえ	en	ローカライズされたフィールドの言語コード（現在は en のみ対応）。
maxAge	integer	いいえ	0	価格データの最大経過日数。0 を指定すると、価格の報告時期にかかわらず、すべてのスタンドが返されます。
output_file	string	いいえ	（なし）	任意の CSV ファイル名。省略すると、タイムスタンプ付きの名前が生成されます。

出力形式

データセットの各項目につき1つのステーションです。ZIP コード 11507 の実際の結果：

{
  "id": "56437",
  "name": "Sunoco",
  "distance": null,
  "priceUnit": "dollars_per_gallon",
  "ratingsCount": 45,
  "starRating": 4.4,
  "address_line1": "993 Willis Ave",
  "address_line2": "",
  "address_locality": "Albertson",
  "address_region": "NY",
  "address_postalCode": "11507",
  "price_credit": 4.47,
  "price_credit_postedTime": "2026-05-28T10:04:12.551Z",
  "price_cash": 4.25,
  "price_cash_postedTime": "2026-05-28T10:04:12.536Z"
}

---

MCP ツールとして使用する

Fuel Prices API を MCP ツールとして読み込むと、アシスタントから呼び出せるようになります。MCP サーバーの URL には、この Actor だけが事前に読み込まれています：

https://mcp.apify.com/?tools=actors,docs,johnvc/fuelprices

ブラウザーで OAuth 認証を行うか、Apify API トークン（Python の例で使用しているものと同じ APIFY_API_TOKEN）を使って認証してください。トークンは https://console.apify.com/settings/integrations で取得できます。無料の Apify アカウントは https://apify.com?fpr=9n7kx3 で作成できます。

Claude Cowork Desktop にインストールする

Cowork はデスクトップアプリの自動化モードです。Fuel Prices API をツールとして使えるようにするには、Apify MCP サーバーをコネクターとして追加します。

1. Claude デスクトップアプリを開き、Settings → Connectors に移動します（または Settings → Developer → Edit Config に移動して、claude_desktop_config.json を直接編集します）。
   • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows：%APPDATA%\Claude\claude_desktop_config.json
2. この Actor だけが事前に読み込まれた Apify MCP サーバーを追加します：

{
  "mcpServers": {
    "apify": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.apify.com/?tools=actors,docs,johnvc/fuelprices"
      ]
    }
  }
}

3. アプリを再起動します。Cowork が初めてツールを呼び出すときに、ブラウザーで OAuth プロンプトに応答するか、コネクターの設定で Apify API トークンを追加して OAuth を省略します。
4. Cowork のチャットで、ツールが利用可能であることを確認し、Fuel Prices API を実行するよう依頼します。

デスクトップアプリをダウンロードして、無料トライアルを開始してください：https://claude.ai/referral/uIlpa7nPLg 詳しくはこちら：https://docs.apify.com/platform/integrations/claude-desktop

Claude Code にインストールする

Claude Code はコマンドラインツールです。次のコマンドで Actor の MCP サーバーを追加します：

claude mcp add --transport http apify \
  "https://mcp.apify.com/?tools=actors,docs,johnvc/fuelprices"

ブラウザーでの OAuth 認証の代わりにトークンを使うには：

claude mcp add --transport http apify \
  "https://mcp.apify.com/?tools=actors,docs,johnvc/fuelprices" \
  --header "Authorization: Bearer YOUR_APIFY_TOKEN"

claude mcp list を実行するか、セッション内で /mcp を実行して確認します。Claude Code に Fuel Prices API を呼び出すよう依頼してください。

Claude Code を無料でお試しください：https://claude.ai/referral/uIlpa7nPLg Claude Code の MCP ドキュメント：https://code.claude.com/docs/en/mcp

Claude（ウェブサイト）にインストールする

claude.ai では、Apify をコネクターとして追加し、この Actor のツールだけを有効にします。

1. Settings → Connectors → Browse connectors に移動し、Apify MCP server を検索します。インストールします（プロンプトが表示された場合は、有効化または更新してください）。
2. 接続時に Apify API トークンで認証し、johnvc/fuelprices ツールを有効にします。
3. 任意のチャットで + → Connectors を開き、Apify をオンにします。
4. または、Add custom connector を選択して、完全な MCP URL https://mcp.apify.com/?tools=actors,docs,johnvc/fuelprices を貼り付けます。プロンプトが表示されたら OAuth を使用します。
5. Claude に Fuel Prices API を実行するよう依頼します。

ウェブで Claude を開く：https://claude.ai/referral/uIlpa7nPLg

Cursor にインストールする

Cursor は、プロジェクトファイル .cursor/mcp.json から MCP サーバーを読み込みます。

1. プロジェクト内に .cursor/mcp.json を作成します：

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com/?tools=actors,docs,johnvc/fuelprices"
    }
  }
}

2. ブラウザーでの OAuth 認証の代わりにトークン認証を使う場合は、ヘッダーを追加します：

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com/?tools=actors,docs,johnvc/fuelprices",
      "headers": { "Authorization": "Bearer YOUR_APIFY_TOKEN" }
    }
  }
}

3. Cursor → Settings → MCP を開き、apify サーバーが接続されていること（緑色の点）を確認します。
4. Composer または Chat で、Cursor に Fuel Prices API を呼び出すよう依頼します。

Cursor を初めて使う方はこちら：https://cursor.com/referral?code=XQP4VBLI3NNX

ChatGPT へのインストール

ChatGPT は開発者モードを通じて Apify MCP サーバーに接続します（ChatGPT Pro、Plus、Business、Enterprise、Education プランで利用できます）。

1. プロフィールアイコンをクリックし、Settings > Apps に移動します。Create app ボタンが表示されない場合は、Advanced settings を開き、Developer mode を有効にします。
2. Create app をクリックして、フォームに入力します。
   • Name： Apify
   • MCP Server URL： https://mcp.apify.com/?tools=actors,docs,johnvc/fuelprices
   • Authentication： OAuth
3. Create をクリックし、Apify との接続を認証します。
4. 会話でアプリを使用するには、チャット内の + をクリックし、Developer mode を選択して、Apify を選びます。

詳しい情報：https://docs.apify.com/platform/integrations/mcp

n8n 連携

n8n コミュニティノードとして利用できます：n8n-nodes-fuel-prices-api。n8n で Settings、Community Nodes を開き、n8n-nodes-fuel-prices-api をインストールすると、任意のワークフローで Fuel Prices ノードを使用できます（AI エージェントのツールとしても動作します）。

---

心を込めて作成

Fuel Prices API を活用して、信頼性の高い構造化された結果を用いた価格モニタリング、比較アプリ、分析を実現しましょう。

注目のタスク

この API で特定の問題を解決する、すぐに実行できるサンプルです。それぞれ専用の設定画面が開き、ワンクリックでご自身のアカウントから実行できます。

• 米国内の任意の都市で、燃料の種類別に最新のガソリン価格を検索 - 米国内の任意の都市を検索し、各スタンドの名前、住所全体、距離、現金・クレジットカードの価格、評価を1行ずつ取得します。
• GPS 地図座標の近くにあるガソリン価格を検索 - 地図から緯度と経度を貼り付けると、価格、距離、評価とともに近くのスタンドを取得できます。
• 郵便番号からガソリンスタンドの価格を検索 - 米国内の任意の ZIP コードを対象に、住所全体、現金・クレジットカードの価格、評価とともにスタンドを検索します。

🤖 AI アシスタントにこの Actor について質問する

お好みの AI で Fuel Prices API についてすぐに送信できるプロンプトを開きます。

• 💬 ChatGPT
• 🧠 Claude
• 🔍 Perplexity
• 🅒 Copilot

最終更新日：2026.10.27