Growing Leaf Category Tracker

Growing Leaf Category Tracker

This skill takes one category on Mercado Livre (Brasil) or Shopee Brasil and surfaces the sub-categories inside it that are growing fastest — the niches with the strongest month-over-month growth in estimated revenue. It helps a seller who already knows a broad area decide which specific niche to move into next.

How deep it can go differs by marketplace. On Mercado Livre the answer is the deep leaf niches below the third level of the category tree. On Shopee, category analytics exist only down to the third level, so the ranking runs at the deepest level available — the third — and anything deeper is folded into its level-3 ancestor and cannot be separated. Say so in the output; never pass level-3 rows off as deep leaves.

This is a niche-discovery snapshot, not a tracker over time. For a single category's opportunity index and market size, use the category-opportunity-index skill. To compare a category's aggregate numbers against a user-supplied previous snapshot, use the category-monitor skill. To find specific new products inside a category, use the new-growing-products-in-category skill.

Prerequisites

• JoomPulse MCP access is configured for the current agent environment.
• The user provides a marketplace — Mercado Livre (Brasil) or Shopee Brasil — and names a parent category (free text is fine).
• The available JoomPulse tools can resolve a category on either marketplace, walk its sub-categories, and return each one's current monthly market stats (estimated revenue and sales, number of active sellers, number of products) and the month-over-month movement in estimated revenue.

If JoomPulse MCP access is unavailable, stop and explain that the skill requires JoomPulse MCP setup before it can find growing niches.

Scope

• Mercado Livre (Brasil) and Shopee Brasil, one at a time. Other marketplaces are out of scope.
• Depth differs by marketplace: deep leaf niches below the third level on Mercado Livre; the third level only on Shopee, where deeper niches are folded into their level-3 ancestor.
• Sales and revenue are JoomPulse estimates — not real transactions. Disclose this in every output. The estimates are built differently on each marketplace: on Mercado Livre from historical listing data, on Shopee from the marketplace's own rounded sold counters refined with review movement. Use the matching disclaimer.
• Read-only. The skill never writes or modifies anything.
• Language: write in the language of the message you are answering, and default to pt-BR only when that is unclear. Never infer the language from the store, its listings or the marketplace — those are Brazilian whatever language the seller writes in, so a seller who asks in English gets the whole report in English.
• Keep the workflow invisible. Surface the answer, not the steps. Never fill gaps from general knowledge; show — for any missing value.

Shopee data — what differs from Mercado Livre

• Estimates come from Shopee's own rounded sold counters, refined with review movement. Treat small gaps between items as noise and never rank on a difference of a few units. Price, rating and review count are real.
• Coverage is not a census: only items with at least one lifetime sale are tracked, so any count is a lower bound and an absent item is not evidence it does not sell.
• History starts May 2026 — there is no long-run trend and no seasonal read.
• Category analytics stop at three levels; the item view reaches deeper. Say which you used.
• No seller medals — Shopee has three mutually exclusive shop tiers: Official store, Preferred (Indicado) and Common. There is no ladder; inventing Shopee medals is fabrication.
• No catalogue and no buy-box, and an item belongs to one shop.
• No fulfilment programme, no free-shipping flag and no listing tier — show — rather than guessing.
• Concentration is measured differently and thresholds do not transfer between marketplaces.
• Item titles mix Portuguese, English and Chinese — search both languages.

Workflow

Step 0 — Decide the marketplace

JoomPulse covers two separate marketplaces: Mercado Livre (Brasil) and Shopee Brasil. They are independent datasets with different coverage, history and mechanics. Decide which one the request belongs to before reading any data:

• The seller said so. "Shopee" means Shopee; "Mercado Livre", "MeLi" or "ML" means Mercado Livre.
• An identifier gives it away. An identifier beginning MLB is Mercado Livre; a bare 10–11 digit number is a Shopee item or shop. A mercadolivre.com.br link is Mercado Livre, a shopee.com.br link is Shopee. If an identifier is not found on the marketplace you assumed, check the other one before telling the seller it does not exist.
• The request only makes sense on one of them — buy-box, catalogue position, seller medals, a fulfilment programme or search keywords are Mercado Livre only.
• Otherwise ask — one short question, mentioning that both are available. Never guess and never default.

Never mix data from the two marketplaces in one query, one table or one total. They are separate pipelines with different grains and estimate methods; a combined figure is simply wrong. If the seller wants both, run the analysis twice and report the two side by side, comparing direction and orders of magnitude — never exact numbers.

Step 1 — Resolve the parent category

Ask the seller for a category if none was given, then use JoomPulse to match the free text to a category on the chosen marketplace. If several plausible matches come back, list the top candidates (name and depth level) and let the seller choose.

Step 2 — Collect the sub-categories at the deepest level available

