ClawHub

flight-scout

v0.1.1

调用远程 Flight Scout 商用 API 的 skill。用于用户提供 API base URL 和 API key 后，执行航班搜索、价格日历、同步甩尾查询、异步甩尾任务查询，并返回结构化 JSON 结果。

⭐ 0· 152·1 current·1 all-time
byLinden@ebolaboy

Install

OpenClaw Prompt Flow

Install with OpenClaw

Best for remote or guided setup. Copy the exact prompt, then paste it into OpenClaw for ebolaboy/flight-scout.

Previewing Install & Setup.
Prompt PreviewInstall & Setup
Install the skill "flight-scout" (ebolaboy/flight-scout) from ClawHub.
Skill page: https://clawhub.ai/ebolaboy/flight-scout
Keep the work scoped to this skill only.
After install, inspect the skill metadata and help me finish setup.
Required env vars: FLIGHT_SCOUT_API_BASE_URL, FLIGHT_SCOUT_API_KEY
Required binaries: python3
Use only the metadata you can verify from ClawHub; do not invent missing requirements.
Ask before making any broader environment changes.

Command Line

CLI Commands

Use the direct CLI path if you want to install manually and keep every step visible.

OpenClaw CLI

Bare skill slug

openclaw skills install flight-scout

ClawHub CLI

Package manager switcher

npx clawhub@latest install flight-scout
Security Scan
VirusTotalVirusTotal
Benign
View report →
OpenClawOpenClaw
Benign
high confidence
✓
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.
Assessment
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.

Like a lobster shell, security has layers — review code before you run it.

Runtime requirements

Binspython3
EnvFLIGHT_SCOUT_API_BASE_URL, FLIGHT_SCOUT_API_KEY
Primary envFLIGHT_SCOUT_API_KEY
latestvk97dhsr6837fqkr2995w2m5he584hsxa
152downloads
0stars
1versions
Updated 2w ago
v0.1.1
MIT-0
Linden@ebolaboy
latest
Download

flight-scout

该 skill 目录通常会附带一个 .env.example 模板文件。

推荐做法：

  • 使用官方安装脚本完成安装或更新；脚本会保留现有 .env，只同步受管理文件
  • 如果手动安装，请根据 .env.example 创建本地 .env
  • 本地 .env 用于保存真实接口密钥，不应提交到版本库

本地 .env 里通常包含：

  • FLIGHT_SCOUT_API_BASE_URL
  • FLIGHT_SCOUT_API_KEY
  • FLIGHT_SCOUT_API_TIMEOUT_SECONDS

脚本行为：

  • scripts/call_api.py 会优先自动读取 skill 根目录下的 .env
  • 如果当前 shell 已经显式设置了同名环境变量，则以显式环境变量为准

读取以下环境变量：

  • FLIGHT_SCOUT_API_BASE_URL
  • FLIGHT_SCOUT_API_KEY
  • FLIGHT_SCOUT_API_TIMEOUT_SECONDS，默认 30

调用前必须确认：

  1. 出发机场三字码
  2. 到达机场三字码
  3. 日期
  4. 舱位与乘客数（如未给出，默认 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

Comments

Loading comments...