fuel-prices

⛽ Fuel Prices API：以整洁的 JSON 获取美国实时加油站价格

使用 Fuel Prices API 的最高效、可靠且对开发者友好的方式。

Actor 页面： apify.com/johnvc/fuelprices 输入架构： apify.com/johnvc/fuelprices/input-schema

Fuel Prices API 可针对美国任意地点（并覆盖部分加拿大地区），返回实时、由用户报告的加油站价格和站点元数据，并以整洁、结构化的 JSON 格式呈现。可按邮政编码、城市名称或 GPS 坐标搜索，并获取每个站点的一条记录：名称、完整地址、距搜索地点的距离、现金和信用卡价格及其发布时间、价格单位和评分。可选择燃油类型（普通、中级、高级、柴油、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？

站点级详细信息。 每条结果对应一个加油站，包含名称、完整地址、距搜索地点的距离、现金和信用卡价格、价格单位及评分，方便直接比较各个站点。

随心选择搜索方式。 可按邮政编码、城市名称搜索，或直接粘贴地图上的 GPS 坐标。坐标会解析到最近的区域。

燃油类型和新鲜度控制。 可选择普通、中级、高级、柴油、E85 或无铅 88，并使用新鲜度筛选器仅保留近期报告的价格。

仅按结果付费。 按返回的站点数量计费，无设置费、无订阅费，未返回结果的运行也不收费。搜索一个常见城市或邮政编码通常只需几美分。

易于自动化。 只需几行 Python 代码即可调用，也可以将其加载为 MCP 工具，让 Claude 和 Cursor 等助手按需获取实时燃油价格。

功能

核心能力

• 按邮政编码、城市或坐标搜索美国各地（覆盖部分加拿大地区）
• 选择燃油类型：普通、中级、高级、柴油、E85、无铅 88
• 按数据最大天数筛选新鲜度
• 现金和信用卡价格，并附有各自的发布时间
• 站点元数据：名称、地址、距离、评分

数据质量

• 每个站点一条记录，结构稳定
• 分别报告现金和信用卡价格，且各自附有发布时间
• 完整的地址组成部分（地址行 1/2、城市、地区、邮政编码）
• 距离和评分，便于排序和比较
• 每次查询的 JSON 结构一致

使用示例

基本示例

体验 API 最省钱的方式：输入一个邮政编码，查询普通燃油。

{
  "search": "11507"
}

高级示例

按城市搜索柴油，仅获取最新数据。

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

按坐标搜索

直接粘贴地图上的 GPS 坐标。

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

输入参数

参数	类型	必填	默认值	描述
search	string	是	-	地点查询：邮政编码、城市名称或 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 文件名；若省略，则会生成带时间戳的文件名。

输出格式

每个数据集条目对应一个站点。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 token（与 Python 示例中使用的 APIFY_API_TOKEN 相同）。在 https://console.apify.com/settings/integrations 获取 token，并在 https://apify.com?fpr=9n7kx3 免费注册 Apify 账号。

在 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. 添加 Apify MCP 服务，仅预加载这个 Actor：

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

3. 重启应用。Cowork 首次调用该工具时，请在浏览器中完成 OAuth 验证，或在连接器设置中添加 Apify API token 以跳过 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"

若要使用 token 而非浏览器 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 token 进行身份验证，并启用工具 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. 若要使用 token 身份验证而非浏览器 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 并填写表单：
   • 名称： Apify
   • MCP 服务 URL： https://mcp.apify.com/?tools=actors,docs,johnvc/fuelprices
   • 身份验证： 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 Agent 工具使用）。

---

用心打造

使用 Fuel Prices API，为价格监控、比价应用和分析提供可靠、结构化的结果。

精选任务

可直接运行的示例，展示此 API 如何解决特定问题。每个示例都会打开独立的设置页面，让你一键在自己的账户中运行。

• 按燃油类型查找美国任意城市的实时汽油价格 - 搜索美国任意城市，并获取每个加油站的一行数据，包含名称、完整地址、距离、现金和信用卡价格以及评分。
• 查找 GPS 地图坐标附近的汽油价格 - 粘贴地图中的纬度和经度，即可获取附近加油站的价格、距离和评分。
• 按 ZIP 代码查找加油站价格 - 查询美国任意 ZIP 代码对应的加油站，获取完整地址、现金和信用卡价格以及评分。

🤖 向 AI 助手咨询此 Actor

在你选择的 AI 工具中打开一条关于 Fuel Prices API 的即用提示词：

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

最后更新：2026.10.27