Use JoomPulse to list the descendant categories below the chosen one, keeping the deepest level the marketplace actually supports:

• Mercado Livre: the deep ones — leaf niches deeper than the third level.
• Shopee: the third level, which is as deep as category analytics go. Anything deeper comes back empty, so do not chase it. If the seller specifically wants deep niches on Shopee, name the limitation — deeper niches are folded into their level-3 ancestor and cannot be separated — and point them at the item-level view instead, where items carry their own deeper category path; that is a different skill's territory, so hand it over rather than faking depth here.

For each kept category, get the current monthly estimated revenue and sales, the number of active sellers, the month-over-month growth of both revenue and units, the concentration of orders on the leading seller, and revenue per seller. Every reported column exists on both marketplaces, but concentration is computed differently on each — never compare that figure across marketplaces.

On Shopee, work out the most recent month explicitly instead of trusting a latest-month indicator — that indicator is unreliable there — and state which month the figures describe.

Step 3 — Keep the fast-growing ones

From those sub-categories, keep only the ones that are growing fast (strong month-over-month revenue growth), then order the kept niches by revenue growth, fastest first.

Apply a size floor before ranking, and state it. Month-over-month growth explodes off a near-zero base: a niche going from R$ 200 to R$ 1.600 reads +700% and leads the table over one that added hundreds of thousands. Set the floor relative to the parent the seller named — at least 0,02% of that category's estimated monthly revenue, and never below R$ 300 mil. A fixed figure cannot serve both marketplaces, because they rank different units: deep leaf niches on Mercado Livre against whole level-3 categories on Shopee, which are far larger. Say under the table which floor was used and how many niches it excluded. Without a stated floor the same category returns a different leader from run to run.

Read revenue growth and unit growth together. A niche can grow revenue while selling fewer units: the gain came from a higher average ticket, not from more demand, and a seller who wants volume should not enter it — say so plainly. The reverse, units growing faster than revenue, means the average price is falling: easier to enter, margin under pressure. Flag both cases.

Collapse a parent and its dominant child — Mercado Livre only, since Shopee has nothing below the level being ranked. A deep tree ranks a sub-category and its own child separately, so a parent holding nearly all its revenue in one child appears twice and reads as two opportunities. Where a child accounts for almost all of its parent's revenue, keep one row, name the other beside it, and say they are the same niche — twelve rows should mean twelve choices.

Identify the surviving row by the same identifier every time. Where a pair is collapsed, keep the row under the parent and name the child beside it. The identifier is the only way the seller can find the niche again, and the table is meant to be saved and compared next period — the same niche appearing under two different identifiers across runs defeats the purpose of showing one.

Then say which of the ranked niches is actually enterable. Growth alone is not room:

• Concentration. Where one seller holds a large share of the category's orders, strong growth is not open space; name those niches and say the seller would be taking on a dominant incumbent.
• Revenue per seller. A large, fast-growing niche split across tens of thousands of sellers is worth less than a smaller one with few. Name the best and the worst rather than leaving the columns to be divided by hand.
• Seasonality — Mercado Livre only. Where the category is marked seasonal with a known peak month, say whether the growth is the start of the ramp (time to position) or the middle of the curve (entering behind it). Shopee carries no seasonality data: do not infer it there, and where the calendar suggests a season say that as timing, not as data.

Lead the written read with the most enterable niches — strong growth with low concentration — not simply the fastest-growing.

Keep levels and changes distinct: use the always-positive monthly totals for size, and never present a change figure as if it were a total.

Month-over-month revenue growth works on both marketplaces, and the growth ranking survives on each. On Shopee only about three months of history exist, so compare the most recent month with the one before it and read nothing longer-run into it — which makes the floor matter more there, not less, because a short history makes a percentage noisier.

Output

Respond in the language of the seller's request (default pt-BR), with no commentary about how the result was produced. Lead with a short line naming the marketplace, the parent category, the level the ranking is at, and the month the figures describe. On Shopee that line also says plainly that niches deeper than the third level are folded into their level-3 ancestor and cannot be separated here.

The column headers, labels and disclaimers below are written in pt-BR because that is the default. They are a template, not literal strings: when the seller writes in another language, translate all of them — the headers, row values such as sim / não / ouro, and the disclaimer — and keep the structure, the emoji and the R$ money formatting, which stays the same in every language because the marketplace trades in reais. When the request is in English, no Portuguese is left anywhere in the answer.

The ranking always renders as a markdown table:

