# My Product Vs Catalog

> >

- **Type:** Skill
- **Install:** `agentstack add skill-joomcode-joompulse-skills-my-product-vs-catalog`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [joomcode](https://agentstack.voostack.com/s/joomcode)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [joomcode](https://github.com/joomcode)
- **Source:** https://github.com/joomcode/joompulse-skills/tree/main/skills/my-product-vs-catalog
- **Website:** https://joompulse.com/mcp-connector

## Install

```sh
agentstack add skill-joomcode-joompulse-skills-my-product-vs-catalog
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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

1. **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.
2. **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.
3. **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).
4. **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:

1. **Veredito** — two to four sentences: where the seller wins, where they lose,
   their buy-box position, and the single top priority.
2. **Comparison table** — one row per parameter: `Parâmetro`, `Meu produto`,
   `Catálogo / Concorrentes`, `Status`, `O que fazer`.
3. **Improvement priorities** — a numbered list, ordered by impact: what matters most
   for competitiveness first, then quick wins, then the long-term levers.
4. **Competitors (optional)** — a short table of competing listings, cheapest first,
   flagging the buy-box winner.
5. **Disclaimer** — include the bilingual estimate notice below.
6. **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.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [joomcode](https://github.com/joomcode)
- **Source:** [joomcode/joompulse-skills](https://github.com/joomcode/joompulse-skills)
- **License:** MIT
- **Homepage:** https://joompulse.com/mcp-connector

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-joomcode-joompulse-skills-my-product-vs-catalog
- Seller: https://agentstack.voostack.com/s/joomcode
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.