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,--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_cursorvalue from one search as--cursorin the next. - Listing IDs are long integer strings;
id_b64is the base64 form Airbnb uses internally. - Search and view only — booking is not implemented.