Radar Scout

Arquiva uma campanha Sponsored Products. ATENÇÃO: arquivar NÃO TEM VOLTA na Amazon — a campanha sai da operação para sempre e não pode ser reativada; o histórico dela continua nos relatórios. Para tirar do ar de forma reversível, use radarscout_pause_campaign. Só arquiva com confirm_archive:true junto de execute:true, depois de o vendedor dizer explicitamente que entende que não dá para desfazer. Use quando o usuário quiser encerrar de vez uma campanha que não vai mais usar.

radarscout_archive_campaign

Lista as campanhas de anúncios (Ads) de uma conta de seller em um período, com investimento, vendas por anúncios, impressões, cliques, pedidos, as razões derivadas (ACoS, ROAS, CTR, CVR, CPC) e o status atual de cada campanha. Por padrão inclui campanhas habilitadas e pausadas; arquivadas somente se solicitado. Uma campanha sem investimento no período aparece com métricas zeradas, nunca é omitida. Campanhas ativas que não exibiram anúncios no período trazem ad_serving_summary com a contagem de anúncios por status de veiculação — evidência para distinguir 'anúncio não está sendo exibido' de 'dados não foram importados'. Não exibir anúncios tem múltiplas causas possíveis (sem estoque, orçamento esgotado, lances baixos, suspensão); se todos os status estiverem saudáveis mesmo sem exibições, a causa provável está no lance ou na segmentação, não na importação de dados. Cada campanha traz o portfólio a que pertence hoje (também para períodos passados), e o resumo portfolios soma só as campanhas listadas por portfólio — sem as arquivadas, salvo se states pedir; portfolio_id filtra um portfólio. Use quando o usuário quiser comparar campanhas ou portfólios, achar as que gastam sem vender ou entender por que uma campanha não está exibindo anúncios.

radarscout_list_ad_campaigns

Cria uma campanha Sponsored Products inteira de uma vez: a campanha, os grupos de anúncios, os produtos anunciados (por SKU, que vem de radarscout_list_seller_offers) e as palavras-chave que você indicar. Sem `execute:true`, apenas mostra o que seria criado, sem mexer na Amazon. Se algum passo falhar no meio, o que já tinha sido criado é pausado — nada fica gastando pela metade — e a resposta diz o que existe e o que faltou. Com campaign.portfolioId, a campanha já nasce dentro daquele portfólio (o id vem de radarscout_list_ad_campaigns); um portfólio que não existe na conta é recusado antes de qualquer coisa, com a lista dos que existem. Há um limite de 10 campanhas criadas por dia, e um nome que já existe na conta é recusado. Use quando o usuário quiser lançar uma campanha nova inteira.

radarscout_create_campaign_structure

Cria um grupo de anúncios dentro de uma campanha que já existe. O grupo nasce vazio: depois use radarscout_add_product_ads para colocar os produtos e radarscout_add_keywords ou radarscout_add_targets para dizer em quais buscas ou produtos ele compete. O lance padrão vale para toda palavra e todo alvo sem lance próprio, e fica entre R$ 0,02 e R$ 500. Um nome que já existe na campanha é recusado. Pode nascer pausado (state PAUSED) para montar tudo antes de ligar. Use quando o usuário quiser separar produtos ou temas dentro de uma campanha que já existe.

radarscout_create_ad_group

Cria um portfólio de anúncios — o agrupador que junta campanhas na conta, por marca, linha de produto ou o critério do vendedor. Nasce sem teto de gasto, como na Amazon. Um nome que já existe na conta é recusado. Depois de criado, radarscout_create_campaign_structure aceita o portfolioId para a campanha já nascer dentro dele, e radarscout_list_ad_campaigns mostra e filtra por portfólio. Use quando o usuário quiser organizar as campanhas em grupos, por marca ou linha de produto.

radarscout_create_portfolio

