docs

Ferramentas Disponíveis

Disponível emAmazon

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

FerramentaO 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

FerramentaO 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

FerramentaO 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

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

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

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

FerramentaO 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

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

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

FerramentaO 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

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

FerramentaO 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

FerramentaO 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 fuso America/Sao_Paulo.
  • Paginação por cursor — As ferramentas de listagem retornam um next_cursor quando 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.