/install airbnb-agent
Airbnb Agent
Search Airbnb via pyairbnb API, filter listings, and inspect detail pages without login or browser automation.
When to Use
Use for Airbnb rental searches, shortlist comparison, coordinate-based filtering, and listing detail analysis when login-only data is not required.
Setup
bash scripts/setup.sh
Creates .venv/ with pyairbnb + curl-cffi.
Quick Reference
| Topic | File |
|---|---|
| Usage, parameters, and limitations | references/api-fields.md |
| API fields and common coordinates | references/api-fields.md |
Core Rules
- Run setup first if
.venv/is missing. - Search by coordinate box; ask for or derive center coordinates before running.
- Treat detail keyword matches as signals, not verified facts.
- Pass the same dates and guest count to both search and detail analysis.
- Save JSON outputs and cite listing URLs when summarizing recommendations.
Workflow
.venv/bin/python3 scripts/search.py "Brighton" \
--check-in 2026-08-27 --check-out 2026-09-04 --guests 3 \
--bedrooms 2 --max-price 20000 --min-rating 4.8 \
--center-lat 50.8225 --center-lng -0.1373 --max-distance-km 2.5
.venv/bin/python3 scripts/details.py /tmp/airbnb_candidates.json \
--top 15 --check-in 2026-08-27 --check-out 2026-09-04 --guests 3
Outputs:
/tmp/airbnb_candidates.jsonfrom search/tmp/airbnb_results.jsonfrom detail analysis
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install airbnb-agent - After installation, invoke the skill by name or use
/airbnb-agent - Provide required inputs per the skill's parameter spec and get structured output
What is Airbnb Agent?
Search Airbnb listings, filter short-term rentals, and analyze detail pages for parking, basement, and renovation signals. It is an AI Agent Skill for Claude Code / OpenClaw, with 34 downloads so far.
How do I install Airbnb Agent?
Run "/install airbnb-agent" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Airbnb Agent free?
Yes, Airbnb Agent is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Airbnb Agent support?
Airbnb Agent is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Airbnb Agent?
It is built and maintained by Neo Shi (@suidge); the current version is v1.0.2.