cli-web-airbnb 0.1.1__tar.gz

cli_web_airbnb-0.1.1/PKG-INFO

@@ -0,0 +1,12 @@
+Metadata-Version: 2.4
+Name: cli-web-airbnb
+Version: 0.1.1
+Summary: CLI for Airbnb — search stays, listings, and locations
+Requires-Python: >=3.10
+Requires-Dist: click>=8.0
+Requires-Dist: curl_cffi>=0.5.10
+Requires-Dist: rich>=13.0
+Requires-Dist: prompt_toolkit>=3.0
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary

cli_web_airbnb-0.1.1/cli_web/airbnb/README.md

@@ -0,0 +1,236 @@
+# cli-web-airbnb
+
+Search Airbnb stays, get listing details, and look up location suggestions — all from the terminal with structured JSON output.
+
+> Generated by [CLI-Anything-Web](../../../../cli-anything-web-plugin/) from [airbnb.com](https://www.airbnb.com)
+
+## Installation
+
+```bash
+pip install cli-web-airbnb
+```
+
+## Usage
+
+### Search Stays
+
+```bash
+# Search for stays in a location
+cli-web-airbnb search stays "London, UK" --json
+
+# Search with dates and guests
+cli-web-airbnb search stays "Paris, France" --checkin 2024-06-01 --checkout 2024-06-05 --adults 2 --json
+
+# Filter by max price
+cli-web-airbnb --json search stays "Tokyo, Japan" --max-price 150
+
+# Filter by price and room type
+cli-web-airbnb search stays "New York, NY" --max-price 200 --room-type entire_home
+
+# Paginate results using a cursor from a previous response
+cli-web-airbnb search stays "Tokyo, Japan" --cursor "eyJ..."
+```
+
+### Listings Detail
+
+```bash
+# Get full details for a listing
+cli-web-airbnb listings get 770993223449115417 --json
+
+# With dates for pricing context
+cli-web-airbnb listings get 770993223449115417 --checkin 2024-06-01 --checkout 2024-06-05 --json
+```
+
+### Listing Reviews
+
+```bash
+# Get reviews for a listing (sorted by best quality)
+cli-web-airbnb listings reviews 770993223449115417 --json
+
+# Get most recent reviews
+cli-web-airbnb listings reviews 770993223449115417 --sort RECENT --limit 10 --json
+```
+
+### Availability Calendar
+
+```bash
+# Get 12-month availability calendar
+cli-web-airbnb listings availability 770993223449115417 --json
+
+# Get 3 months starting from a specific month
+cli-web-airbnb listings availability 770993223449115417 --month 6 --year 2026 --count 3 --json
+```
+
+### Autocomplete Locations
+
+```bash
+# Suggest locations for a partial query
+cli-web-airbnb autocomplete locations "New Yor" --json
+
+# With more results
+cli-web-airbnb autocomplete locations "Lond" --num-results 10 --json
+```
+
+## Auth
+
+Airbnb is a **no-auth public site** — no login is required. All three command groups (`search`, `listings`, `autocomplete`) work without any credentials.
+
+Optional cookie-based auth (for wishlists and booking) is not yet implemented. The public endpoints cover all search and listing detail functionality.
+
+## JSON Output
+
+Every command supports `--json` for structured output. The flag can be placed at the group level (before the subcommand) or at the subcommand level (after):
+
+```bash
+# Group-level --json (before subcommand)
+cli-web-airbnb --json search stays "London, UK"
+
+# Subcommand-level --json (after subcommand)
+cli-web-airbnb search stays "London, UK" --json
+
+# Listings detail
+cli-web-airbnb listings get 770993223449115417 --json
+
+# Autocomplete
+cli-web-airbnb autocomplete locations "New Yor" --json
+```
+
+Example response for `search stays --json`:
+
+```json
+{
+  "success": true,
+  "count": 18,
+  "next_cursor": "eyJzZWN0aW9uX29mZnNldCI6MCwiaXRlbXNfb2Zmc2V0IjoxOH0=",
+  "total_count": 300,
+  "location_slug": "London--UK",
+  "listings": [
+    {
+      "id": "770993223449115417",
+      "id_b64": "RGVtYW5kU3RheUxpc3Rpbmc6NzcwOTkzMjIzNDQ5MTE1NDE3",
+      "name": "Room with Wembley view",
+      "rating": "4.98 (42)",
+      "price": "$142",
+      "price_qualifier": "total",
+      "latitude": 51.5589,
+      "longitude": -0.2789,
+      "badges": ["Guest favourite"],
+      "url": "https://www.airbnb.com/rooms/770993223449115417"
+    }
+  ]
+}
+```
+
+Example response for `listings get --json`:
+
+```json
+{
+  "success": true,
+  "id": "770993223449115417",
+  "name": "Room with Wembley view",
+  "rating": "4.98 (42)",
+  "review_count": 42,
+  "host_name": "Sean",
+  "description": "Indulge in a stylish retreat...",
+  "amenities": ["Body soap", "Shower gel", "Wifi"],
+  "price": null,
+  "bedrooms": null,
+  "bathrooms": null,
+  "max_guests": null,
+  "url": "https://www.airbnb.com/rooms/770993223449115417"
+}
+```
+
+Example response for `listings reviews --json`:
+
+```json
+{
+  "success": true,
+  "listing_id": "770993223449115417",
+  "count": 24,
+  "reviews": [
+    {
+      "id": "1651523546402376930",
+      "rating": 5,
+      "date": "March 2026",
+      "reviewer": "Craig",
+      "reviewer_location": "Falkirk, United Kingdom",
+      "comment": "Sean was a brilliant host...",
+      "host_response": null
+    }
+  ]
+}
+```
+
+Example response for `listings availability --json`:
+
+```json
+{
+  "success": true,
+  "listing_id": "770993223449115417",
+  "months": [
+    {
+      "month": 4,
+      "year": 2026,
+      "days": [
+        {"date": "2026-04-06", "available": true, "checkin": true, "checkout": true, "min_nights": 1}
+      ]
+    }
+  ]
+}
+```
+
+Example response for `autocomplete locations --json`:
+
+```json
+{
+  "success": true,
+  "suggestions": [
+    {
+      "query": "London, United Kingdom",
+      "place_id": "ChIJdd4hrwug2EcRmSrV3Vo6llI",
+      "display": "London, United Kingdom"
+    }
+  ]
+}
+```
+
+Error responses always follow the same shape:
+
+```json
+{"error": true, "code": "SERVER_ERROR", "message": "No StaysSearch data in page HTML"}
+```
+
+## REPL Mode
+
+Run without arguments to enter interactive mode:
+
+```bash
+cli-web-airbnb
+```
+
+Type `help` for available commands, `quit` to exit.
+
+## Testing
+
+```bash
+cd airbnb/agent-harness
+pip install -e .
+
+# Unit tests (no network)
+python -m pytest cli_web/airbnb/tests/test_core.py -v
+
+# All tests including E2E (requires live network)
+python -m pytest cli_web/airbnb/tests/ -v -s
+
+# Subprocess tests (requires installed binary on PATH)
+CLI_WEB_FORCE_INSTALLED=1 python -m pytest cli_web/airbnb/tests/test_e2e.py -v -s
+```
+
+## Protocol
+
+- **Website:** https://www.airbnb.com
+- **Protocol:** SSR HTML + niobeClientData (embedded GraphQL) + REST API `/api/v2/`
+- **Auth:** None required (public no-auth site)
+- **Bot protection:** Akamai/DataDome — bypassed with `curl_cffi` Chrome impersonation
+- **API key:** `d306zoyjsyarp7ifhu67rjxn52tv0t20` (used for `/api/v2/` REST calls only, not HTML pages)

cli_web_airbnb-0.1.1/cli_web/airbnb/__init__.py

@@ -0,0 +1,3 @@
+"""cli-web-airbnb — CLI for Airbnb search and listings."""
+
+__version__ = "0.1.0"

cli_web_airbnb-0.1.1/cli_web/airbnb/__main__.py

@@ -0,0 +1,6 @@
+"""Allow python -m cli_web.airbnb execution."""
+
+from .airbnb_cli import cli
+
+if __name__ == "__main__":
+    cli()

cli_web_airbnb-0.1.1/cli_web/airbnb/airbnb_cli.py

@@ -0,0 +1,169 @@
+"""cli-web-airbnb — Airbnb search and listings CLI."""
+
+from __future__ import annotations
+
+import json as _json
+import shlex
+import sys
+
+# Windows UTF-8 fix — reconfigure both stdout and stderr
+for _stream in (sys.stdout, sys.stderr):
+    if (
+        _stream
+        and getattr(_stream, "encoding", None)
+        and _stream.encoding.lower() not in ("utf-8", "utf8")
+    ):
+        try:
+            _stream.reconfigure(encoding="utf-8", errors="replace")
+        except AttributeError:
+            pass
+
+import click
+
+from .commands.autocomplete import autocomplete_group
+from .commands.listings import listings
+from .commands.search import search
+from .core.exceptions import AirbnbError
+from .utils.repl_skin import ReplSkin
+
+_skin = ReplSkin("airbnb", version="0.1.0")
+
+
+@click.group(invoke_without_command=True)
+@click.option("--json", "json_mode", is_flag=True, help="Output all results as JSON.")
+@click.option("--version", is_flag=True, help="Show version and exit.")
+@click.pass_context
+def cli(ctx, json_mode, version):
+    """🏠  cli-web-airbnb — Search Airbnb stays, listings and locations.
+
+    Running without a subcommand enters interactive REPL mode.
+
+    Examples:
+      cli-web-airbnb search stays "London, UK"
+      cli-web-airbnb search stays "Paris, France" --checkin 2024-06-01 --checkout 2024-06-05 --json
+      cli-web-airbnb listings get 770993223449115417
+      cli-web-airbnb autocomplete locations "New Yor"
+    """
+    ctx.ensure_object(dict)
+    ctx.obj["json"] = json_mode
+
+    if version:
+        click.echo("cli-web-airbnb 0.1.0")
+        return
+
+    if ctx.invoked_subcommand is None:
+        _repl(ctx)
+
+
+cli.add_command(search)
+cli.add_command(listings)
+cli.add_command(autocomplete_group, name="autocomplete")
+
+
+def _print_repl_help() -> None:
+    """Print REPL help listing all commands and key options."""
+    _skin.info("Available commands:")
+    print()
+    print("  search stays LOCATION     Search for stays in a location")
+    print("    --checkin DATE            Check-in date (YYYY-MM-DD)")
+    print("    --checkout DATE           Check-out date (YYYY-MM-DD)")
+    print("    --adults N                Number of adults (default: 1)")
+    print("    --children N              Number of children")
+    print("    --infants N               Number of infants")
+    print("    --pets N                  Number of pets (0 or 1)")
+    print("    --min-price N             Minimum nightly price")
+    print("    --max-price N             Maximum nightly price")
+    print("    --room-type TYPE          Filter: entire_home|private_room|shared_room|hotel_room")
+    print(
+        "    --amenity ID              Filter by amenity ID (repeatable: 4=WiFi, 8=Kitchen, 40=AC, 33=Pool)"
+    )
+    print("    --cursor TOKEN            Pagination cursor for next page")
+    print("    --page N                  Page number (note: Airbnb uses cursors, not pages)")
+    print("    --locale TEXT             Language locale (default: en)")
+    print("    --currency TEXT           Currency code (default: USD)")
+    print()
+    print("  listings get LISTING_ID   Get details for a specific listing")
+    print("    --adults N                Number of adults")
+    print("    --checkin DATE            Check-in date")
+    print("    --checkout DATE           Check-out date")
+    print("    --locale TEXT             Language locale (default: en)")
+    print("    --currency TEXT           Currency code (default: USD)")
+    print()
+    print("  listings reviews LISTING_ID  Get guest reviews for a listing")
+    print("    --limit N                 Number of reviews (default: 24)")
+    print("    --offset N                Pagination offset (default: 0)")
+    print("    --sort ORDER              Sort: BEST_QUALITY|RECENT|RATING_DESC|RATING_ASC")
+    print()
+    print("  listings availability LISTING_ID  Get 12-month availability calendar")
+    print("    --month N                 Starting month 1-12 (default: current)")
+    print("    --year N                  Starting year (default: current)")
+    print("    --count N                 Number of months to fetch (default: 12)")
+    print()
+    print("  autocomplete locations QUERY  Suggest locations for a partial query")
+    print("    --num-results N           Number of suggestions (default: 5)")
+    print()
+    print("  Global flags:")
+    print("    --json                    Output results as JSON (place before OR after subcommand)")
+    print('    Examples: --json search stays "London" OR: search stays "London" --json')
+    print()
+    print("  help                        Show this help")
+    print("  quit / exit                 Exit REPL")
+    print()
+
+
+def _repl(ctx: click.Context) -> None:
+    """Interactive REPL loop."""
+    _skin.print_banner()
+    pt_session = _skin.create_prompt_session()
+
+    while True:
+        try:
+            line = _skin.get_input(pt_session)
+        except (KeyboardInterrupt, EOFError):
+            break
+
+        line = line.strip()
+        if not line:
+            continue
+        if line in ("help", "?", "h"):
+            _print_repl_help()
+            continue
+        if line in ("quit", "exit", "q"):
+            break
+
+        try:
+            args = shlex.split(line)
+        except ValueError as exc:
+            click.echo(f"Parse error: {exc}", err=True)
+            continue
+
+        repl_args = ["--json"] + args if ctx.obj.get("json") else args
+        try:
+            cli.main(args=repl_args, standalone_mode=False)
+        except SystemExit:
+            pass
+        except Exception as exc:
+            if ctx.obj.get("json"):
+                payload = (
+                    exc.to_dict()
+                    if isinstance(exc, AirbnbError)
+                    else {"error": True, "code": "ERROR", "message": str(exc)}
+                )
+                click.echo(_json.dumps(payload))
+            else:
+                click.echo(f"Error: {exc}", err=True)
+
+
+def main() -> None:
+    """Entry point for cli-web-airbnb."""
+    cli()
+
+
+# MCP server mode — exposes every command as an MCP tool over stdio.
+# Canonical adapter: cli-web-core/cli_web_core/mcp_server.py (vendored copy).
+from cli_web.airbnb import __version__ as _pkg_version  # noqa: E402
+from cli_web.airbnb.utils.doctor import register_doctor_command  # noqa: E402
+from cli_web.airbnb.utils.mcp_server import register_mcp_command  # noqa: E402
+
+register_mcp_command(cli, app_name="airbnb", version=_pkg_version)
+register_doctor_command(cli, app_name="airbnb", pkg="airbnb")

cli_web_airbnb-0.1.1/cli_web/airbnb/commands/autocomplete.py

@@ -0,0 +1,100 @@
+"""Autocomplete command group — location suggestions."""
+
+from __future__ import annotations
+
+import click
+
+from ..core.client import AirbnbClient
+from ..utils.helpers import handle_errors, print_json, resolve_json_mode
+
+
+@click.group(
+    "autocomplete",
+    invoke_without_command=True,
+)
+@click.pass_context
+def autocomplete_group(ctx: click.Context) -> None:
+    """Autocomplete helpers for Airbnb search inputs (locations, etc.)."""
+    if ctx.invoked_subcommand is None:
+        click.echo(ctx.get_help())
+
+
+@autocomplete_group.command("locations")
+@click.argument("query")
+@click.option(
+    "--num-results",
+    "-n",
+    default=5,
+    show_default=True,
+    type=int,
+    help="Maximum number of suggestions to return.",
+)
+@click.option(
+    "--locale",
+    default="en",
+    show_default=True,
+    help="Locale for suggestion labels (e.g. en, fr, de).",
+)
+@click.option(
+    "--currency",
+    default="USD",
+    show_default=True,
+    help="Currency code used for price display context (e.g. USD, EUR).",
+)
+@click.option(
+    "--json",
+    "json_mode",
+    is_flag=True,
+    default=False,
+    help="Output as JSON.",
+)
+@click.pass_context
+def locations(
+    ctx: click.Context,
+    query: str,
+    num_results: int,
+    locale: str,
+    currency: str,
+    json_mode: bool,
+) -> None:
+    """Suggest locations matching partial QUERY text.
+
+    Returns ranked location suggestions suitable for use as a destination
+    in search commands.
+
+    \b
+    Examples:
+      autocomplete locations "Lond"
+      autocomplete locations "New Y" --num-results 10
+      autocomplete locations "Paris" --locale fr --currency EUR --json
+    """
+    json_mode = resolve_json_mode(json_mode, ctx)
+    with handle_errors(json_mode=json_mode):
+        with AirbnbClient(locale=locale, currency=currency) as client:
+            suggestions = client.autocomplete_locations(
+                query=query,
+                num_results=num_results,
+            )
+
+        if not suggestions:
+            if json_mode:
+                print_json({"success": True, "data": {"query": query, "suggestions": []}})
+            else:
+                click.echo(f"No location suggestions found for '{query}'.")
+            return
+
+        if json_mode:
+            print_json(
+                {
+                    "success": True,
+                    "data": {
+                        "query": query,
+                        "suggestions": [s.to_dict() for s in suggestions],
+                    },
+                }
+            )
+        else:
+            click.echo(f"\nLocation suggestions for '{query}':\n")
+            for i, suggestion in enumerate(suggestions, start=1):
+                click.echo(f"  {i}. {suggestion.display}  [place_id: {suggestion.place_id}]")
+            click.echo()