ads_report
ChatGPTList the shop's own Etsy Ads stats per listing over a window. The totals describe the whole ad account over the window, not the page of rows.
By ProfitTree
ProfitTree helps Etsy sellers research public listings, shops, and keywords and inspect their connected shops' sales, profit, orders, ads, product costs, and tracked items through ChatGPT.
all reads every product. The summary describes the whole shop, not the page. Read-only: no cost is written by this tool.shop_id, and a shop id is not something that can be guessed. Each row carries the shop's currency, which denominates every money figure those tools answer with, and the day its reports were last pulled: a window that runs past that day is answered from data never fetched, not from a drop in sales. This is the seller's own connected shops, not a search of Etsy — use shop_finder for that. shop_id narrows the answer to one shop, for re-reading a row without listing the account again. A shop the seller does not own is simply not among their shops, so it answers an empty list rather than a refusal — the same reason the other owner tools answer not-found. This tool is free: it costs no AI credits, because every other owner tool depends on it.resolution says what happened to the keyword asked for: exact if the market holds it, best_match if the nearest keyword held was used instead, not_found if neither. Read the rows against the resolution — on a best_match they describe the matched keyword, not the one asked for.listing_report. include names the sections wanted and defaults to all of them, so a caller that names nothing gets the complete picture. Naming only what is needed skips the reads for the rest.image_url: that link cannot be fetched from here. Works for any public listing on Etsy, from product_finder, listing_detail, tracking or an id the seller gives you. Each listing answers in the order asked, as a text block naming it followed by its photo, or a text block alone saying why no photo came back. One listing that cannot be served never fails the others. The photos are other sellers' copyrighted work: look at them for market research and design analysis only; never copy them, reproduce them or use them in a listing.listing_detail.keywords or a shop_id in filters is required.product_id is a product in this shop; call products_report to find one.shop_id must be a shop connected to this account; call connected_shops for the ids, as any other id answers not-found.*_report tools. include names the sections wanted and defaults to all of them, so a caller that names nothing gets the complete picture. Naming only what is needed skips the reads for the rest.search_type decides what search_term means: keyword finds shops selling for that keyword, shop_name finds shops named like it. filters.top_category and filters.country_iso are matched exactly against values the market holds. When either is named, the valid values are returned in filter_options so a guessed one can be corrected without a second search.collection_id, returns the seller's collections of that kind — call this first, since a collection id is not something that can be guessed. With one, returns that collection's listing, shop or keyword metrics, again decided by kind. days is the metrics window in whole UTC days, ending tonight, compared against the same length immediately before it. It does not apply to keyword metrics, which are the market's monthly averages.connected_shops costs credit_cost_per_call credits from the weekly allowance this account shares with Rupert's own chat. credits_included is what the plan includes a week and credits_used is what is spent of it, so the credits remaining are credits_included - credits_used; they all reset at credits_reset_at. A call that fails costs nothing: its credits are given back. While unlimited is true, tool calls cost this account nothing at all and promo_ends_on is the last day that holds. The allowance is still reported, because it is the same one the account's Rupert chat keeps spending. rate_ceiling is the calls this connection may make in one minute and calls_this_minute is what it has spent of that. Every tool but this one counts against it, including connected_shops. counting is false when call counting is unavailable, and calls_this_minute is then absent — the ceiling is not being enforced rather than at zero. Calling this tool is free and counts against neither allowance, so call it to check what is left before starting a long sequence of calls.Click any prompt to copy it.
Add this badge to your site or README. It links to this page.
HTML
<a href="https://mcp-app-store.keenethics-labs.com/app/profittree"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>
Markdown
[](https://mcp-app-store.keenethics-labs.com/app/profittree)