account.check_credits
ChatGPTCheck your current credit balance and subscription plan.
analytics_business
ChatGPTHow the whole workspace did: orders, revenue and customers against the period before, the split per marketplace, and the trend. One call — do not read shops one by one to add them up.
analytics_product
ChatGPTProducts ranked over a period, or one item's report. For a single item pass product_id and model_type — the id means a different thing for a product than for a listing, which is the usual reason a first attempt comes back empty.
analytics_shop
ChatGPTEvery shop ranked over a period, or one shop in detail. view=pnl gives that shop's profit and loss with its cost and fee breakdowns. Ranking every shop is one call; never loop over shops.
analyze_competition
ChatGPTUSE WHEN user wants HHI concentration, top shops, country mix, or price tiers for a niche. Pass keyword or taxonomy_id. DON'T USE for keyword scores. Score/tier meanings: read dodgeprint://etsy/guide.
apply_change
ChatGPTMake a catalog change. Two ways: (1) one step — action and params (the same params preview_change takes) to create something the user fully described and asked for: a template, or a Shopify vendor or product type. Use it only when every value came from the user; the app asks them to allow the call, so do not ask again in the chat. (2) preview_id from preview_change, after the user agreed to the preview (a variant groups file the user sent counts as agreeing) — needed for spreadsheet imports, renaming a variant group, or when you filled in or guessed a value. A preview_id works once and expires after 15 minutes.
benchmark_listing
ChatGPTUSE WHEN seller wants to compare their listing vs niche competitors. Mode A: listing_id (+ rolling_24h). Mode B: title+tags+price. Returns percentile matrix + suggestions. Not both modes. Score/tier: read dodgeprint://etsy/guide.
deploy_status
ChatGPTHow a deploy went: pass a deploy job id or a deploy request id for progress, per-product results and the failure reason. Read-only — this never starts a deploy.
explore_niche
ChatGPTUSE WHEN user wants a niche overview: top keywords, top listings, trending tags, price tiers, gaps. Supports seed_type keyword|taxonomy_id|tags. Don't use for single keyword deep-dive — use research_keyword instead.
find_niche_hidden_gems
ChatGPTUSE WHEN user wants curated quick-win KEYWORD niches: high opportunity + low competition + high seller_fit, gated by min_gem_score. KEYWORD-level only — for LISTING-level use scout_new_winners; for custom tuning use scout_opportunities.
find_shops
ChatGPTList the connected shops (Etsy, Amazon, TikTok, WooCommerce, Shopify) with status and whether they can be deployed to. Use it to turn a shop name the user mentioned into the shop_id other tools need.
fulfillment
ChatGPTFulfillment orders and their supplier state, overall statistics, or the connected suppliers. Read-only — this never submits anything to a supplier.
get_listing
ChatGPTEverything about one listing: title, description, price, images, videos, variants (including whether each is hidden), personalization and the Etsy how-it's-made fields.
how_to_use
ChatGPTUSE WHEN user asks what tools are available, how scoring works, or wants guidance. Pass topic=version|scoring|workflows|mistakes|<tool_name> for a specific slice.
integrations
ChatGPTWebhook subscriptions and their recent deliveries, or export requests and their files. Answers "did my webhook fire" and "where is my export". Read-only.
inventory
ChatGPTStock levels and cost of goods for a shop — what is running low, and what each unit cost. Pass a product_id for its cost history.
ledger
ChatGPTThe shop's financial ledger for reconciliation — Etsy entries, Shopify balance transactions or Amazon finance transactions, whichever the platform uses. Pass a transaction_id for its item lines and fee breakdown. Amazon figures trail real time by up to two days.
list_listings
ChatGPTListings of a shop with their marketplace status. Use before asking about one listing in detail.
list_orders
ChatGPTOrders of a shop with status, totals and buyer summary. Look one up by its marketplace id or internal reference by passing reference_id.
market.listing_stats
ChatGPTViews, sales, favorites, conversion and revenue of any Etsy listing — not only the user's own — for the last 7, 14 or 30 days, with growth against the period before, 7/14/30-day windows and the last 7 days day by day. Pass listing ids or etsy.com listing links; compare up to 20 at once. sold_24h, when present, is how the listing sold in the last 24 hours, with its source and reading time; without it there is no 24h data, so do not guess one. Reading the 24h figures: when sales_24h_best_is_min is true Etsy only shows "Over 20", so say "over 20", never 20. bought_24h null means Etsy shows no buyers line: unknown, not slow sales (downloads rarely have it). Etsy counts buyers, the estimate counts orders: never add the two, and a keyword's Etsy buyer count is a lower bound. Always give the reading time (signals_at), usually 1-4 hours old.
market.shop_listings
ChatGPTListings of any Etsy shop ranked by sales, views, favorites, revenue or conversion over the last 7, 14 or 30 days — "what is this shop selling best?". Pass the shop name (URL slug) or its Etsy shop id. sold_24h, when present, is how the listing sold in the last 24 hours, with its source and reading time; without it there is no 24h data, so do not guess one. Reading the 24h figures: when sales_24h_best_is_min is true Etsy only shows "Over 20", so say "over 20", never 20. bought_24h null means Etsy shows no buyers line: unknown, not slow sales (downloads rarely have it). Etsy counts buyers, the estimate counts orders: never add the two, and a keyword's Etsy buyer count is a lower bound. Always give the reading time (signals_at), usually 1-4 hours old.
market.top_listings
ChatGPTEtsy-wide top listings over the last 7, 14 or 30 days, ranked by sales, views, favorites, revenue or conversion, optionally within a category or matching words in the title. metric_value is the value of the ranking metric. Market-wide data: it does not read the user's shops. sold_24h, when present, is how the listing sold in the last 24 hours, with its source and reading time; without it there is no 24h data, so do not guess one. Reading the 24h figures: when sales_24h_best_is_min is true Etsy only shows "Over 20", so say "over 20", never 20. bought_24h null means Etsy shows no buyers line: unknown, not slow sales (downloads rarely have it). Etsy counts buyers, the estimate counts orders: never add the two, and a keyword's Etsy buyer count is a lower bound. Always give the reading time (signals_at), usually 1-4 hours old.
market.top_shops
ChatGPTEtsy-wide top shops over the last 7, 14 or 30 days, ranked by sales, sales per day, favorers, listings or reviews, optionally in one country. Market-wide data: it does not read the user's shops.
market.trending_24h
ChatGPTEtsy keywords and products selling the most over the last 24 hours, refreshed hourly. Use it when the user asks what is hot or trending today. Each keyword carries its competition and opportunity scores, so it also answers "what should I sell right now". Market-wide data: it does not read the user's shops. Products can be filtered by Etsy signals (sold in the last N hours, carts, labels, on sale, buyers line) and keywords by page-1 ads; the result lists only the filters really applied, so never claim a filter that is not in listing_filters_applied or keyword_filters_applied. listings_degraded true means the Etsy signals are temporarily missing: say so, never "no listings". When answering about ads, name the top advertised listings (top_ads) and say the ads are as seen from the US and Canada; an ad's price is the list price, the buyer pays price_sale when sale_pct is set. ads null means the keyword is not in the ads queue, not zero ads. Reading the 24h figures: when sales_24h_best_is_min is true Etsy only shows "Over 20", so say "over 20", never 20. bought_24h null means Etsy shows no buyers line: unknown, not slow sales (downloads rarely have it). Etsy counts buyers, the estimate counts orders: never add the two, and a keyword's Etsy buyer count is a lower bound. Always give the reading time (signals_at), usually 1-4 hours old.
plan_seasonal_calendar
ChatGPTUSE WHEN user asks for upcoming seasonal events, prep windows, or tied keywords. Returns event_date (holiday), peak_date/peak_window_end (Etsy buying window, weeks before the holiday), prep_window_start, v6 keywords.
playbook
ChatGPTStep-by-step procedure for a multi-step task, with the formats, platform differences and call order that are easy to get wrong. Load one before reconciling money, diagnosing a deploy, tracing an order or debugging a webhook. Call with no name to list them. Free — costs no credits.
preview_change
ChatGPTCheck a catalog change before it is made: importing products into the DodgePrint catalog from a spreadsheet (no shop is needed or touched), importing variant groups from a spreadsheet, creating or renaming a variant group, creating a template (description, tag, bullet point, generic keyword, personalization, shipping profile, shipping package or size chart), or adding a Shopify vendor or product type. Nothing is saved. Returns a preview and a preview_id; show the preview to the user and wait for their agreement before apply_change, except a variant groups file the user sent, whose passing preview is applied at once. Skip this for a simple creation the user fully described: apply_change takes action and params directly. For a spreadsheet, have the user attach it here, read it and pass its rows in products.import_file (up to 100) or variant_groups.import_file (up to 200). Without rows either one returns template_url, a template with sample rows, and an upload link; offer the link only if they cannot attach the file or it has more rows than that. Variant groups, like products, come only from a spreadsheet: start with variant_groups.import_file and no rows. Free — costs no credits.
reconcile_payouts
ChatGPTWhat a marketplace actually paid: ledger rows with their type codes already resolved to names, grouped and summed per type and per currency. Picks the right code table for the shop's platform — Etsy and Amazon use incompatible ones.
research_keyword
ChatGPTUSE WHEN user wants full picture of 1-5 keywords: v6 scores, trends, listings, breakdown. depth=quick=fast; depth=deep=all blocks+categories/shops. Batch via 'keywords' list — first gets deep, rest slim in one query.
research_shop
ChatGPTUSE WHEN user asks for a full dossier on ONE specific shop by name. Returns overview, top tags, 30d performance, tier, niche concentration. Not for top-shops leaderboard. Score/tier: read dodgeprint://etsy/guide.
resolve_codes
ChatGPTTurn the numeric codes lists return — order status_id, shipment status_id, ledger type — into names. Ledger types differ per platform, so pass shop_id for those. Use this instead of guessing what a code means.
scout_new_winners
ChatGPTUSE WHEN seller wants trending LISTINGS from NEW shops + NEW products — 'underdog winners' with recent sales, young shops/listings, ranked by gem_score. For keyword gems use find_niche_hidden_gems.
scout_opportunities
ChatGPTUSE WHEN user wants ranked keyword opportunities by filters/presets. rank_by: seller_fit (default)|opportunity|growth_velocity|gem_score. Presets: sweet_spot|underserved|low_comp_growing. Don't use for single keyword — use research_keyword.
search_catalog
ChatGPTSearch the internal catalog — products, designs or variant groups. This is the account's own library, not the listings published on a marketplace.
set_default_workspace
ChatGPTSwitch the workspace this connection works in. Every later call — in this chat and in new ones — acts in it. Call it only after the user has picked a workspace from the whoami list or asked by name to switch; never on your own, and ask again when the name matches more than one workspace. Free — costs no credits.
shop.list_my_shops
ChatGPTList the shops you can access in one workspace, optionally filtered by marketplace platform.
shop.top_selling_products
ChatGPTTop-selling products by units sold in a recent time window across the shops in one workspace.
suggest_tags
ChatGPTUSE WHEN seller wants optimized Etsy tags for a listing (beta). Pass title OR seed_keyword. Returns up to 13 tags ranked by opportunity. DON'T pass both. Score/tier: read dodgeprint://etsy/guide.
supplier_health
ChatGPTWhy a supplier is not accepting orders. Without arguments, every connection and its state. With supplier_id, the four layers that must all be right before an order can be submitted: the connection, its actions, its field mappings and its submission options.
trace_order
ChatGPTWhere one order stands end to end: marketplace status, fulfillment stage, supplier submission, tracking numbers and any alerts. Accepts the internal order id, the shop's reference, or the fulfillment code — an order and its fulfillment order do not share an id.
webhook_health
ChatGPTWhether webhooks are firing: the subscriptions with their active flag, plus recent deliveries and why they failed. A subscription is switched off automatically after a long run of failures, which is invisible from the receiving end.
whoami
ChatGPTThe current credential: user, plan, the workspace this connection works in and every workspace it can switch to. Call this first, and whenever the user asks to see or change workspaces. Free — costs no credits.
Analyze competition
ClaudeBenchmark listing
ClaudeExplore niche
ClaudeFind niche hidden gems
ClaudeFind shared keywords
ClaudeHow to use
ClaudePlan seasonal calendar
ClaudeResearch keyword
ClaudeResearch shop
ClaudeScout new winners
ClaudeScout opportunities
ClaudeSuggest tags
Claude