Ferramentas Disponíveis

O catálogo de ferramentas que o Radar Scout (MCP) expõe ao seu cliente de IA — agrupadas por finalidade.

Cada ferramenta abaixo é uma capacidade que o assistente pode acionar em seu nome. As que leem dados de um vendedor pedem o seller_account_id (obtido com radarscout_whoami); algumas não precisam de vendedor algum, por serem identidade, simulação pura ou conhecimento. Você não chama as ferramentas diretamente — basta perguntar em linguagem natural e o cliente escolhe a certa.

Identidade & conexão

| Ferramenta | O que você pode pedir | | --- | --- | | radarscout_whoami | "Quem sou eu e quais contas Amazon tenho conectadas?" — retorna o seu User e cada seller_account_id. Ponto de partida para todas as demais. | | radarscout_connect_amazon_sp_api | "Quero conectar uma nova conta Amazon" — gera o link de consentimento da SP-API para você autorizar uma nova SellerAccount (escolha de região e app de destino). |

Produtos & descoberta

| Ferramenta | O que você pode pedir | | --- | --- | | radarscout_search_products | "Busque produtos por palavra-chave / ASIN" — pesquisa no catálogo monitorado do vendedor. | | radarscout_get_product_details | "Me dê os detalhes deste produto" — ficha completa de um produto específico. | | 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. |

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). | | radarscout_get_settlement_summary | "Qual foi meu repasse no último ciclo?" — resumo dos repasses quinzenais (settlement) e do net_payout. | | 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. |

Repricer

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

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 a partir de um glossário curado. Não precisa de seller_account_id. |

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.
• Um seller_account_id por consulta — Se você tem várias SellerAccounts, indique qual quer consultar.

Para o panorama do servidor e como conectar um cliente, veja Radar Scout (MCP).