Devolve o desempenho de anúncios (Ads) dia a dia no período: investimento, vendas por anúncios, impressões, cliques, pedidos e as razões derivadas (ACoS, ROAS, CTR, CVR, CPC) de cada dia. Sem campaign_id, é a conta inteira; com campaign_id, é a linha daquela campanha. Use quando o usuário perguntar como evoluiu, se piorou depois de uma mudança, em que dia o gasto disparou ou quando a veiculação parou — as outras tools de Ads só dão o total do período. Períodos de até 400 dias.

radarscout_list_ads_daily_performance

Lista as palavras-chave e os alvos de produto/categoria das campanhas de anúncios (Ads) de uma conta, cada um com o lance atual — o valor que a Amazon usa nos leilões agora. Quando o item não tem lance próprio, a ferramenta resolve e mostra o lance padrão do grupo de anúncios, com a origem indicada em bid_source. Use antes de propor qualquer mudança de lance: os ids retornados (keyword_id/target_id) são exatamente os que radarscout_update_keyword_bid e radarscout_update_target_bid recebem. Com period_start e period_end, cada item vem também com o desempenho do período (investimento, vendas por anúncios, impressões, cliques, pedidos, unidades, ACoS, ROAS, CTR, CVR e CPC), ordenado por investimento — é o que responde "esse lance está valendo a pena?". Sem o período, a resposta traz só os lances. Em contas grandes, filtre por campaign_id para uma resposta menor e mais rápida.

radarscout_list_ad_bids

Lista as propostas do motor de automação de Ads do Radar para uma conta de seller. Propostas com mais de 24 horas podem não refletir o estado atual — lances, orçamentos e status de campanha podem ter mudado; confira o estado atual pelas tools de leitura antes de aprovar uma proposta antiga. `unknown` = o resultado da execução não pôde ser confirmado pelo sistema — inspecione o registro de auditoria (`auditId`) antes de tratar como concluída. Use quando o usuário perguntar o que o Radar está sugerindo nos anúncios ou quiser revisar as propostas antes de aprovar ou recusar.

radarscout_list_ads_proposals

Pausa uma campanha Sponsored Products (state=PAUSED). Reversível via radarscout_resume_campaign — mas pausar e reativar contam como a mesma família de mudança: depois de uma, a campanha fica 7 dias em espera antes de aceitar a outra. Uma resposta `rejected_cooldown` indica espera ativa (`daysRemaining` diz quanto falta). Use quando o usuário quiser tirar uma campanha do ar sem perder o histórico dela.

radarscout_pause_campaign

Pausa ou reativa uma palavra-chave Sponsored Products: pausada, ela para de gastar e de mostrar o anúncio, e o histórico dela continua lá. É diferente de negativar — negativar bloqueia a busca no grupo ou na campanha inteira, inclusive o que outras palavras capturariam. Use quando a palavra gasta sem vender e o vendedor quer desligá-la, ou quer religar uma que foi pausada. O keywordId e o campaignId vêm de radarscout_list_ad_bids, que também mostra quanto a palavra gastou e rendeu. Não arquiva: arquivar não tem volta na Amazon. Há período de espera de 7 dias entre mudanças de estado da mesma palavra.

radarscout_update_keyword_state

Pausa ou reativa um alvo de produto ou categoria (target) Sponsored Products: pausado, ele para de gastar e de mostrar o anúncio, e o histórico continua lá. É diferente de negativar o alvo, que bloqueia o produto ou a categoria no grupo ou na campanha inteira. Use quando o alvo gasta sem vender e o vendedor quer desligá-lo, ou quer religar um que foi pausado. O targetId e o campaignId vêm de radarscout_list_ad_bids, que também mostra quanto o alvo gastou e rendeu. Não arquiva: arquivar não tem volta na Amazon. Há período de espera de 7 dias entre mudanças de estado do mesmo alvo.

radarscout_update_target_state

