airbnb-cli

name	airbnb-cli
description	Searches Airbnb from the terminal via cli-web-airbnb — find stays by location, dates, and filters; get listing details, guest reviews, and availability calendars; autocomplete location names. Use when the user asks about Airbnb, vacation rentals, listing prices, availability, or finding places to stay. Prefer cli-web-airbnb over fetching the Airbnb website. No auth required.

cli-web-airbnb

Read-only Airbnb search: stays, listing details, reviews, availability, location autocomplete. Bot protection (Akamai/DataDome) is bypassed automatically. Install: pip install cli-web-airbnb

Commands

search

• search stays LOCATION — search stays (e.g. "London, UK"). Options: --checkin DATE --checkout DATE, --adults N (default 1), --children N, --infants N, --pets N, --min-price N, --max-price N, --room-type [entire_home|private_room|shared_room|hotel_room] (repeatable), --amenity ID (repeatable; 4=WiFi, 8=Kitchen, 40=AC, 33=Pool), --cursor TOKEN (pagination), --locale, --currency

listings

• listings get LISTING_ID — full details (description, amenities, host, price). Options: --checkin, --checkout, --adults
• listings reviews LISTING_ID — guest reviews. Options: --limit N (default 24), --offset N, --sort [best_quality|recent|rating_desc|rating_asc]
• listings availability LISTING_ID — calendar. Options: --month N, --year N, --count N (months, default 12), --available-only

autocomplete

• autocomplete locations QUERY — location suggestions. Options: -n/--num-results N (default 5)

Examples

# Search with dates and budget — returns listings with id, name, price, rating
cli-web-airbnb search stays "Paris, France" --checkin 2026-07-01 --checkout 2026-07-05 --adults 2 --max-price 200 --json

# Search → inspect top result
ID=$(cli-web-airbnb search stays "London, UK" --json | python3 -c "import json,sys; print(json.load(sys.stdin)['listings'][0]['id'])")
cli-web-airbnb listings get $ID --json

# Recent reviews for a listing
cli-web-airbnb listings reviews 770993223449115417 --sort recent --limit 10 --json

# Next 3 months of availability
cli-web-airbnb listings availability 770993223449115417 --count 3 --available-only --json

# Resolve a partial location before searching
cli-web-airbnb autocomplete locations "New Yor" --json

JSON output

Add --json to any command for structured output. Success responses are flat envelopes, e.g. search: {"success": true, "count", "next_cursor", "total_count", "listings": [{id, id_b64, name, url, rating, price, price_qualifier, latitude, longitude, badges}]}. Errors: {"error": true, "code": "...", "message": "..."}.

Utilities

cli-web-airbnb doctor [--json] diagnoses local setup (install, dependencies). cli-web-airbnb mcp-serve exposes the commands as MCP tools over stdio. Running with no subcommand opens an interactive REPL.

Agent tips

• Pagination is cursor-based: pass the next_cursor value from one search as --cursor in the next.
• Listing IDs are long integer strings; id_b64 is the base64 form Airbnb uses internally.
• Search and view only — booking is not implemented.