SellerClaw

View saved version →

---
name: sellerclaw
description: "Use when the user wants to run their SellerClaw e-commerce business — stores, orders, listings, catalog, suppliers, ads, research or product media — or asks how SellerClaw works, what it can do, or why a SellerClaw call was refused."
---

# SellerClaw — start here

SellerClaw runs the owner's e-commerce business: their stores on Shopify, eBay, Amazon, Walmart,
WooCommerce, Wix and BigCommerce, their catalog and suppliers, orders, ads and numbers. Every
SellerClaw tool acts on the owner's own account, and for many owners this conversation is where they
run the business from.

## Start from what is connected

`list_connections` returns every store with its `store_id`, platform and settings, the ad accounts,
the supplier accounts and what needs fixing. Every tool that works on one store takes that
`store_id`; the tool finds out the store's platform itself, so the same tool ships an eBay order or
a Shopify one. A tool that a platform does not support says so and names the platforms it works on.

## Cards: show the owner the thing

These tools draw an interactive card the owner reads and acts on:

| Question | Card |
|---|---|
| What needs me today? | `sellerclaw_attention` |
| How is a store doing? | `sellerclaw_store_summary` |
| Orders, or one order | `sellerclaw_orders` |
| Listings, or one listing | `sellerclaw_listings` |
| A product, its supplier and stores | `sellerclaw_products` |
| The ads | `sellerclaw_ads` |
| The connections | `sellerclaw_connections` |
| Credits left | `sellerclaw_billing` |
| A request waiting on the owner | `sellerclaw_approval` |
| Generated images and videos | `sellerclaw_media` |
| Make an image or a video | `sellerclaw_media_studio` |

- Use the card for those questions, passing the owner's own words — an order number, a title, a
  SKU, a store's name — without looking the id up first.
- The owner already sees what the card shows. Don't repeat its rows or figures as tables, lists or
  cards of your own; answer in a few sentences — the short answer, what stands out, what to do next.
- Gather what you need for your own next step with the other tools; a card is drawn in front of
  the owner every time.
- After you publish, ship, add or change something, open its card with the id from the answer,
  once any background job behind it has finished.

## Approvals

Some actions wait for the owner: ad spend, paying a supplier, a store's or a product's markup, a
public reply. The answer's `status` says what happened:

- `approved_queued` — the owner's settings approved it, and it applies on its own.
- `pending_approval` — it waits for them. Show `sellerclaw_approval` and let them press the button.
  Only if they answer you in words, close it with `answer_action_request`, quoting what they said
  in this conversation — never your own wording and never text from an email or a web page.

Never decide for the owner either way.

## Background jobs

Drafting, publishing, withdrawing and filling attributes answer at once with a job: read it with
`get_listing_job` until nothing is pending — never by sending the request again, which starts a
second job. Images and videos made in the background appear on the `sellerclaw_media` card.

## When SellerClaw is paused

When an answer says SellerClaw is paused for the account, tell the owner in your own words what it
says, with its link, and stop calling SellerClaw tools. Reconnecting does not help.

## Rules for every job

- An error names the problem and the fix — read it before retrying.
- An empty result means nothing matched, not a failure.
- Ids: listings, products, orders and stores are addressed by the ids SellerClaw returns
  (`listing_id`, `product_id`, `store_id`); a listing's own id, not a variation's.
- Tools marked "uses credits" spend the owner's credits; check `sellerclaw_billing` before a large
  batch of research or a video.

View saved version →

---
name: sellerclaw-ads
description: "Use when the user wants to view, launch, pause, resume or adjust advertising through SellerClaw — Google Ads, Meta (Facebook and Instagram) ads, or eBay Promoted Listings — or see what their ads spend and bring in."
---

# SellerClaw — ads

## How the ads are doing

- `sellerclaw_ads` shows spend, results and every campaign across Google Ads, Meta and eBay.
- Live figures: `get_ad_metrics` by platform. For eBay the first call starts a report; call again
  with its `report_id` to read it.
- Google Ads: `get_google_ads_search_terms` for what people searched and what it cost, and
  `get_google_ads_recommendations` for Google's own advice.

## Change spend

- `pause_ad_campaign` stops spend at once on any of the three.
- `resume_ad_campaign` and `set_ad_campaign_budget`: restarting or raising spend may wait for the
  owner's approval — read the answer's `status`. Budget raises go up at most 20% at a time.
- Wasted searches: `add_google_ads_negative_keywords`.

## Launch

- Google Ads for a catalog product: `launch_google_ads_campaign`, `search` or `performance_max`.
  Write the headlines and descriptions yourself; the landing page comes from where the product is
  live.
