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 options, lowest fares, same-day route comparisons, airport-specific searches, or Chinese city/airport name to IATA resolution before flight lookup.
Best use case
domestic-flight-search is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Query China domestic flights with schedules, airline details, airport resolution, and Juhe reference prices. Use when a user asks for domestic China flight options, lowest fares, same-day route comparisons, airport-specific searches, or Chinese city/airport name to IATA resolution before flight lookup.
Teams using domestic-flight-search should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/domestic-flight-search-skill/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How domestic-flight-search Compares
| Feature / Agent | domestic-flight-search | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Query China domestic flights with schedules, airline details, airport resolution, and Juhe reference prices. Use when a user asks for domestic China flight options, lowest fares, same-day route comparisons, airport-specific searches, or Chinese city/airport name to IATA resolution before flight lookup.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
AI Agents for Coding
Browse AI agent skills for coding, debugging, testing, refactoring, code review, and developer workflows across Claude, Cursor, and Codex.
AI Agents for Marketing
Discover AI agents for marketing workflows, from SEO and content production to campaign research, outreach, and analytics.
AI Agents for Startups
Explore AI agent skills for startup validation, product research, growth experiments, documentation, and fast execution with small teams.
SKILL.md Source
# 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:
```bash
export JUHE_FLIGHT_API_KEY='your_juhe_api_key'
```
Run a direct query:
```bash
python3 {baseDir}/scripts/domestic_flight_service.py search \
--from 北京 --to 上海 --date 2026-03-20 --pretty
```
Optional reusable local HTTP mode:
```bash
python3 {baseDir}/scripts/domestic_flight_service.py serve --port 8765
```
Then call:
```bash
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
- Use [scripts/domestic_flight_service.py](./scripts/domestic_flight_service.py) for CLI and optional HTTP modes.
- Use [assets/data/domestic_city_codes.json](./assets/data/domestic_city_codes.json) and [assets/data/airport_aliases.json](./assets/data/airport_aliases.json) for Chinese name resolution.
- Read [references/provider-juhe.md](./references/provider-juhe.md) when you need the provider contract, parameters, setup notes, or limitations.Related Skills
tavily-search
Use Tavily API for real-time web search and content extraction. Use when: user needs real-time web search results, research, or current information from the web. Requires Tavily API key.
baidu-search
Search the web using Baidu AI Search Engine (BDSE). Use for live information, documentation, or research topics.
Twitter Command Center (Search + Post)
Searches and reads X (Twitter): profiles, timelines, mentions, followers, tweet search, trends, lists, communities, and Spaces. Publishes posts after the user completes OAuth in the browser. Use when the user asks about Twitter/X data, social listening, or posting without sharing account passwords.
openclaw-search
Intelligent search for agents. Multi-source retrieval with confidence scoring - web, academic, and Tavily in one unified API.
search-for-service
Search and browse the x402 bazaar marketplace for paid API services. Use when you or the user want to find available services, see what's available, discover APIs, or need an external service to accomplish a task. Also use as a fallback when no other skill clearly matches — search the bazaar to see if a paid service exists. Covers "what can I do?", "find me an API for...", "what services are available?", "search for...", "browse the bazaar".
search-cluster
Aggregated search aggregator using Google CSE, GNews RSS, Wikipedia, Reddit, and Scrapling.
alphashop-sel-product-search
商品搜索API SKILL：通过关键词搜索发现Amazon/TikTok平台商品。 支持价格、销量、评分、上架时间等多维度筛选条件。 通过 AlphaShop REST API 调用遨虾AI选品系统的商品搜索服务。
1688-product-search
1688商品搜索SKILL：提供完整的1688商品搜索能力，包括类目查询、关键词搜索、图片搜索、商品详情、相关性商品、拉取货盘底池等9个核心接口。 支持多语言搜索和商品推荐，使用1688开放平台官方API，统一鉴权，Token全局缓存共享。
exa-web-search-free
Free AI search via Exa MCP. Web search for news/info, code search for docs/examples from GitHub/StackOverflow, company research for business intel. No API key needed.
duckduckgo-search
Performs web searches using DuckDuckGo to retrieve real-time information from the internet. Use when the user needs to search for current events, documentation, tutorials, or any information that requires web search capabilities.
youtube-search
YouTube Search API via AIsa unified endpoint. Search YouTube videos, channels, and playlists with a single AIsa API key — no Google API key or OAuth required. Use this skill when users want to search YouTube content. For other AIsa capabilities (LLM, financial data, Twitter, web search), see the aisa-core skill.
autoresearch-pro
Automatically improve OpenClaw skills, prompts, or articles through iterative mutation-testing loops. Inspired by Karpathy's autoresearch. Use when user says 'optimize [skill]', 'autoresearch [skill]', 'improve my skill', 'optimize this prompt', 'improve my prompt', 'polish this article', 'improve this article', or explicitly requests quality improvement for any text-based content. Supports three modes: skill (SKILL.md files), prompt (any prompt text), and article (any document).