DodgePrint

Everything about one listing: title, description, price, images, videos, variants (including whether each is hidden), personalization and the Etsy how-it's-made fields.

get_listing

USE 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.

how_to_use

Stock 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.

inventory

Listings of a shop with their marketplace status. Use before asking about one listing in detail.

list_listings

List the shops you can access in one workspace, optionally filtered by marketplace platform.

shop.list_my_shops

Orders of a shop with status, totals and buyer summary. Look one up by its marketplace id or internal reference by passing `reference_id`.

list_orders

Views, 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.listing_stats

Step-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.

playbook

USE 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.

plan_seasonal_calendar

Products 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_product

What 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.

reconcile_payouts

USE 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_keyword

USE 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.

research_shop

Turn 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.

resolve_codes

USE 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_new_winners

USE 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.

scout_opportunities

Search the internal catalog — products, designs or variant groups. This is the account's own library, not the listings published on a marketplace.

search_catalog

Switch 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.

set_default_workspace

Every 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.

analytics_shop

Listings 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.shop_listings

USE 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.

suggest_tags

Why 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.

supplier_health

Etsy-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_listings

Top-selling products by units sold in a recent time window across the shops in one workspace.

shop.top_selling_products

Etsy-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.top_shops

Where 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.

trace_order

Etsy 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.

market.trending_24h

Whether 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.

webhook_health

Webhook subscriptions and their recent deliveries, or export requests and their files. Answers "did my webhook fire" and "where is my export". Read-only.

integrations

The 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.

whoami