← 返回 Skills 市场
159
总下载
0
收藏
1
当前安装
1
版本数
在 OpenClaw 中安装
/install flight-scout
功能描述
调用远程 Flight Scout 商用 API 的 skill。用于用户提供 API base URL 和 API key 后,执行航班搜索、价格日历、同步甩尾查询、异步甩尾任务查询,并返回结构化 JSON 结果。
使用说明 (SKILL.md)
flight-scout
该 skill 目录通常会附带一个 .env.example 模板文件。
推荐做法:
- 使用官方安装脚本完成安装或更新;脚本会保留现有
.env,只同步受管理文件 - 如果手动安装,请根据
.env.example创建本地.env - 本地
.env用于保存真实接口密钥,不应提交到版本库
本地 .env 里通常包含:
FLIGHT_SCOUT_API_BASE_URLFLIGHT_SCOUT_API_KEYFLIGHT_SCOUT_API_TIMEOUT_SECONDS
脚本行为:
scripts/call_api.py会优先自动读取 skill 根目录下的.env- 如果当前 shell 已经显式设置了同名环境变量,则以显式环境变量为准
读取以下环境变量:
FLIGHT_SCOUT_API_BASE_URLFLIGHT_SCOUT_API_KEYFLIGHT_SCOUT_API_TIMEOUT_SECONDS,默认30
调用前必须确认:
- 出发机场三字码
- 到达机场三字码
- 日期
- 舱位与乘客数(如未给出,默认
economy和1)
优先使用脚本:
示例命令:
python3 {baseDir}/scripts/call_api.py search --origin HKG --destination NRT --date 2026-05-01
python3 {baseDir}/scripts/call_api.py calendar --origin PVG --destination CDG --date-start 2026-07-03 --date-end 2026-07-15
接口选择规则:
- 普通航班搜索:调用
search - 机场联想补全:调用
airport-search - 日期区间最低价:调用
calendar - 甩尾票接口选择:
- 如果需要同步直接返回结果,调用
hidden-city-sync - 如果接受异步任务和轮询,调用
hidden-city-job-create - 不需要先调用
hidden-city-sync再决定是否发起hidden-city-job-create - 选择依据主要是“是否需要即时结果”和“调用额度消耗”,不是先做命中判断
- 如果需要同步直接返回结果,调用
- 用量汇总:调用
usage - 当用户询问“已用多少额度 / 剩余多少额度 / 什么时候重置”时,优先调用
usage - 如果业务接口返回
quota_exceeded,继续读取meta.remaining_units、meta.cycle_ends_at、meta.upgrade_required
结果处理要求:
- 直接返回接口 JSON,不要重写字段名
- 如果接口返回错误,保留
request_id、error.code、error.message - 额度相关字段优先读取
data.quota.*;如果是额度拦截错误,则读取meta.remaining_units、meta.included_units、meta.cycle_ends_at - 如果使用异步 job,明确告诉用户当前
job_id和状态 - 如果使用同步查询,就按同步结果直接说明;如果使用异步 job,就按任务状态与最终结果说明
详细接口字段见 references/api-contract.md
安全使用建议
This skill appears to be a straightforward client for a Flight Scout API. Before installing: 1) Verify the FLIGHT_SCOUT_API_BASE_URL is the official/trusted endpoint you expect (the skill will send your API key there). 2) Do not store unrelated secrets in the skill's .env (the script will read it). 3) Review the GitHub homepage/repo (provided) if you want source provenance. If you plan to let the agent invoke the skill autonomously, remember it can make network calls using the configured base URL and API key.
功能分析
Type: OpenClaw Skill
Name: flight-scout
Version: 0.1.1
The flight-scout skill is a standard API wrapper for flight searching and 'hidden city' ticket discovery. The core logic in `scripts/call_api.py` uses Python's standard library to make authenticated requests to a user-defined API endpoint. It includes legitimate functionality for handling API quotas and asynchronous jobs, and the instructions in `SKILL.md` are strictly focused on functional task execution without any signs of prompt injection or malicious intent.
能力评估
Purpose & Capability
Name/description (flight API client) match the declared requirements: python3 plus FLIGHT_SCOUT_API_BASE_URL and FLIGHT_SCOUT_API_KEY. The included script constructs requests to the provided base URL and uses the API key in X-API-Key header—expected for this purpose. No unrelated credentials or binaries are requested.
Instruction Scope
SKILL.md instructs the agent to read a local .env (if present) and environment variables, then call the documented endpoints and return raw JSON. The instructions do not ask the agent to read unrelated system files or transmit data to endpoints other than the configured FLIGHT_SCOUT_API_BASE_URL.
Install Mechanism
No install spec — instruction-only with a bundled Python script. Nothing is downloaded or written by an installer. This is low-risk and appropriate for a small API wrapper.
Credentials
Only two required env vars (base URL and API key) plus an optional timeout are requested; these are proportional to an HTTP API client. Note: the skill will send the provided API key to whatever base URL is configured, so the user should ensure the base URL is trustworthy.
Persistence & Privilege
The skill does not request always:true and does not modify other skills or system-wide config. It only reads a local .env in its own directory and environment variables; this is normal for a skill of this type.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install flight-scout - 安装完成后,直接呼叫该 Skill 的名称或使用
/flight-scout触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v0.1.1
Release Flight Scout skill 0.1.1
元数据
常见问题
flight-scout 是什么?
调用远程 Flight Scout 商用 API 的 skill。用于用户提供 API base URL 和 API key 后,执行航班搜索、价格日历、同步甩尾查询、异步甩尾任务查询,并返回结构化 JSON 结果。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 159 次。
如何安装 flight-scout?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install flight-scout」即可一键安装,无需额外配置。
flight-scout 是免费的吗?
是的,flight-scout 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
flight-scout 支持哪些平台?
flight-scout 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 flight-scout?
由 Linden(@ebolaboy)开发并维护,当前版本 v0.1.1。
推荐 Skills