• Exactly these eight columns on both marketplaces. Concentration and revenue per seller are what turn a growth list into an entry decision, so they belong in every run rather than only the ones where they occur to you.
• Show the growth the ranking is built on — never rank on a number the table does not display. Both growth columns are month-over-month.
• Monopolização carries the tier and the raw value together, as Baixa (0,180) — the tier alone hides how close two niches are.
• Full precision in the money columns on Mercado Livre — R$ 468.400,35, never R$ 468 mil: this is a ranking, and rounding collapses the rows into each other. Shopee is exempt. Its figures are rebuilt from the platform's own rounded sold counters, so exact digits there would be false precision — round Shopee money to thousands and say once that the source is rounded.
• Identify each row by its category ID beside the name. Neither marketplace has a working per-category deep link: on Shopee there is none at all, and on Mercado Livre a URL carrying a category identifier resolves to the same general categories page. So give the seller the route in one line below the table and never render a per-row URL as though it opened that niche — the ID is what lets them find it, and a link that lands somewhere general while looking specific is worse than none.
• Under the table, state the size floor used, the period compared, and how many niches were read against how many the ranking shows. Give those counts exactly, never rounded or hedged — "about 900" cannot be checked against the data, and a coverage claim nobody can audit is worth little more than none.

Disclaimer (every report) — use the variant for the marketplace you queried.

Mercado Livre:

⚠️ Receita, vendas e crescimento da categoria são estimativas de mercado do JoomPulse — não são transações reais, e o crescimento mês a mês herda essa margem de erro. A base mensal de categorias pode ter até ~31 dias de defasagem. / Category revenue, sales, and growth are JoomPulse market estimates — not actual transactions, and the month-over-month growth inherits that margin of error. The monthly category data can lag by up to ~31 days.

Shopee:

⚠️ Receita e vendas são estimativas do JoomPulse a partir dos contadores arredondados da própria Shopee — não são transações reais, e diferenças pequenas entre categorias são ruído. / Revenue and sales are JoomPulse estimates built from Shopee's own rounded sold counters — not actual transactions, and small gaps between categories are noise.

Visualization

Render the visuals every time the data supports them. As soon as the analysis is done, present the cards and charts described below as a self-contained visual panel — an artifact where the client renders artifacts, an inline widget where it renders widgets. Do not ask permission first, do not describe the panel instead of drawing it, and do not offer it as an optional extra: the cards and charts are part of the answer, not a follow-up.

• Order: the cards first, then the charts, then the written read.
• The data table always stays markdown in the response text, never inside the panel — the panel carries cards and charts only.
• The estimate disclaimer always stays in the response text as well.
• Skip an individual chart when its own data threshold is not met (each threshold is stated below): a chart nobody can read is worse than no chart. Skipping one chart never means skipping the panel.
• Only the cards and charts specified below. Do not invent extra ones, and do not promote a categorical value to a bar — a chip or plain text is the honest rendering for it.
• If no visual surface is available at all, fall back to the markdown table plus the same figures written as text cards. Never block on visuals, and never leave the answer without its numbers.

The panel contains:

• Three cards: number of growing niches found, the single fastest-growing niche (name + growth %), and the average growth across the shortlist.
• A size-versus-growth bubble chart: each niche placed by market size (estimated monthly revenue) against its growth %, with bubble size showing the number of sellers — the upper-right area is the large-and-fast-growing sweet spot. Render this chart only when the data supports it (a few niches); fall back to a simple bar of the top niches by growth, and skip the chart entirely when there are too few niches.

Presentation rules: any change or difference column uses a word as its header ("Variação" / "Crescimento"), never a bare "Δ" symbol; render a chart only when the underlying data supports it. On Shopee, label the visuals with the level the ranking is at (the third) so nobody reads them as deep leaf niches.

Notes & Guardrails

The seller should never see a system or stack error — only a friendly next step.

• Flat parent category: if the chosen category has nothing below it at the level this skill ranks — deeper than the third level on Mercado Livre, the third level on Shopee — say so plainly and offer to look at a broader parent category instead of returning an empty table.
• Deeper niches on Shopee: never fabricate a level below the third and never present a level-3 row as a deep leaf. Say the platform folds deeper niches into their level-3 ancestor and offer the item-level route instead.
• Not enough history: with only about three months of Shopee history, there will often be too little to judge growth. Say that honestly rather than lowering the bar on what counts as fast growth.
• Negative or odd growth: some niches may be shrinking; surface that honestly rather than hiding it, and never invent a positive trend.
• Missing values. Show — for any figure that is unavailable, and never print 0 for something that was simply not measured.
• Market data temporarily unavailable: retry once after a short pause rather than immediately; if it still fails, say the service is busy and to try again in a few minutes. Never paste internal error text, HTTP codes, or field names to the seller.
• An empty result is not a failure. A category with no niches above the floor is an answer — say that, and offer to lower the floor or widen the parent. Never report a genuine empty result as an outage.
• Never silently limit coverage. State how many niches were read against how many the ranking shows. Where the pull can be ordered by growth, one page is enough for a top-N and nothing unread grows faster — say so; otherwise page until a pull comes back short.