scrapebadger-cli 0.2.1__tar.gz → 0.3.0__tar.gz

{scrapebadger_cli-0.2.1 → scrapebadger_cli-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: scrapebadger-cli
-Version: 0.2.1
+Version: 0.3.0
 Summary: ScrapeBadger CLI — Twitter, Vinted, Google, and Web Scraping from the command line
 Author: ScrapeBadger Team
 License: MIT
@@ -28,6 +28,13 @@ Command-line interface for ScrapeBadger — Twitter, Vinted, and Web Scraping.
 
 ```bash
 pip install scrapebadger-cli
+# or: uv tool install scrapebadger-cli
+```
+
+The installed command is `scrapebadger`. To run without installing:
+
+```bash
+uvx --from scrapebadger-cli scrapebadger --help
 ```
 
 ## Quick Start

{scrapebadger_cli-0.2.1 → scrapebadger_cli-0.3.0}/README.md

@@ -6,6 +6,13 @@ Command-line interface for ScrapeBadger — Twitter, Vinted, and Web Scraping.
 
 ```bash
 pip install scrapebadger-cli
+# or: uv tool install scrapebadger-cli
+```
+
+The installed command is `scrapebadger`. To run without installing:
+
+```bash
+uvx --from scrapebadger-cli scrapebadger --help
 ```
 
 ## Quick Start

{scrapebadger_cli-0.2.1 → scrapebadger_cli-0.3.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "scrapebadger-cli"
-version = "0.2.1"
+version = "0.3.0"
 description = "ScrapeBadger CLI — Twitter, Vinted, Google, and Web Scraping from the command line"
 requires-python = ">=3.10"
 license = {text = "MIT"}

scrapebadger_cli-0.3.0/src/scrapebadger_cli/commands/redfin.py

@@ -0,0 +1,121 @@
+"""Redfin real-estate commands."""
+
+import typer
+
+from scrapebadger_cli.client import api_get
+from scrapebadger_cli.output import render
+
+app = typer.Typer(no_args_is_help=True)
+
+FMT = typer.Option("json", "--output", "-o", help="Output format: json, csv, table, markdown")
+FIELDS = typer.Option(None, "--fields", "-f", help="Comma-separated fields to include")
+
+
+@app.command()
+def search(
+    location: str = typer.Argument(..., help="City/state, ZIP, address or neighborhood"),
+    page: int = typer.Option(1, "--page", "-p", help="1-20"),
+    sort: str | None = typer.Option(
+        None, "--sort", help="relevant, newest, price_low_to_high, etc."
+    ),
+    price_min: int | None = typer.Option(None, "--price-min"),
+    price_max: int | None = typer.Option(None, "--price-max"),
+    beds_min: int | None = typer.Option(None, "--beds-min"),
+    baths_min: float | None = typer.Option(None, "--baths-min"),
+    home_type: str | None = typer.Option(
+        None,
+        "--home-type",
+        help="house, condo, townhouse, multi_family, land, other, mobile, coop",
+    ),
+    sqft_min: int | None = typer.Option(None, "--sqft-min"),
+    sqft_max: int | None = typer.Option(None, "--sqft-max"),
+    lot_min: int | None = typer.Option(None, "--lot-min"),
+    lot_max: int | None = typer.Option(None, "--lot-max"),
+    year_built_min: int | None = typer.Option(None, "--year-built-min"),
+    year_built_max: int | None = typer.Option(None, "--year-built-max"),
+    max_days_on_market: int | None = typer.Option(None, "--max-days-on-market"),
+    north: float | None = typer.Option(None, "--north", help="Map bounds for tiling past the cap"),
+    south: float | None = typer.Option(None, "--south"),
+    east: float | None = typer.Option(None, "--east"),
+    west: float | None = typer.Option(None, "--west"),
+    fmt: str = FMT,
+    fields: str | None = FIELDS,
+) -> None:
+    """Search Redfin for for-sale properties."""
+    data = api_get(
+        "/v1/redfin/search",
+        {
+            "location": location,
+            "page": page,
+            "sort": sort,
+            "price_min": price_min,
+            "price_max": price_max,
+            "beds_min": beds_min,
+            "baths_min": baths_min,
+            "home_type": home_type,
+            "sqft_min": sqft_min,
+            "sqft_max": sqft_max,
+            "lot_min": lot_min,
+            "lot_max": lot_max,
+            "year_built_min": year_built_min,
+            "year_built_max": year_built_max,
+            "max_days_on_market": max_days_on_market,
+            "north": north,
+            "south": south,
+            "east": east,
+            "west": west,
+        },
+    )
+    render(data, fmt, fields)
+
+
+@app.command()
+def property(
+    property_id: str = typer.Argument(..., help="Redfin numeric property id"),
+    fmt: str = FMT,
+    fields: str | None = FIELDS,
+) -> None:
+    """Get a Redfin property's full detail by propertyId."""
+    data = api_get(f"/v1/redfin/property/{property_id}", {})
+    render(data, fmt, fields)
+
+
+@app.command("property-url")
+def property_url(
+    url: str = typer.Argument(..., help="Full Redfin property URL (/CA/City/.../home/12345678)"),
+    fmt: str = FMT,
+    fields: str | None = FIELDS,
+) -> None:
+    """Get a Redfin property's full detail by home URL."""
+    data = api_get("/v1/redfin/property", {"url": url})
+    render(data, fmt, fields)
+
+
+@app.command()
+def agent(
+    agent_id: str | None = typer.Argument(None, help="Redfin agent id"),
+    url: str | None = typer.Option(None, "--url", help="Full Redfin /realestateagents/... URL"),
+    fmt: str = FMT,
+    fields: str | None = FIELDS,
+) -> None:
+    """Get a Redfin agent's profile and their active listings."""
+    data = api_get("/v1/redfin/agent", {"agent_id": agent_id, "url": url})
+    render(data, fmt, fields)
+
+
+@app.command()
+def autocomplete(
+    query: str = typer.Argument(..., help="Partial location — city, ZIP, address, neighborhood"),
+    fmt: str = FMT,
+    fields: str | None = FIELDS,
+) -> None:
+    """Resolve a search term to Redfin regions/addresses."""
+    data = api_get("/v1/redfin/autocomplete", {"query": query})
+    render(data, fmt, fields)
+
+
+@app.command("markets")
+def list_markets(fmt: str = FMT, fields: str | None = FIELDS) -> None:
+    """List Redfin coverage regions (US)."""
+    data = api_get("/v1/redfin/markets", {})
+    render(data, fmt, fields)

{scrapebadger_cli-0.2.1 → scrapebadger_cli-0.3.0}/src/scrapebadger_cli/main.py

@@ -13,6 +13,7 @@ from scrapebadger_cli.commands import (
     loopnet,
     realtor,
     reddit,
+    redfin,
     stream,
     tiktok,
     twitter,
@@ -44,6 +45,7 @@ app.add_typer(web.app, name="web", help="Web scraping commands")
 app.add_typer(google.app, name="google", help="Google scraper commands")
 app.add_typer(realtor.app, name="realtor", help="Realtor real-estate commands")
 app.add_typer(loopnet.app, name="loopnet", help="LoopNet commercial real estate commands")
+app.add_typer(redfin.app, name="redfin", help="Redfin real-estate commands")
 app.command()(auth.auth)
 app.command(name="credits")(auth.credits)
 app.command(name="logout")(auth.logout)