Nubimetrics

Meli Category Detail

Returns performance metrics (GMV, units sold, avg price, top sellers) for a MercadoLibre category node. Use when: the user asks how a category is performing, wants revenue or volume data for a specific category, or needs to know the top sellers in a category. Requires: a valid category_path — call meli_category_explorer first if unknown. Limitation: data is available for closed months only; falls back to previous month automatically when current month has no data yet. Note: data_available=false

Meli Category Explorer

Browses and searches MercadoLibre categories, returning scoring metrics: GMV, visits, and competition level. Use when: you need to find a valid category_path before calling meli_market_rankings or meli_category_detail, or when the user wants to explore which categories exist and how competitive they are. Tip: pass a search_term to filter by keyword; omit it to browse the full tree. Not for own-performance review: only_my_categories narrows results to categories the seller sells in, but this too

Nubi Category Forecast

Returns demand forecasting for a MercadoLibre category: monthly GMV and units projections for the next 12 months, plus an accumulated annual (YTD) summary. Use when: the user asks about future market size, demand trends, or growth projections for a category. Requires: a valid category_path — call meli_category_explorer first if unknown. Note: is_generated=false means there is no forecast model for that category.

Nubi Category Market Size

Returns historical monthly GMV, successful items (units sold), and average ticket for a MercadoLibre category over a date range. Each data point includes the prior-year value for direct YoY comparison. Use when: the user asks how big a category is, how GMV or units evolved over time, or wants to compare growth year-over-year. Requires: a valid category_path — call meli_category_explorer first if unknown. Complement with nubi_category_market_structure for competitive context. Note: data_availabl

Nubi Category Market Structure

Returns historical monthly visits, active sellers, professional sellers, and listings for a MercadoLibre category over a date range. Each data point includes the prior-year value for direct YoY comparison. Use when: the user asks how competitive a category is, how many sellers or listings it has, or how visit volume has evolved over time. Requires: a valid category_path — call meli_category_explorer first if unknown. Complement with nubi_category_market_size for GMV and revenue context. Note: d

Nubi Competition Publication Detail

Returns detail and metrics for one followed publication — title, price, stock, condition, shipping, catalog membership, plus GMV/units/sales/visits/conversion in the requested date range. Use when: the user wants the full snapshot for a specific followed publication, not a time series. Requires: member_code and member_owner from nubi_competition_publication_group_members. Note: days sets the KPI window as an exact day count ending today — no fixed buckets. For a time series over this same publi

Nubi Competition Publication Evolution

Returns a historical time series for one followed publication — visits, GMV, units, price, and conversion. Use when: the user wants to chart how a specific followed publication evolved over a date range. Requires: member_code and member_owner from nubi_competition_publication_group_members. Note: the metric set differs from nubi_competition_seller_evolution — this tool returns 'price' instead of 'items'. Do not assume the same 5 metrics between the two evolution tools. All 5 metrics return one

Nubi Competition Publication Group Members

Lists the publications tracked inside one followed-publication group — the hashes needed to request evolution or detail for a specific publication. Use when: the user wants to see which publications are being followed in a group or needs member_code/member_owner to drill into a specific publication. Prerequisite: call nubi_competition_publication_groups first to find the group_id. Note: unlike sellers, publications need both member_code (the item) and member_owner (the seller who owns it) — dif

Nubi Competition Publication Group Metrics

Returns aggregated totals — total GMV, total units, total visits, average price — for every publication followed in a group over a date range. A single summary, not a per-publication breakdown. Use when: the user wants the overall size of a followed-publication group's activity, not individual publication performance. Prerequisite: call nubi_competition_publication_groups first to find the group_id. Note: days sets the window as an exact day count ending today — no fixed buckets.

Nubi Competition Publication Groups

Lists the authenticated seller's followed-publication groups — name, description, favorite flag, and member count for each. Always includes the default 'Publicaciones Favoritas' group. Use when: the user wants to see which followed-publication groups exist or needs a group_id before calling nubi_competition_publication_group_members. Next step: pass any group_id to nubi_competition_publication_group_members to list that group's publications.

Nubi Competition Publication Log

Returns the change history for one followed publication — price, title, category, listing type, shipping, and status changes over time. Use when: the user wants to see what changed on a specific followed publication and when. Requires: member_code and member_owner from nubi_competition_publication_group_members. No date range filter — always returns the full change history.

Nubi Competition Seller Evolution

Returns a historical time series for one followed competitor, covering visits, GMV, units sold, active items, and conversion. Use when: the user wants to chart how a specific competitor evolved over a date range. Requires: seller_id_competitor — a competitor hash from nubi_competition_seller_group_members. Call once per seller to chart — to compare several competitors, call this tool once per seller_id_competitor and combine the series client-side. Note: every metric comes as one point per day

Nubi Competition Seller Group Members

