← 返回 Skills 市场
baizhexue

Domestic Flight Search

作者 baizhexue · GitHub ↗ · v0.1.0 · MIT-0
cross-platform ✓ 安全检测通过
296
总下载
0
收藏
1
当前安装
1
版本数
在 OpenClaw 中安装
/install domestic-flight-search-skill
功能描述
Query China domestic flights with schedules, airline details, airport resolution, and Juhe reference prices. Use when a user asks for domestic China flight o...
使用说明 (SKILL.md)

Domestic Flight Search

Use the local Python script in this skill to query China domestic flights from the Juhe flight API. Tell users they must apply for their own Juhe API key before live queries will work.

Provider docs: https://www.juhe.cn/docs/api/id/818

Setup Requirement

This skill does not ship with an API key. Users must create their own Juhe account, subscribe to the flight API, and set JUHE_FLIGHT_API_KEY before running live searches.

Quick Start

Set the API key first:

export JUHE_FLIGHT_API_KEY='your_juhe_api_key'

Run a direct query:

python3 {baseDir}/scripts/domestic_flight_service.py search \
  --from 北京 --to 上海 --date 2026-03-20 --pretty

Optional reusable local HTTP mode:

python3 {baseDir}/scripts/domestic_flight_service.py serve --port 8765

Then call:

curl 'http://127.0.0.1:8765/search?from=北京&to=上海&date=2026-03-20'

Workflow

  1. Resolve the user's origin and destination. Accept common Chinese city names, airport names, or IATA codes. If the user says “北京首都” or “浦东机场”, keep the airport-specific query.

  2. Query the script. For a single answer, run the CLI. For repeated machine-to-machine calls, use the local HTTP service.

  3. Summarize the result. Mention airline, flight number, departure and arrival airport, departure and arrival time, duration, and ticket_price. Call the price 参考票价, not a guaranteed bookable fare.

  4. Handle ambiguity and missing setup. If the city is not recognized, ask for a specific airport or 3-letter code. If the user wants a round trip, run two one-way queries. If JUHE_FLIGHT_API_KEY is missing, tell the user to apply for a Juhe key and configure it before retrying.

Output Rules

  • Sort results by lowest ticket_price first.
  • Prefer up to 5 options unless the user asked for more.
  • State the exact travel date in YYYY-MM-DD.
  • If the provider returns no results, say that no flight was found for that route/date under the current query.
  • If the provider fails, surface the provider error_code and reason briefly.

Resources

安全使用建议
This skill appears to do what it claims. Before installing or running it: (1) obtain your own Juhe API key and set JUHE_FLIGHT_API_KEY (do not share this key); (2) run the CLI or local HTTP server only on machines you trust — avoid binding the server to a public interface so other hosts cannot trigger queries using your environment key; (3) review the included Python script if you will run it in an environment with sensitive data (it reads only the JUHE_* env vars and the included JSON mapping files); (4) when in doubt, run the test using the bundled sample response first to confirm behavior without contacting the provider.
功能分析
Type: OpenClaw Skill Name: domestic-flight-search-skill Version: 0.1.0 The skill is a legitimate tool for querying Chinese domestic flights using the Juhe API. The Python script (domestic_flight_service.py) uses standard libraries to perform name resolution via local JSON data and fetches flight information from a verified provider endpoint (apis.juhe.cn). There is no evidence of data exfiltration, malicious execution, or prompt injection; the code requires a user-provided API key and defaults to local-only network binding for its optional HTTP service mode.
能力评估
✓ Purpose & Capability
Name/description match the requested artifacts: the skill ships a Python script that queries Juhe's flight API, uses included city/airport mapping data, and declares JUHE_FLIGHT_API_KEY as the primary credential — all of which are expected for a Juhe-based flight lookup tool.
✓ Instruction Scope
SKILL.md directs the agent to run the bundled Python CLI or optional local HTTP server and to obtain a Juhe API key before live queries. The runtime instructions reference only the included data files and the sample response; they do not ask the agent to read unrelated system files or exfiltrate arbitrary data. Note: the optional 'serve' mode opens a local HTTP endpoint (default 127.0.0.1) which will call Juhe using the environment API key — run only on trusted hosts and avoid binding to public interfaces.
✓ Install Mechanism
No install spec is provided; this is instruction-plus-scripts only and requires python3 already on PATH. Nothing is downloaded or written to disk by an installer, which is low risk and proportional to the task.
✓ Credentials
The skill requires a single provider credential (JUHE_FLIGHT_API_KEY, with fallback JUHE_API_KEY) which is necessary and sufficient to call the Juhe API. No unrelated secrets or system credentials are requested. The code reads only those env vars.
✓ Persistence & Privilege
The skill is not forced-always and uses normal agent invocation. It does not modify other skills or system-wide agent settings. The only runtime persistence is an optional local HTTP service (user launches it explicitly).
如何使用
  1. 确保已安装 OpenClaw（本地或 Docker 部署）
  2. 在对话框中输入安装命令：/install domestic-flight-search-skill
  3. 安装完成后，直接呼叫该 Skill 的名称或使用 /domestic-flight-search-skill 触发
  4. 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v0.1.0
- Initial release of the domestic-flight-search skill for querying China domestic flights. - Supports city/airport name to IATA resolution and schedules via Juhe API. - Users must supply their own Juhe API key via the JUHE_FLIGHT_API_KEY environment variable. - Includes command-line and optional local HTTP service modes. - Returns flight options with airline details, airport info, and reference prices. - Handles ambiguous input, missing city/airport, or absent API key with user guidance.
元数据
Slug domestic-flight-search-skill
版本 0.1.0
许可证 MIT-0
累计安装 1
当前安装数 1
历史版本数 1
常见问题

Domestic Flight Search 是什么？

Query China domestic flights with schedules, airline details, airport resolution, and Juhe reference prices. Use when a user asks for domestic China flight o... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 296 次。

如何安装 Domestic Flight Search？

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

Domestic Flight Search 是免费的吗？

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

Domestic Flight Search 支持哪些平台？

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

谁开发了 Domestic Flight Search？

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

推荐 Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463815 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259802 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200680 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191345 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190333 · by oswalpalash

💬 留言讨论