← 返回 Skills 市场

Fuel CLI

Name: Fuel CLI
Author: shan8851

作者 shan8851 · GitHub ↗ · v0.1.0 · MIT-0

cross-platform ✓ 安全检测通过

110

总下载

当前安装

版本数

在 OpenClaw 中安装

/install fuel-cli

功能描述

UK fuel prices CLI — find nearby stations by postcode or coordinates, get station details, ranked by price/distance/freshness, and agent-friendly JSON envelo...

使用说明 (SKILL.md)

fuel-cli

Use fuel for UK fuel prices: nearby station search, station detail, ranked results with freshness tracking.

Setup

npm install -g @shan8851/fuel-cli
Register at https://www.fuel-finder.service.gov.uk for Fuel Finder OAuth credentials
export FUEL_FINDER_CLIENT_ID=*** and export FUEL_FINDER_CLIENT_SECRET=*** or add to .env
Warm cache reads work without credentials until the cache needs a refresh

Nearby Stations

By postcode: fuel near "SE1 9SG" --fuel E10
By coordinates: fuel near "51.501,-0.141" --fuel B7_STANDARD
Custom radius: fuel near "SE1 9SG" --fuel E10 --radius 8mi
Sort options: fuel near "SE1 9SG" --fuel E10 --sort price (best, price, distance, freshest)
Limit results: fuel near "SE1 9SG" --fuel E10 --limit 5
Force refresh: fuel near "SE1 9SG" --fuel E10 --refresh

Station Detail

By name: fuel station "tesco watford"
By node ID: fuel station "\x3Cnode-id>"
Project one field: fuel station "\x3Cnode-id>" --output station.prices.0.pencePerLitre
Project subtree: fuel station "\x3Cnode-id>" --output station.openingTimes

Fuel Types

E10 — E10 unleaded petrol
E5 — Super unleaded petrol
B7_STANDARD — Standard diesel
B7_PREMIUM — Premium diesel
B10 — B10 biodiesel
HVO — HVO diesel

Output

Defaults to text in a TTY and JSON when piped
Force JSON: fuel near "SE1 9SG" --fuel E10 --json
Force text: fuel near "SE1 9SG" --fuel E10 --text
Disable colour: fuel --no-color near "SE1 9SG" --fuel E10
Success envelope: { ok, schemaVersion, command, requestedAt, data }
Error envelope: { ok, schemaVersion, command, requestedAt, error }

Agent Notes

--fuel is required on near — petrol and diesel are never mixed in one ranking
--output \x3Cpath> is available on both near and station
Paths use dot notation with zero-based array indexes, for example stations.0.selectedPricePencePerLitre or station.prices.0.pencePerLitre
In text mode, scalar projections print just the value; object or array projections print plain JSON
Projection errors are structured: malformed paths return INVALID_INPUT, missing paths return NOT_FOUND
Data-quality advisories live under data.quality.advisories — warn about stale prices, missing timestamps, and excluded test stations
data.quality.freshnessCounts breaks down fresh/aging/stale/unknown price counts
Likely test/demo forecourts are excluded automatically when normal stations exist; count is in data.quality.excludedLikelyTestStations

Configuration

FUEL_FINDER_CLIENT_ID — required for live data (free registration)
FUEL_FINDER_CLIENT_SECRET — required for live data
FUEL_FINDER_BASE_URL — optional, defaults to https://www.fuel-finder.service.gov.uk
FUEL_CACHE_DIR — optional, override cache location (defaults to platform cache dir)

Notes

near requires --fuel so petrol and diesel results are never mixed
Accepts UK postcodes (SE1 9SG) and coordinates (51.501,-0.141)
Radius accepts unitless (miles) or with mi/km suffix
Persistent local cache for station and price data — works offline until cache expires
Prices include freshness bands (fresh \x3C 30min, aging \x3C 24h, stale > 24h, unknown)
Exit codes: 0 success, 2 bad input or ambiguity, 3 upstream failure, 4 internal error
When a station query is ambiguous, the error includes candidate suggestions with brand, address, postcode, and node ID

安全使用建议

This skill appears to do what it says: a CLI that queries UK Fuel Finder data and requires Fuel Finder OAuth credentials. Before installing: 1) Verify the npm package (@shan8851/fuel-cli) and its source repository (look for a reputable GitHub repo, commit history, and matching homepage) to ensure the published package matches the source. 2) Avoid committing FUEL_FINDER_CLIENT_SECRET to version control or public .env files; store secrets in a secure credential store and rotate them if exposed. 3) If you prefer reduced risk, inspect the package contents or run it in an isolated environment (container or VM) before installing globally. 4) If the government provides an official client, prefer that over third-party packages.

功能分析

Type: OpenClaw Skill Name: fuel-cli Version: 0.1.0 The fuel-cli skill bundle provides a legitimate interface for querying UK fuel prices using the official government Fuel Finder API. It requires standard OAuth credentials (FUEL_FINDER_CLIENT_ID/SECRET) and includes detailed instructions for the agent to handle structured JSON output and data-quality advisories. No evidence of data exfiltration, malicious execution, or harmful prompt injection was found in SKILL.md or _meta.json.

能力标签

requires-oauth-tokenrequires-sensitive-credentials

能力评估

✓ Purpose & Capability

Name/description, required binary ('fuel'), required env vars (FUEL_FINDER_CLIENT_ID, FUEL_FINDER_CLIENT_SECRET), and the install spec (npm @shan8851/fuel-cli) are coherent: a client ID/secret for the Fuel Finder API is expected for live queries.

✓ Instruction Scope

SKILL.md instructs only to install the CLI, set OAuth env vars, and run the 'fuel' commands. It does not direct the agent to read unrelated files or exfiltrate data. It does mention storing credentials in a .env file and optional env vars (FUEL_FINDER_BASE_URL, FUEL_CACHE_DIR) that are reasonable for configuration.

ℹ Install Mechanism

Install uses an npm package that creates the 'fuel' binary (expected). Npm installs carry moderate risk compared with no-install skills; the package owner (@shan8851) and homepage (fuel-cli.xyz) are not verified in this manifest — you should confirm the package's provenance, inspect its repository, and prefer official or well-known sources where possible.

✓ Credentials

Requested environment variables are proportional: client ID and secret for the Fuel Finder service are needed for live data. The SKILL.md also documents optional env vars (base URL, cache dir); these are reasonable. No unrelated credentials or broad system secrets are requested.

✓ Persistence & Privilege

Skill is not always-enabled and can be invoked by the user; it does not request elevated persistence or modify other skills. The CLI uses a local persistent cache, which is documented and expected for offline/warm-cache behavior.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install fuel-cli
安装完成后，直接呼叫该 Skill 的名称或使用 /fuel-cli 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v0.1.0

Initial publish with OpenClaw metadata

元数据

Slug fuel-cli

版本 0.1.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题

Fuel CLI 是什么？

UK fuel prices CLI — find nearby stations by postcode or coordinates, get station details, ranked by price/distance/freshness, and agent-friendly JSON envelo... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 110 次。

如何安装 Fuel CLI？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install fuel-cli」即可一键安装，无需额外配置。

Fuel CLI 是免费的吗？

是的，Fuel CLI 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。

Fuel CLI 支持哪些平台？

Fuel CLI 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Fuel CLI？

由 shan8851（@shan8851）开发并维护，当前版本 v0.1.0。