From 13039689f8b2f4d22fe81c32bc67cb3b1e05aa20 Mon Sep 17 00:00:00 2001 From: norightsforlis Date: Sat, 20 Jun 2026 13:33:54 +0100 Subject: [PATCH] Add `fast-growing-international-products` skill Co-Authored-By: Claude Opus 4.8 --- README.md | 1 + .../SKILL.md | 112 ++++++++++++++++++ 2 files changed, 113 insertions(+) create mode 100644 skills/fast-growing-international-products/SKILL.md diff --git a/README.md b/README.md index 46c2768..5ff4b0e 100644 --- a/README.md +++ b/README.md @@ -31,6 +31,7 @@ https://joompulse.com | [`pulse-find-exact-same-product`](skills/pulse-find-exact-same-product/SKILL.md) | Finds product listings that appear to represent the same real-world product as a reference item. | "find the same product", "match this product", "find duplicate listings" | "encontrar o mesmo produto", "achar produto igual", "encontrar anúncios duplicados" | | [`ml-product-analysis`](skills/ml-product-analysis/SKILL.md) | Analyzes one Mercado Livre product and its competitors, returning a product card and a ranked table of comparable products with price, estimated sales and revenue, logistics, and catalog / buy-box status. | "analyze this product", "how much does this sell", "find competing products" | "analisar este produto", "quanto vende esse produto", "encontrar produtos concorrentes" | | [`product-change-monitor`](skills/product-change-monitor/SKILL.md) | Tracks how a Mercado Livre product changed over a period (by default week over week), returning a change table with the current price, rating, review count, estimated weekly sales and revenue, logistics, and seller details, each shown against about a week ago. | "monitor this product", "track price changes", "what changed this week", "did the price drop" | "monitorar este produto", "acompanhar este anúncio", "o preço caiu", "variação de avaliações" | +| [`fast-growing-international-products`](skills/fast-growing-international-products/SKILL.md) | Finds fast-growing international (imported) products across all categories as one table, each tagged with its category. | "fast-growing international products", "imported products taking off", "cross-border winners across all categories" | "produtos internacionais em alta", "produtos importados crescendo rápido", "internacionais que mais crescem em todas as categorias" | ## How These Skills Work diff --git a/skills/fast-growing-international-products/SKILL.md b/skills/fast-growing-international-products/SKILL.md new file mode 100644 index 0000000..a3ac675 --- /dev/null +++ b/skills/fast-growing-international-products/SKILL.md @@ -0,0 +1,112 @@ +--- +name: fast-growing-international-products +description: > + Finds fast-growing international (imported) products ACROSS ALL Mercado Livre + (Brasil) categories, using JoomPulse, and returns them as one product table + that includes each item's category, with price, estimated weekly sales and + revenue, rating, time on air, shipping, listing type, seller medal, and a + JoomPulse link per item. Use it when a seller wants rising imported products + marketwide, not inside a single niche. Triggers include: "fast-growing + international products", "imported products that are taking off", "cross-border + winners across all categories", and the pt-BR equivalents "produtos + internacionais em alta", "produtos importados crescendo rápido", "produtos + internacionais que mais crescem em todas as categorias". Sales and revenue are + JoomPulse estimates, not real transactions. For the same search limited to one + category, use the single-category international skill; to match items to a + specific JoomPro product for import, use the international-product-matcher skill. +--- + +# Fast-Growing International Products + +This skill returns the **fast-growing international (imported) products across all +Mercado Livre (Brasil) categories** — a marketwide shortlist of cross-border +items with recent momentum, each shown with the category it sits in. It is the +all-categories sibling of the single-category international skill. + +For imported products inside one specific category, use the single-category +international skill. To match each item to a specific JoomPro product with a +per-item import action, use the international-product-matcher skill. + +## Prerequisites + +- JoomPulse MCP access is configured for the current agent environment. +- The available JoomPulse tools can return active international listings across + categories with their category, price, estimated sales and revenue, rating, + time on air, logistics, listing type and seller medal. + +If JoomPulse MCP access is unavailable, stop and explain that the skill requires +JoomPulse MCP setup before it can find international products. + +## Scope + +- **Mercado Livre (Brasil) only.** Other marketplaces are out of scope. +- **Sales and revenue are JoomPulse estimates** derived from historical listing + data — not real transactions. Price, rating, and reviews are real history. + Disclose the estimate caveat in every output. +- **Read-only.** The skill never writes or modifies anything. +- **Language:** detect the seller's language and respond in it. Default to pt-BR. +- **Keep the workflow invisible.** Show `—` for any missing value; never fabricate. + +## Workflow + +### Step 1 — Optional narrowing + +This skill is marketwide by default. The seller may optionally narrow it to a +broad area; if they do and the term is ambiguous, disambiguate before continuing. + +### Step 2 — Find fast-growing international products marketwide + +Use JoomPulse to get active **international (imported)** listings across +categories. There is no single "fast growth" flag, so define it pragmatically and +**state the rule you used** — for example, recently listed items with strong +estimated weekly sales, or the top items by estimated weekly revenue. Keep a +clearly stated **top-N** (for example top 30) and say it is a top-N. + +## Output + +Respond in the seller's language (default pt-BR). The product list always renders +as a markdown table, and **includes a Category column** (the cross-category +differentiator): + +| MLB | Nome | Vendedor | Categoria | Preço | Vendas (semana) | Receita (semana) | Classificação | Avaliações | Tempo no ar | Frete grátis | Mercado Envios Full | Tipo de anúncio | Medalha | +|---|---|---|---|--:|--:|--:|--:|--:|--:|:--:|:--:|---|---| + +- The **MLB** identifier links to the item's JoomPulse page. +- State the fast-growth rule and the top-N cap you applied, in one short line. + +**Disclaimer (every report):** + +> ⚠️ Vendas e receita são estimativas do JoomPulse com base no histórico de +> anúncios — não são transações reais. Preço, classificação e avaliações são +> histórico real do Mercado Livre. + +## Visualization + +When the client can render inline visuals, present metric cards and a chart; +otherwise fall back to the markdown table plus text cards. Never block on visuals. +The product table always renders as markdown, on every surface, and the ⚠️ +disclaimer always stays in the text. + +When inline visuals are available: + +- **Three cards:** number of products in the shortlist (top-N), number of distinct + categories represented, and average ticket. +- **A horizontal bar** of the top products by estimated weekly revenue, plus an + optional small companion bar of which categories contribute the most + fast-growing international products. Render charts only when there are enough + items (skip under about four). + +Presentation rules: render a chart only when the data supports it; any change +column uses a word header, never a bare "Δ". + +## Notes & Guardrails + +The seller should never see a system or stack error — only a friendly next step. + +- **High-ticket, low-rotation skew:** marketwide imported items can skew toward + expensive, slow-moving SKUs; surface that honestly rather than implying broad + momentum that is not there. +- **Market data temporarily unavailable:** retry once quietly; if it is still + down, say market data is temporarily unavailable and to try again. Never paste + internal error text, HTTP codes, or field names to the seller. +- **Never silently limit coverage** — always state the top-N cap.