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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: sellerclaw-cli
-Version: 3.2.0
+Version: 3.3.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

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

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "sellerclaw-cli"
-version = "3.2.0"
+version = "3.3.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.2.0 → sellerclaw_cli-3.3.0}/sellerclaw_cli/commands/bigcommerce_listings.py

@@ -45,6 +45,14 @@ SPECS = (
                 choices=("active", "published", "draft", "withdrawn"),
                 help="Mirror status to filter by; omit for all.",
             ),
+            flag(
+                "marketplace_statuses",
+                type=bool,
+                help=(
+                    "Also count the products by BigCommerce's own status (visible/hidden) — hidden ones included, "
+                    "which the mirror does not hold. Asks BigCommerce; every other number is the same without it."
+                ),
+            ),
         ),
     ),
     Cmd(

{sellerclaw_cli-3.2.0 → sellerclaw_cli-3.3.0}/sellerclaw_cli/commands/research_catalog.py

@@ -18,8 +18,16 @@ _ALL_STOREFRONTS = (
     "ikea",
     "nike",
     "allbirds",
+    "shopify",
 )
 
+_STORE_HELP = (
+    "shopify only: one store's domain (or any link on it) — that store's own catalogue instead of "
+    "every Shopify store."
+)
+_COUNTRY_HELP = "shopify only: the buyer's two-letter country (US, GB, CA ...). Everything else here is US."
+_CURRENCY_HELP = "shopify only: the currency to price in (USD, GBP ...)."
+
 SPECS = (
     Cmd(
         "ebay-search",
@@ -68,7 +76,9 @@ SPECS = (
                 "listing_id",
                 help=(
                     "The storefront's own id: Amazon ASIN, eBay item number, Etsy listing id, "
-                    "Best Buy SKU, Newegg item number, Nike style-colour. A product URL also works."
+                    "Best Buy SKU, Newegg item number, Nike style-colour, Shopify gid://shopify/p/... "
+                    "(gid://shopify/Product/... with store). A product URL also works, except inside "
+                    "one Shopify store."
                 ),
             ),
             body_field(
@@ -79,7 +89,9 @@ SPECS = (
                     "Allbirds this is a second call and costs twice as much."
                 ),
             ),
-            body_field("currency", help="Preferred display currency where supported (Etsy)."),
+            body_field("currency", help="Preferred display currency where supported (Etsy, Shopify)."),
+            body_field("store", help=_STORE_HELP),
+            body_field("country", help=_COUNTRY_HELP),
         ),
     ),
     Cmd(
@@ -91,23 +103,36 @@ SPECS = (
             body_field(
                 "marketplace",
                 required=True,
-                choices=("amazon", "bestbuy", "newegg", "nike", "allbirds"),
-                help="Storefront to search. eBay has its own richer command: ebay-search.",
+                choices=("amazon", "bestbuy", "newegg", "nike", "allbirds", "shopify"),
+                help=(
+                    "Storefront to search. shopify searches every Shopify store and names the store "
+                    "selling each row. eBay has its own richer command: ebay-search."
+                ),
+            ),
+            body_field(
+                "query",
+                help="What to search for. Required, except when browsing one Shopify store (store).",
             ),
-            body_field("query", required=True, help="What to search for."),
             body_field("limit", type=int, help="Max rows (1-50). Defaults to 10."),
             body_field(
                 "page",
                 type=int,
                 help="Result page, on storefronts that page (amazon, bestbuy, newegg).",
             ),
+            body_field(
+                "cursor",
+                help="shopify only: the previous page's next_cursor, sent with the same search.",
+            ),
+            body_field("store", help=_STORE_HELP),
+            body_field("country", help=_COUNTRY_HELP),
+            body_field("currency", help=_CURRENCY_HELP),
         ),
     ),
     Cmd(
         "listing-prices",
         "POST",
         "/agent/research/catalog/listings/prices",
-        summary="Re-check what up to 5 known listings cost right now, on one storefront.",
+        summary="Re-check what up to 5 known listings (50 on Shopify) cost right now, on one storefront.",
         body=(
             body_field(
                 "marketplace",
@@ -121,11 +146,14 @@ SPECS = (
                 required=True,
                 example=["B09B8V1LZ3", "B07QK2SPP7"],
                 help=(
-                    "Up to 5 storefront ids, or product URLs. Amazon checks all of them in one "
-                    "call; other storefronts are read one at a time and charged per listing. "
-                    "target, ikea and allbirds take the product URL."
+                    "Up to 5 storefront ids, or product URLs — 50 on shopify (10 inside one store). "
+                    "Amazon and Shopify check them all in one call; other storefronts are read one "
+                    "at a time and charged per listing. target, ikea and allbirds take the product URL."
                 ),
             ),
+            body_field("store", help=_STORE_HELP),
+            body_field("country", help=_COUNTRY_HELP),
+            body_field("currency", help=_CURRENCY_HELP),
         ),
     ),
 )

{sellerclaw_cli-3.2.0 → sellerclaw_cli-3.3.0}/sellerclaw_cli/commands/shopify_listings.py

@@ -63,7 +63,9 @@ SPECS = (
             "carries the remote_product_id that `update` and `delete` take, already deduplicated, "
             "plus the product's title, category, variant count, stock and price range. Use this "
             "for anything product-level — reviewing categories, finding uncategorized products, "
-            "picking what to delete — instead of `list` plus grouping the variant rows yourself."
+            "picking what to delete — instead of `list` plus grouping the variant rows yourself. "
+            "Paged: `total` counts the whole store's products; `next_offset` is where the next "
+            "page starts (null on the last) — pass it as `--offset` until it is null."
         ),
         flags=(
             flag(
@@ -71,6 +73,20 @@ SPECS = (
                 choices=("active", "published", "draft", "withdrawn"),
                 help="Mirror status to filter the underlying rows by; omit for all live listings.",
             ),
+            flag(
+                "limit",
+                type=int,
+                minimum=1,
+                maximum=500,
+                help="Max products per page (default and max 500). A page can hold fewer.",
+            ),
+            flag(
+                "offset",
+                type=int,
+                minimum=0,
+                default=0,
+                help="Products to skip — the previous page's `next_offset`.",
+            ),
         ),
     ),
     Cmd(
@@ -87,6 +103,15 @@ SPECS = (
                 choices=("active", "published", "draft", "withdrawn"),
                 help="Mirror status to filter by; omit for all live listings.",
             ),
+            flag(
+                "marketplace_statuses",
+                type=bool,
+                help=(
+                    "Also count the products by Shopify's own status (active/draft/archived) — drafts and archived "
+                    "included, which the mirror does not hold. Asks Shopify; every other number is the same without "
+                    "it."
+                ),
+            ),
         ),
     ),
     Cmd(

{sellerclaw_cli-3.2.0 → sellerclaw_cli-3.3.0}/sellerclaw_cli/commands/tiktok_shop_listings.py

@@ -47,6 +47,14 @@ SPECS = (
                 choices=("active", "published", "draft", "withdrawn"),
                 help="Mirror status to filter by; omit for all.",
             ),
+            flag(
+                "marketplace_statuses",
+                type=bool,
+                help=(
+                    "Also count the products by TikTok Shop's own status — those not on sale included, which the "
+                    "mirror does not hold. Asks TikTok Shop; every other number is the same without it."
+                ),
+            ),
         ),
     ),
     Cmd(

{sellerclaw_cli-3.2.0 → sellerclaw_cli-3.3.0}/sellerclaw_cli/commands/walmart_listings.py

@@ -46,6 +46,14 @@ SPECS = (
                 choices=("active", "published", "draft", "withdrawn"),
                 help="Mirror status to filter by; omit for all.",
             ),
+            flag(
+                "marketplace_statuses",
+                type=bool,
+                help=(
+                    "Also count the items by Walmart's own lifecycle status (active/retired) — retired ones included,"
+                    " which the mirror does not hold. Asks Walmart; every other number is the same without it."
+                ),
+            ),
         ),
     ),
     Cmd(

{sellerclaw_cli-3.2.0 → sellerclaw_cli-3.3.0}/sellerclaw_cli/commands/wix_listings.py

@@ -45,6 +45,14 @@ SPECS = (
                 choices=("active", "published", "draft", "withdrawn"),
                 help="Mirror status to filter by; omit for all.",
             ),
+            flag(
+                "marketplace_statuses",
+                type=bool,
+                help=(
+                    "Also count the products by Wix's own status (visible/hidden) — hidden ones included, which the "
+                    "mirror does not hold. Asks Wix; every other number is the same without it."
+                ),
+            ),
         ),
     ),
     Cmd(

{sellerclaw_cli-3.2.0 → sellerclaw_cli-3.3.0}/sellerclaw_cli/commands/woocommerce_listings.py

@@ -45,6 +45,15 @@ SPECS = (
                 choices=("active", "published", "draft", "withdrawn"),
                 help="Mirror status to filter by; omit for all.",
             ),
+            flag(
+                "marketplace_statuses",
+                type=bool,
+                help=(
+                    "Also count the products by WooCommerce's own status (publish/draft/pending/private) — "
+                    "unpublished ones included, which the mirror does not hold. Asks WooCommerce; every other number "
+                    "is the same without it."
+                ),
+            ),
         ),
     ),
     Cmd(

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

@@ -29,6 +29,12 @@ sellerclaw_run(group="research-catalog", command="listing-search",
 sellerclaw_run(group="research-catalog", command="listing-prices",
   body={"marketplace": "amazon", "listing_ids": ["B09B8V1LZ3", "B07QK2SPP7"]})
 
+# Every Shopify store at once — which stores sell it, at what price — or one store's whole catalogue
+sellerclaw_run(group="research-catalog", command="listing-search",
+  body={"marketplace": "shopify", "query": "insulated water bottle", "country": "US", "limit": 20})
+sellerclaw_run(group="research-catalog", command="listing-search",
+  body={"marketplace": "shopify", "store": "www.rival-store.com", "limit": 50})
+
 # A competitor's social presence: the account, then what it publishes
 sellerclaw_run(group="research-social", command="instagram-profile", body={"handle": "rivalbrand"})
 sellerclaw_run(group="research-social", command="tiktok-profile-videos",
@@ -48,12 +54,13 @@ eBay answer plain fetches with a bot wall often enough that the guess is frequen
 for `web scrape` only for storefronts this does not cover.
 
 Storefronts covered: `amazon`, `ebay`, `etsy`, `bestbuy`, `newegg`, `target`, `ikea`, `nike`,
-`allbirds` — all US. Give `url` and the storefront is recognised from it; give `marketplace` +
-`listing_id` when you have the id instead.
+`allbirds` — all US — and `shopify`, every store on Shopify in any country. Give `url` and the
+storefront is recognised from it; give `marketplace` + `listing_id` when you have the id instead. A
+store on Shopify runs under its own domain, so send its links with `"marketplace": "shopify"`.
 
 What is worth knowing before you call:
 
-- **Keyword search** exists for `amazon`, `bestbuy`, `newegg`, `nike` and `allbirds`. For eBay use
+- **Keyword search** exists for `amazon`, `bestbuy`, `newegg`, `nike`, `allbirds` and `shopify`. For eBay use
   `ebay-search` — the official API, free, and it also covers GTINs and whole storefronts. Etsy
   publishes no reachable keyword search at all.
 - **Best Buy and Nike need their own id.** Best Buy's newer URLs dropped the numeric SKU and Nike is
@@ -69,6 +76,22 @@ What is worth knowing before you call:
 - **A field that is absent was not published** — Target often publishes no price, IKEA no stock. An
   absent key is never zero, and never worth reporting as one.
 
+Shopify has two modes and its own options:
+
+- **Without `store`** it is Shopify's catalogue of every store. Each row names the store in `seller`;
+  the host of its `url` is that store's domain. Each product shows **one offer** — one store's price
+  — and a later read or price check of the same id may answer with another store's offer: check
+  `seller` on every row.
+- **With `store`** (a domain, or any link on it) it is that store's own catalogue; leave `query` out
+  to browse all of it. Ids there are `gid://shopify/Product/…` from its own search, and a URL is not
+  accepted; across all stores ids are `gid://shopify/p/…`, and a product URL works when the catalogue
+  knows the page. To follow one store's price, search and price-check inside that store.
+- `country` and `currency` price for another market; only `shopify` takes them. `next_cursor` goes
+  back as `cursor` for the next page; `total` is Shopify's estimate of matches.
+- A read shows one variant and lists every choice under `<Option> options`. `listing-prices` takes
+  up to 50 ids or links in one call (10 inside a store). A store that "did not answer as a Shopify
+  store" is not on Shopify or keeps its catalogue closed — use `web scrape`.
+
 ## Watching a rival's price over time
 
 One-off research answers "what do they charge today". `competitors` answers "did they just undercut
@@ -96,7 +119,7 @@ decision, not the decision: changing what the owner earns is theirs to approve.
   `tiktok-audience-demographics` for where that audience sits.
 - `research-catalog` — `ebay-search` over the marketplace's own catalog (pass `sellers` to scan a
   competitor's storefront instead of the whole marketplace), plus `listing-get`, `listing-search` and
-  `listing-prices` for reading listings on nine US storefronts as data.
+  `listing-prices` for reading listings on nine US storefronts and every Shopify store as data.
 - `web` — `scrape` one page and read it back as text, for pages `research-catalog` does not cover.
 - `competitors` — a standing watch list per store, with price snapshots and the undercutting report.
 - `store-audit` — the other direction: `onpage` and `pagespeed` on the owner's own shop, and