Reativa uma campanha Sponsored Products pausada (state=ENABLED). Reversível via radarscout_pause_campaign — mas pausar e reativar contam como a mesma família de mudança: depois de uma, a campanha fica 7 dias em espera antes de aceitar a outra. Uma resposta `rejected_cooldown` indica espera ativa (`daysRemaining` diz quanto falta). Use quando o usuário quiser voltar a veicular uma campanha que está pausada.

radarscout_resume_campaign

Rejeita uma proposta do motor de automação — ela nunca é executada. Use radarscout_list_ads_proposals para revisar as propostas pendentes antes de decidir, e registre o motivo em `reason` — ele fica registrado para revisão. Use quando o usuário decidir descartar uma proposta pendente.

radarscout_reject_ads_proposal

Lista os termos de busca (search terms) que acionaram os anúncios de uma conta de seller em um período, com investimento, vendas por anúncios, impressões, cliques, pedidos, unidades e as razões derivadas (ACoS, ROAS, CTR, CVR, CPC). Cada termo vem com o alvo que o capturou e o tipo do alvo (palavra-chave BROAD/PHRASE/EXACT ou segmentação automática/por produto). Filtros opcionais por campanha, cliques mínimos, investimento mínimo e se houve venda. Use quando o usuário perguntar quais buscas dispararam os anúncios, quais termos gastam sem converter ou o que vale negativar.

radarscout_list_search_terms

Retorna os indicadores de topo de anúncios (Ads) de uma conta de seller em um período: investimento, vendas por anúncios, impressões, cliques, pedidos e as razões derivadas (ACoS, ROAS, CTR, CVR, CPC). Inclui todas as campanhas do período, mesmo pausadas ou arquivadas; com portfolio_id, soma só as campanhas que estão hoje naquele portfólio, arquivadas incluídas. Use quando o usuário perguntar como estão os anúncios no geral, quanto gastou em Ads ou qual o ACoS da conta.

radarscout_get_ads_overview

Explica um conceito ou métrica do Radar (ex.: PMI, safe mode, MC1–MC3, repasse, preço mínimo, Buy Box %, GMV, Receita Líquida, CMV, settlement, limites de alteração, ACoS, ROAS, CTR, CVR, CPC, negativar, status de veiculação, proposta de automação, simulação, lance herdado) com uma definição em português. Não acessa dados de seller. Use quando o usuário perguntar o que significa um termo, uma sigla ou uma métrica do Radar ou da operação na Amazon.

radarscout_explain_concept

Busca oportunidades no Radar (entidade Product do catálogo Amazon, identificada por ASIN) por termo livre (título/marca), lista de ASIN/EAN ou filtros (categoria, marca, faixa de preço, avaliações, nota). Retorna linhas compactas com paginação por cursor. Usa o índice Atlas Search do dashboard (Oportunidades). Não lista ofertas do seller (SellerListing) — para isso use radarscout_list_seller_offers. Exige seller_account_id apenas para atribuição. Use quando o usuário quiser encontrar produtos para vender ou localizar um item do catálogo por ASIN, EAN, marca ou categoria.

radarscout_search_products

Retorna o detalhe completo de UMA oportunidade (Product do catálogo Amazon) por ASIN: metadados, estatísticas D90, tarifas FBA e estimativas de vendas (unidades) e receita. Não é a oferta do seller (SellerListing) — para estoque/FBA da conta use radarscout_get_seller_offer. Exige seller_account_id apenas para atribuição. Use quando o usuário pedir o detalhe de um produto do catálogo por ASIN.

radarscout_get_product_details

Estima vendas mensais (unidades) a partir do BSR e da categoria raiz, usando a matriz sales_estimate_bsr do Radar (mesma ferramenta "Vendas por BSR" do dashboard). Informe category_id (código da categoria Amazon) ou category_name, e o ranking BSR. Não acessa dados de seller — é um simulador. Não confundir com radarscout_get_product_details (oportunidade) nem com ofertas do seller. Use quando o usuário perguntar quantas unidades por mês um BSR representa em uma categoria.

radarscout_estimate_sales_from_bsr