Lists the competitors tracked inside one seller-competitor group — the hashes needed to request metrics or analysis for a specific competitor. Use when: the user wants to see who is in a competitor group or needs a seller_id_competitor to drill into a specific competitor. Prerequisite: call nubi_competition_seller_groups first to find the group_id. Note: is_self=true means that entry is the seller's own account added to the group — its member_code cannot be used as seller_id_competitor elsewher

Nubi Competition Seller Group Metrics

Returns aggregated totals — total GMV, total units, average ticket — for every seller in a competitor group over a date range. A single summary, not a per-seller breakdown. Use when: the user wants the overall size of a competitor group's market activity, not individual competitor performance. Prerequisite: call nubi_competition_seller_groups first to find the group_id. Note: days sets the window as an exact day count ending today — no fixed buckets.

Nubi Competition Seller Groups

Lists the authenticated seller's competitor-tracking groups — name, description, favorite flag, and member count for each. Use when: the user wants to see which seller-competitor groups exist or needs a group_id before calling nubi_competition_seller_group_members. Next step: pass any group_id to nubi_competition_seller_group_members to list that group's competitors.

Nubi Competition Seller Items

Returns a competitor's full publication catalog with GMV, units sold, price, and catalog membership status per item. Use when: the user wants to dig into what a specific competitor is selling, how their publications perform, or compare a competitor's catalog against the market. Requires: a seller_id_competitor obtained from nubi_competition_seller_group_members — call that tool first to list competitors. This ID is an obfuscated hash, not a MercadoLibre seller ID. Note: days sets the window as

Nubi Competition Seller Metrics

Returns snapshot totals — GMV, visits, units, active items, conversion — plus a GMV-by-category breakdown and an 80/20 (Pareto) item split, for one competitor over a date range. A single point-in-time summary, not a time series. Use when: the user wants a quick performance snapshot for a specific competitor. Requires: a seller_id_competitor obtained from nubi_competition_seller_group_members. Next step: call nubi_competition_seller_evolution for the same competitor's historical trend, or nubi_c

Nubi Evaluate Categories

Returns the authenticated seller's MercadoLibre categories with revenue, ranking position, and a Pareto-80 flag indicating which categories drive 80% of revenue. Use when: the user wants to understand their own category performance, identify their top-earning categories, or evaluate where they rank within each category. Limitation: data is available for closed months only; falls back to previous month automatically. Not for market-wide browsing: this tool only returns the authenticated seller's

Meli Market Rankings

Returns the top-100 MercadoLibre ranking for items, brands, catalog entries, sellers, or official stores within a category. Use when: the user wants to know who the top sellers are, which brands lead a category, which products rank highest by revenue or units, how the market is structured, or which official stores lead a category. Requires: a valid category_id — call meli_category_explorer first if unknown. Limitation: data is available for closed months only; falls back to previous month autom

Meli Publication Explorer

Searches MercadoLibre publications by keyword, returning GMV, units sold, price, catalog membership, seller alias, listing age, exposure tier, installments code, shipping method (full/flex/free), brand, model, official store, sku/gtin/part number/OEM, and category path/name data. Use when: the user wants to research specific products, analyze how a product type performs on the marketplace, or find publications to compare pricing and volume. Requires: a search keyword (title) of at least 2 chara

Meli Search Trends Rankings

Returns the top-100 trending MercadoLibre search terms within a category. Use when: the user wants to know what buyers are searching for in a category — search demand, not sales performance. Not for ranking products/sellers/brands by revenue or units — use meli_market_rankings for that. Requires: a valid category_id — call meli_category_explorer first if unknown. Limitation: data is available for closed months only; falls back to previous month automatically. Returns a guidance string (not an e

Nubi Seller Info

Returns full account and category-access details for one specific MercadoLibre seller: plan, site, currency, publications, competition slots, and which categories it's entitled to query. Use when: you already know or want a specific seller_id (see nubi_user_info's linked_sellers for the list) and need its plan/currency/category access before calling category-scoped tools. Note: fetches account details for the requested seller_id fresh — an extra request beyond nubi_user_info, not just a slice o

Nubi User Feedback

Records feedback about the product, a tool, or the data it returned, for the Nubimetrics team to review. Does not change or fix anything in this conversation. Use when: the user explicitly complains, praises, reports a bug, or suggests something; OR you notice a problem yourself while using another tool (e.g. implausible, inconsistent, or contradictory data) — you do not need the user to say something first. Proactively suggest this tool when the user describes a problem that looks like a prod

Nubi User Info

Returns identity for the authenticated user: email, name, and every MercadoLibre seller account linked to it (seller_id, nickname, site, which one is main). Use when: you need to know who the current user is, or which seller_id/site_id values are available before calling nubi_seller_info or any tool that accepts a seller_id override. Note: does not include plan, currency, or category access — call nubi_seller_info with the seller_id you care about for that.