scrapebadger-cli 0.2.1__py3-none-any.whl

scrapebadger_cli/__init__.py

@@ -0,0 +1 @@
+"""ScrapeBadger CLI — Twitter, Vinted, and Web Scraping from the command line."""

scrapebadger_cli/client.py

@@ -0,0 +1,57 @@
+"""HTTP client for ScrapeBadger API."""
+
+import os
+from typing import Any
+
+import httpx
+import typer
+
+from scrapebadger_cli.config import get_api_key
+
+BASE_URL = os.environ.get("SCRAPEBADGER_API_URL", "https://scrapebadger.com")
+_client: httpx.Client | None = None
+
+
+def _get_client() -> httpx.Client:
+    global _client
+    if _client is None:
+        api_key = get_api_key()
+        if not api_key:
+            typer.echo(
+                "No API key found. Set SCRAPEBADGER_API_KEY or run: scrapebadger auth",
+                err=True,
+            )
+            raise typer.Exit(1)
+        _client = httpx.Client(
+            base_url=BASE_URL,
+            headers={"X-API-Key": api_key},
+            timeout=300.0,
+        )
+    return _client
+
+
+def api_get(path: str, params: dict[str, Any] | None = None) -> dict | list:
+    """Make a GET request to the ScrapeBadger API."""
+    clean = {k: v for k, v in (params or {}).items() if v is not None}
+    resp = _get_client().get(path, params=clean or None)
+    return _handle_response(resp)
+
+
+def api_post(path: str, json_body: dict[str, Any] | None = None) -> dict | list:
+    """Make a POST request to the ScrapeBadger API."""
+    resp = _get_client().post(path, json=json_body)
+    return _handle_response(resp)
+
+
+def _handle_response(resp: httpx.Response) -> dict | list:
+    """Handle API response, exit on errors."""
+    if resp.status_code >= 400:
+        try:
+            detail = resp.json().get("detail", resp.text)
+        except Exception:
+            detail = resp.text
+        typer.echo(f"Error ({resp.status_code}): {detail}", err=True)
+        raise typer.Exit(1)
+    if resp.status_code == 204:
+        return {"status": "deleted"}
+    return resp.json()

scrapebadger_cli/commands/__init__.py

@@ -0,0 +1 @@
+"""CLI command modules."""

scrapebadger_cli/commands/amazon.py

