sellerclaw-cli 3.1.2__tar.gz → 3.2.0__tar.gz

{sellerclaw_cli-3.1.2 → sellerclaw_cli-3.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: sellerclaw-cli
-Version: 3.1.2
+Version: 3.2.0
 Summary: Command-line client and MCP server for the SellerClaw Agent API — run your stores, orders, listings, ads and suppliers from a terminal, scripts, or Claude. LLM-friendly JSON, browser sign-in.
 Project-URL: Homepage, https://sellerclaw.ai
 Project-URL: Documentation, https://github.com/sellerai-com/sellerclaw-cli#readme
@@ -525,10 +525,13 @@ New CLI commands appear automatically — there is nothing per-command to mainta
 Alongside those four, a client that supports [MCP Apps](https://modelcontextprotocol.io) gets
 **interactive cards** for the questions a seller asks most — what needs them today
 (`sellerclaw_attention`), how a store is doing (`sellerclaw_store_summary`), the orders or one
-order (`sellerclaw_orders`), listings or one listing (`sellerclaw_listings`), ads across every
+order (`sellerclaw_orders`), listings or one listing (`sellerclaw_listings`), a catalog product
+with its supplier and every store it is listed in (`sellerclaw_products`), ads across every
 platform (`sellerclaw_ads`), the health of every connection (`sellerclaw_connections`), and a
-request waiting on the owner (`sellerclaw_approval`). The cards show; changing anything still goes
-through `sellerclaw_run`. A client without cards gets the same answers as a short text summary plus
+request waiting on the owner (`sellerclaw_approval`). The order, listing and product cards find what
+the owner names in their own words — an order number, a title, a SKU — and open it when only one
+matches. The cards show;
+changing anything still goes through `sellerclaw_run`. A client without cards gets the same answers as a short text summary plus
 the full structured result.
 
 The guides live in the package ([`sellerclaw_cli/guides/`](sellerclaw_cli/guides/)) and are the same

{sellerclaw_cli-3.1.2 → sellerclaw_cli-3.2.0}/README.md

@@ -490,10 +490,13 @@ New CLI commands appear automatically — there is nothing per-command to mainta
 Alongside those four, a client that supports [MCP Apps](https://modelcontextprotocol.io) gets
 **interactive cards** for the questions a seller asks most — what needs them today
 (`sellerclaw_attention`), how a store is doing (`sellerclaw_store_summary`), the orders or one
-order (`sellerclaw_orders`), listings or one listing (`sellerclaw_listings`), ads across every
+order (`sellerclaw_orders`), listings or one listing (`sellerclaw_listings`), a catalog product
+with its supplier and every store it is listed in (`sellerclaw_products`), ads across every
 platform (`sellerclaw_ads`), the health of every connection (`sellerclaw_connections`), and a
-request waiting on the owner (`sellerclaw_approval`). The cards show; changing anything still goes
-through `sellerclaw_run`. A client without cards gets the same answers as a short text summary plus
+request waiting on the owner (`sellerclaw_approval`). The order, listing and product cards find what
+the owner names in their own words — an order number, a title, a SKU — and open it when only one
+matches. The cards show;
+changing anything still goes through `sellerclaw_run`. A client without cards gets the same answers as a short text summary plus
 the full structured result.
 
 The guides live in the package ([`sellerclaw_cli/guides/`](sellerclaw_cli/guides/)) and are the same

{sellerclaw_cli-3.1.2 → sellerclaw_cli-3.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "sellerclaw-cli"
-version = "3.1.2"
+version = "3.2.0"
 description = "Command-line client and MCP server for the SellerClaw Agent API — run your stores, orders, listings, ads and suppliers from a terminal, scripts, or Claude. LLM-friendly JSON, browser sign-in."
 readme = "README.md"
 requires-python = ">=3.11"

{sellerclaw_cli-3.1.2 → sellerclaw_cli-3.2.0}/sellerclaw_cli/_command_group.py

@@ -18,10 +18,11 @@ import difflib
 import inspect
 import mimetypes
 import re
-from collections.abc import Sequence
+from collections.abc import Mapping, Sequence
 from dataclasses import dataclass, replace
 from pathlib import Path
 from typing import Any
+from urllib.parse import quote
 
 import typer
 
@@ -237,12 +238,14 @@ def _validate_flag(f: Flag, value: object) -> None:
     """Reject out-of-range / out-of-choice values locally (clear error, no server round-trip)."""
     if value is None or value == [] or value is False:
         return
-    if f.choices and isinstance(value, str) and value not in f.choices:
-        emit_error(
-            UserInputError(
-                f"{f.primary_option}: must be one of {', '.join(f.choices)} (got {value!r})"
+    # A repeatable flag arrives as a list; each value is held to the same choices as a single one.
+    for item in value if isinstance(value, list) else [value]:
+        if f.choices and isinstance(item, str) and item not in f.choices:
+            emit_error(
+                UserInputError(
+                    f"{f.primary_option}: must be one of {', '.join(f.choices)} (got {item!r})"
+                )
             )
-        )
     if isinstance(value, int) and not isinstance(value, bool):
         if f.minimum is not None and value < f.minimum:
             emit_error(UserInputError(f"{f.primary_option}: must be >= {f.minimum} (got {value})"))
@@ -348,6 +351,19 @@ def positionals_of(path: str) -> list[str]:
     return _PATH_PARAM_RE.findall(path)
 
 
+def fill_path(path: str, values: Mapping[str, Any]) -> str:
+    """``path`` with each ``{placeholder}`` replaced by its value, encoded as one path segment.
+
+    What people call things does not stay inside a URL's rules: an order number is ``#1001``, and
+    put in the path as it is, ``#`` starts the fragment — the request reaches ``/agent/orders/``
+    and asks for something else entirely. Encoded, every value is one segment whatever it holds,
+    and the server reads it back decoded.
+    """
+    for name, value in values.items():
+        path = path.replace("{" + name + "}", quote(str(value), safe=""))
+    return path
+
+
 def command_help(cmd: Cmd) -> str:
     """Help blurb shown by ``<group> <cmd> --help`` and embedded in discovery output."""
     pieces: list[str] = []
@@ -634,9 +650,10 @@ def _expand_id_prefix(cmd: Cmd, positionals: dict[str, Any], prefix: str) -> str
     list_path = cmd.resolve_list_path
     if not list_path:
         return None
-    for name, value in positionals.items():
-        if name != cmd.active_positional:
-            list_path = list_path.replace("{" + name + "}", str(value))
+    list_path = fill_path(
+        list_path,
+        {name: value for name, value in positionals.items() if name != cmd.active_positional},
+    )
     try:
         with Client.from_env() as client:
             data = client.request("GET", list_path)
@@ -717,9 +734,7 @@ def _make_callback(group: str, cmd: Cmd):
                 cmd, values, values.get(cmd.active_positional)
             )
             values[cmd.active_positional] = resolved_active
-        path = cmd.path
-        for name in positionals:
-            path = path.replace("{" + name + "}", str(values[name]))
+        path = fill_path(cmd.path, {name: values[name] for name in positionals})
         body: Any = None
         if cmd.takes_body:
             raw_body = kwargs.pop("body")
@@ -754,8 +769,7 @@ def _make_callback(group: str, cmd: Cmd):
                 params[f.query_key] = value
         poll_path = cmd.job_poll_path
         if poll_path is not None:
-            for name in positionals:
-                poll_path = poll_path.replace("{" + name + "}", str(values[name]))
+            poll_path = fill_path(poll_path, {name: values[name] for name in positionals})
         run_operation(
             ctx,
             cmd.method,

{sellerclaw_cli-3.1.2 → sellerclaw_cli-3.2.0}/sellerclaw_cli/commands/listings.py

@@ -130,6 +130,17 @@ SPECS = (
                 ),
                 choices=("owner", "agent", "sync", "marketplace", "unknown"),
             ),
+            flag(
+                "sale_state",
+                repeatable=True,
+                help=(
+                    "Whether a shopper can buy it; repeat to combine. --sale-state out_of_stock "
+                    "--sale-state not_selling = 'what is not selling': live listings with nothing "
+                    "to sell, or that the channel hides, is reviewing, refused or lost. A live "
+                    "listing nobody can buy is still status 'active', so --status cannot ask this."
+                ),
+                choices=("selling", "out_of_stock", "not_selling", "not_published"),
+            ),
             flag("limit", type=int, minimum=1, maximum=200, default=25, help="Max results per page."),
             flag("offset", type=int, minimum=0, default=0, help="Results to skip (paging)."),
         ),

{sellerclaw_cli-3.1.2 → sellerclaw_cli-3.2.0}/sellerclaw_cli/commands/orders.py

@@ -66,7 +66,15 @@ SPECS = (
             ),
         ),
     ),
-    Cmd("get", "GET", "/agent/orders/{order_id}", summary="Get one order by id."),
+    Cmd(
+        "get",
+        "GET",
+        "/agent/orders/{order_id}",
+        summary=(
+            "Get one order by its id, its whole order number (#1001, the # optional) or the "
+            "marketplace's order id. A number two stores share answers 409 naming both."
+        ),
+    ),
     Cmd(
         "search",
         "GET",

{sellerclaw_cli-3.1.2 → sellerclaw_cli-3.2.0}/sellerclaw_cli/commands/research_seo.py

@@ -87,7 +87,15 @@ SPECS = (
         "/agent/research/seo/serp-competitors",
         summary="serp competitors research.",
         body=(
-            body_field("domain", required=True, help="Seed domain to find competitors for."),
+            body_field(
+                "keywords",
+                repeatable=True,
+                required=True,
+                help=(
+                    "Keywords whose Google results to read (1-200); the domains ranking for them "
+                    "are the competitors. Not a domain."
+                ),
+            ),
             body_field("location_name", help="Location name (e.g. 'United States')."),
             body_field("location_code", type=int, help="Numeric location code (overrides name)."),
             body_field("language_name", help="Language name (e.g. 'English')."),
@@ -121,7 +129,7 @@ SPECS = (
             body_field("location_code", type=int, help="Numeric location code (overrides name)."),
             body_field("language_name", help="Language name (e.g. 'English (United States)')."),
             body_field("language_code", help="Marketplace language code (e.g. 'en_US')."),
-            body_field("depth", type=int, help="Number of reviews to fetch (1-100). Defaults to 10."),
+            body_field("depth", type=int, help="Number of reviews to fetch (1-50). Defaults to 10."),
         ),
     ),
     Cmd(

{sellerclaw_cli-3.1.2 → sellerclaw_cli-3.2.0}/sellerclaw_cli/guides/listings.md

@@ -8,6 +8,7 @@ for `sellerclaw_describe` only for a command not shown here, or when a call erro
 ```text
 sellerclaw_run(group="channels", command="list")                       # store ids
 sellerclaw_run(group="listings", command="search", flags={"q": "wireless mouse"})   # find across all stores
+sellerclaw_run(group="listings", command="search", flags={"sale_state": ["out_of_stock", "not_selling"]})   # what shoppers cannot buy
 sellerclaw_run(group="shopify-listings", command="summary", positionals={"store_id": STORE_ID})
 ```
 

{sellerclaw_cli-3.1.2 → sellerclaw_cli-3.2.0}/sellerclaw_cli/guides/orders.md

@@ -36,7 +36,7 @@ Creating the fulfillment tells the *channel* and the buyer. The SellerClaw order
 separately — do it right after, or the order stays in the seller's open work:
 
 ```text
-# ORDER_ID here is the internal SellerClaw order id, not the channel's.
+# ORDER_ID: the SellerClaw order id, or the order number the owner quotes (#1001).
 sellerclaw_run(group="orders", command="set-shipped", positionals={"order_id": ORDER_ID},
   body={"tracking_number": "1Z999AA10123456784", "tracking_carrier": "UPS"})
 ```

{sellerclaw_cli-3.1.2 → sellerclaw_cli-3.2.0}/sellerclaw_cli/guides/research.md

@@ -13,7 +13,7 @@ sellerclaw_run(group="research-trends", command="related-queries", flags={"keywo
 
 # SEO / keyword research (body-driven)
 sellerclaw_run(group="research-seo", command="keyword-ideas",    body={"keyword": "wireless mouse"})
-sellerclaw_run(group="research-seo", command="serp-competitors", body={"keyword": "wireless mouse"})
+sellerclaw_run(group="research-seo", command="serp-competitors", body={"keywords": ["wireless mouse", "bluetooth mouse"]})
 
 # What the marketplace itself already lists (query, gtin, or a competitor's storefront)
 sellerclaw_run(group="research-catalog", command="ebay-search",
@@ -40,7 +40,9 @@ sellerclaw_run(group="web", command="scrape", flags={"url": "https://rival.examp
 
 ## A listing on a marketplace is data, not a page
 
-`listing-get` returns a rival's price, stock, seller, condition, rating and specifications as fields.
+`listing-get` returns a rival's price, stock, seller, condition, rating and specifications as fields,
+plus the seller's own selling points (`features`) and `description` where the storefront publishes
+them — most publish no specifications, so capacity, materials and what is in the box are read there.
 Scraping the same page returns markdown a price still has to be guessed out of — and Amazon, Etsy and
 eBay answer plain fetches with a bot wall often enough that the guess is frequently of nothing. Reach
 for `web scrape` only for storefronts this does not cover.