| name | my-product-vs-catalog |
| description | Compares the seller's own Mercado Livre listing against the available competing listings of the same catalog product — the buy-box competition — and says where they win, lose, and what to fix first. Use it when a seller asks why they don't win the buy-box, why they don't sell despite the same product, or how they rank inside a catalog, given a Mercado Livre or JoomPulse link or a listing or catalog product identifier. It scores each parameter — price, free shipping, Full, listing type, seller reputation, official store — as Melhor, Na média, Pior, or Criticamente pior, presents reviews and rating as context, and returns a verdict, a comparison table, prioritized actions, and a spreadsheet. Triggers include "why don't I win the buy-box" and the pt-BR "por que não ganho o buy-box". Mercado Livre (Brasil) only; sales and revenue are JoomPulse estimates, not real transactions. For a product and its competitors, use the single-product analysis skill; for one over time, the change-monitor skill.
|
Mercado Livre — My Product vs. Catalog (Buy-Box Competitiveness)
This skill compares the seller's own Mercado Livre (Brasil) listing against
the available competing listings of the same catalog product — the sellers competing
for the same buy-box — and tells the seller, in pt-BR, where they win, where they
lose, and what to fix first to win the buy-box and convert more.
Given a product by a Mercado Livre link, a JoomPulse link, a Mercado Livre listing
identifier, or a catalog product identifier, it identifies the seller's listing and
the catalog it belongs to, gathers the available competing listings, and produces
a short verdict, a comparison table, a prioritized list of improvements, and a
downloadable spreadsheet. The comparison covers the available competing listings;
when a large catalog is sampled, it says so.
This is different from the sibling skills. To size up a single product and find the
products that compete with it, use the single-product analysis skill. To track how
one product moves over time, use the change-monitor skill. This skill answers
"how do I stack up against the other sellers of the exact same product, and what
should I change to win?"
Prerequisites
- JoomPulse MCP access is configured for the current agent environment.
- The seller provides their product as a Mercado Livre link, a JoomPulse link, a
Mercado Livre listing identifier, or a catalog product identifier.
- The available JoomPulse tools can look up a listing's current market data, the
set of competing listings for the same catalog product, and the buy-box winner's
attributes.
If JoomPulse MCP access is unavailable, stop and explain that the skill requires
JoomPulse MCP setup before it can compare a listing against its catalog.
Scope
- Mercado Livre (Brasil) only. Other marketplaces are out of scope.
- It compares within one catalog product. The comparison is the seller versus
the other sellers of the same catalog product (the same buy-box), not a search
for similar products.
- Sales and revenue are JoomPulse estimates derived from historical listing
data — not real transactions. Disclose this in every output. Price, rating,
review count, logistics, and seller attributes are real Mercado Livre data — say
so, it is a strength of the report.
- Read-only. The skill does not sign in as the seller or modify any listing.
- Language: detect the seller's language and respond in it. Default to pt-BR.
- Keep the workflow invisible. The seller wants the answer, not a play-by-play.
If one lookup returns nothing, switch approaches quietly; only if everything fails
do you say one short, friendly sentence.
How It Works
- Identify the product. Resolve the link or identifier to the seller's listing
and the catalog product it belongs to. If the input is a catalog product (rather
than a single listing), ask the seller which listing is theirs, since the whole
point is to compare their listing against the rest. The catalog product is the
key that groups competing sellers.
- Gather the catalog. Collect every active competing listing for that catalog
product, plus the buy-box winner's attributes and the catalog's overall totals,
so there is a clear "catalog leader" to benchmark against.
- Compare and classify. For each parameter, compare the seller's value to the
catalog median, the best/cheapest competitor, and the buy-box winner, and label
it (see Status levels below).
- Prioritize. Sort the gaps by how much they cost: buy-box and conversion
levers first, quick wins ahead of slow ones — which naturally yields the order
price → logistics → reputation.
Parameters Compared
- Price — versus the catalog median, the cheapest competitor, and the buy-box
price.
- Free shipping (frete grátis) — whether the seller offers it and how common it
is among competitors and the buy-box winner.
- Mercado Envios Full — same, since Full strongly influences exposure and the
buy-box.
- Listing type — Premium / Clássico / Grátis tier, versus the catalog.
- Reviews and rating — on catalog products these are usually shared across all
sellers of the same product, so they are generally not comparable between
competitors. Present them as context, not as a scored Melhor/Pior dimension,
instead of treating a shared number as an advantage.
- Seller reputation and medal — versus the buy-box winner and the catalog.
- Official store — whether the seller or the buy-box winner is an official store
(shown when relevant).
Status Levels
Each parameter gets one status, with a colour marker so it reads at a glance:
- 🟢 Melhor — better than most of the catalog; keep it.
- 🟡 Na média — on par with the catalog, i.e. level with most sellers (not merely
an arithmetic average).
- 🟠 Pior — clearly behind the catalog.
- 🔴 Criticamente pior — behind on a buy-box or conversion lever (price, free
shipping, Full) where the gap is large — this is what most directly costs the sale.
- — — not compared (no data available, or a catalog-shared metric like reviews).
Output
Respond in pt-BR, leading with the verdict:
- Veredito — two to four sentences: where the seller wins, where they lose,
their buy-box position, and the single top priority.
- Comparison table — one row per parameter:
Parâmetro, Meu produto,
Catálogo / Concorrentes, Status, O que fazer.
- Improvement priorities — a numbered list, ordered by impact: what matters most
for competitiveness first, then quick wins, then the long-term levers.
- Competitors (optional) — a short table of competing listings, cheapest first,
flagging the buy-box winner.
- Disclaimer — include the bilingual estimate notice below.
- Downloads — offer the comparison as a downloadable spreadsheet.
Disclaimer (every report):
⚠️ Sales and revenue are JoomPulse estimates based on historical listing
data — they are not actual transactions. Price, rating, reviews, logistics,
and seller data are real Mercado Livre data. / 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, avaliações, logística e dados do
vendedor são dados reais do Mercado Livre.
Edge Cases
- The input is a catalog product, not a single listing: ask which listing is the
seller's before comparing.
- The product is not part of a catalog: there is no shared buy-box to compete in;
say so and offer the single-product analysis skill instead.
- The seller is the only seller: there is nothing to compare — report the buy-box
status and say they are currently alone on this product.
- A very large catalog: when there are more competitors than can be fetched at
once, the medians and shares are based on a sample — say so — while the buy-box
leader's attributes remain exact.
- A listing is not tracked by JoomPulse: the index covers products with sales;
say it isn't tracked and offer to try another listing or link.
- A parameter has no data: show it as "dado indisponível" rather than dropping it,
so the seller can see every parameter was checked.
