Skill instructions
category-monitor8.34 KB
View saved version →
---
name: category-monitor
description: >
Monitors one Mercado Livre (Brasil) category's aggregate health via JoomPulse — estimated
sales, number of products and catalog products, active sellers, the seller-medal
distribution, and the monopolization level. Each run builds today's snapshot table and
offers it for download; to see what changed, the user sends a table from a previous period
and the skill shows the metric-by-metric difference. The baseline is whatever table the user
supplies — no hidden session memory. Triggers: "monitor this category", "what changed in
this category", "track category sales and sellers", and the pt-BR "monitorar esta
categoria", "o que mudou na categoria", "comparar a categoria com o período anterior". Sales
and revenue are JoomPulse estimates, not real transactions. To track one named product over
time use the product-change-monitor skill; for a one-shot market-size or opportunity
snapshot use the category-opportunity-index skill.
---
# Category Monitor
This skill tracks **one Mercado Livre (Brasil) category's aggregate health over time** — its estimated
sales, number of products and catalog products, number of active sellers, the distribution of sellers
across medal tiers, and how concentrated the market is (monopolization).
Each run builds **today's snapshot table** for the category and offers it as a **downloadable table**.
To see what changed, the user **supplies the table from a previous period** (the one this skill
produced before); the skill compares the two and shows the difference per metric. **The baseline is
whatever table the user provides — there is no hidden session memory and nothing is stored
server-side.** The default view is the whole category; the user may instead point it at a single
listing or a catalog product (a catalog product rolls up its competing listings).
To track one named product over time, use the product-change-monitor skill. For a one-shot
opportunity / market-size snapshot, use the category-opportunity-index skill.
## Prerequisites
- JoomPulse MCP access is configured for the current agent environment.
- The user names a category (or, optionally, a single listing or catalog product).
- For a period comparison, the user supplies a previous table that this skill produced for the same
category (pasted or uploaded). Without it, the skill produces a standalone snapshot.
- The available JoomPulse tools can return a category's aggregate metrics and its seller-medal
distribution.
If JoomPulse MCP access is unavailable, stop and explain that the skill requires JoomPulse MCP setup
before it can monitor a category.
## Scope
- **Mercado Livre (Brasil) only.** Other marketplaces are out of scope.
- **Sales and revenue are JoomPulse estimates** derived from historical listing data — not real
transactions. Disclose this in every output.
- **Read-only.** The skill never writes or modifies anything; it does not store the snapshot — the
user keeps the downloadable table and brings it back next period.
- **Language:** detect the seller's language and respond in it. Default to pt-BR.
- **The baseline is user-supplied.** Never claim a change without a previous table to compare against,
and never infer or fabricate one from memory.
## Workflow
### Step 1 — Resolve what to monitor
Ask for a category if none was given, then use JoomPulse to match the free text to a category
(disambiguate with the user when several plausible matches return). Optionally, the user can point the
skill at a single listing or a catalog product instead.
### Step 2 — Collect today's aggregates
Use JoomPulse to collect, for the target: estimated sales, number of products, number of catalog
products, number of active sellers, the seller-medal distribution, and the monopolization level.
### Step 3 — Present today's snapshot and offer it for download
Render the snapshot table for **today** (head it with the category name and the date). This table is
the deliverable —
Preview of the first 4,000 characters. Read full instructions →
category-opportunity-index10.4 KB
View saved version →
---
name: category-opportunity-index
description: >
Reports the JoomPulse opportunity index (low, medium, or high) for one
Mercado Livre (Brasil) category, alongside that category's current monthly
market stats — estimated GMV, estimated sales, number of active sellers,
number of active listings, and average ticket — then writes a plain-language
read on how attractive the category is to enter. Use it when a seller wants a
one-shot market snapshot for a category they name. Triggers include: "is this
category worth entering", "show the opportunity index for this category",
"how big is this market", and the pt-BR equivalents "qual o índice de
oportunidade", "vale a pena entrar nessa categoria", "tamanho de mercado da
categoria". Sales and revenue are JoomPulse estimates, not real transactions.
For ranking the sellers in a category, use the top-sellers-in-category skill; for
trending search terms, use the top-keywords-in-my-category skill; for comparing
category aggregates against a user-supplied previous snapshot, use the
category-monitor skill.
---
# Category Opportunity Index
This skill answers a single question for **one** Mercado Livre (Brasil)
category: is it worth entering? Given a category named in free text, it reads
that category's **opportunity index** (low, medium, or high) and its current
monthly market indicators — estimated GMV, estimated sales, active sellers,
active listings, and average ticket — then writes a short pt-BR summary that
interprets the opportunity level together with how concentrated the market is
(monopolization) and which way it is growing.
This is a point-in-time snapshot, not a tracker. To rank the sellers inside a
category, use the top-sellers-in-category skill. For the trending search terms
shoppers use in a category, use the top-keywords-in-my-category skill. To compare
a category's aggregates against a user-supplied previous snapshot, use the
category-monitor skill. This skill answers "how attractive is this category right
now?" for a category the user names.
## Prerequisites
- JoomPulse MCP access is configured for the current agent environment.
- The user names the category to evaluate (free text is fine).
- The available JoomPulse tools can resolve a category name to a category and
return that category's current monthly market indicators plus its recent
monthly history.
If JoomPulse MCP access is unavailable, stop and explain that the skill requires
JoomPulse MCP setup before it can report a category's opportunity index.
## Scope
- **Mercado Livre (Brasil) only.** Other marketplaces are out of scope.
- **Sales and revenue are JoomPulse estimates** derived from historical listing
data — not real transactions. The seller, listing, and average-ticket counts
shown here are estimates too. Disclose this in every output.
- **Read-only.** The skill never writes or modifies anything.
- **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 approach does not return data, switch to another quietly; only if
every approach fails do you say one short, friendly sentence. Never fill gaps
from general knowledge, and never fabricate a number — show `—` when a value
is missing.
## Workflow
### Step 1 — Resolve the category
1. If the user did not name a category, ask which one to evaluate
(for example *"Para qual categoria você quer o Índice de Oportunidade?"*).
2. Use JoomPulse to match the free text to a category, retrieving candidate
categories with their name, depth level, and opportunity index for the
current month.
3. Pick the best match. If several plausible categories come back, list the top
candidates (name and level) and ask the user to choose — do not silently
guess between unrelated categories. If nothing matches, say the category was
not found and ask for a broader or rephrased term.
### Step 2 — Get the cu
Preview of the first 4,000 characters. Read full instructions →
fast-growing-international-products6.27 KB
View saved version →
---
name: fast-growing-international-products
description: >
Finds fast-growing international (imported) products ACROSS ALL Mercado Livre
(Brasil) categories, using JoomPulse, and returns them as one product table
that includes each item's category, with price, estimated weekly sales and
revenue, rating, time on air, shipping, listing type, seller medal, and a
JoomPulse link per item. Use it when a seller wants rising imported products
marketwide, not inside a single niche. Triggers include: "fast-growing
international products", "imported products that are taking off", "cross-border
winners across all categories", and the pt-BR equivalents "produtos
internacionais em alta", "produtos importados crescendo rápido", "produtos
internacionais que mais crescem em todas as categorias". Sales and revenue are
JoomPulse estimates, not real transactions. For the same search limited to one
category, use the single-category international skill.
---
# Fast-Growing International Products
This skill returns the **fast-growing international (imported) products across all
Mercado Livre (Brasil) categories** — a marketwide shortlist of cross-border
items with recent momentum, each shown with the category it sits in. It is the
all-categories sibling of the single-category international skill.
For imported products inside one specific category, use the single-category
international skill.
## Prerequisites
- JoomPulse MCP access is configured for the current agent environment.
- The available JoomPulse tools can return active international listings across
categories with their category, price, estimated sales and revenue, rating,
time on air, logistics, listing type and seller medal.
If JoomPulse MCP access is unavailable, stop and explain that the skill requires
JoomPulse MCP setup before it can find international products.
## Scope
- **Mercado Livre (Brasil) only.** Other marketplaces are out of scope.
- **Sales and revenue are JoomPulse estimates** derived from historical listing
data — not real transactions. Price, rating, and reviews are real history.
Disclose the estimate caveat in every output.
- **Read-only.** The skill never writes or modifies anything.
- **Language:** detect the seller's language and respond in it. Default to pt-BR.
- **Keep the workflow invisible.** Show `—` for any missing value; never fabricate.
## Workflow
### Step 1 — Optional narrowing
This skill is marketwide by default. The seller may optionally narrow it to a
broad area; if they do and the term is ambiguous, disambiguate before continuing.
### Step 2 — Find fast-growing international products marketwide
Use JoomPulse to get active **international (imported)** listings across
categories. There is no single "fast growth" flag, so it must be defined from a
real momentum proxy — **revenue alone is not growth**, and ranking by it surfaces
old, high-ticket slow movers rather than rising items.
**Default fast-growth rule (always apply and disclose):** an item is "fast-growing"
only when it is **recently listed (low time on air)** *and* has **strong estimated
weekly sales (and/or estimated weekly revenue)** — that is, it gained real traction
in a short time. Rank the shortlist by that momentum (estimated weekly sales/revenue
relative to how recently it was listed), not by revenue on its own. **State this
rule in the output.**
Keep a clearly stated **top-N** (for example top 30) and say it is a top-N.
**Fallback (not "growth"):** if recency data is unavailable, you may instead show
the **top international items by estimated weekly revenue** — but label it plainly
as a *top-by-revenue fallback*, never call it "fast-growing" or "growth", and say
the momentum rule could not be applied.
## Output
Respond in the seller's language (default pt-BR). The product list always renders
as a markdown table, and **includes a Category column** (the cross-category
differentiator):
| MLB | Nome | Vendedor | Categoria | Preço | Vendas (se
Preview of the first 4,000 characters. Read full instructions →
growing-leaf-category-tracker6.28 KB
View saved version →
---
name: growing-leaf-category-tracker
description: >
Finds the fastest-growing deep sub-categories (leaf categories, deeper than the
third level) under a chosen Mercado Livre (Brasil) category, ranked by
month-over-month revenue growth, using JoomPulse market data. Use it when a
seller picks a category and wants the niches inside it that are growing fastest
right now. Triggers include: "fast-growing subcategories", "which niches are
growing in this category", "deep growing categories", and the pt-BR equivalents
"subcategorias em crescimento", "nichos que mais crescem nesta categoria",
"categorias profundas em alta". Sales and revenue are JoomPulse estimates, not
real transactions. For one category's opportunity index, use the
category-opportunity-index skill; for comparing category aggregates against a
user-supplied previous snapshot, use the category-monitor skill; for new products
inside a category, use the new-growing-products-in-category skill.
---
# Growing Leaf Category Tracker
This skill takes one Mercado Livre (Brasil) category and surfaces the **deep
sub-categories inside it that are growing fastest** — the leaf niches (below the
third level of the category tree) 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.
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 names a parent category (free text is fine).
- The available JoomPulse tools can resolve a category, 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 its growth direction.
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) only.** Other marketplaces are out of scope.
- **Sales and revenue are JoomPulse estimates** derived from historical listing
data — not real transactions. Disclose this in every output.
- **Read-only.** The skill never writes or modifies anything.
- **Language:** detect the seller's language and respond in it. Default to pt-BR.
- **Keep the workflow invisible.** Surface the answer, not the steps. Never fill
gaps from general knowledge; show `—` for any missing value.
## Workflow
### 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. If several plausible matches come back, list the top
candidates (name and depth level) and let the seller choose.
### Step 2 — Collect the deep sub-categories
Use JoomPulse to list the descendant categories below the chosen one, keeping the
**deep ones — leaf niches deeper than the third level**. For each, get the
current monthly estimated revenue and sales, the number of active sellers, the
number of products, and the month-over-month revenue growth.
### Step 3 — Keep the fast-growing ones
From those deep sub-categories, **keep only the ones that are growing fast**
(strong month-over-month revenue growth), then order the kept niches by growth,
fastest first. Use the always-positive monthly totals for size (revenue, sales,
products); growth is the filter that selects the niches — never present a change
figure as a total or as a table column.
## Output
Respond in the seller's language (default pt-BR), with no commentary about how the
result was produced. The ranking always renders as a markdown table:
| Categoria | Qtd. ven
Preview of the first 4,000 characters. Read full instructions →
high-demand-low-quality-finder8.98 KB
View saved version →
---
name: high-demand-low-quality-finder
description: >
Finds Mercado Livre (Brasil) products in one category that have high demand but a low rating
— listings that sell well yet score at or below a rating threshold the user chooses, an
opening to enter with a better offer. Use it when a seller wants weak-rated but well-selling
products to beat. The skill asks for a category and a rating threshold, then returns the
matching active listings ranked by demand, using JoomPulse market data. Triggers: "high
demand low rating products", "low quality opportunities", "products I can beat", and the pt-
BR "produtos com muita demanda e nota baixa", "oportunidades de baixa qualidade", "produtos
mal avaliados que vendem". Sales and revenue are JoomPulse estimates, not real transactions;
price, rating, and reviews are real history. For brand-new listings use the new-growing-
products-in-category skill; for niches without strong incumbents use the uncontested-niche-
finder skill; for one product and its competitors use the ml-product-analysis skill.
---
# High-Demand, Low-Quality Finder
This skill surfaces products in one Mercado Livre (Brasil) category that **sell
well but are poorly rated** — listings with strong demand whose rating sits at or
below a threshold the seller chooses. These are the products a seller has the best
chance of beating: the demand is already proven, and a better offer can win on
quality. The result is a ranked product table, ordered by estimated demand, with a
JoomPulse link per product.
This is different from finding fresh entrants or empty niches. To find brand-new
listings that are already selling in a category, use the new-and-growing-products
skill. To find niches with no strong incumbents, use the uncontested-niche skill.
To size up a single product and the products that compete with it, use the
single-product analysis skill. This skill answers "which proven sellers in this
category are weak on quality, so I can enter with a better offer?"
## Prerequisites
- JoomPulse MCP access is configured for the current agent environment.
- The user provides the **category** (a name or a category identifier) **and** a
**rating threshold** (for example `4.0`). Both are required.
- The available JoomPulse tools can resolve a category and list the active
listings in it with their demand, rating, price, and logistics.
If JoomPulse MCP access is unavailable, stop and explain that the skill requires
JoomPulse MCP setup before it can find opportunities.
## Scope
- **Mercado Livre (Brasil) only.** Other marketplaces are out of scope.
- **Sales and revenue are JoomPulse estimates** derived from historical listing
data — not real transactions. Disclose this in every output. By contrast,
**price, rating, and review count are real history** from Mercado Livre — 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 approach does not return data, switch to another quietly; only if
every approach fails do you say one short, friendly sentence.
## Workflow
### Step 1 — Collect the inputs
1. Ask the user for both the **category** and the **rating threshold**. Both are
required before you proceed.
2. Resolve the user's category text to a category identifier. If they gave a name,
look it up in JoomPulse and confirm the match if it is ambiguous; if they gave
an identifier, use it directly.
3. The rating threshold becomes the upper bound: keep only products whose rating
is **at or below** the chosen value.
### Step 2 — Pull the category's listings
Use JoomPulse to obtain the active listings in the chosen category whose rating is
at or below the threshold. For each listing, gather the data needed for the table:
estimated weekly sales and revenue, e
Preview of the first 4,000 characters. Read full instructions →
ml-product-analysis10.4 KB
View saved version →
---
name: ml-product-analysis
description: >
Analyzes one Mercado Livre product and its competitors. Use this skill when a
user wants to size up a single product or the products that compete with it —
by a Mercado Livre link, a JoomPulse link, a photo, or a row of data. It
returns a product card for the subject plus a ranked table of comparable
products, each with price, estimated monthly sales and revenue, logistics, and
catalog / buy-box status. Triggers include: "analyze this product", "how much
does this sell", "find similar products", "find competing products", and the
pt-BR equivalents "analisar este produto", "quanto vende esse produto",
"produtos parecidos", "produtos concorrentes", "análise por foto", "análise por
link". For "what new products should I add to my store" across a whole catalog,
use the assortment gap-analysis skill instead — this skill analyzes a single
product the seller already has in hand.
---
# Mercado Livre Single-Product Analysis
This skill analyzes **one** Mercado Livre (Brasil) product and the products that
compete with it. Given a single product — by a Mercado Livre link, a JoomPulse
link, a photo, or a row of data — it identifies the product, finds comparable
listings, and returns a product card for the subject plus a ranked table of
analogs. For each product it shows price, estimated monthly sales and revenue,
logistics, and catalog / buy-box status.
This is different from whole-catalog assortment analysis. If the user wants to
know which new products to add to their store, hand off to the gap-analysis
skill. This skill works on a single product the seller already has in hand.
## Prerequisites
- JoomPulse MCP access is configured for the current agent environment.
- The user provides one product as a Mercado Livre link, a JoomPulse link, a
product photo, or a row of data (a `.csv` / `.xlsx` file, a pasted table, or
typed fields).
- The available JoomPulse tools can look up product market data and search for
comparable listings.
If JoomPulse MCP access is unavailable, stop and explain that the skill requires
JoomPulse MCP setup before it can analyze a product or find competitors.
## Scope
- **Mercado Livre (Brasil) only.** Other marketplaces are out of scope.
- **Sales and revenue are JoomPulse estimates** derived from historical listing
data — not real transactions. Disclose this in every output.
- **Prices are Mercado Livre prices only.** Do not surface sourcing prices,
margins, or profit figures.
- **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. Do the analysis quietly and present only the result. If one approach to
finding the product or its competitors does not work, switch to another
silently; only if every approach fails do you say one short, friendly sentence.
## Input Router
Resolve the input to a single normalized subject product, then find analogs. The
first matching rule wins:
1. **A photo** → Photo route.
2. **A `.csv` / `.xlsx` file, a pasted table, or typed fields** → Tabular route.
3. **A Mercado Livre link** → MLB route.
4. **A JoomPulse product link** → JoomPulse route.
5. **A JoomPulse store link** → this is a whole store, not one product. Ask for a
specific product link or a product title; whole-store analysis belongs to the
gap-analysis skill.
6. **Any other link** (a different marketplace, a generic web page) → do not
scrape it. Explain that only Mercado Livre and JoomPulse links can be resolved
directly, and ask the seller to paste the product name or upload a photo →
Keyword route.
7. **Plain text** (a product name or keywords) → Keyword route.
Every route converges on one normalized subject product plus a set of candidate
analogs.
### MLB route
1. Extract the product identifier from the link, noting wheth
Preview of the first 4,000 characters. Read full instructions →
my-product-vs-catalog8.28 KB
View saved version →
---
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
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 th
Preview of the first 4,000 characters. Read full instructions →
new-growing-products-in-category8.74 KB
View saved version →
---
name: new-growing-products-in-category
description: >
Finds new, already-selling product listings inside one Mercado Livre (Brasil)
category on JoomPulse — recent listings (by default under about 30 days on air)
that are well rated (rating above 3) and have real traction (more than about 30
estimated sales in the last month), all thresholds overridable — and returns
them as a product table with a JoomPulse link per listing. Use it when a seller
wants fresh, promising entrants in a niche. Triggers include: "new products in
category", "what's launching and already selling", "recent best-sellers in
my category", and the pt-BR equivalents "produtos novos na categoria", "novos
anúncios que já vendem", "lançamentos em alta na minha categoria". Mercado Livre
(Brasil) only; sales and revenue are JoomPulse estimates, not real transactions,
while price, rating, and review count are real history. For weak-rated but
well-selling products to beat, use the high-demand low-quality skill; for
tracking one product over time, use the product change-monitor skill.
---
# New & Growing Products in a Category
This skill surfaces **newly launched listings that are already selling well**
inside one Mercado Livre (Brasil) category, using JoomPulse market data. The
seller picks a category; the skill returns the recent, well-rated,
traction-having listings as a product table, each row linking to its JoomPulse
page so the seller can dig deeper.
This is a discovery snapshot, not a tracker and not a whole-catalog audit. For
products that sell well but are poorly rated — gaps you can enter with a better
offer — use the high-demand low-quality skill. To follow how one product
moves over time, use the product change-monitor skill. This skill answers "which
fresh entrants in this niche are already getting traction right now?"
## Prerequisites
- JoomPulse MCP access is configured for the current agent environment.
- The user provides a category, either by name or by its category identifier.
- The available JoomPulse tools can look up the active listings in a category and
resolve a category name to its identifier.
If JoomPulse MCP access is unavailable, stop and explain that the skill requires
JoomPulse MCP setup before it can find new growing products in a category.
## Scope
- **Mercado Livre (Brasil) only.** Other marketplaces are out of scope.
- **Sales and revenue are JoomPulse estimates** derived from historical listing
data — not real transactions. Disclose this in every output. By contrast,
**price, rating, and review count are real history** from Mercado Livre — 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 approach does not return data, switch to another quietly; only if
every approach fails do you say one short, friendly sentence.
## Workflow
### Step 1 — Capture the category and confirm the thresholds
1. Ask the user for the **category** — a name or a category identifier.
2. The skill keeps three filters, each with a **default the user may override**:
- **recently listed** — under about 30 days on air;
- **well rated** — rating above 3;
- **real traction** — more than about 30 estimated sales in the last month.
3. Echo back what you captured (the category plus the three thresholds in use) so
the user can adjust before you run, then remember those inputs for the rest of
the run.
4. If the user gave a category **name**, resolve it to its identifier first with
JoomPulse, matching the current category list. If the name is ambiguous, list
the candidate categories with their level and ask which one. If the user
already gave an identifier, skip resolution.
### Step 2 — Find the new, already-selling listings
1. Use JoomPulse to retrieve
Preview of the first 4,000 characters. Read full instructions →
popular-international-products5.35 KB
View saved version →
---
name: popular-international-products
description: >
Finds fast-growing international (imported) products inside ONE chosen Mercado
Livre (Brasil) category, using JoomPulse, and returns them as a product table
with price, estimated weekly sales and revenue, rating, reviews, time on air,
shipping, listing type and seller medal, a JoomPulse link per item, and a
pointer to JoomPro for sourcing. Use it when a seller wants the trending
imported items in a specific category. Triggers include: "popular international
products in this category", "fast-growing imported products", and the pt-BR
equivalents "produtos internacionais em alta nessa categoria", "produtos
importados que mais crescem", "achados internacionais para importar". Sales and
revenue are JoomPulse estimates, not real transactions. For the same search
across all categories at once, use the all-categories international skill.
---
# Popular International Products
This skill looks inside **one** Mercado Livre (Brasil) category and returns the
**fast-growing international (imported) products** in it — items flagged as
cross-border, ranked by recent momentum. For each it shows price, estimated
weekly sales and revenue, rating, reviews, time on air, shipping, listing type
and seller medal, with a JoomPulse link per item and a pointer to JoomPro for
sourcing.
It covers a single category and gives a general JoomPro search link. To scan all
categories at once, use the all-categories international skill.
## Prerequisites
- JoomPulse MCP access is configured for the current agent environment.
- The user names a category (free text is fine).
- The available JoomPulse tools can return the active international listings in a
category with their price, estimated sales and revenue, rating, reviews, time
on air, logistics, listing type and seller medal.
If JoomPulse MCP access is unavailable, stop and explain that the skill requires
JoomPulse MCP setup before it can find international products.
## Scope
- **Mercado Livre (Brasil) only.** Other marketplaces are out of scope.
- **Sales and revenue are JoomPulse estimates** derived from historical listing
data — not real transactions. By contrast, price, rating, and review count are
real history. Disclose the estimate caveat in every output.
- **Read-only.** The skill never writes or modifies anything.
- **Language:** detect the seller's language and respond in it. Default to pt-BR.
- **Keep the workflow invisible.** Surface the answer, not the steps. Show `—` for
any missing value; never fabricate one.
## Workflow
### Step 1 — Resolve the category
Ask for a category if none was given, then use JoomPulse to match the free text to
a category, disambiguating with the seller when several plausible matches return.
### Step 2 — Find fast-growing international products
Use JoomPulse to get the active **international (imported)** listings in the
category. There is no single "fast growth" flag, so use a clear momentum proxy
and **state the rule you used**: recently listed items (low time on air) with
strong estimated weekly sales or revenue. Do not label a list as fast-growing
when it is ranked by revenue alone. Keep the shortlist (about 10).
## Output
Respond in the seller's language (default pt-BR). The product list always renders
as a markdown table:
| MLB | Nome | Vendedor | Preço | Vendas (semana) | Receita (semana) | Classificação | Avaliações | Tempo no ar | Frete grátis | Mercado Envios Full | Tipo de anúncio | Medalha | JoomPro |
|---|---|---|--:|--:|--:|--:|--:|--:|:--:|:--:|---|---|---|
- The **MLB** identifier links to the item's JoomPulse page.
- **JoomPro** is a general JoomPro search link (`https://joom.pro/pt-br/search`)
for sourcing the item.
- State the fast-growth rule you applied, in one short line.
**Disclaimer (every report):**
> ⚠️ 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 e avaliaçõ
Preview of the first 4,000 characters. Read full instructions →
product-change-monitor8.35 KB
View saved version →
---
name: product-change-monitor
description: >
Monitors how one or a few Mercado Livre products or listings changed over a
period — by default week over week. Use it when a user wants to track how a
named product changes over time, given a Mercado Livre link, a JoomPulse link,
a Mercado Livre listing identifier, or a catalog product identifier. It returns
a change table: per product the current value and the difference versus about a
week ago for price, rating, and review count, plus the current estimated weekly
sales and revenue, logistics, listing type, seller medal, and time on air, with
a JoomPulse link per product. Triggers include: "monitor this product", "track
price changes", "what changed this week", "did the price drop", and the pt-BR
equivalents "monitorar este produto", "acompanhar este anúncio", "o preço caiu",
"variação de avaliações". Sales and revenue are JoomPulse estimates, not real
transactions; price, rating, and reviews are real history. For point-in-time
product and competitor analysis, use the single-product analysis skill.
---
# Mercado Livre Product Change Monitor
This skill shows how **one** Mercado Livre (Brasil) product — or a few of them —
**changed over a period**, by default the last week. Given a product by a Mercado
Livre link, a JoomPulse link, a Mercado Livre listing identifier, or a catalog
product identifier, it reports for each product the current value **and the
change versus about a week ago** for the metrics that have real history (price,
rating, review count), plus the current snapshot for estimated weekly sales and
revenue, logistics, listing type, seller medal, and how long the listing has been
on air. The result is a change table with a JoomPulse link per product, plus a
downloadable spreadsheet.
This is different from a single point-in-time analysis. To size up a product and
find the products that compete with it, use the single-product analysis skill. To
decide which new products to add across a whole catalog, use the gap-analysis
skill. This skill answers "how did this product move over time?" for a product
the user names.
## Prerequisites
- JoomPulse MCP access is configured for the current agent environment.
- The user provides one product (or a small set) 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 product's current market data and
its daily price and reviews history.
If JoomPulse MCP access is unavailable, stop and explain that the skill requires
JoomPulse MCP setup before it can monitor a product's changes.
## Scope
- **Mercado Livre (Brasil) only.** Other marketplaces are out of scope.
- **Sales and revenue are JoomPulse estimates** derived from historical listing
data — not real transactions. Disclose this in every output. By contrast,
**price, rating, and review count are real history** from Mercado Livre — 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 approach does not return data, switch to another quietly; only if
every approach fails do you say one short, friendly sentence.
## Workflow
### Step 1 — Identify the product(s)
Resolve the input to one or more Mercado Livre listings:
1. From a Mercado Livre link, a JoomPulse link, or a pasted identifier, determine
whether you have an individual **listing** or a **catalog product**.
2. For a catalog product, expand it to the competing listings for that product,
pick the representative one (the strongest seller / buy-box winner) for the
row, and note the buy-box competition (how many sellers compete).
3. Confirm the listing is active. If there is no market data for it, see Notes &
Guardrails.
4. A JoomPu
Preview of the first 4,000 characters. Read full instructions →
pulse-find-exact-same-product3.49 KB
View saved version →
---
name: pulse-find-exact-same-product
description: >
Finds product listings that appear to represent the same real-world product as a
reference item. Use this skill when a user wants to find duplicate listings,
match a product across listings, identify identical products by title or URL,
compare product photos against marketplace listings, or find the same product
on Mercado Livre.
---
# Find Exact Same Product
This skill helps find listings that appear to represent the same real-world
product as a reference product.
"The same product" means the candidate listing matches the reference item's
identity: brand, model, variant, color, size, capacity, pack count, bundle
contents, and other defining attributes visible from the provided product data.
Formatting, casing, punctuation, and translation differences are acceptable when
the underlying product is clearly the same.
## Prerequisites
- JoomPulse MCP access is configured for the current agent environment.
- The user provides a product title, product URL, product identifier, or product
image.
- The available JoomPulse tools can search marketplace listings and return
enough product data to compare candidates.
If JoomPulse MCP access is unavailable, stop and explain that the skill requires
JoomPulse MCP setup before it can search or compare products.
## Workflow
1. Resolve the reference product.
- If the user provides a title, use it directly as the reference.
- If the user provides a product URL or identifier, fetch the available
product details first.
- If the user provides an image, use the available image-based product search
workflow to generate candidate listings.
2. Search for candidate listings.
- Use JoomPulse product search tools to find plausible candidates.
- Treat search results as candidate generation, not final truth.
- Prefer a compact candidate set first, then broaden only when recall is
clearly too low.
3. Enrich candidates.
- Fetch product attributes, title, seller/listing metadata, images, and links
when available.
- Keep enough source data to explain why a candidate was accepted or rejected.
4. Decide exact matches.
- Accept a candidate only when the defining attributes match the reference.
- Reject candidates when brand, model, size, color, capacity, pack count,
bundle contents, or other defining attributes differ.
- If data is insufficient for a confident match, do not mark it as exact.
- Do not rely on title similarity alone when important attributes are missing
or ambiguous.
5. Return results.
- List confirmed matches with product links when available.
- Include a short rationale for each accepted match.
- If there are no confident matches, say so clearly and summarize what was
checked.
- When useful, include rejected near-matches separately with the key reason
they were rejected.
## Output Format
Use a concise table when there are multiple candidates:
| Result | Product | Link | Why it matches |
| --- | --- | --- | --- |
| Match | Product title | Product URL | Same brand, model, size, and variant |
For a single match, a short paragraph with the product link and rationale is
enough.
## Notes
- Prefer precision over recall. A smaller list of confident matches is better
than a broad list of uncertain candidates.
- Do not expose raw private data, internal identifiers, or implementation
details in the final answer.
- If the user asks for bulk matching, process items one by one and make
uncertainty explicit for each item.
seller-overview-tracker9.99 KB
View saved version →
---
name: seller-overview-tracker
description: >
Snapshot tracker for one Mercado Livre (Brasil) seller via JoomPulse — estimated monthly
revenue and sales, listing count, sales trend, reputation, seller medal, categories covered,
and cancellation rate. Each run builds today's snapshot table and offers it for download; to
see what changed, the user sends the seller's table from a previous period and the skill
shows the metric-by-metric difference (old → new). The baseline is whatever table the user
supplies — no hidden session memory. Use it to track one specific seller over time.
Triggers: "track this seller", "monitor this store", "what changed for this seller",
"compare this seller with last period", and the pt-BR "monitorar este vendedor", "acompanhar
esta loja", "o que mudou nesse vendedor". Sales and revenue are JoomPulse estimates, not
real transactions. To rank many sellers in a category and track how that ranking moves, use
the top-sellers-in-category skill. Mercado Livre (Brasil) only.
---
# Seller Overview Tracker
This skill tracks **one Mercado Livre (Brasil) seller over time** — its estimated
monthly revenue and sales, listing count, sales trend, reputation, seller medal,
the categories it covers, and its cancellation rate.
Each run builds **today's snapshot table** for the seller and offers it as a
**downloadable table**. To see what changed, the user **supplies the seller's table
from a previous period** (the one this skill produced before); the skill compares
the two and shows the difference per metric. **The baseline is whatever table the
user provides — there is no hidden session memory and nothing is stored
server-side.** The seller is identified by a store link or a seller identifier.
It is different from ranking work: to rank many sellers in a category and track how
that ranking moves, use the top-sellers-in-category skill; to analyze one product, use
the single-product analysis skill. This skill follows **one** seller.
## Prerequisites
- JoomPulse MCP access is configured for the current agent environment.
- The user provides one seller as a Mercado Livre store link or a seller identifier.
- For a period comparison, the user supplies a previous table that this skill
produced for the same seller (pasted or uploaded). Without it, the skill produces
a standalone snapshot.
- The available JoomPulse tools can look up that seller's current market snapshot.
If JoomPulse MCP access is unavailable, stop and explain that the skill requires
JoomPulse MCP setup before it can monitor a seller.
## Scope
- **Mercado Livre (Brasil) only.** Other marketplaces are out of scope.
- **Sales and revenue are JoomPulse estimates** — estimated monthly revenue,
estimated monthly sales, average ticket, and average price are not real
transactions. Disclose this in every output. By contrast, the rolling 60-day
and 365-day sales counts, the sales trend, and the cancellation rate are real
Mercado Livre data.
- **Read-only.** The skill never signs in as the seller or modifies a listing; it
does not store the snapshot — the user keeps the downloadable table and brings it
back next period.
- **Language:** respond in pt-BR by default; mirror another language only if the
user clearly uses it.
- **The baseline is user-supplied.** Never claim a change without a previous table
to compare against, and never infer or fabricate one from memory.
- **Keep the workflow invisible.** The user wants the answer, not a play-by-play.
If one approach does not return data, retry quietly; only if it still fails do
you say one short, friendly sentence.
## Workflow
### Step 1 — Resolve the seller and pull today's snapshot
1. Resolve the seller from the store link or seller identifier the user provided.
If given a store link, resolve it to the seller once.
2. Use JoomPulse to pull the current snapshot for that one seller: store name,
estimated monthly revenue, estimated monthly sales, sales trend,
Preview of the first 4,000 characters. Read full instructions →
top-brand-position-tracker13 KB
View saved version →
---
name: top-brand-position-tracker
description: >
Ranks the brands within one Mercado Livre (Brasil) category by estimated weekly revenue and
tracks how each brand's position changes between periods, using JoomPulse. Each run builds
today's brand-ranking table and offers it for download; to see how positions moved, the user
sends a brand table from a previous period and the skill shows each brand's movement (rose,
fell, new, or out). The baseline is whatever table the user supplies — no hidden session
memory. Use it to see the top brands in a category and which are rising or falling.
Triggers: "top brands in this category", "which brands are growing", "brand ranking", and
the pt-BR "principais marcas da categoria", "ranking de marcas", "quais marcas estão
crescendo". Mercado Livre (Brasil) only; sales and revenue are JoomPulse estimates, not real
transactions. To rank sellers (shops) rather than brands use the top-sellers-in-category
skill; for category market size use the category-opportunity-index skill.
---
# 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.** Other marketplaces are out of scope.
- **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 on
Preview of the first 4,000 characters. Read full instructions →
top-keywords-in-my-category4.94 KB
View saved version →
---
name: top-keywords-in-my-category
description: >
Lists the top trending search keywords for one Mercado Livre (Brasil) category
— the real Mercado Livre search-trends ranking of what shoppers look for — with
each keyword's rank and how many products compete for it. Use it when a seller
wants to know what people search in their niche, which terms to put in titles
and ads, or where demand is concentrated. Triggers include: "top keywords in my
category", "trending search terms", "what do people search for", "best keywords
for my listings", and the pt-BR equivalents "palavras-chave mais buscadas",
"termos em alta na categoria", "o que as pessoas pesquisam", "melhores
palavras-chave para meus anúncios". The keywords and ranks are real search-trend
data, not estimates. For category market size and opportunity, use the
category-opportunity-index skill; for ranking the sellers in a category, use the
top-sellers-in-category skill.
---
# Top Keywords In My Category
This skill returns the **top trending search keywords** for one Mercado Livre
(Brasil) category — the ranked list of terms shoppers are actually searching,
each with its position and how many products already compete for it. It tells a
seller what to put in titles and ads and where demand is concentrated.
Unlike most JoomPulse skills, the data here is **real search-trend data, not an
estimate**. For a category's market size and opportunity index, use the
category-opportunity-index skill. For the sellers ranked inside a category, use the
top-sellers-in-category skill.
## Prerequisites
- JoomPulse MCP access is configured for the current agent environment.
- The user names a category (free text is fine).
- The available JoomPulse tools can resolve a category and return its trending
search keywords with each keyword's rank and competing-product count.
If JoomPulse MCP access is unavailable, stop and explain that the skill requires
JoomPulse MCP setup before it can list a category's keywords.
## Scope
- **Mercado Livre (Brasil) only.** Other marketplaces are out of scope.
- **Real data, not an estimate.** The keywords, ranks, and competing-product
counts come from Mercado Livre search trends — say so; do not add the sales
estimate disclaimer that other skills use.
- **Read-only.** The skill never writes or modifies anything.
- **Language:** detect the seller's language and respond in it. Default to pt-BR.
- **Keep the workflow invisible.** Show `—` for any missing value; never fabricate.
## Workflow
### Step 1 — Resolve the category
Ask for a category if none was given, then use JoomPulse to match the free text to
a category, disambiguating with the seller when several plausible matches return.
### Step 2 — Get the trending keywords
Use JoomPulse to retrieve the category's trending search keywords, each with its
rank and its competing-product count. Sort by rank, best position first.
## Output
Respond in the seller's language (default pt-BR). The keywords always render as a
markdown table, sorted by position. The headers below are the pt-BR default and
may be rendered in the seller's language:
| Posição | Palavra-chave | Produtos (oferta) |
|--:|---|--:|
- **Posição** — the keyword's rank in the category's search trends.
- **Produtos (oferta)** — the number of active offers (listings) matching that
keyword, i.e. how many products currently compete for it. This is a real
search-trend count, not an estimate.
Close with a short, optional takeaway (use the top terms in titles and ads; a high
competing-product count means a crowded term, a low one a more open opportunity).
This is **real Mercado Livre search-trend data, not an estimate** — state that
once, in place of the estimate disclaimer.
## Visualization
When the client can render inline visuals, present metric cards and a chart;
otherwise fall back to the markdown table plus text cards. Never block on visuals.
The keywords table always renders as markdown, on every surfa
Preview of the first 4,000 characters. Read full instructions →
top-sellers-in-category8.26 KB
View saved version →
---
name: top-sellers-in-category
description: >
Ranks the top sellers in one Mercado Livre (Brasil) category by estimated average monthly
revenue via JoomPulse, and returns a downloadable leaderboard — per seller: estimated
monthly sales and revenue, 365-day completed sales, cancellation rate, sales trend, brands,
product counts, international shipping, and listing-type counts, with a JoomPulse link each.
It can also track how the ranking moved: supply a previous-period leaderboard for the same
category and it shows each seller's movement (rose / fell / new) plus the biggest movers.
Triggers: "top sellers in this category", "biggest stores in a category", "rank sellers by
revenue", and the pt-BR "principais vendedores da categoria", "maiores lojas da categoria",
"quem mais vende nessa categoria". Sales and revenue are JoomPulse estimates, not real
transactions. To monitor one seller over time use the seller-overview-tracker skill; to rank
brands use the top-brand-position-tracker skill.
---
# Top Sellers In Category
This skill returns the **top sellers in one Mercado Livre (Brasil) category**,
ranked by estimated average monthly revenue. For each seller it shows estimated
average monthly sales and revenue, completed sales over the last 365 days,
cancellation rate, sales trend, brands, how their products split between all
listings and listings with sales, international shipping, and classic versus
premium listing counts.
By default it produces **today's leaderboard** as a downloadable table. It can
also show **how the ranking moved over time**: if you supply a previous-period
leaderboard that this skill produced for the same category, it compares the two
and reports each seller's movement (rose / fell / new) plus the biggest movers.
**The baseline is the table you supply — there is no hidden session memory.**
To monitor a single named seller over time, use the seller-overview-tracker skill.
To rank brands rather than sellers, use the top-brand-position-tracker skill.
## Prerequisites
- JoomPulse MCP access is configured for the current agent environment.
- The user names a category (free text is fine).
- For a period comparison, the user supplies a previous leaderboard that this
skill produced for the same category (pasted or uploaded). Without it, the skill
produces a standalone leaderboard.
- The available JoomPulse tools can find the sellers active in a category and
return each seller's profile (estimated average monthly sales and revenue,
last-365-day completed sales, cancellation rate, sales trend, brands, listing
distribution, international shipping, classic and premium listing counts).
Seller medal — used to color the chart — and reputation are read when available.
If JoomPulse MCP access is unavailable, stop and explain that the skill requires
JoomPulse MCP setup before it can rank a category's sellers.
## Scope
- **Mercado Livre (Brasil) only.** Other marketplaces are out of scope.
- **Sales and revenue are JoomPulse estimates** derived from historical listing
data — not real transactions. Cancellation rate and last-365-day completed sales
are real history. Disclose the estimate caveat in every output.
- **Read-only.** The skill never writes or modifies anything; it does not store the
leaderboard — the user keeps the downloadable table and brings it back next period.
- **Language:** detect the seller's language and respond in it. Default to pt-BR.
- **The baseline is user-supplied.** Never claim a movement without a previous
leaderboard to compare against, and never infer or fabricate one from memory.
## Workflow
### Step 1 — Resolve the category and find its sellers
Ask for a category if none was given, then use JoomPulse to match the free text to
a category and find the sellers active in it.
### Step 2 — Rank by estimated average monthly revenue
Rank the sellers by **estimated average monthly revenue**, highest first. Keep a
sensible top (default about 50, up t
Preview of the first 4,000 characters. Read full instructions →
unbranded-products-in-category6.01 KB
View saved version →
---
name: unbranded-products-in-category
description: >
Finds products with no brand (unbranded / no-name / generic) in one Mercado Livre (Brasil)
category via JoomPulse — an opening to enter with your own brand / private label, since
buyers there aren't anchored to a brand name. Asks for a category, lists the active no-brand
listings ranked by estimated weekly demand, and returns a product table (price, estimated
weekly sales and revenue, rating, reviews, time on air, shipping, listing type, seller
medal) with a JoomPulse link per item. Triggers: "unbranded products", "products without a
brand", "private-label opportunities", and the pt-BR "produtos sem marca", "genéricos que
vendem", "oportunidade de marca própria". Sales and revenue are JoomPulse estimates, not
real transactions. NOT for ranking brands (use top-brand-position-tracker), brand-new
listings (use new-growing-products-in-category), high-demand low-rated products (use high-
demand-low-quality-finder), or niches without platinum sellers (use uncontested-niche-
finder).
---
# Unbranded Products In Category
This skill surfaces the **products that have no brand** (unbranded / no-name /
generic) in one Mercado Livre (Brasil) category — the listings where the brand is
empty. These are spots where a seller can enter with their **own brand / private
label**, because buyers there aren't anchored to a brand name. For each it shows
price, estimated weekly sales and revenue, rating, reviews, time on air, shipping,
listing type and seller medal, with a JoomPulse link per item.
It is the opposite of ranking a category's brands (for that, use the
top-brand-position-tracker skill). For fresh listings use the
new-growing-products-in-category skill; for low-rated, well-selling products use
the high-demand-low-quality-finder skill; for deep niches without platinum sellers
use the uncontested-niche-finder skill.
## Prerequisites
- JoomPulse MCP access is configured for the current agent environment.
- The user names a category (free text is fine).
- The available JoomPulse tools can return the active listings in a category, tell
which of them have no brand, and provide each listing's price, estimated weekly
sales and revenue, rating, reviews, time on air, logistics, listing type and
seller medal.
If JoomPulse MCP access is unavailable, stop and explain that the skill requires
JoomPulse MCP setup before it can find unbranded products.
## Scope
- **Mercado Livre (Brasil) only.** Other marketplaces are out of scope.
- **Sales and revenue are JoomPulse estimates** derived from historical listing
data — not real transactions. By contrast, price, rating, and review count are
real history. Disclose the estimate caveat in every output.
- **Read-only.** The skill never writes or modifies anything, and does not render
product images.
- **Language:** detect the seller's language and respond in it. Default to pt-BR.
- **Keep the workflow invisible.** Show `—` for any missing value; never fabricate.
## Workflow
### Step 1 — Resolve the category
Ask for a category if none was given, then use JoomPulse to match the free text to
a category. If several plausible matches come back, list the top candidates (name
and depth level) and let the user choose — do not guess between unrelated categories.
### Step 2 — Find the unbranded products
Use JoomPulse to get the category's **active** listings that have **no brand**
(brand empty / unbranded). Rank them by estimated weekly demand (estimated weekly
revenue, or weekly sales), highest first, and keep the strongest ~20–30.
## Output
Respond in the seller's language (default pt-BR). The product list always renders
as a markdown table:
| MLB | Nome | Vendedor | Preço | Vendas (semana) | Receita (semana) | Classificação | Avaliações | Tempo no ar | Frete grátis | Mercado Envios Full | Tipo de anúncio | Medalha do vendor |
|---|---|---|--:|--:|--:|--:|--:|--:|:--:|:--:|---|---|
- The **MLB** identifier links t
Preview of the first 4,000 characters. Read full instructions →
uncontested-niche-finder11.9 KB
View saved version →
---
name: uncontested-niche-finder
description: >
Finds low-competition niche products on Mercado Livre (Brasil) — active listings in deep
sub-categories (deeper than the third level) of a chosen category that have no platinum
seller at all, surfaced via JoomPulse. Use it when a seller wants uncontested niches, gaps
without strong incumbents, or where to enter without fighting a dominant platinum seller.
Triggers (EN): "uncontested niche", "low-competition products", "categories without platinum
sellers", "find a niche to enter"; (pt-BR): "nicho sem concorrência", "produtos sem vendedor
platinum", "nicho pouco disputado", "subcategorias sem platinum". It returns one table of
niche products, each with a competition signal (number of sellers) and a JoomPulse link.
Sales and revenue are JoomPulse estimates, not real transactions; price, rating, and reviews
are real history. For one product and its competitors use the ml-product-analysis skill; for
fast-growing deep categories rather than products use the growing-leaf-category-tracker
skill.
---
# Uncontested Niche Finder
This skill finds products in **deep sub-categories** of a chosen Mercado Livre
(Brasil) category — sub-categories deeper than the third level — that have **no
platinum seller at all** among their listings. These are genuinely
platinum-free niches a seller can enter without fighting a dominant incumbent.
Given a category by name or identifier, it surfaces the active listings in those
deep niches, and ranks them by estimated traction so the strongest uncontested
opportunities surface first.
A truly uncontested niche is a **whole deep sub-category with zero platinum
sellers** — not merely the non-platinum listings inside a sub-category that
still has platinum sellers elsewhere. Dropping individual platinum-held listings
is not enough: if any platinum seller is active in the sub-category, that niche
is contested, so the skill keeps only the deep sub-categories that have no
platinum seller present. If keeping only platinum-free sub-categories would leave
too few results, the skill may also show non-platinum listings from sub-
categories that still have platinum sellers — but it labels those plainly as
**non-platinum listings (platinum sellers still present in the category)** and
does not call them uncontested.
This is different from broad assortment work. To size up one product and the
products that compete with it, use the ml-product-analysis skill. To find the
fast-growing deep **categories** under a category (rather than the products inside
them), use the growing-leaf-category-tracker skill. This skill answers "where can
I enter without facing a platinum seller?" for a category the seller names.
## Prerequisites
- JoomPulse MCP access is configured for the current agent environment.
- The user provides one category, as a name or a category identifier.
- The available JoomPulse tools can resolve a category, walk its deep
sub-categories, and list the active product listings within them.
If JoomPulse MCP access is unavailable, stop and explain that the skill requires
JoomPulse MCP setup before it can find uncontested niches.
## Scope
- **Mercado Livre (Brasil) only.** Other marketplaces are out of scope.
- **Sales and revenue are JoomPulse estimates** derived from historical listing
data — not real transactions. Disclose this in every output. By contrast,
**price, rating, and review count are real Mercado Livre history** — 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 niches, 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. Never fill gaps
from general knowledge.
## Workflow
### Step 1 — Resolve the catego
Preview of the first 4,000 characters. Read full instructions →