@@ -0,0 +1,227 @@
+"""Amazon marketplace 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")
+DOMAIN = typer.Option("com", "--domain", "-d", help="Amazon marketplace TLD (com, co.uk, de, etc.)")
+
+
+@app.command()
+def search(
+    query: str = typer.Argument(..., help="Search text"),
+    domain: str = DOMAIN,
+    page: int = typer.Option(1, "--page", "-p"),
+    sort_by: str | None = typer.Option(None, "--sort-by", help="e.g. price_low_to_high"),
+    category: str | None = typer.Option(None, "--category", help="Department/search alias"),
+    min_price: float | None = typer.Option(None, "--min-price"),
+    max_price: float | None = typer.Option(None, "--max-price"),
+    zip_code: str | None = typer.Option(None, "--zip", help="Delivery ZIP/postal code"),
+    fmt: str = FMT,
+    fields: str | None = FIELDS,
+) -> None:
+    """Search the Amazon catalog for products."""
+    data = api_get(
+        "/v1/amazon/search",
+        {
+            "query": query,
+            "domain": domain,
+            "page": page,
+            "sort_by": sort_by,
+            "category": category,
+            "min_price": min_price,
+            "max_price": max_price,
+            "zip": zip_code,
+        },
+    )
+    render(data, fmt, fields)
+
+
+@app.command()
+def autocomplete(
+    query: str = typer.Argument(..., help="Partial search text"),
+    domain: str = DOMAIN,
+    fmt: str = FMT,
+    fields: str | None = FIELDS,
+) -> None:
+    """Get Amazon keyword autocomplete suggestions."""
+    data = api_get("/v1/amazon/autocomplete", {"query": query, "domain": domain})
+    render(data, fmt, fields)
+
+
+@app.command()
+def product(
+    asin: str = typer.Argument(..., help="Amazon ASIN"),
+    domain: str = DOMAIN,
+    zip_code: str | None = typer.Option(None, "--zip", help="Delivery ZIP/postal code"),
+    language: str | None = typer.Option(None, "--language", help="e.g. en_US"),
+    fmt: str = FMT,
+    fields: str | None = FIELDS,
+) -> None:
+    """Get a full product detail page (PDP) by ASIN."""
+    data = api_get(
+        f"/v1/amazon/products/{asin}",
+        {"domain": domain, "zip": zip_code, "language": language},
+    )
+    render(data, fmt, fields)
+
+
+@app.command()
+def offers(
+    asin: str = typer.Argument(..., help="Amazon ASIN"),
+    domain: str = DOMAIN,
+    zip_code: str | None = typer.Option(None, "--zip", help="Delivery ZIP/postal code"),
+    fmt: str = FMT,
+    fields: str | None = FIELDS,
+) -> None:
+    """Get all seller offers (buybox + competing) for a product."""
+    data = api_get(f"/v1/amazon/products/{asin}/offers", {"domain": domain, "zip": zip_code})
+    render(data, fmt, fields)
+
+
+@app.command()
+def reviews(
+    asin: str = typer.Argument(..., help="Amazon ASIN"),
+    domain: str = DOMAIN,
+    page: int = typer.Option(1, "--page", "-p"),
+    sort_by: str | None = typer.Option(None, "--sort-by", help="helpful or recent"),
+    star: str | None = typer.Option(None, "--star", help="e.g. five_star, critical"),
+    verified_only: bool = typer.Option(False, "--verified-only"),
+    media_only: bool = typer.Option(False, "--media-only"),
+    fmt: str = FMT,
+    fields: str | None = FIELDS,
+) -> None:
+    """Get customer reviews for a product."""
+    data = api_get(
+        f"/v1/amazon/products/{asin}/reviews",
+        {
+            "domain": domain,
+            "page": page,
+            "sort_by": sort_by,
+            "star": star,
+            "verified_only": verified_only,
+            "media_only": media_only,
+        },
+    )
+    render(data, fmt, fields)
+
+
+@app.command()
+def bestsellers(
+    domain: str = DOMAIN,
+    category: str | None = typer.Option(None, "--category", help="Browse node ID"),
+    page: int = typer.Option(1, "--page", "-p"),
+    fmt: str = FMT,
+    fields: str | None = FIELDS,
+) -> None:
+    """Get an Amazon Best Sellers list."""
+    data = api_get("/v1/amazon/bestsellers", {"domain": domain, "category": category, "page": page})
+    render(data, fmt, fields)
+
+
+@app.command(name="new-releases")
+def new_releases(
+    domain: str = DOMAIN,
+    category: str | None = typer.Option(None, "--category", help="Browse node ID"),
+    page: int = typer.Option(1, "--page", "-p"),
+    fmt: str = FMT,
+    fields: str | None = FIELDS,
+) -> None:
+    """Get an Amazon New Releases list."""
+    data = api_get(
+        "/v1/amazon/new-releases", {"domain": domain, "category": category, "page": page}
+    )
+    render(data, fmt, fields)
+
+
+@app.command()
+def deals(
+    domain: str = DOMAIN,
+    category: str | None = typer.Option(None, "--category", help="Department/category"),
+    page: int = typer.Option(1, "--page", "-p"),
+    fmt: str = FMT,
+    fields: str | None = FIELDS,
+) -> None:
+    """Get current Amazon deals (Today's Deals / Lightning Deals)."""
+    data = api_get("/v1/amazon/deals", {"domain": domain, "category": category, "page": page})
+    render(data, fmt, fields)
+
+
+@app.command()
+def category(
+    node: str = typer.Argument(..., help="Amazon browse node ID"),
+    domain: str = DOMAIN,
+    page: int = typer.Option(1, "--page", "-p"),
+    sort_by: str | None = typer.Option(None, "--sort-by"),
+    fmt: str = FMT,
+    fields: str | None = FIELDS,
+) -> None:
+    """Browse an Amazon category/department by browse-node ID."""
+    data = api_get(
+        "/v1/amazon/category",
+        {"node": node, "domain": domain, "page": page, "sort_by": sort_by},
+    )
+    render(data, fmt, fields)
+
+
+@app.command()
+def seller(
+    seller_id: str = typer.Argument(..., help="Amazon seller ID"),
+    domain: str = DOMAIN,
+    fmt: str = FMT,
+    fields: str | None = FIELDS,
+) -> None:
+    """Get an Amazon seller profile (ratings + feedback summary)."""
+    data = api_get(f"/v1/amazon/sellers/{seller_id}", {"domain": domain})
+    render(data, fmt, fields)
+
+
+@app.command(name="seller-products")
+def seller_products(
+    seller_id: str = typer.Argument(..., help="Amazon seller ID"),
+    domain: str = DOMAIN,
+    page: int = typer.Option(1, "--page", "-p"),
+    fmt: str = FMT,
+    fields: str | None = FIELDS,
+) -> None:
+    """Get the storefront product listings of a seller."""
+    data = api_get(f"/v1/amazon/sellers/{seller_id}/products", {"domain": domain, "page": page})
+    render(data, fmt, fields)
+
+
+@app.command(name="seller-feedback")
+def seller_feedback(
+    seller_id: str = typer.Argument(..., help="Amazon seller ID"),
+    domain: str = DOMAIN,
+    page: int = typer.Option(1, "--page", "-p"),
+    fmt: str = FMT,
+    fields: str | None = FIELDS,
+) -> None:
+    """Get buyer feedback entries for a seller."""
+    data = api_get(f"/v1/amazon/sellers/{seller_id}/feedback", {"domain": domain, "page": page})
+    render(data, fmt, fields)
+
+
+@app.command()
+def markets(
+    fmt: str = FMT,
+    fields: str | None = FIELDS,
+) -> None:
+    """List all supported Amazon marketplaces."""
+    data = api_get("/v1/amazon/markets")
+    render(data, fmt, fields)
+
+
+@app.command()
+def categories(
+    fmt: str = FMT,
+    fields: str | None = FIELDS,
+) -> None:
+    """List reference Amazon departments / category aliases."""
+    data = api_get("/v1/amazon/categories")
+    render(data, fmt, fields)

scrapebadger_cli/commands/auth.py

@@ -0,0 +1,52 @@
+"""Auth and account commands."""
+
+import typer
+
+from scrapebadger_cli.client import api_get
+from scrapebadger_cli.config import clear_api_key, get_api_key, save_api_key
+from scrapebadger_cli.output import console
+
+
+def auth(
+    api_key: str = typer.Option("", "--api-key", "-k", help="API key (or enter interactively)"),
+    show: bool = typer.Option(False, "--show", help="Show current saved API key"),
+) -> None:
+    """Set up or view your ScrapeBadger API key."""
+    if show:
+        key = get_api_key()
+        if key:
+            console.print(f"[green]Current API key:[/green] {key[:12]}...{key[-4:]}")
+        else:
+            console.print("[yellow]No API key configured.[/yellow]")
+        return
+
+    if not api_key:
+        api_key = typer.prompt("Enter your ScrapeBadger API key")
+
+    api_key = api_key.strip()
+    if not api_key:
+        console.print("[red]API key cannot be empty.[/red]")
+        raise typer.Exit(1)
+
+    save_api_key(api_key)
+    console.print(f"[green]API key saved.[/green] ({api_key[:12]}...{api_key[-4:]})")
+
+
+def credits() -> None:
+    """Check your credit balance."""
+    data = api_get("/v1/account/me")
+    if isinstance(data, dict):
+        balance = data.get("credits_balance", "unknown")
+        tier = data.get("tier", "unknown")
+        rate_limit = data.get("rate_limit_per_minute", "unknown")
+        console.print(f"[green]Credits balance:[/green] {balance}")
+        console.print(f"[dim]Tier:[/dim] {tier}")
+        console.print(f"[dim]Rate limit:[/dim] {rate_limit}/min")
+    else:
+        console.print(data)
+
+
+def logout() -> None:
+    """Remove saved API key."""
+    clear_api_key()
+    console.print("[green]API key removed.[/green]")

scrapebadger_cli/commands/ebay.py

@@ -0,0 +1,217 @@
+"""eBay marketplace 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")
+DOMAIN = typer.Option("com", "--domain", "-d", help="eBay marketplace TLD (com, co.uk, de, etc.)")
+
+
+@app.command()
+def search(
+    query: str = typer.Argument(..., help="Search text"),
+    domain: str = DOMAIN,
+    category_id: str | None = typer.Option(None, "--category-id", help="Restrict to a category"),
+    page: int = typer.Option(1, "--page", "-p"),
+    per_page: int | None = typer.Option(None, "--per-page", help="60, 120 or 240"),
+    sort_by: str | None = typer.Option(None, "--sort-by", help="e.g. price_low_to_high"),
+    condition: str | None = typer.Option(None, "--condition", help="e.g. new, used"),
+    buying_format: str | None = typer.Option(
+        None, "--buying-format", help="auction, buy_it_now, best_offer"
+    ),
+    min_price: float | None = typer.Option(None, "--min-price"),
+    max_price: float | None = typer.Option(None, "--max-price"),
+    free_shipping: bool = typer.Option(False, "--free-shipping"),
+    fmt: str = FMT,
+    fields: str | None = FIELDS,
+) -> None:
+    """Search eBay active listings.
+
+    Auction cards include bids, current_bid and time_left. Pass
+    --buying-format auction to return only auctions.
+    """
+    data = api_get(
+        "/v1/ebay/search",
+        {
+            "query": query,
+            "domain": domain,
+            "category_id": category_id,
+            "page": page,
+            "per_page": per_page,
+            "sort_by": sort_by,
+            "condition": condition,
+            "buying_format": buying_format,
+            "min_price": min_price,
+            "max_price": max_price,
+            "free_shipping": free_shipping,
+        },
+    )
+    render(data, fmt, fields)
+
+
+@app.command()
+def completed(
+    query: str = typer.Argument(..., help="Search text"),
+    domain: str = DOMAIN,
+    category_id: str | None = typer.Option(None, "--category-id", help="Restrict to a category"),
+    page: int = typer.Option(1, "--page", "-p"),
+    per_page: int | None = typer.Option(None, "--per-page", help="60, 120 or 240"),
+    sort_by: str | None = typer.Option(None, "--sort-by", help="e.g. ending_soonest"),
+    condition: str | None = typer.Option(None, "--condition", help="e.g. new, used"),
+    min_price: float | None = typer.Option(None, "--min-price"),
+    max_price: float | None = typer.Option(None, "--max-price"),
+    fmt: str = FMT,
+    fields: str | None = FIELDS,
+) -> None:
+    """Search completed/sold eBay listings (price research)."""
+    data = api_get(
+        "/v1/ebay/completed",
+        {
+            "query": query,
+            "domain": domain,
+            "category_id": category_id,
+            "page": page,
+            "per_page": per_page,
+            "sort_by": sort_by,
+            "condition": condition,
+            "min_price": min_price,
+            "max_price": max_price,
+        },
+    )
+    render(data, fmt, fields)
+
+
+@app.command()
+def item(
+    item_id: str = typer.Argument(..., help="eBay item ID"),
+    domain: str = DOMAIN,
+    fmt: str = FMT,
+    fields: str | None = FIELDS,
+) -> None:
+    """Get a full eBay item detail page by item ID.
+
+    For auctions this includes bids, current_bid, time_left, end_time_at and
+    (for fixed-price / auction-with-Buy-It-Now listings) buy_it_now_price.
+    """
+    data = api_get(f"/v1/ebay/items/{item_id}", {"domain": domain})
+    render(data, fmt, fields)
+
+
+@app.command(name="item-reviews")
+def item_reviews(
+    item_id: str = typer.Argument(..., help="eBay item ID"),
+    domain: str = DOMAIN,
+    page: int = typer.Option(1, "--page", "-p"),
+    fmt: str = FMT,
+    fields: str | None = FIELDS,
+) -> None:
+    """Get product reviews (rating + histogram) for an eBay item."""
+    data = api_get(f"/v1/ebay/items/{item_id}/reviews", {"domain": domain, "page": page})
+    render(data, fmt, fields)
+
+
+@app.command()
+def seller(
+    username: str = typer.Argument(..., help="eBay seller username"),
+    domain: str = DOMAIN,
+    fmt: str = FMT,
+    fields: str | None = FIELDS,
+) -> None:
+    """Get an eBay seller profile (feedback + store info)."""
+    data = api_get(f"/v1/ebay/sellers/{username}", {"domain": domain})
+    render(data, fmt, fields)
+
+
+@app.command(name="seller-items")
+def seller_items(
+    username: str = typer.Argument(..., help="eBay seller username"),
+    domain: str = DOMAIN,
+    query: str | None = typer.Option(None, "--query", "-q", help="Filter the seller's listings"),
+    page: int = typer.Option(1, "--page", "-p"),
+    per_page: int | None = typer.Option(None, "--per-page", help="60, 120 or 240"),
+    fmt: str = FMT,
+    fields: str | None = FIELDS,
+) -> None:
+    """Get the active listings of an eBay seller."""
+    data = api_get(
+        f"/v1/ebay/sellers/{username}/items",
+        {"domain": domain, "query": query, "page": page, "per_page": per_page},
+    )
+    render(data, fmt, fields)
+
+
+@app.command(name="seller-feedback")
+def seller_feedback(
+    username: str = typer.Argument(..., help="eBay seller username"),
+    domain: str = DOMAIN,
+    page: int = typer.Option(1, "--page", "-p"),
+    fmt: str = FMT,
+    fields: str | None = FIELDS,
+) -> None:
+    """Get buyer feedback entries for an eBay seller."""
+    data = api_get(f"/v1/ebay/sellers/{username}/feedback", {"domain": domain, "page": page})
+    render(data, fmt, fields)
+
+
+@app.command()
+def category(
+    category_id: str = typer.Argument(..., help="eBay category ID"),
+    domain: str = DOMAIN,
+    page: int = typer.Option(1, "--page", "-p"),
+    per_page: int | None = typer.Option(None, "--per-page", help="60, 120 or 240"),
+    sort_by: str | None = typer.Option(None, "--sort-by"),
+    min_price: float | None = typer.Option(None, "--min-price"),
+    max_price: float | None = typer.Option(None, "--max-price"),
+    fmt: str = FMT,
+    fields: str | None = FIELDS,
+) -> None:
+    """Browse eBay listings within a category by category ID."""
+    data = api_get(
+        f"/v1/ebay/categories/{category_id}/items",
+        {
+            "domain": domain,
+            "page": page,
+            "per_page": per_page,
+            "sort_by": sort_by,
+            "min_price": min_price,
+            "max_price": max_price,
+        },
+    )
+    render(data, fmt, fields)
+
+
+@app.command()
+def categories(
+    fmt: str = FMT,
+    fields: str | None = FIELDS,
+) -> None:
+    """List reference eBay categories."""
+    data = api_get("/v1/ebay/categories")
+    render(data, fmt, fields)
+
+
+@app.command()
+def autocomplete(
+    query: str = typer.Argument(..., help="Partial search text"),
+    domain: str = DOMAIN,
+    fmt: str = FMT,
+    fields: str | None = FIELDS,
+) -> None:
+    """Get eBay keyword autocomplete suggestions."""
+    data = api_get("/v1/ebay/autocomplete", {"query": query, "domain": domain})
+    render(data, fmt, fields)
+
+
+@app.command()
+def markets(
+    fmt: str = FMT,
+    fields: str | None = FIELDS,
+) -> None:
+    """List all supported eBay marketplaces."""
+    data = api_get("/v1/ebay/markets")
+    render(data, fmt, fields)