mcpField
A
airbnb-search

airbnb-search

github.com/olafs-worldOther6457 installsUpdated 37w ago
Repository

About airbnb-search

airbnb-search is a command-line skill for finding Airbnb listings by location and dates. It returns prices, ratings, and booking links, with filters for price and bedrooms.

Key features

  1. 01Search listings by location and dates
  2. 02Filter by price and bedrooms
  3. 03Show prices, ratings, and booking links
  4. 04Output results as JSON

Use cases

  1. 01Compare Airbnb stays for a trip
  2. 02Find listings within a price range
  3. 03Review ratings and booking links

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/olafs-world/airbnb-search --skill airbnb-search

After installing, type/airbnb-searchin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

CHANGELOG.md
LICENSE
.gitignore
AGENTS.md
README.md
pyproject.toml
pytest.ini
uv.lock
.github/workflows/
ci.yml
airbnb_search/
search.py
cli.py
__init__.py
scripts/
airbnb-search.py
tests/
test_cli.py
__init__.py
test_search.py

Details

From the project README

Airbnb Search

Search Airbnb listings from the command line. Returns prices, ratings, and direct booking links.

Requirements

  • Python 3.8+
  • requests library (auto-installed via uv run --with)

Quick Start

# Run directly (no install needed)
uv run --with requests scripts/airbnb-search.py "Steamboat Springs, CO" --checkin 2025-03-01 --checkout 2025-03-03

# JSON output
uv run --with requests scripts/airbnb-search.py "Denver, CO" --checkin 2025-06-01 --checkout 2025-06-05 --json

Options

query                Search location (e.g., "Steamboat Springs, CO")
--checkin, -i DATE   Check-in date (YYYY-MM-DD)
--checkout, -o DATE  Check-out date (YYYY-MM-DD)
--min-price N        Minimum price filter
--max-price N        Maximum price filter
--min-bedrooms N     Minimum bedrooms filter
--limit N            Max results (default: 50)
--json               Output as JSON
--format FORMAT      table or json (default: table)

Example Output

📍 Steamboat Springs, CO
📊 Found 300+ total listings

==========================================================================================
Cozy Mountain Cabin 🏆
  2BR/1BA | ⭐4.92 | 127 reviews
  💰 $407 total
  🔗 https://airbnb.com/rooms/12345678

Notes

  • Dates are required for accurate pricing
  • Prices include cleaning fees in the total
  • No user API key needed — uses Airbnb's public frontend API key (hardcoded, same key used by airbnb.com in the browser)
  • May break if Airbnb changes their internal GraphQL API
  • Be respectful of rate limits

Links

Comments

Markdown supported