scrapebadger-cli 0.21.2__tar.gz → 0.22.0__tar.gz

{scrapebadger_cli-0.21.2 → scrapebadger_cli-0.22.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: scrapebadger-cli
-Version: 0.21.2
+Version: 0.22.0
 Summary: ScrapeBadger CLI — Twitter, Vinted, Google, and Web Scraping from the command line
 Author: ScrapeBadger Team
 License: MIT
@@ -22,7 +22,7 @@ Description-Content-Type: text/markdown
 
 # ScrapeBadger CLI
 
-Command-line interface for ScrapeBadger — Twitter, Vinted, and Web Scraping.
+Command-line access to ScrapeBadger APIs, including Etsy, AliExpress, Target, ASOS, Best Buy, search engines, social media and general web scraping.
 
 ## Install
 
@@ -71,3 +71,17 @@ WebP up to 5 MiB are supported. Returns active listings in visual ranking order;
 10 credits per successful request. Filter with `--catalog-ids`, `--brand-ids`,
 `--status-ids`, `--color-ids`, `--size-ids`, `--material-ids` and price bounds.
 Resend the same image and `--time` from pagination when requesting `--page 2`.
+
+## Dedicated ecommerce APIs
+
+```bash
+scrapebadger etsy search "ceramic mug" --currency USD --country US
+scrapebadger aliexpress search "keyboard"
+scrapebadger target search "laptop" --zip-code 55403 --store-id 1375
+scrapebadger asos search "shoes" --market uk
+scrapebadger bestbuy search "laptop"
+```
+
+Run `scrapebadger <api> --help` to list product, review, store, availability and
+reference commands for that API. Each command supports `--help` for its exact
+parameters. Requests use your API key's existing permissions and credit balance.

{scrapebadger_cli-0.21.2 → scrapebadger_cli-0.22.0}/README.md

@@ -1,6 +1,6 @@
 # ScrapeBadger CLI
 
-Command-line interface for ScrapeBadger — Twitter, Vinted, and Web Scraping.
+Command-line access to ScrapeBadger APIs, including Etsy, AliExpress, Target, ASOS, Best Buy, search engines, social media and general web scraping.
 
 ## Install
 
@@ -49,3 +49,17 @@ WebP up to 5 MiB are supported. Returns active listings in visual ranking order;
 10 credits per successful request. Filter with `--catalog-ids`, `--brand-ids`,
 `--status-ids`, `--color-ids`, `--size-ids`, `--material-ids` and price bounds.
 Resend the same image and `--time` from pagination when requesting `--page 2`.
+
+## Dedicated ecommerce APIs
+
+```bash
+scrapebadger etsy search "ceramic mug" --currency USD --country US
+scrapebadger aliexpress search "keyboard"
+scrapebadger target search "laptop" --zip-code 55403 --store-id 1375
+scrapebadger asos search "shoes" --market uk
+scrapebadger bestbuy search "laptop"
+```
+
+Run `scrapebadger <api> --help` to list product, review, store, availability and
+reference commands for that API. Each command supports `--help` for its exact
+parameters. Requests use your API key's existing permissions and credit balance.

{scrapebadger_cli-0.21.2 → scrapebadger_cli-0.22.0}/pyproject.toml

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

scrapebadger_cli-0.22.0/src/scrapebadger_cli/__init__.py

@@ -0,0 +1 @@
+"""ScrapeBadger CLI for ecommerce, search, social and general web scraping APIs."""

scrapebadger_cli-0.22.0/src/scrapebadger_cli/commands/aliexpress.py

@@ -0,0 +1,181 @@
+"""AliExpress dedicated API commands."""
+
+from urllib.parse import quote
+
+import typer
+
+from scrapebadger_cli.client import api_get
+from scrapebadger_cli.output import render
+
+app = typer.Typer(no_args_is_help=True)
+
+
+@app.command("search")
+def search(
+    query: str = typer.Argument(...),
+    page: int = typer.Option(1, "--page"),
+    country: str = typer.Option("US", "--country"),
+    currency: str = typer.Option("USD", "--currency"),
+    language: str = typer.Option("en", "--language"),
+    sort: str = typer.Option("default", "--sort"),
+    min_price: float | None = typer.Option(None, "--min-price"),
+    max_price: float | None = typer.Option(None, "--max-price"),
+    fmt: str = typer.Option("json", "--output", "-o"),
+    fields: str | None = typer.Option(None, "--fields", "-f"),
+) -> None:
+    "Search products. 5 credits."
+    render(
+        api_get(
+            "/v1/aliexpress/search",
+            {
+                "query": query,
+                "page": page,
+                "country": country,
+                "currency": currency,
+                "language": language,
+                "sort": sort,
+                "min_price": min_price,
+                "max_price": max_price,
+            },
+        ),
+        fmt,
+        fields,
+    )
+
+
+@app.command("product")
+def product(
+    product_id: str = typer.Argument(...),
+    country: str = typer.Option("US", "--country"),
+    currency: str = typer.Option("USD", "--currency"),
+    language: str = typer.Option("en_US", "--language"),
+    fmt: str = typer.Option("json", "--output", "-o"),
+    fields: str | None = typer.Option(None, "--fields", "-f"),
+) -> None:
+    "Get product detail. 5 credits."
+    render(
+        api_get(
+            f"/v1/aliexpress/products/{quote(str(product_id), safe='')}",
+            {"country": country, "currency": currency, "language": language},
+        ),
+        fmt,
+        fields,
+    )
+
+
+@app.command("reviews")
+def reviews(
+    product_id: str = typer.Argument(...),
+    page: int = typer.Option(1, "--page"),
+    page_size: int = typer.Option(10, "--page-size"),
+    sort: str = typer.Option("complex_default", "--sort"),
+    fmt: str = typer.Option("json", "--output", "-o"),
+    fields: str | None = typer.Option(None, "--fields", "-f"),
+) -> None:
+    "Get product reviews. 5 credits."
+    render(
+        api_get(
+            f"/v1/aliexpress/products/{quote(str(product_id), safe='')}/reviews",
+            {"page": page, "page_size": page_size, "sort": sort},
+        ),
+        fmt,
+        fields,
+    )
+
+
+@app.command("store")
+def store(
+    store_id: str = typer.Argument(...),
+    country: str = typer.Option("US", "--country"),
+    currency: str = typer.Option("USD", "--currency"),
+    language: str = typer.Option("en", "--language"),
+    fmt: str = typer.Option("json", "--output", "-o"),
+    fields: str | None = typer.Option(None, "--fields", "-f"),
+) -> None:
+    "Get store profile. 10 credits."
+    render(
+        api_get(
+            f"/v1/aliexpress/stores/{quote(str(store_id), safe='')}",
+            {"country": country, "currency": currency, "language": language},
+        ),
+        fmt,
+        fields,
+    )
+
+
+@app.command("store-products")
+def store_products(
+    store_id: str = typer.Argument(...),
+    page: int = typer.Option(1, "--page"),
+    page_size: int = typer.Option(24, "--page-size"),
+    country: str = typer.Option("US", "--country"),
+    currency: str = typer.Option("USD", "--currency"),
+    language: str = typer.Option("en", "--language"),
+    query: str = typer.Option("", "--query"),
+    sort: str = typer.Option("bestmatch_sort", "--sort"),
+    fmt: str = typer.Option("json", "--output", "-o"),
+    fields: str | None = typer.Option(None, "--fields", "-f"),
+) -> None:
+    "Get store products. 10 credits."
+    render(
+        api_get(
+            f"/v1/aliexpress/stores/{quote(str(store_id), safe='')}/products",
+            {
+                "page": page,
+                "page_size": page_size,
+                "country": country,
+                "currency": currency,
+                "language": language,
+                "query": query,
+                "sort": sort,
+            },
+        ),
+        fmt,
+        fields,
+    )
+
+
+@app.command("autocomplete")
+def autocomplete(
+    query: str = typer.Argument(...),
+    country: str = typer.Option("US", "--country"),
+    language: str = typer.Option("en", "--language"),
+    fmt: str = typer.Option("json", "--output", "-o"),
+    fields: str | None = typer.Option(None, "--fields", "-f"),
+) -> None:
+    "Get search suggestions. 5 credits."
+    render(
+        api_get(
+            "/v1/aliexpress/autocomplete",
+            {"query": query, "country": country, "language": language},
+        ),
+        fmt,
+        fields,
+    )
+
+
+@app.command("categories")
+def categories(
+    fmt: str = typer.Option("json", "--output", "-o"),
+    fields: str | None = typer.Option(None, "--fields", "-f"),
+) -> None:
+    "Get category navigation. 5 credits."
+    render(api_get("/v1/aliexpress/categories", {}), fmt, fields)
+
+
+@app.command("store-categories")
+def store_categories(
+    store_id: str = typer.Argument(...),
+    country: str = typer.Option("US", "--country"),
+    fmt: str = typer.Option("json", "--output", "-o"),
+    fields: str | None = typer.Option(None, "--fields", "-f"),
+) -> None:
+    "Get store product categories. 5 credits."
+    render(
+        api_get(
+            f"/v1/aliexpress/stores/{quote(str(store_id), safe='')}/categories",
+            {"country": country},
+        ),
+        fmt,
+        fields,
+    )

scrapebadger_cli-0.22.0/src/scrapebadger_cli/commands/asos.py

@@ -0,0 +1,188 @@
+"""ASOS fashion product 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="json, csv, table, markdown")
+FIELDS = typer.Option(None, "--fields", "-f", help="Comma-separated fields")
+MARKET = typer.Option("uk", "--market", "-m", help="uk, us, au, de, fr, it, es, nl, se, dk, pl")
+
+
+@app.command()
+def search(
+    query: str | None = typer.Argument(None),
+    market: str = MARKET,
+    category_id: int | None = typer.Option(None, "--category-id"),
+    offset: int = typer.Option(0),
+    limit: int = typer.Option(48),
+    sort: str = typer.Option("recommended", help="recommended, freshness, priceasc, pricedesc"),
+    brand: str | None = typer.Option(None, help="Comma-separated brand facet ids"),
+    colour: str | None = typer.Option(None, help="Comma-separated colour facet ids"),
+    size: str | None = typer.Option(None, help="Comma-separated size facet ids"),
+    min_price: float | None = typer.Option(None),
+    max_price: float | None = typer.Option(None),
+    store: str | None = typer.Option(None),
+    country: str | None = typer.Option(None),
+    currency: str | None = typer.Option(None),
+    language: str | None = typer.Option(None),
+    fmt: str = FMT,
+    fields: str | None = FIELDS,
+) -> None:
+    """Search by keyword, category, price and fashion facets."""
+    params = {k: v for k, v in locals().items() if k not in ("fmt", "fields")}
+    render(api_get("/v1/asos/search", params), fmt, fields)
+
+
+@app.command()
+def product(
+    product_id: int,
+    market: str = MARKET,
+    store: str | None = typer.Option(None),
+    country: str | None = typer.Option(None),
+    currency: str | None = typer.Option(None),
+    language: str | None = typer.Option(None),
+    fmt: str = FMT,
+    fields: str | None = FIELDS,
+) -> None:
+    """Product details with live prices; --currency overrides prices while copy follows --market."""
+    render(
+        api_get(
+            f"/v1/asos/products/{product_id}",
+            {
+                "market": market,
+                "store": store,
+                "country": country,
+                "currency": currency,
+                "language": language,
+            },
+        ),
+        fmt,
+        fields,
+    )
+
+
+@app.command("stock-price")
+def stock_price(
+    product_ids: str,
+    market: str = MARKET,
+    store: str | None = typer.Option(None, "--store"),
+    country: str | None = typer.Option(None, "--country"),
+    currency: str | None = typer.Option(None, "--currency"),
+    language: str | None = typer.Option(None, "--language"),
+    fmt: str = FMT,
+    fields: str | None = FIELDS,
+) -> None:
+    """Refresh live stock and prices for comma-separated product IDs (up to 50)."""
+    render(
+        api_get(
+            "/v1/asos/stock-price",
+            {
+                "product_ids": product_ids,
+                "market": market,
+                "store": store,
+                "country": country,
+                "currency": currency,
+                "language": language,
+            },
+        ),
+        fmt,
+        fields,
+    )
+
+
+@app.command()
+def categories(
+    market: str = MARKET,
+    gender: str = typer.Option("men"),
+    store: str | None = typer.Option(None, "--store"),
+    country: str | None = typer.Option(None, "--country"),
+    currency: str | None = typer.Option(None, "--currency"),
+    language: str | None = typer.Option(None, "--language"),
+    fmt: str = FMT,
+    fields: str | None = FIELDS,
+) -> None:
+    """Nested navigation for men or women."""
+    render(
+        api_get(
+            "/v1/asos/categories",
+            {
+                "market": market,
+                "gender": gender,
+                "store": store,
+                "country": country,
+                "currency": currency,
+                "language": language,
+            },
+        ),
+        fmt,
+        fields,
+    )
+
+
+@app.command()
+def autocomplete(
+    query: str,
+    market: str = MARKET,
+    store: str | None = typer.Option(None, "--store"),
+    country: str | None = typer.Option(None, "--country"),
+    currency: str | None = typer.Option(None, "--currency"),
+    language: str | None = typer.Option(None, "--language"),
+    fmt: str = FMT,
+    fields: str | None = FIELDS,
+) -> None:
+    """Search suggestions with result counts."""
+    render(
+        api_get(
+            "/v1/asos/autocomplete",
+            {
+                "query": query,
+                "market": market,
+                "store": store,
+                "country": country,
+                "currency": currency,
+                "language": language,
+            },
+        ),
+        fmt,
+        fields,
+    )
+
+
+@app.command()
+def filters(
+    query: str | None = typer.Argument(None),
+    market: str = MARKET,
+    category_id: int | None = typer.Option(None, "--category-id"),
+    store: str | None = typer.Option(None, "--store"),
+    country: str | None = typer.Option(None, "--country"),
+    currency: str | None = typer.Option(None, "--currency"),
+    language: str | None = typer.Option(None, "--language"),
+    fmt: str = FMT,
+    fields: str | None = FIELDS,
+) -> None:
+    """Facet option IDs and counts for keyword/category searches."""
+    render(
+        api_get(
+            "/v1/asos/filters",
+            {
+                "query": query,
+                "market": market,
+                "category_id": category_id,
+                "store": store,
+                "country": country,
+                "currency": currency,
+                "language": language,
+            },
+        ),
+        fmt,
+        fields,
+    )
+
+
+@app.command()
+def markets(fmt: str = FMT, fields: str | None = FIELDS) -> None:
+    """Supported storefront defaults. Free."""
+    render(api_get("/v1/asos/markets"), fmt, fields)

scrapebadger_cli-0.22.0/src/scrapebadger_cli/commands/bestbuy.py

@@ -0,0 +1,142 @@
+"""Best Buy catalogue commands."""
+
+import typer
+
+from scrapebadger_cli.client import api_get
+from scrapebadger_cli.output import render
+
+app = typer.Typer(no_args_is_help=True)
+
+
+@app.command("markets")
+def markets(
+    output: str = typer.Option("json", "--output", "-o"),
+    fields: str | None = typer.Option(None, "--fields"),
+) -> None:
+    """List supported markets."""
+    render(api_get("/v1/bestbuy/markets", {}), output, fields)
+
+
+@app.command("search")
+def search(
+    query: str = typer.Option(..., "--query"),
+    page: int = typer.Option(1, "--page"),
+    sort: str = typer.Option("best_match", "--sort"),
+    output: str = typer.Option("json", "--output", "-o"),
+    fields: str | None = typer.Option(None, "--fields"),
+) -> None:
+    """Search products."""
+    render(
+        api_get("/v1/bestbuy/search", {"query": query, "page": page, "sort": sort}), output, fields
+    )
+
+
+@app.command("category")
+def category(
+    category_id: str = typer.Option(..., "--category-id"),
+    page: int = typer.Option(1, "--page"),
+    output: str = typer.Option("json", "--output", "-o"),
+    fields: str | None = typer.Option(None, "--fields"),
+) -> None:
+    """Browse a category."""
+    render(
+        api_get("/v1/bestbuy/category", {"category_id": category_id, "page": page}), output, fields
+    )
+
+
+@app.command("categories")
+def categories(
+    query: str = typer.Option("laptop", "--query"),
+    output: str = typer.Option("json", "--output", "-o"),
+    fields: str | None = typer.Option(None, "--fields"),
+) -> None:
+    """Get categories."""
+    render(api_get("/v1/bestbuy/categories", {"query": query}), output, fields)
+
+
+@app.command("deals")
+def deals(
+    page: int = typer.Option(1, "--page"),
+    output: str = typer.Option("json", "--output", "-o"),
+    fields: str | None = typer.Option(None, "--fields"),
+) -> None:
+    """Get laptop and computer deals."""
+    render(api_get("/v1/bestbuy/deals", {"page": page}), output, fields)
+
+
+@app.command("autocomplete")
+def autocomplete(
+    query: str = typer.Option(..., "--query"),
+    output: str = typer.Option("json", "--output", "-o"),
+    fields: str | None = typer.Option(None, "--fields"),
+) -> None:
+    """Get search suggestions."""
+    render(api_get("/v1/bestbuy/autocomplete", {"query": query}), output, fields)
+
+
+@app.command("products-sku-reviews")
+def products_sku_reviews(
+    sku: str = typer.Argument(...),
+    page: int = typer.Option(1, "--page"),
+    page_size: int = typer.Option(10, "--page-size"),
+    sort: str = typer.Option("MOST_RECENT", "--sort"),
+    output: str = typer.Option("json", "--output", "-o"),
+    fields: str | None = typer.Option(None, "--fields"),
+) -> None:
+    """Get product reviews."""
+    render(
+        api_get(
+            f"/v1/bestbuy/products/{sku}/reviews",
+            {"page": page, "page_size": page_size, "sort": sort},
+        ),
+        output,
+        fields,
+    )
+
+
+@app.command("products-sku-questions")
+def products_sku_questions(
+    sku: str = typer.Argument(...),
+    page: int = typer.Option(1, "--page"),
+    page_size: int = typer.Option(10, "--page-size"),
+    query: str = typer.Option("", "--query"),
+    output: str = typer.Option("json", "--output", "-o"),
+    fields: str | None = typer.Option(None, "--fields"),
+) -> None:
+    """Get product questions."""
+    render(
+        api_get(
+            f"/v1/bestbuy/products/{sku}/questions",
+            {"page": page, "page_size": page_size, "query": query},
+        ),
+        output,
+        fields,
+    )
+
+
+@app.command("products-sku-availability")
+def products_sku_availability(
+    sku: str = typer.Argument(...),
+    zip_code: str = typer.Option(..., "--zip-code"),
+    store_id: str = typer.Option("7", "--store-id"),
+    output: str = typer.Option("json", "--output", "-o"),
+    fields: str | None = typer.Option(None, "--fields"),
+) -> None:
+    """Get product availability."""
+    render(
+        api_get(
+            f"/v1/bestbuy/products/{sku}/availability", {"zip_code": zip_code, "store_id": store_id}
+        ),
+        output,
+        fields,
+    )
+
+
+@app.command("get-product")
+def get_product(
+    sku: str = typer.Argument(...),
+    output: str = typer.Option("json", "--output", "-o"),
+    fields: str | None = typer.Option(None, "--fields"),
+) -> None:
+    """Get product detail."""
+    render(api_get(f"/v1/bestbuy/products/{sku}", {}), output, fields)

scrapebadger_cli-0.22.0/src/scrapebadger_cli/commands/etsy.py

@@ -0,0 +1,191 @@
+"""Etsy dedicated API commands."""
+
+from urllib.parse import quote
+
+import typer
+
+from scrapebadger_cli.client import api_get
+from scrapebadger_cli.output import render
+
+app = typer.Typer(no_args_is_help=True)
+
+
+@app.command("search")
+def search(
+    query: str = typer.Argument(...),
+    page: int = typer.Option(1, "--page"),
+    country: str = typer.Option("US", "--country"),
+    currency: str = typer.Option("USD", "--currency"),
+    language: str = typer.Option("en-US", "--language"),
+    sort: str = typer.Option("most_relevant", "--sort"),
+    min_price: float | None = typer.Option(None, "--min-price"),
+    max_price: float | None = typer.Option(None, "--max-price"),
+    fmt: str = typer.Option("json", "--output", "-o"),
+    fields: str | None = typer.Option(None, "--fields", "-f"),
+) -> None:
+    "Search listings. 10 credits."
+    render(
+        api_get(
+            "/v1/etsy/search",
+            {
+                "query": query,
+                "page": page,
+                "country": country,
+                "currency": currency,
+                "language": language,
+                "sort": sort,
+                "min_price": min_price,
+                "max_price": max_price,
+            },
+        ),
+        fmt,
+        fields,
+    )
+
+
+@app.command("listing")
+def listing(
+    listing_id: str = typer.Argument(...),
+    country: str = typer.Option("US", "--country"),
+    currency: str = typer.Option("USD", "--currency"),
+    language: str = typer.Option("en-US", "--language"),
+    fmt: str = typer.Option("json", "--output", "-o"),
+    fields: str | None = typer.Option(None, "--fields", "-f"),
+) -> None:
+    "Get listing detail. 10 credits."
+    render(
+        api_get(
+            f"/v1/etsy/listings/{quote(str(listing_id), safe='')}",
+            {"country": country, "currency": currency, "language": language},
+        ),
+        fmt,
+        fields,
+    )
+
+
+@app.command("shop")
+def shop(
+    shop_name: str = typer.Argument(...),
+    country: str = typer.Option("US", "--country"),
+    currency: str = typer.Option("USD", "--currency"),
+    language: str = typer.Option("en-US", "--language"),
+    fmt: str = typer.Option("json", "--output", "-o"),
+    fields: str | None = typer.Option(None, "--fields", "-f"),
+) -> None:
+    "Get shop profile. 10 credits."
+    render(
+        api_get(
+            f"/v1/etsy/shops/{quote(str(shop_name), safe='')}",
+            {"country": country, "currency": currency, "language": language},
+        ),
+        fmt,
+        fields,
+    )
+
+
+@app.command("shop-listings")
+def shop_listings(
+    shop_name: str = typer.Argument(...),
+    page: int = typer.Option(1, "--page"),
+    country: str = typer.Option("US", "--country"),
+    currency: str = typer.Option("USD", "--currency"),
+    language: str = typer.Option("en-US", "--language"),
+    fmt: str = typer.Option("json", "--output", "-o"),
+    fields: str | None = typer.Option(None, "--fields", "-f"),
+) -> None:
+    "Get shop listings. 10 credits."
+    render(
+        api_get(
+            f"/v1/etsy/shops/{quote(str(shop_name), safe='')}/listings",
+            {"page": page, "country": country, "currency": currency, "language": language},
+        ),
+        fmt,
+        fields,
+    )
+
+
+@app.command("shop-reviews")
+def shop_reviews(
+    shop_name: str = typer.Argument(...),
+    page: int = typer.Option(1, "--page"),
+    country: str = typer.Option("US", "--country"),
+    currency: str = typer.Option("USD", "--currency"),
+    language: str = typer.Option("en-US", "--language"),
+    fmt: str = typer.Option("json", "--output", "-o"),
+    fields: str | None = typer.Option(None, "--fields", "-f"),
+) -> None:
+    "Get shop reviews. 20 credits."
+    render(
+        api_get(
+            f"/v1/etsy/shops/{quote(str(shop_name), safe='')}/reviews",
+            {"page": page, "country": country, "currency": currency, "language": language},
+        ),
+        fmt,
+        fields,
+    )
+
+
+@app.command("categories")
+def categories(
+    country: str = typer.Option("US", "--country"),
+    currency: str = typer.Option("USD", "--currency"),
+    language: str = typer.Option("en-US", "--language"),
+    fmt: str = typer.Option("json", "--output", "-o"),
+    fields: str | None = typer.Option(None, "--fields", "-f"),
+) -> None:
+    "Get categories. 10 credits."
+    render(
+        api_get(
+            "/v1/etsy/categories", {"country": country, "currency": currency, "language": language}
+        ),
+        fmt,
+        fields,
+    )
+
+
+@app.command("listing-reviews")
+def listing_reviews(
+    listing_id: str = typer.Argument(...),
+    page: int = typer.Option(1, "--page"),
+    sort: str = typer.Option("Relevancy", "--sort"),
+    country: str = typer.Option("US", "--country"),
+    currency: str = typer.Option("USD", "--currency"),
+    language: str = typer.Option("en-US", "--language"),
+    fmt: str = typer.Option("json", "--output", "-o"),
+    fields: str | None = typer.Option(None, "--fields", "-f"),
+) -> None:
+    "Get listing reviews. 20 credits."
+    render(
+        api_get(
+            f"/v1/etsy/listings/{quote(str(listing_id), safe='')}/reviews",
+            {
+                "page": page,
+                "sort": sort,
+                "country": country,
+                "currency": currency,
+                "language": language,
+            },
+        ),
+        fmt,
+        fields,
+    )
+
+
+@app.command("autocomplete")
+def autocomplete(
+    query: str = typer.Argument(...),
+    country: str = typer.Option("US", "--country"),
+    currency: str = typer.Option("USD", "--currency"),
+    language: str = typer.Option("en-US", "--language"),
+    fmt: str = typer.Option("json", "--output", "-o"),
+    fields: str | None = typer.Option(None, "--fields", "-f"),
+) -> None:
+    "Get search suggestions. 20 credits."
+    render(
+        api_get(
+            "/v1/etsy/autocomplete",
+            {"query": query, "country": country, "currency": currency, "language": language},
+        ),
+        fmt,
+        fields,
+    )

scrapebadger_cli-0.22.0/src/scrapebadger_cli/commands/target.py

@@ -0,0 +1,182 @@
+"""Target catalogue commands."""
+
+import typer
+
+from scrapebadger_cli.client import api_get
+from scrapebadger_cli.output import render
+
+app = typer.Typer(no_args_is_help=True)
+
+
+@app.command("markets")
+def markets(
+    output: str = typer.Option("json", "--output", "-o"),
+    fields: str | None = typer.Option(None, "--fields"),
+) -> None:
+    """List supported markets."""
+    render(api_get("/v1/target/markets", {}), output, fields)
+
+
+@app.command("search")
+def search(
+    query: str = typer.Option(..., "--query"),
+    page: int = typer.Option(1, "--page"),
+    page_size: int = typer.Option(24, "--page-size"),
+    store_id: str = typer.Option("1375", "--store-id"),
+    zip_code: str = typer.Option("55403", "--zip-code"),
+    sort: str = typer.Option("relevance", "--sort"),
+    output: str = typer.Option("json", "--output", "-o"),
+    fields: str | None = typer.Option(None, "--fields"),
+) -> None:
+    """Search products."""
+    render(
+        api_get(
+            "/v1/target/search",
+            {
+                "query": query,
+                "page": page,
+                "page_size": page_size,
+                "store_id": store_id,
+                "zip_code": zip_code,
+                "sort": sort,
+            },
+        ),
+        output,
+        fields,
+    )
+
+
+@app.command("category")
+def category(
+    category_id: str = typer.Option(..., "--category-id"),
+    page: int = typer.Option(1, "--page"),
+    page_size: int = typer.Option(24, "--page-size"),
+    store_id: str = typer.Option("1375", "--store-id"),
+    zip_code: str = typer.Option("55403", "--zip-code"),
+    output: str = typer.Option("json", "--output", "-o"),
+    fields: str | None = typer.Option(None, "--fields"),
+) -> None:
+    """Browse a category."""
+    render(
+        api_get(
+            "/v1/target/category",
+            {
+                "category_id": category_id,
+                "page": page,
+                "page_size": page_size,
+                "store_id": store_id,
+                "zip_code": zip_code,
+            },
+        ),
+        output,
+        fields,
+    )
+
+
+@app.command("autocomplete")
+def autocomplete(
+    query: str = typer.Option(..., "--query"),
+    output: str = typer.Option("json", "--output", "-o"),
+    fields: str | None = typer.Option(None, "--fields"),
+) -> None:
+    """Get search suggestions."""
+    render(api_get("/v1/target/autocomplete", {"query": query}), output, fields)
+
+
+@app.command("stores")
+def stores(
+    zip_code: str = typer.Option(..., "--zip-code"),
+    limit: int = typer.Option(10, "--limit"),
+    output: str = typer.Option("json", "--output", "-o"),
+    fields: str | None = typer.Option(None, "--fields"),
+) -> None:
+    """Find nearby stores."""
+    render(api_get("/v1/target/stores", {"zip_code": zip_code, "limit": limit}), output, fields)
+
+
+@app.command("get-store")
+def get_store(
+    store_id: str = typer.Argument(...),
+    output: str = typer.Option("json", "--output", "-o"),
+    fields: str | None = typer.Option(None, "--fields"),
+) -> None:
+    """Get store detail."""
+    render(api_get(f"/v1/target/stores/{store_id}", {}), output, fields)
+
+
+@app.command("categories")
+def categories(
+    category_id: str = typer.Option("5xtly", "--category-id"),
+    output: str = typer.Option("json", "--output", "-o"),
+    fields: str | None = typer.Option(None, "--fields"),
+) -> None:
+    """Get categories."""
+    render(api_get("/v1/target/categories", {"category_id": category_id}), output, fields)
+
+
+@app.command("products-tcin-reviews")
+def products_tcin_reviews(
+    tcin: str = typer.Argument(...),
+    page: int = typer.Option(1, "--page"),
+    page_size: int = typer.Option(10, "--page-size"),
+    sort: str = typer.Option("most_recent", "--sort"),
+    output: str = typer.Option("json", "--output", "-o"),
+    fields: str | None = typer.Option(None, "--fields"),
+) -> None:
+    """Get product reviews."""
+    render(
+        api_get(
+            f"/v1/target/products/{tcin}/reviews",
+            {"page": page, "page_size": page_size, "sort": sort},
+        ),
+        output,
+        fields,
+    )
+
+
+@app.command("products-tcin-questions")
+def products_tcin_questions(
+    tcin: str = typer.Argument(...),
+    page: int = typer.Option(1, "--page"),
+    page_size: int = typer.Option(10, "--page-size"),
+    output: str = typer.Option("json", "--output", "-o"),
+    fields: str | None = typer.Option(None, "--fields"),
+) -> None:
+    """Get product questions."""
+    render(
+        api_get(f"/v1/target/products/{tcin}/questions", {"page": page, "page_size": page_size}),
+        output,
+        fields,
+    )
+
+
+@app.command("products-tcin-availability")
+def products_tcin_availability(
+    tcin: str = typer.Argument(...),
+    zip_code: str = typer.Option(..., "--zip-code"),
+    limit: int = typer.Option(10, "--limit"),
+    output: str = typer.Option("json", "--output", "-o"),
+    fields: str | None = typer.Option(None, "--fields"),
+) -> None:
+    """Get product availability."""
+    render(
+        api_get(f"/v1/target/products/{tcin}/availability", {"zip_code": zip_code, "limit": limit}),
+        output,
+        fields,
+    )
+
+
+@app.command("get-product")
+def get_product(
+    tcin: str = typer.Argument(...),
+    store_id: str = typer.Option("1375", "--store-id"),
+    zip_code: str = typer.Option("55403", "--zip-code"),
+    output: str = typer.Option("json", "--output", "-o"),
+    fields: str | None = typer.Option(None, "--fields"),
+) -> None:
+    """Get product detail."""
+    render(
+        api_get(f"/v1/target/products/{tcin}", {"store_id": store_id, "zip_code": zip_code}),
+        output,
+        fields,
+    )

{scrapebadger_cli-0.21.2 → scrapebadger_cli-0.22.0}/src/scrapebadger_cli/main.py

@@ -4,17 +4,21 @@ import typer
 
 from scrapebadger_cli.commands import (
     airbnb,
+    aliexpress,
     amazon,
     apartments,
     app_store,
+    asos,
     auth,
     baidu,
+    bestbuy,
     bing,
     booking,
     chatgpt,
     depop,
     duckduckgo,
     ebay,
+    etsy,
     facebook,
     gemini,
     google,
@@ -32,6 +36,7 @@ from scrapebadger_cli.commands import (
     reddit,
     redfin,
     stream,
+    target,
     tiktok,
     twitter,
     vinted,
@@ -58,6 +63,11 @@ app.add_typer(vinted.app, name="vinted", help="Vinted marketplace commands")
 app.add_typer(amazon.app, name="amazon", help="Amazon marketplace commands")
 app.add_typer(ebay.app, name="ebay", help="eBay marketplace commands")
 app.add_typer(walmart.app, name="walmart", help="Walmart marketplace commands")
+app.add_typer(aliexpress.app, name="aliexpress", help="Aliexpress scraper commands")
+app.add_typer(etsy.app, name="etsy", help="Etsy scraper commands")
+app.add_typer(bestbuy.app, name="bestbuy", help="Bestbuy scraper commands")
+app.add_typer(target.app, name="target", help="Target scraper commands")
+app.add_typer(asos.app, name="asos", help="Asos scraper commands")
 app.add_typer(gumtree.app, name="gumtree", help="Gumtree classifieds commands (UK, AU, ZA)")
 app.add_typer(google_play.app, name="google-play", help="Google Play Store commands")
 app.add_typer(app_store.app, name="app-store", help="Apple App Store commands")

{scrapebadger_cli-0.21.2 → scrapebadger_cli-0.22.0}/uv.lock

@@ -228,7 +228,7 @@ wheels = [
 
 [[package]]
 name = "scrapebadger-cli"
-version = "0.21.1"
+version = "0.22.0"
 source = { editable = "." }
 dependencies = [
     { name = "httpx" },

scrapebadger_cli-0.21.2/src/scrapebadger_cli/__init__.py

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