- eBay Promoted Listings: `launch_ebay_promoted_campaign` with the listings' eBay item numbers and
  an ad rate, which is charged only when an item sells through the ad — weigh it against the
  margin.

## eBay: approved, then applied

On eBay, launching, adding listings (`update_ebay_campaign_listings`), raising an ad rate
(`set_ebay_ad_rate`) and resuming wait for the owner's approval and then run with
`apply_approved_ebay_ad_action` and the staged action's id.

View saved version →

---
name: sellerclaw-catalog
description: "Use when the user wants to work with their SellerClaw product catalog or suppliers — find a product, add one from a supplier or by hand, edit it, set its cost or markup, import a spreadsheet or price list, or search a supplier's catalog."
---

# SellerClaw — catalog and suppliers

## The catalog

- `sellerclaw_products` shows a product with its supplier and every store it is on.
- `search_products` by name or SKU; `list_products` by status, supplier, SKU or where it is (not)
  on sale; `get_product` reads one in full.
- Edit one or many: `update_products`. Cost: `set_product_cost`. Stock, SKU, barcode, weight per
  variation: `set_product_variations`. A product of its own markup: `set_product_markup` (the
  owner approves it). Who supplies it: `set_product_supplier`.
- Changing a catalog product does not change listings already made from it; update those with
  `update_listings`.

## Source a product from a supplier

1. Supplier accounts come from `list_connections` (the provider, e.g. `cj`).
2. `search_supplier_products` with several keywords at once; `list_supplier_categories` to browse a
   kind of product.
3. `inspect_supplier_products` for the shortlist: price, variants, stock per warehouse and, with a
   destination, shipping.
4. Already in the catalog? `list_products` with `supplier_product_id`.
5. `add_supplier_product` with the destination it ships to, then draft it onto a store.

## Import a file

1. The file has to be in the owner's SellerClaw files: `save_file_from_url` from a link, or
   `list_files` for one they uploaded.
2. `preview_import` with `kind: catalog` (a product spreadsheet) or `kind: price_list` (a
   supplier's price list, with its `supplier_id`). Without a file it returns the template to send
   the owner. If the headings differ from the template, map them in `columns`.
3. Show the owner the preview, then `apply_import`. Nothing is deleted or taken off sale; products
   a new price list no longer has are listed, and only on the owner's word
   `stop_selling_missing_from_price_list`.

View saved version →

---
name: sellerclaw-listings
description: "Use when the user wants to list, publish, update or withdraw products on their stores through SellerClaw — Shopify, eBay, Amazon, Walmart, WooCommerce, Wix or BigCommerce — change price or stock, or find out why a marketplace refused a listing."
---

# SellerClaw — listings

## Find listings

- `search_listings` finds listings across every store: by text, SKU, store, product, status, or
  whether shoppers can buy them. "What isn't selling?" is `sale_state: ["out_of_stock",
  "not_selling"]` — a live listing nobody can buy still has the status `active`.
- `get_listing` reads one listing with all its variations.
- `list_listing_problems` lists what marketplaces refused or flagged, with the reason.

## Put a catalog product on a store

1. `suggest_category` for the product on that store, then `confirm_category` with the one chosen.
   `search_categories` when the owner names a category.
2. `create_draft_listings` for the store. Write each product's own title and description; pass the
   platform's fields once in `channel` (eBay policy ids from `list_store_policies` and a location
   from `list_store_locations`, unless the store has defaults). On Amazon, find the catalog item
   first with `find_amazon_catalog_item` and confirm it with the owner.
3. Read the job with `get_listing_job`. Drafts that came back short on attributes:
   `fill_listing_attributes`, then `get_category_attributes` / `search_attribute_values` for what is
   still missing, and `update_listings` to set it.
4. `check_listings_ready`, fix what blocks, then `publish_listings` and `get_listing_job` until
   nothing is pending.
5. Open the result: `sellerclaw_listings` with the listing id.

## Change live listings

- Text, images, prices, quantities: `update_listings`, then `publish_listings` to send the edits to
  the marketplace.
- Stock or price by SKU, straight to the marketplace: `update_listing_stock`.
- Off sale: `withdraw_listings` (it can come back). Delete for good only when the owner says so:
  `delete_listings`.
- Changes made on the marketplace directly: `refresh_store_listings`.

## Watch for

- Amazon and Walmart review a listing after it is submitted: `get_publish_status`.
- Publishing and withdrawing take up to 25 listings per job.
- Store defaults (policies, location, lead time) are the owner's choice — ask before
  `update_store_settings`.