Lista os produtos rastreados (Produtos Rastreados / Monitorar BuyBox) do usuário, com preço atual, variação recente de preço (a partir do histórico de preços) e a flag de notificação. Use para o seller revisar sua watchlist de monitoramento de Buy Box. Não confunda com favoritos — produto rastreado é outra entidade. Paginação por cursor (limit + cursor opaco).

radarscout_list_tracked_products

Gera o link de autorização da Amazon (SP-API) para o usuário clicar e conectar uma nova conta de seller ao Radar. Solicita a região (NA, EU ou FE — padrão NA) e o app de destino (radar, analytics ou repricer — padrão radar). Retorna a URL de consentimento; a conexão só é concluída depois que o usuário completa o fluxo na Amazon. Use quando o usuário quiser conectar uma conta Amazon nova ao Radar.

radarscout_connect_amazon_sp_api

Retorna o usuário Radar autenticado, as contas de seller conectadas — cada uma com o marketplace (Amazon ou Mercado Livre), que determina quais tools se aplicam a ela — e o status de assinatura por app (Radar / Analytics / Repricer) para saber quais tools do MCP estão liberadas. Use no início da conversa para obter o seller_account_id que as demais tools exigem, ou quando o usuário não souber qual conta usar ou disser que não vê seus dados.

radarscout_whoami

Calculadora de tarifas e rentabilidade da Amazon Brasil (FBA, FBM ou DBA). A partir de preço, custo, peso/dimensões, categoria e impostos, retorna a tarifa de venda (referral), a tarifa de logística (FBA/DBA), a tarifa de armazenamento (FBA), os impostos, o lucro líquido, a margem (%) e o ROI (%). Não acessa dados de seller — é um simulador. Use quando o usuário quiser saber quanto sobra vendendo a um preço, se um produto vale a pena ou qual o preço mínimo para cobrir os custos.

radarscout_calculate_fees

Retorna a Cascata Financeira (margem de contribuição) de uma conta de seller em um período: GMV menos devoluções e impostos chega à Receita Líquida; menos CMV chega ao MC1; menos tarifas Amazon chega ao MC2; menos anúncios chega ao MC3. Informa a cobertura de CMV (completa, parcial ou ausente) e lista os SKUs sem custo cadastrado. Use quando o usuário perguntar por que o lucro caiu, de onde vêm os custos, quanto a Amazon cobra no total ou pedir o detalhamento de MC1 a MC3.

radarscout_get_profit_waterfall

Lista os pedidos Amazon do seller num período, do mais recente ao mais antigo — a tela Pedidos do Analytics. Por padrão devolve UM registro por pedido (com os SKUs em items[]); use granularity="item" para uma linha por SKU, como na tela. Serve para conferir pedido a pedido contra um ERP: traz amazon_order_id, merchant_order_id, data (ISO e dia no fuso de São Paulo), status, FBA/FBM e o valor decomposto. Atenção: items_total é a soma dos item_price da Amazon e NÃO inclui frete — frete, desconto promocional e imposto vêm em campos separados. Sem status_group a lista inclui cancelados (o GMV dos outros relatórios não os inclui). Não devolve CPF nem endereço do comprador. total_orders conta PEDIDOS distintos desta base e não é comparável com o campo orders de radarscout_get_sales_overview, que conta ITENS de pedido vindos do relatório Sales & Traffic da Amazon. Use quando o usuário quiser conferir pedido a pedido, comparar com o ERP ou investigar um pedido específico.

radarscout_list_orders

Lista os produtos vendidos por uma conta de seller em um período, ranqueados por lucro líquido (sort=profit) ou margem líquida % (sort=margin), sinalizando os SKUs com margem negativa (prejuízo). Suporta paginação por cursor. Use quando o usuário perguntar quais produtos mais vendem ou mais lucram, quais são os campeões ou quais SKUs estão dando prejuízo.

radarscout_list_top_products

