Hunter Hub

Curva ABC dos produtos: classifica em A/B/C por receita, lucro ou quantidade (regra de Pareto). Responde "quais produtos concentram meu faturamento" e destaca itens com alta receita mas baixo lucro (isFalseA).

get_abc_analysis

Custos de Fulfillment (Full) por anúncio no período: armazenagem, coleta, retirada e estoque antigo. Lastro no DRE (ARM-791).

get_fulfillment_costs

DRE (Demonstrativo de Resultados) completo do período: receita bruta, taxas, custos, despesas, ads e lucro líquido. O gasto de Ads dos canais listados em excludedAdsChannels não entra nos números: não diga que ele é zero, diga que não está disponível aqui.

get_dre

Dados de mercado de QUALQUER anúncio do Mercado Livre pelo ID (preço, vendedor, atributos, reputação, frete), inclusive de concorrentes. Bate na API do ML; tem cota diária por token. `estimate` é faixa estimada a partir do total vendido e da idade; visitas têm baixa confiança e nunca são número exato.

get_market_item

Detalhe completo de 1 anúncio do vendedor, incluindo a descrição do anúncio (ML). Use o id interno retornado por search_listings. Primeira chamada de um anúncio ML sem descrição em cache pode levar mais tempo (busca ao vivo no ML).

get_listing_detail

Detalhe completo de 1 pedido (itens, frete, taxas, financeiro). Use o id interno retornado por search_orders.

get_order_detail

Dossiê completo de um caso da Central de Recuperação: canal, evidência, valores, status e contestationScript, o texto pronto para colar no atendimento do marketplace do caso (null quando o caso já foi encerrado).

get_recovery_case

Série temporal de vendas (receita, lucro, pedidos) agrupada por dia, semana ou mês. Use para identificar tendência e sazonalidade.

get_sales_evolution

Histórico de concorrência de um produto de catálogo do Mercado Livre: contagem de vendedores, preço mínimo/médio e mudanças de vencedor da buy box ao longo dos últimos meses.

get_catalog_history

Histórico de preço e avaliação de um anúncio do Mercado Livre ao longo dos últimos meses, com resumo de variação (7d/30d, mín/máx). Não é escopado ao vendedor: funciona para QUALQUER anúncio, inclusive de concorrentes.

get_item_history

Histórico de vendas de um anúncio próprio (variationId) ou catálogo (buyBoxId) ao longo do tempo. Cruzado com get_listing_activity, responde "qual preço vendeu mais". historyWindow indica até onde o histórico existe.

get_listing_sales_history

Lista as contas de marketplace (Mercado Livre, etc.) conectadas pelo vendedor. Use os accountId retornados para filtrar as outras ferramentas.

list_accounts

Lista os produtos e/ou concorrentes que o usuário monitora (Monitoramento de Mercado), com preço/vendas atuais e variação recente. Use type para filtrar só produtos ou só vendedores.

get_watchlist

Só o que MUDOU no monitoramento de mercado desde a última observação: produtos com variação de preço/avaliação e vendedores com variação de vendas ou anúncios novos. Diferente de get_watchlist (que lista tudo), aqui só aparece quem teve alguma mudança real. Bom para um resumo periódico ("o que mudou essa semana").

get_watch_deltas

Performance de Mercado Ads no período: ACOS, TACOS, ROAS, investimento, receita de Ads e lucro após Ads. O gasto de Ads dos canais listados em excludedAdsChannels não entra nos números: não diga que ele é zero, diga que não está disponível aqui.

get_ads_performance

Posição dos anúncios do usuário numa busca por palavra-chave no Mercado Livre (mesma medição da tela /anuncios/ranqueamento). Mede o top 192 resultados (coverageLimit); anúncio fora disso volta com lista vazia, não "não encontrado". O zipCode devolvido é o EFETIVAMENTE medido: em modo de busca sem suporte a localização, degrada para nacional e ecoa null. Com includeCompetitors:true, também devolve quem está ranqueado acima da melhor posição do usuário. Bate na API do ML (4 requisições de scraper por chamada); tem cota diária/por minuto baixa por token.

get_keyword_ranking

Lista os produtos sem custo cadastrado: SKUs do Hunter com custo zero e anúncios ativos sem SKU vinculado, dos que mais faturaram nos últimos 90 dias para os que menos faturaram. Sem custo, o lucro e a margem desses produtos ficam errados. Paginado.

list_skus_without_cost

Ranking de produtos do vendedor por receita, lucro, quantidade ou margem. Responde "qual produto mais deu lucro" e "quais têm pior margem".

get_product_ranking

Resumo da Central de Recuperação (cobranças indevidas dos marketplaces auditados): valor identificado e quantidade de casos abertos (e quanto do valor identificado são suspeitas, casos de confiança média que pedem revisão antes de contestar), valor recuperado, pedidos auditados, canais auditados e data da última varredura. startDate/endDate filtram só o valor recuperado (data da recuperação).

get_recovery_summary

Resumo financeiro do período: receita, custos, lucro líquido real, margem de contribuição, número de vendas e ticket médio. O gasto de Ads dos canais listados em excludedAdsChannels não entra nos números: não diga que ele é zero, diga que não está disponível aqui.

get_financial_summary

Simula o recebido líquido (payout) e, com costBreakdown, o lucro/margem/ROI de um anúncio do Mercado Livre para um dado preço: taxa de venda + frete conforme a logística. Bate na API do ML; tem cota diária por token.

simulate_payout

Situação dos catálogos do vendedor: onde está ganhando ou perdendo a buy box, preço do vencedor e diferença de preço.

get_catalogs_status