How do I install the Serpapi Flights skill?

Run npx skillmds@latest add modbender/serpapi-flights in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Serpapi Flights safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Serpapi Flights?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Serpapi Flights free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Serpapi Flights?

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Serpapi Flights by modbender — Agent Skill

Name: Serpapi Flights
Rating: 4.5 (4 reviews)
Author: modbender

File contents

SerpApi Flights (Google Flights)

Query real-time flight data from Google Flights via SerpApi. Returns airline, flight number, times, prices, aircraft type, and cabin class info.

Setup

export SERPAPI_KEY=your_api_key

Free tier: 100 searches/month at serpapi.com

Query Flights

node {baseDir}/scripts/query.mjs <FROM> <TO> [-d YYYY-MM-DD] [options]

FROM/TO can be IATA codes (HKG, PVG) or Chinese city names (香港, 上海).

Examples

# Basic query
node {baseDir}/scripts/query.mjs HKG PVG -d 2026-02-25

# Business class
node {baseDir}/scripts/query.mjs HKG PVG -d 2026-02-25 -c 3

# All cabin classes (economy + business)
node {baseDir}/scripts/query.mjs HKG PVG -d 2026-02-25 --all

# Direct flights only
node {baseDir}/scripts/query.mjs 香港 上海 -d 2026-02-25 --direct

# Round trip
node {baseDir}/scripts/query.mjs HKG PVG -d 2026-02-25 -r 2026-03-01

# JSON output
node {baseDir}/scripts/query.mjs HKG PVG -d 2026-02-25 --json

Options

-d, --date <YYYY-MM-DD>: Departure date (default: today)
-r, --return <YYYY-MM-DD>: Return date (makes it round-trip)
-c, --class <1-4>: 1=economy, 2=premium economy, 3=business, 4=first
--all: Query economy + business together
-a, --adults <n>: Passengers (default: 1)
--direct: Non-stop flights only
--currency <code>: Currency (default: CNY)
--json: Raw JSON output

Output Columns

Column	Meaning
航空公司	Airline name
航班号	Flight number
出发→到达	Departure → arrival time (+1 = next day)
飞行时间	Total duration
经停	Non-stop or number of stops
价格	Price in specified currency
机型	Aircraft type
延误	⚠️ = often delayed >30min

Supported Cities (Chinese)

北京上海广州深圳成都重庆杭州南京武汉西安长沙昆明厦门青岛大连天津郑州沈阳哈尔滨海口三亚贵阳南宁福州济南合肥太原乌鲁木齐兰州珠海温州宁波无锡揭阳/潮汕/汕头香港澳门台北

Notes

Prices from Google Flights, may differ from airline direct prices
No seat availability/remaining tickets (Google Flights limitation)
Some flights show "待查" price when Google doesn't have pricing
⚠️ delay indicator based on historical data

---name: serpapi-flightsdescription: Query Google Flights via SerpApi for flight schedules, prices, and cabin class info. Use when user asks about flight/机票/航班 prices, schedules, or comparisons.--- # SerpApi Flights (Google Flights) Query real-time flight data from Google Flights via SerpApi. Returns airline, flight number, times, prices, aircraft type, and cabin class info. ## Setup ```bash export SERPAPI_KEY=your_api_key ``` Free tier: 100 searches/month at serpapi.com ## Query Flights ```bash node {baseDir}/scripts/query.mjs <FROM> <TO> [-d YYYY-MM-DD] [options] ``` FROM/TO can be IATA codes (HKG, PVG) or Chinese city names (香港, 上海). ### Examples ```bash # Basic query node {baseDir}/scripts/query.mjs HKG PVG -d 2026-02-25 # Business class node {baseDir}/scripts/query.mjs HKG PVG -d 2026-02-25 -c 3 # All cabin classes (economy + business) node {baseDir}/scripts/query.mjs HKG PVG -d 2026-02-25 --all # Direct flights only node {baseDir}/scripts/query.mjs 香港上海 -d 2026-02-25 --direct # Round trip node {baseDir}/scripts/query.mjs HKG PVG -d 2026-02-25 -r 2026-03-01 # JSON output node {baseDir}/scripts/query.mjs HKG PVG -d 2026-02-25 --json ``` ### Options - `-d, --date <YYYY-MM-DD>`: Departure date (default: today) - `-r, --return <YYYY-MM-DD>`: Return date (makes it round-trip) - `-c, --class <1-4>`: 1=economy, 2=premium economy, 3=business, 4=first - `--all`: Query economy + business together - `-a, --adults <n>`: Passengers (default: 1) - `--direct`: Non-stop flights only - `--currency <code>`: Currency (default: CNY) - `--json`: Raw JSON output ### Output Columns | Column | Meaning | |--------|---------| | 航空公司 | Airline name | | 航班号 | Flight number | | 出发→到达 | Departure → arrival time (+1 = next day) | | 飞行时间 | Total duration | | 经停 | Non-stop or number of stops | | 价格 | Price in specified currency | | 机型 | Aircraft type | | 延误 | ⚠️ = often delayed >30min | ### Supported Cities (Chinese) 北京上海广州深圳成都重庆杭州南京武汉西安长沙昆明厦门青岛大连天津郑州沈阳哈尔滨海口三亚贵阳南宁福州济南合肥太原乌鲁木齐兰州珠海温州宁波无锡揭阳/潮汕/汕头香港澳门台北 ## Notes - Prices from Google Flights, may differ from airline direct prices - No seat availability/remaining tickets (Google Flights limitation) - Some flights show "待查" price when Google doesn't have pricing - ⚠️ delay indicator based on historical data

Frequently asked questions

Serpapi Flights