Official Fuel Prices
Live official fuel station prices for France, Spain, Italy and Western Australia in one schema.
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
claude mcp add --transport http official-fuel-prices 'https://mcp.apify.com?tools=sste/official-fuel-prices' --header 'Authorization: <Apify API token as '\''Bearer <token>'\'' (free Apify account; pay per result returned)>'
{
"mcpServers": {
"official-fuel-prices": {
"type": "http",
"url": "https://mcp.apify.com?tools=sste/official-fuel-prices",
"headers": {
"Authorization": "<Apify API token as 'Bearer <token>' (free Apify account; pay per result returned)>"
}
}
}
}
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
Official Fuel Prices API — examples (France, Spain, Italy, Western Australia)
Docs and guides: https://fuel-prices-api.pages.dev/?utm_source=github&utm_medium=referral&utm_campaign=examples
Runnable examples for Official Fuel Prices, an API that returns station-level petrol, diesel, LPG, CNG and hydrogen prices for ~46,000 stations from official government open data (DGCCRF France, MITECO Spain, MIMIT Italy, FuelWatch Western Australia), normalized into one JSON schema with coordinates, ISO timestamps, currency, unit, source and licence on every row.
| Example | What it does |
|---|---|
curl/cheapest-diesel-paris.sh | One HTTP call: 10 cheapest diesel stations within 3 km of Paris |
python/cheapest_nearby.py | CLI: cheapest stations near any coordinates |
python/brand_summary_pandas.py | Median price by brand around Madrid with pandas |
javascript/cheapest-nearby.mjs | Node.js: cheapest stations near a point |
mcp/ | Claude Desktop / Cursor config and example prompts for AI agents |
Setup
- Get an Apify API token: https://console.apify.com/settings/integrations (free account; pay per use).
export APIFY_TOKEN=...- Run any example.
MCP (AI agents)
Server URL: https://mcp.apify.com?tools=sste/official-fuel-prices — works with Claude, Cursor, VS Code and other
MCP clients (OAuth sign-in on first use). Local: npx @apify/actors-mcp-server --tools sste/official-fuel-prices.
Pricing
$0.005 per run + $0.0005 per price row (a "10 cheapest stations" query ≈ $0.01).
Data sources and licences
France: data.economie.gouv.fr (DGCCRF), Licence Ouverte v2.0 · Spain: Geoportal Gasolineras (MITECO), reuse under Ley 37/2007 · Italy: MIMIT Osservaprezzi, IODL 2.0 · Western Australia: FuelWatch. Independent project, not affiliated with these agencies. Examples are MIT-licensed.
الأسئلة الشائعة
ما هو Official Fuel Prices؟
Live official fuel station prices for France, Spain, Italy and Western Australia in one schema.
كيف أثبّت Official Fuel Prices؟
يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http official-fuel-prices 'https://mcp.apify.com?tools=sste/official-fuel-prices' --header 'Authorization: <Apify API token as '\''Bearer <token>'\'' (free Apify account; pay per result returned)>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج Official Fuel Prices إلى مفتاح API؟
نعم. يتطلب Authorization، وتضبطها في إعداداته.
هل Official Fuel Prices مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون Official Fuel Prices؟
ينشره SSTEmpresarial. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.