My Product Vs Catalog logo

My Product Vs Catalog

Organization
joomcode
my-product-vs-catalog

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.

Overview

Publisherjoomcode
Repositoryjoompulse-skills
Skill namemy-product-vs-catalog
Stars
54
Forks
4
Bundled files
Instructions only
LicenseMIT
Links
  • Markdown instructions

    A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.

  • Works with any LLM

    AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.

  • Self-contained

    Everything the model needs lives in the instructions — no extra files to sync.

  • Open source

    Published by joomcode on GitHub. Read the source before you install it.

Installation

Install the My Product Vs Catalog AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

1

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

  1. Open the app and go to Plugins → Skills.
  2. Choose "Install from GitHub".
  3. Paste the skill folder URL below and confirm.
    https://github.com/joomcode/joompulse-skills/tree/main/skills/my-product-vs-catalog
  4. Enable the skill in any chat where you want it available.
Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.
2

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills
git clone --depth 1 https://github.com/joomcode/joompulse-skills.git /tmp/joompulse-skills
mkdir -p .claude/skills
cp -r /tmp/joompulse-skills/skills/my-product-vs-catalog .claude/skills/my-product-vs-catalog
Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable My Product Vs Catalog in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads My Product Vs Catalog on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so My Product Vs Catalog is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

  • Loaded only when it is needed

    The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.

  • Switch models mid-chat

    Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

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 the language of their request, 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. JoomPulse also covers Shopee Brasil, but Shopee has no catalogue and no buy-box — an item belongs to one shop, so there is no set of rival offers on the same product to be measured against and no buy-box to win. This analysis therefore exists only for Mercado Livre; never apply its logic or its verdict wording to a Shopee item.
  • 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: 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. 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 the language of the seller's request, default pt-BR, leading with the verdict:

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.

  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 item is on Shopee, not Mercado Livre: say plainly that Shopee has no catalogue and no buy-box, so there is no rival-offer set on the same product to compare against — the question cannot be answered there, and Mercado Livre logic must not be borrowed. Offer the nearest real alternative: how the item compares with others in its Shopee category on price, rating and reviews, labelled as a public-market comparison rather than a buy-box verdict. If the marketplace is unclear, ask first — an identifier beginning MLB is Mercado Livre, a bare 10–11 digit number is Shopee.
  • 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.

Frequently asked questions

What does the My Product Vs Catalog AI skill do?

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...

Why use My Product Vs Catalog on TypingMind?

Because you install it once and use it with any model. My Product Vs Catalog is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install My Product Vs Catalog in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/joomcode/joompulse-skills/tree/main/skills/my-product-vs-catalog. TypingMind reads its SKILL.md and installs it as a skill you can enable per chat.

Which AI models can use My Product Vs Catalog?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with My Product Vs Catalog?

As many as you like. As long as a model supports skills, you can use My Product Vs Catalog with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the My Product Vs Catalog AI skill free?

Yes. It is published on GitHub by joomcode under the MIT license. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

View all

Set up your own AI workspace now

Get notified about new features and future giveaways by subscribing to our newsletter 👇