Resumo de repasses (settlement) de uma conta de seller Amazon: o próximo repasse projetado (data estimada de depósito + valor estimado), o último repasse concluído (período, repasse líquido/net payout e data de depósito no banco — distinta do fim do período) e o resumo de deduções do ciclo atual (tarifas Amazon e reserva retida). Responde "quando e quanto vou receber?". Sinaliza quando a ingestão de dados ainda está incompleta e os valores podem ser parciais. Use quando o usuário perguntar quando e quanto vai receber, ou estranhar a diferença entre o que vendeu e o que a Amazon depositou.

radarscout_get_settlement_summary

Retorna os indicadores de topo de uma conta de seller em um período: GMV (faturamento bruto), número de itens de pedido, ticket médio e lucro líquido MC3 (após CMV, tarifas Amazon e anúncios). Use quando o usuário perguntar como foram as vendas, quanto faturou ou qual o ticket médio de um período, ou quiser comparar períodos. Para entender por que o lucro mudou, use radarscout_get_profit_waterfall.

radarscout_get_sales_overview

Detalhe de uma oferta do seller (SellerListing) por listing_id ou sku: estoque, FBA/FBM, Buy Box, limites de preço/PMI, CMV e inteligência de reposição no período. Não confundir com radarscout_get_product_details (oportunidade/catálogo). Use quando o usuário perguntar de um SKU específico da própria conta.

radarscout_get_seller_offer

Lista as ofertas do seller (SellerListing — SKUs da conta conectada) com estoque, modalidade (FBA/FBM/DBA), Buy Box e inteligência de reposição (velocidade, dias de cobertura, status). Não é a busca de Oportunidades do catálogo (Product) — para isso use radarscout_search_products. Dados vêm do sync de analytics/repricer. Use quando o usuário perguntar dos próprios anúncios ou SKUs, quanto tem de estoque, o que precisa repor ou quais SKUs estão perdendo a Buy Box.

radarscout_list_seller_offers

Lista, do mais recente ao mais antigo, os eventos de Atividade do Repricer de uma conta de seller (alterações de preço, mudanças de configuração, syncs, erros). Pagina com limit + cursor opaco; quando next_cursor não é nulo há mais eventos. Eventos em modo seguro (safe mode) são simulações — não publicaram preço na Amazon — e vêm marcados como tal. Use quando o usuário quiser ver o que o repricer fez recentemente ou investigar erros e mudanças de configuração.

radarscout_list_repricer_activity

Audita as decisões recentes de repricing de um anúncio (SKU ou ASIN) de uma conta de seller: para cada decisão mostra o gatilho, o preço anterior → novo preço, a ação de preço aplicada (match_price, price_below, use_min_price…), a Automação/Estratégia envolvida e os limites ativos de preço mínimo/máximo. Explica explicitamente quando o anúncio está travado no Preço Mínimo e qual limite é o vínculo (mínimo manual ou PMI calculado por custo). Na Amazon, informa o teto da Buy Box aprendido (buy_box_ceiling): o preço em que a Buy Box foi perdida após uma subida da gestão, acima do qual o Repricer não sobe por 6 horas, e winning_price, o maior preço em que a Buy Box se manteve após uma subida desde então; enquanto ele vale, a gestão sobe direto para a metade do caminho entre os dois (busca binária pelo maior preço que ainda ganha a Buy Box) e para quando não cabe mais um passo entre eles. Decisões em modo seguro são marcadas como simulação. Responde "por que o preço deste SKU caiu?" e "por que está travado no preço mínimo?". Use quando o usuário perguntar por que o preço de um anúncio caiu, subiu ou não sai do mínimo.

radarscout_explain_price_change

Retorna a saúde do Repricer de uma conta de seller em um período: taxa de vitória na Buy Box (Buy Box win rate) das ofertas ativas com repricing, e a contagem de aumentos vs reduções de preço aplicados pelo Repricer no período. Use quando o usuário perguntar se o repricer está funcionando ou como está a taxa de Buy Box. Para entender o preço de um SKU específico, use radarscout_explain_price_change.

radarscout_get_repricer_summary