top-brand-position-tracker

Top brand position tracker

This skill ranks the brands inside one Mercado Livre (Brasil) category by estimated weekly revenue and tracks how each brand's position in that ranking moves over time. It aggregates each brand's active listings into a leaderboard.

Each run builds today's brand-ranking table for the category and offers it as a downloadable table. To see how positions moved, the user supplies a brand table from a previous period (the one this skill produced before); the skill matches brands by name and shows each brand's position movement. The baseline is whatever table the user provides — there is no hidden session memory and nothing is stored server-side. A standalone run is the ranking only: no movement column and no legend.

This is different from ranking sellers or sizing a category. To rank sellers (shops) in a category, or to track how a seller leaderboard moves over time, use the seller-ranking skills. To report a category's market size and opportunity (estimated GMV, sales, number of sellers, average ticket), use the category opportunity skill. This skill answers "which brands lead this category, and how did their positions move since a previous table?"

Prerequisites

• JoomPulse MCP access is configured for the current agent environment.
• The user provides the category to analyze — a category name, a category identifier, or a JoomPulse category link.
• For a period comparison, the user supplies a previous brand table that this skill produced for the same category (pasted or uploaded). Without it, the skill produces a standalone ranking.
• The available JoomPulse tools can look up the active listings in a category along with their estimated weekly sales and revenue, review counts, and prices.

If JoomPulse MCP access is unavailable, stop and explain that the skill requires JoomPulse MCP setup before it can rank brands and track their positions.

Scope

• Mercado Livre (Brasil) only. JoomPulse also covers Shopee Brasil, but Shopee brand coverage is incomplete by construction — only items with tracked sales carry a brand, so brands are systematically missing and a ranking would imply a completeness the data cannot support. Brand shares and brand leaderboards must not be computed for Shopee; this analysis exists only for Mercado Livre.
• Sales and revenue are JoomPulse estimates derived from historical listing data — not real transactions. Disclose this in every output. By contrast, review count is real Mercado Livre history — say so, it is a strength of the report.
• Read-only. The skill never signs in as the seller and never modifies anything; it does not store the ranking — the user keeps the downloadable table and brings it back next period.
• The baseline is user-supplied. Never claim a position change without a previous table to compare against, and never infer or fabricate one from memory.
• Language: respond in pt-BR by default. If the seller clearly writes in another language, mirror it; otherwise pt-BR.
• Keep the workflow invisible. The seller wants the ranking, not a play-by- play. If one approach does not return data, switch to another quietly; only if every approach fails do you say one short, friendly sentence.