← Back to Skills Marketplace
Airbnb Search
by
Aaron Levin
· GitHub ↗
· v0.1.4
1833
Downloads
1
Stars
3
Active Installs
3
Versions
Install in OpenClaw
/install airbnb-search
Description
Search Airbnb listings with prices, ratings, and direct links. No user API key required (uses Airbnb's public frontend API key). Use when searching for Airbnb stays, vacation rentals, or accommodation pricing.
README (SKILL.md)
Airbnb Search
Search Airbnb listings from the command line. Returns prices, ratings, and direct booking links.
Requirements
- Python 3.8+
requestslibrary (auto-installed viauv 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
Usage Guidance
This skill appears internally consistent with its stated purpose, but consider the following before installing:
- The code calls Airbnb's internal GraphQL endpoint using a hardcoded frontend API key. That key is public in the browser but may stop working if Airbnb rotates it or changes the API.
- Using an unofficial/internal API may violate Airbnb's terms of service; be mindful of legal/ToS risks and rate limits.
- The repository includes integration tests that perform live API calls — running the tests will make network requests to Airbnb and could trigger rate limits.
- There are minor repo metadata inconsistencies (multiple version strings: registry 0.1.4, pyproject 0.1.3, package __version__ 0.1.0; and slight GitHub/owner name variants). These look like sloppy maintenance rather than malicious intent, but you may want to verify the upstream source (GitHub link) and the package owner before trusting it in production.
- The skill exposes listing lat/lng in results (as returned by Airbnb). If you need to avoid precise location data, review parse_listings output or filter coordinates.
If you proceed: review the code yourself (it’s small and readable), run it in a sandboxed environment if possible, and avoid running the integration tests unless you intend to make live API requests.
Capability Analysis
Type: OpenClaw Skill
Name: airbnb-search
Version: 0.1.4
The OpenClaw skill 'airbnb-search' is benign. Its primary function is to search Airbnb listings using their public frontend API, which is clearly stated and implemented in `airbnb_search/search.py`. The code uses standard Python libraries (`requests`, `argparse`), handles input safely, and does not exhibit any signs of data exfiltration, unauthorized execution, persistence mechanisms, or prompt injection attempts in `SKILL.md` or `AGENTS.md`. The hardcoded API key is explicitly noted as a public key used by Airbnb's website, not a sensitive credential.
Capability Assessment
Purpose & Capability
Name/description (Airbnb Search) align with the code and runtime instructions. The package makes direct HTTP calls to Airbnb's ExploreSearch endpoint and returns prices, ratings, and links — exactly what the skill says. The hardcoded API key matches the claim that no user key is required.
Instruction Scope
SKILL.md and scripts instruct the agent to run the included CLI script which calls Airbnb's GraphQL endpoint. The instructions only reference the dependencies needed (requests) and the repo's scripts; they do not ask for unrelated files, system credentials, or to send data to third parties beyond airbnb.com. The repo contains integration tests that make live API calls — these may run network requests if executed.
Install Mechanism
No install spec is present (instruction-only for runtime), and there are no remote downloads or extract steps. The code files are included in the skill package (CLI and search implementation); dependency is just the requests library declared in pyproject. This is proportionate to the functionality.
Credentials
The skill requires no environment variables, no credentials, and no config paths. The single API key is hardcoded in code (a public frontend key) which matches the documentation's 'no user API key' claim. No unrelated secrets are requested.
Persistence & Privilege
Skill does not request persistent/system privileges (always:false). It does not modify other skills or system configs. Autonomous invocation is allowed (platform default) but not combined with other concerning flags.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install airbnb-search - After installation, invoke the skill by name or use
/airbnb-search - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.4
Address security report: clarify API key messaging, remove curl|bash installer, document API fragility
v0.1.3
Bundle source in scripts/ for skill auditing; remove uvx dependency
v1.0.0
Initial release - search Airbnb listings with prices and links
Metadata
Frequently Asked Questions
What is Airbnb Search?
Search Airbnb listings with prices, ratings, and direct links. No user API key required (uses Airbnb's public frontend API key). Use when searching for Airbnb stays, vacation rentals, or accommodation pricing. It is an AI Agent Skill for Claude Code / OpenClaw, with 1833 downloads so far.
How do I install Airbnb Search?
Run "/install airbnb-search" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Airbnb Search free?
Yes, Airbnb Search is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Airbnb Search support?
Airbnb Search is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Airbnb Search?
It is built and maintained by Aaron Levin (@awlevin); the current version is v0.1.4.
More Skills