Ferramentas Disponíveis
Tudo o que o assistente consegue consultar e fazer depois que você conecta o Radar Scout, agrupado por assunto.
Você não precisa decorar nada disto: pergunte em português e o assistente escolhe a ferramenta certa. Esta página serve para saber o que dá para pedir e, se você usa os nomes técnicos, qual ferramenta faz o quê. Para conectar, veja Assistente IA.
As ferramentas que leem dados de uma conta pedem o identificador dela (seller_account_id), que o assistente descobre sozinho com radarscout_whoami.
Identidade & conexão
| Ferramenta | O que você pode pedir |
|---|---|
radarscout_whoami | "Quais são as minhas contas de seller?" — mostra quem você é, as contas conectadas (Amazon e Mercado Livre) e os apps ativos. É o ponto de partida das outras. |
radarscout_connect_amazon_sp_api | "Quero conectar uma nova conta da Amazon" — gera o link para você autorizar a conta na própria Amazon. |
Produtos & descoberta
| Ferramenta | O que você pode pedir |
|---|---|
radarscout_search_products | "Ache produtos de Casa com BSR abaixo de 10 mil" — busca oportunidades no catálogo da Amazon por palavra, ASIN ou filtros, como no Scout. Não é a lista das suas ofertas. |
radarscout_get_product_details | "Me dê os detalhes deste produto" — a ficha de um produto do catálogo, mesmo sem oferta sua: na Amazon (por ASIN), preço, estimativas e tarifas FBA; no Mercado Livre (pelo link do produto de catálogo), fotos, ficha técnica e variações, para usar como modelo de cadastro na Amazon. |
radarscout_list_top_products | "Quais são meus produtos mais vendidos?" — ranking dos campeões de venda no período. |
radarscout_list_tracked_products | "Liste os produtos que estou monitorando" — todos os produtos rastreados da conta. |
radarscout_estimate_sales_from_bsr | "Quantas vendas por mês esse BSR representa?" — converte a posição no ranking de vendas em estimativa, dentro de uma categoria. |
Suas ofertas
| Ferramenta | O que você pode pedir |
|---|---|
radarscout_list_seller_offers | "Quais são as minhas ofertas?" / "O que preciso repor?" — as ofertas da conta com estoque, modo de entrega, Buy Box e a inteligência de reposição (dias de cobertura, sugestão de compra). Filtra por ativas, ganhando ou perdendo a Buy Box, modo de entrega e busca. |
radarscout_get_seller_offer | "Abra os detalhes desta oferta" — a ficha de uma oferta: estoque (incluindo unidades já a caminho do centro de distribuição FBA), Buy Box, limites de preço e PMI, custo e reposição. |
radarscout_get_account_health | "Como está a saúde da minha conta?" — índice de saúde do vendedor (taxa de defeitos de pedido, cancelamentos pelo vendedor, envios atrasados), status da conta e alertas da Amazon. |
radarscout_get_inventory_health | "Qual é a saúde do meu estoque?" — resumo da situação: produtos zerados, críticos, em atenção e parados, com totais de unidades e SKUs. |
radarscout_build_replenishment_plan | "O que preciso comprar agora?" — lista de compra por urgência, com unidades sugeridas descontando o estoque já a caminho do centro de distribuição FBA. |
Financeiro
| Ferramenta | O que você pode pedir |
|---|---|
radarscout_get_sales_overview | "Como foram minhas vendas neste período?" — visão geral de GMV e vendas. |
radarscout_get_profit_waterfall | "Mostre minha Cascata de Lucro" — camada por camada do GMV ao lucro (MC1, MC2, MC3), com tarifas detalhadas por tipo (comissão, logística FBA, armazenagem, mensalidade, reembolsos e outras). Indica quando parte das tarifas ainda é estimada, quantos pedidos aguardam tarifa real e o percentual coberto — o mesmo comportamento da tela de DRE. |
radarscout_get_settlement_summary | "Qual foi meu repasse no último ciclo?" / "Quanto vou receber no próximo?" — o próximo repasse projetado (data e valor estimado pela média dos anteriores), o último repasse concluído e as deduções do ciclo. |
radarscout_list_orders | "Liste meus pedidos neste período" — pedidos Amazon do mais recente ao mais antigo, um registro por pedido (com os produtos em items[]). Use granularity: "item" para uma linha por produto, como na tela de Pedidos do Analytics. Serve para conferir pedido a pedido contra um ERP: traz número do pedido Amazon e do lojista, data, status (Pendente / Embarcado / Entregue / Cancelado), FBA ou FBM e o valor decomposto — total de itens, frete, desconto promocional e imposto separados. Atenção: o total de itens é a soma dos preços unitários da Amazon e não inclui frete. Não devolve dados pessoais do comprador. |
radarscout_get_sales_traffic_by_item | "Mostre sessões, conversão e Buy Box por produto" — sessões, visualizações de página, unidades vendidas, faturamento, taxa de conversão e porcentagem de Buy Box por ASIN, dentro do período. |
radarscout_calculate_fees | "Quanto fica de tarifa e lucro se eu vender a este preço?" — simulador da Calculadora (FBA/FBM/DBA): tarifas, lucro líquido, margem e ROI. Não lê dados do vendedor. |
Anúncios no catálogo
Essas ferramentas consultam e gerenciam os seus anúncios de produto na Amazon (cadastro, fotos, variações, oferta). São diferentes das ferramentas de Anúncios (Ads), que tratam de campanhas e lances.
Leitura
| Ferramenta | O que você pode pedir |
|---|---|
radarscout_check_listing | "Mostre como está esse anúncio" — lê o seu próprio anúncio na Amazon (por ASIN ou SKU) ou no Mercado Livre (pelo código MLB, SKU ou código da oferta no Radar Scout), com título, fotos, ficha técnica, GTIN e variações. Outro vendedor é recusado. |
radarscout_list_listing_problems | "Quais anúncios estão com problema?" — lista as suas ofertas Amazon com supressão ou erros de qualidade, com o motivo de cada um. Amazon apenas. |
radarscout_get_listing_requirements | "O que a Amazon precisa para eu cadastrar este produto?" — atributos obrigatórios e opcionais do tipo de produto, exemplos de valores aceitos, temas de variação disponíveis e o que cada variação deve informar. |
Ações
O assistente mostra a prévia da Amazon; a criação ou edição só acontece quando você confirma.
| Ferramenta | O que você pode pedir |
|---|---|
radarscout_create_offer | "Quero vender este ASIN que já existe na Amazon" — cria uma oferta para o seu SKU em um produto já cadastrado, com prévia de tarifas e validação antes de enviar. Oferta FBM nasce com estoque 0. |
radarscout_create_listing | "Quero criar um anúncio novo" — cadastra um produto novo na Amazon com todos os atributos obrigatórios; aceita famílias de variação (um produto pai e um filho por cor ou tamanho, com validação individual). |
radarscout_update_listing | "Quero mudar o título, as fotos ou os atributos deste anúncio" — edita um anúncio existente na Amazon, com prévia dos campos a alterar antes de enviar. |
Anúncios (Ads) — Leitura
| Ferramenta | O que você pode pedir |
|---|---|
radarscout_get_ads_overview | "Como foram meus anúncios neste período?" — indicadores consolidados da conta: investimento, vendas por anúncios, impressões, cliques, pedidos e as métricas derivadas (ACoS, ROAS, CTR, CVR, CPC). Inclui todas as campanhas, mesmo pausadas ou arquivadas. Traz também o frescor do dado: quando foi a última importação e quantas linhas vieram — inclusive o caso em que a importação está saudável e a conta simplesmente não veiculou. Pode somar só as campanhas de um portfólio ("como foi o portfólio Linha Casa?"). |
radarscout_list_ads_daily_performance | "Como evoluiu o investimento neste mês?" — desempenho dia a dia (investimento, vendas, ACoS e demais métricas), da conta ou de uma campanha. É o que mostra movimento: em que dia o gasto disparou, se piorou depois de uma mudança, quando a veiculação parou. Até 400 dias por consulta. |
radarscout_list_ad_campaigns | "Liste minhas campanhas com desempenho" — desempenho por campanha: investimento, vendas, ACoS, ROAS e demais métricas, com o status atual de cada campanha. Por padrão exibe campanhas habilitadas e pausadas; arquivadas somente se solicitadas. Uma campanha sem investimento no período aparece com métricas zeradas, nunca é omitida. Cada linha traz também o orçamento diário e o status de veiculação da Amazon; quando uma campanha habilitada não teve nenhuma impressão no período, vem junto a contagem de status dos anúncios dela — evidência, não diagnóstico. Cada campanha mostra o portfólio a que pertence, a resposta traz o total por portfólio, e dá para listar só as campanhas de um portfólio. |
radarscout_list_ad_bids | "Qual é o lance atual desta palavra-chave?" — lista keywords e targets com o lance efetivo, indicando quando ele é próprio ou herdado do padrão do grupo de anúncios. Dispensa o velho truque de simular uma ação para descobrir o valor vigente. Informando um período, cada palavra-chave e alvo vem também com o desempenho dele (investimento, vendas, ACoS, ROAS, cliques e conversão), ordenado por investimento — é o que mostra se o lance está valendo a pena. |
radarscout_list_search_terms | "Quais termos de busca acionaram meus anúncios?" — lista os termos que geraram impressões ou cliques, com investimento, vendas, pedidos, unidades e métricas derivadas. Permite filtrar por campanha, tipo de alvo (keyword BROAD/PHRASE/EXACT ou segmentação automática/por produto), cliques mínimos, investimento mínimo e se houve venda. |
Anúncios (Ads) — Ações
As ferramentas abaixo mudam seus anúncios na Amazon. Primeiro o assistente simula e mostra o que seria enviado, sem mudar nada; a mudança só vai para a Amazon quando você confirma (tecnicamente, com execute:true). Precisam do Performance ativo, da conta de anúncios conectada e das mudanças liberadas na sua conta; se não estiverem, o assistente avisa.
Todas respeitam os mesmos limites de proteção do app. Quando um pedido esbarra num limite, a resposta diz qual foi; você pode pedir explicitamente para ignorar o intervalo de espera ou o limite diário num caso específico, e a mudança fica registrada em Atividades como feita a pedido seu.
| Ferramenta | O que você pode pedir |
|---|---|
radarscout_pause_campaign | "Pause esta campanha" — muda o status da campanha para PAUSADA. Reversível via radarscout_resume_campaign. |
radarscout_resume_campaign | "Reative esta campanha" — muda o status da campanha de PAUSADA para HABILITADA. Reversível via radarscout_pause_campaign. |
radarscout_create_campaign_structure | "Crie uma campanha para este SKU com estas palavras-chave" — monta a campanha inteira de uma vez: campanha, grupos, produtos e palavras-chave, podendo já nascer dentro de um portfólio. Se algo falhar no meio, o que foi criado fica pausado, para nada gastar pela metade. Até 10 campanhas novas por dia. |
radarscout_update_campaign_budget | "Ajuste o orçamento diário desta campanha para R$ X" — atualiza o orçamento diário da campanha na Amazon. |
radarscout_update_keyword_bid | "Ajuste o lance desta keyword para R$ X" — atualiza o lance de uma keyword Sponsored Products. |
radarscout_update_target_bid | "Ajuste o lance deste target para R$ X" — atualiza o lance de um target Sponsored Products. |
radarscout_create_portfolio | "Crie um portfólio Linha Casa" — cria o agrupador de campanhas, sem teto de gasto. Depois dá para criar campanhas já dentro dele e ver os números por portfólio. |
radarscout_archive_campaign | "Arquive esta campanha" — tira a campanha da operação para sempre: arquivar não tem volta na Amazon. Exige confirmação explícita; para tirar do ar de forma reversível, use pausar. |
radarscout_add_targets | "Passe a anunciar nestes ASINs" — adiciona alvos de produto ou categoria a um grupo existente, com lance opcional. Alvos que já estão no grupo são apontados antes de qualquer envio. |
radarscout_add_product_ads | "Inclua este produto neste grupo" — passa a anunciar um ASIN ou SKU dentro de um grupo existente, sob as palavras e alvos que o grupo já tem. Não mexe em lance. |
radarscout_create_ad_group | "Crie um grupo nesta campanha" — grupo novo numa campanha existente, com lance padrão e podendo nascer pausado. Nasce vazio: os produtos e as palavras entram depois. |
radarscout_update_ad_group_default_bid | "Mude o lance padrão deste grupo" — ajusta o lance que vale para toda palavra e todo alvo sem lance próprio, então move vários de uma vez. |
radarscout_add_keywords | "Inclua estas palavras-chave neste grupo de anúncios" — adiciona até 100 keywords (EXACT, PHRASE ou BROAD, com lance opcional) a um grupo que já existe. Palavras que já estão no grupo são apontadas antes de qualquer envio. |
radarscout_update_keyword_state | "Pause esta palavra-chave" — desliga (ou religa) uma keyword: pausada, ela para de gastar e de aparecer, e o histórico fica. Diferente de negativar, que bloqueia a busca no grupo ou na campanha inteira. Não arquiva. |
radarscout_update_target_state | "Pause este alvo" — o mesmo para um alvo de produto ou categoria. |
radarscout_create_negative_keyword | "Adicione esta palavra como negativa nesta campanha/grupo de anúncios" — cria uma negative keyword (NEGATIVE_EXACT ou NEGATIVE_PHRASE) em um ad group ou campanha. |
radarscout_create_negative_target | "Adicione este ASIN/termo como negative target" — cria um negative target em um ad group ou campanha. |
Anúncios (Ads) — Propostas do Scout AI
O motor de automação analisa a conta na cadência configurada e cria propostas — nada é enviado à Amazon antes de aprovação. A revisão pode ser feita pelo chat ou pela tela de Recomendações.
| Ferramenta | O que você pode pedir |
|---|---|
radarscout_list_ads_proposals | "O que o Scout AI sugeriu para meus anúncios?" — lista as propostas pendentes e resolvidas, com o motivo escrito pela IA e a evidência que sustenta cada uma. |
radarscout_approve_ads_proposal | "Aprove essa sugestão" — aprova uma proposta; a mudança passa pelos mesmos limites das ações manuais. |
radarscout_reject_ads_proposal | "Rejeite essa sugestão" — descarta a proposta, que fica registrada como recusada. |
Repricer
Leitura
| Ferramenta | O que você pode pedir |
|---|---|
radarscout_get_repricer_summary | "Como está meu Repricer?" — resumo do estado de reprecificação da conta. |
radarscout_list_repricer_activity | "Mostre o histórico de mudanças de preço" — atividade recente do Repricer. |
radarscout_explain_price_change | "Por que este preço mudou?" — explica a decisão por trás de uma reprecificação específica. |
Ações
O assistente mostra o antes e o depois e só aplica quando você confirma. As alterações ficam registradas em Atividades.
| Ferramenta | O que você pode pedir |
|---|---|
radarscout_update_product_cost_and_margin | "Atualize o custo deste SKU para R$ X" / "Mude a margem mínima para Y%" — ajusta o custo do produto e a margem mínima de um anúncio Amazon; recalcula o piso de preço e envia o novo mínimo e máximo à Amazon. Exige Repricer ativo. Não disponível para custo vindo de ERP. |
radarscout_set_repricer_rule | "Ligue o Repricer para este SKU" / "Troque a automação de precificação" — ativa, desativa ou reconfigura a automação de um anúncio Amazon. Mostra se o Repricer ficará armado ou inativo após a mudança. |
radarscout_update_price | "Mude o preço deste SKU para R$ X" — altera o preço de um anúncio Amazon pelo mesmo caminho do painel, sempre respeitando o piso de margem. Requer Repricer ativo com mínimo e máximo definidos; sem esses valores, recusa. Antes de aplicar, mostra preço atual, novo, faixa permitida e como desfazer. |
Conceitos
| Ferramenta | O que você pode pedir |
|---|---|
radarscout_explain_concept | "O que é PMI / Modo Seguro / Buy Box % / repasse / floor price?" — definições dos termos do Radar Scout a partir de um glossário curado. Não precisa de seller_account_id. |
Amazon
Contas do Mercado Livre aparecem na lista de contas, podem ser consultadas no Repricer e têm o anúncio lido via radarscout_check_listing. Vendas, lucro, repasses, ofertas, busca de produtos e anúncios (Ads) são, por enquanto, só da Amazon.
Lembretes de uso
- Período em datas ISO — Ferramentas com janela de tempo usam
period_start/period_end(YYYY-MM-DD), início inclusivo e fim exclusivo, no fusoAmerica/Sao_Paulo. - Paginação por cursor — As ferramentas de listagem retornam um
next_cursorquando há mais linhas; peça ao assistente para "continuar" e ele busca a próxima página. - Uma conta por consulta — Se você tem mais de uma conta conectada, diga qual quer consultar.
- App ativo — Cada ferramenta usa o app do assunto. Veja a tabela em Assistente IA e as regras de prévia em Limites por Plano.
- Anúncios: confirme antes de aplicar — O assistente sempre mostra o que vai mudar. Diga "pode aplicar" só depois de conferir.
Para conectar o assistente, veja Assistente IA.