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, --adultslistings 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.
1---2name: airbnb-cli3description: 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.4---56# cli-web-airbnb78Read-only Airbnb search: stays, listing details, reviews, availability, location autocomplete. Bot protection (Akamai/DataDome) is bypassed automatically.9Install: `pip install cli-web-airbnb`1011## Commands1213### search14- `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`1516### listings17- `listings get LISTING_ID` — full details (description, amenities, host, price). Options: `--checkin`, `--checkout`, `--adults`18- `listings reviews LISTING_ID` — guest reviews. Options: `--limit N` (default 24), `--offset N`, `--sort [best_quality|recent|rating_desc|rating_asc]`19- `listings availability LISTING_ID` — calendar. Options: `--month N`, `--year N`, `--count N` (months, default 12), `--available-only`2021### autocomplete22- `autocomplete locations QUERY` — location suggestions. Options: `-n/--num-results N` (default 5)2324## Examples2526```bash27# Search with dates and budget — returns listings with id, name, price, rating28cli-web-airbnb search stays "Paris, France" --checkin 2026-07-01 --checkout 2026-07-05 --adults 2 --max-price 200 --json2930# Search → inspect top result31ID=$(cli-web-airbnb search stays "London, UK" --json | python3 -c "import json,sys; print(json.load(sys.stdin)['listings'][0]['id'])")32cli-web-airbnb listings get $ID --json3334# Recent reviews for a listing35cli-web-airbnb listings reviews 770993223449115417 --sort recent --limit 10 --json3637# Next 3 months of availability38cli-web-airbnb listings availability 770993223449115417 --count 3 --available-only --json3940# Resolve a partial location before searching41cli-web-airbnb autocomplete locations "New Yor" --json42```4344## JSON output4546Add `--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": "..."}`.4748## Utilities4950`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.5152## Agent tips5354- Pagination is cursor-based: pass the `next_cursor` value from one search as `--cursor` in the next.55- Listing IDs are long integer strings; `id_b64` is the base64 form Airbnb uses internally.56- Search and view only — booking is not implemented.
ItamarZand88