scrapebadger-cli 0.16.0__tar.gz → 0.18.0__tar.gz

{scrapebadger_cli-0.16.0 → scrapebadger_cli-0.18.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: scrapebadger-cli
-Version: 0.16.0
+Version: 0.18.0
 Summary: ScrapeBadger CLI — Twitter, Vinted, Google, and Web Scraping from the command line
 Author: ScrapeBadger Team
 License: MIT

{scrapebadger_cli-0.16.0 → scrapebadger_cli-0.18.0}/pyproject.toml

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

{scrapebadger_cli-0.16.0 → scrapebadger_cli-0.18.0}/src/scrapebadger_cli/commands/facebook.py

@@ -163,6 +163,19 @@ def group(
     render(data, fmt, fields)
 
 
+@app.command(name="group-posts")
+def group_posts(
+    group_id: str = typer.Argument(..., help="Group ID or vanity slug"),
+    after: str | None = AFTER,
+    sort: str = typer.Option("newest", "--sort", help="newest, relevance"),
+    fmt: str = FMT,
+    fields: str | None = FIELDS,
+) -> None:
+    """Get a public Facebook group's post feed, 3 posts per page."""
+    data = api_get(f"/v1/facebook/groups/{group_id}/posts", {"after": after, "sort": sort})
+    render(data, fmt, fields)
+
+
 @app.command()
 def post(
     post_id: str = typer.Argument(..., help="Post ID"),

{scrapebadger_cli-0.16.0 → scrapebadger_cli-0.18.0}/src/scrapebadger_cli/commands/google.py

@@ -936,12 +936,16 @@ def lens(
     language: str | None = typer.Option(None, "--language", help="Language code (alias for --hl)"),
     gl: str | None = typer.Option(None, "--gl", help="Country code"),
     hl: str | None = typer.Option(None, "--hl", help="Language code"),
-    product: bool = typer.Option(False, "--product", help="Bias towards shoppable matches"),
+    product: bool = typer.Option(
+        False, "--product", help="Only the tiles Google marked buyable (price + stock)"
+    ),
     visual_matches: bool = typer.Option(
-        True, "--visual-matches/--no-visual-matches", help="Include visual-matches carousel"
+        True,
+        "--visual-matches/--no-visual-matches",
+        help="Always returned; --no-visual-matches is reported back in warnings",
     ),
     exact_matches: bool = typer.Option(
-        False, "--exact-matches", help="Restrict to exact matches only"
+        False, "--exact-matches", help="Only the pages hosting this image; falls back to the grid"
     ),
     fmt: str = FMT,
     fields: str | None = FIELDS,
@@ -953,6 +957,14 @@ def lens(
     `price` ({value, currency, extracted}) and the raw `tag` chip on
     shoppable matches, and `related_searches` chips. Legacy `results`
     alias kept for backwards compat.
+
+    `--exact-matches` returns just the pages hosting the image, flagged
+    `exact_match`, instead of the broad grid. Available for most images;
+    otherwise the full grid comes back and `warnings` says so.
+
+    Also carries `warnings`: any parameter that could not be applied is named
+    there, including an exact-match lookup that came back empty. Note that
+    `--fields` filters it out unless you ask for it.
     """
     data = api_get(
         "/v1/google/lens/search",
@@ -1250,13 +1262,34 @@ def ads_creative(
 @app.command(name="ads-advertisers")
 def ads_advertisers(
     query: str = typer.Argument(..., help="Advertiser name or domain (min 2 chars)"),
-    region: str = typer.Option("US", "--region"),
-    num: int = typer.Option(10, "--num", help="1-20"),
+    region: str = typer.Option("US", "--region", help="Echoed only; --country filters"),
+    num: int = typer.Option(10, "--num", help="Advertisers, 1-3000"),
+    num_domains: int = typer.Option(10, "--num-domains", help="Domain rows, 0-100"),
+    country: str | None = typer.Option(
+        None, "--country", help="ISO2: only advertisers registered there"
+    ),
+    fuzzy: bool = typer.Option(
+        False,
+        "--fuzzy",
+        help="Also find misspelled / look-alike advertisers, ranked by similarity (15 credits)",
+    ),
+    cursor: str | None = typer.Option(None, "--cursor", help="next_page_token: more domains"),
     fmt: str = FMT,
     fields: str | None = FIELDS,
 ) -> None:
     """Search Ads Transparency advertisers (autocomplete)."""
-    data = api_get("/v1/google/ads/advertisers", {"query": query, "region": region, "num": num})
+    data = api_get(
+        "/v1/google/ads/advertisers",
+        {
+            "query": query,
+            "region": region,
+            "num": num,
+            "num_domains": num_domains,
+            "country": country,
+            "fuzzy": fuzzy,
+            "cursor": cursor,
+        },
+    )
     render(data, fmt, fields)