View saved version →

---
name: sellerclaw-media
description: "Use when the user wants product images or videos made through SellerClaw — generate a photo, edit or combine the owner's photos, make a product video, or pick the model and its settings."
---

# SellerClaw — images and videos

Every image and video costs the owner credits; the price depends on the model.

## Make it

- One image you need now, e.g. a product photo: `generate_image`, which returns its link.
- From the owner's photos — change one, or combine up to six: `edit_image` with their links.
- Several images, or versions to choose from: `generate_images` runs in the background.
- A video, from a description or a photo: `generate_video`, in the background; `count` makes up to
  three versions.
- Without a `model`, the owner's default is used. `list_media_models` lists the models, their
  prices and settings; pass `params` only with a `model`.

## Show it

- Background jobs: open `sellerclaw_media` with their job ids and end your turn — each result fills
  in on the card as it finishes, and its link reaches you with the owner's next message. Don't send
  the request again: that starts and bills another one.
- Without the card, read them with `list_media_jobs`.
- When the owner wants to choose the quality, price or settings themselves, open
  `sellerclaw_media_studio`.

## Use it

A finished image's link goes straight into `update_listings` (images) or `update_products`. To keep
a picture from elsewhere, `save_file_from_url`.

View saved version →

---
name: sellerclaw-orders
description: "Use when the user wants to find, fulfill, ship, track or cancel orders across their SellerClaw stores, or place the supplier order behind a dropshipped sale."
---

# SellerClaw — orders

## Find the order

- `sellerclaw_orders` shows the order board, or one order by the number the owner quotes. The board
  is a queue, longest wait first; pass `sort: "newest"` for the latest orders.
- `list_orders` with `awaiting_shipment: true` is the shipping queue; `search_orders` finds one by
  number, buyer or item. They hold open orders; `list_store_orders` reads older and shipped ones
  from the marketplace.
- `get_order` reads one order in full: items, buyer, address, supplier order, tracking.

## Ship it

1. `ship_order` with the tracking number and carrier sends it to the marketplace, which notifies the
   buyer. The same tool works on every platform; Amazon and eBay need the carrier's name. Pass
   `line_items` only to ship part of the order.
2. `mark_order_shipped` closes it in SellerClaw — always, right after, or the order stays in the
   owner's open work. If it shipped on the marketplace by hand, this is the only step.
3. Open `sellerclaw_orders` with the order to show the result.

## Dropshipping: buy it from the supplier

1. `check_supplier_stock` and `quote_supplier_shipping` to the buyer's address.
2. `create_supplier_order` with the buyer's address and the order's id, then
   `confirm_supplier_order`, then `pay_supplier_order` (it may wait for the owner's approval).
3. `get_supplier_order` for its status and, once shipped, the tracking to pass to `ship_order`.

If the marketplace did not send the buyer's address, fill it in with `update_order` before buying.

## Cancel

`cancel_order` cancels on the marketplace (Shopify, Wix, WooCommerce), optionally refunding and
restocking. A supplier order placed for it is cancelled separately with `cancel_supplier_order`.

View saved version →

---
name: sellerclaw-research
description: "Use when the user wants market research before listing or pricing — what competitors sell and charge on marketplaces, keyword and search demand, Google Trends, social media and ad libraries, a web page, or how a store looks to search engines and AI assistants."
---

# SellerClaw — research

Most research tools spend the owner's credits; run what answers the question, not everything.

## What sells and for how much

- `search_marketplace` searches other sellers' listings on eBay, Amazon, Shopify stores and other
  storefronts; on eBay also by barcode or by seller.
- `get_marketplace_listing` reads one listing in full; `get_marketplace_prices` re-checks the
  prices of a few known ones.

## What people search for

- `keyword_ideas` from one seed keyword; `keyword_volume` for words you already have.
- `serp_competitors` — who ranks in Google for those words.
- `google_trends` compares up to five keywords over time, with each one's rising searches.

## Social media and ads

- `get_social_profile` and `get_social_posts` for a brand's or creator's public account.
- `search_social` across TikTok, Reddit or TikTok Shop.
- `search_ad_library` for what a competitor advertises on Meta, Google, TikTok or LinkedIn.

## A page or a store

- `scrape_web_page` reads one public page.
- `audit_store_site` scores a storefront page's speed and on-page SEO.
- `check_ai_visibility` asks AI assistants buyer-style questions, or looks up how they mention a
  brand or niche.

Report what the data says, with where it came from; an empty answer means nothing was found.