Faça perguntas à análise da sua loja em linguagem simples
O Ask AI responde a perguntas sobre a sua loja a partir dos seus próprios relatórios ROASaurus. As mesmas ferramentas estão disponíveis através de um servidor MCP, para que o Claude, o ChatGPT ou outro cliente MCP possa consultar o seu lucro, atribuição e LTV.
Respostas a partir dos seus dados
Cada número vem de uma chamada a uma ferramenta sobre os seus relatórios, nunca da memória do modelo.
Funciona com o Claude
O modelo da Anthropic lê os resultados e responde no idioma em que escreve.
24 ferramentas só de leitura
Lucro, atribuição, view-throughs, anúncios, campanhas, clientes, LTV, produtos, web, objetivos, stock, benchmarks, custos, públicos, leads, alertas, anomalias, o plano de ação, dashboards, marketing mix, orçamentos e subscrições.
Servidor MCP
Use as mesmas ferramentas a partir do Claude, do ChatGPT ou de outro cliente MCP: inicie sessão com o seu acesso ROASaurus ou envie uma chave de API num cabeçalho.
Mantenha a chave segura
Use uma chave de API com nome que tenha apenas o âmbito mcp, ou a chave de API da loja, que também pode enviar encomendas e eventos. Mantenha qualquer uma delas tão segura como uma palavra-passe.
Por loja
Uma ligação lê uma loja: a loja que escolhe ao iniciar sessão, ou a loja da chave de API.
Como funciona o Ask AI
O Ask AI é uma página de chat no dashboard. Faz uma pergunta, o Claude escolhe as ferramentas que lhe podem responder, a ROASaurus executa-as sobre os dados da sua loja e o Claude escreve a resposta a partir dos resultados. Se uma ferramenta não devolver dados, diz-o e sugere o que ligar, como o script de tracking, as contas de anúncios ou os custos dos produtos. O histórico é guardado por utilizador e loja, e cada utilizador tem um limite diário de perguntas (40 por predefinição, 5 no plano Grátis). O Ask AI também pode propor uma alteração a uma campanha, conjunto de anúncios ou anúncio para a caixa de entrada Actions; nada muda até um proprietário ou administrador a aprovar.
Entre as perguntas a que pode responder estão “Que campanha teve o melhor POAS nos últimos 30 dias?”, “Quantos meses demora uma coorte a recuperar o seu CAC?” e “Estamos no bom caminho para o objetivo de receita deste mês?”
As ferramentas
| Ferramenta | O que devolve |
|---|---|
| profit_summary | Receita, encomendas, AOV, investimento em anúncios, MER, CAC, POAS, custos, lucro bruto e líquido, face ao período anterior |
| attribution | Encomendas, receita, investimento, ROAS e CPA por canal e campanha, em qualquer um dos doze modelos, janelas de lookback e data da encomenda ou do clique |
| view_through | Compras que as plataformas de anúncios reportam após a visualização de um anúncio sem clique, e quantas a ROASaurus colocou em encomendas, por plataforma e campanha |
| ads_table | Investimento, impressões, cliques, CTR e CPM associados às compras registadas, por campanha, conjunto de anúncios ou anúncio |
| campaign_profit | Lucro antes e depois dos anúncios, POAS, CAC e LTV a 90 dias por campanha |
| customer_value | LTV aos 30 a 365 dias, taxa de recompra, dias até à segunda encomenda e coortes mensais |
| ltv_insights | Payback do CAC, LTV previsto, momento de recompra, produto seguinte, segmentos RFM e fatores do LTV |
| products | Produtos mais vendidos e percentagem de compradores de primeira vez que voltaram a encomendar |
| web_analytics | Sessões, taxa de rejeição e taxa de conversão por origem, dispositivo e página de destino |
| goals_forecast | Os objetivos deste mês, os valores reais até agora e a previsão para o fim do mês |
| inventory | Valor do stock, velocidade de vendas, dias restantes e artigos a repor |
| benchmarks | Os seus últimos 90 dias face aos quartis de lojas semelhantes |
| cost_model | Linhas do P&L até ao EBITDA, CM1 a CM3, custos gerais, IVA recuperado e as fontes de custos ligadas |
| audiences | Cada público com as suas regras, a dimensão com consentimento e o estado de sincronização por destino |
| leads_pipeline | Leads, MQLs, SQLs, negócios ganhos, receita ganha e custo por lead, por canal e campanha |
| alerts | Quedas recentes de encomendas, quedas de ROAS, picos de investimento e falhas de tracking |
| anomalies | Métricas que saíram do seu intervalo normal nos últimos dias, com o valor esperado |
| action_plan | O plano de ação semanal e o registo de decisões, com os resultados antes e depois |
| list_dashboards | Dashboards personalizados partilhados com o espaço de trabalho e métricas personalizadas |
| evaluate_metric | Qualquer métrica integrada ou personalizada, ou uma fórmula, com filtros e o período de comparação |
| marketing_mix | Receita incremental, iROAS, ROAS marginal e saturação por canal a partir do marketing mix model |
| optimal_budget | A melhor repartição de um orçamento pelos canais, com limites por canal |
| subscriptions | Subscritores, MRR, churn, motivos de cancelamento e a conversão de compra única em subscrição |
| subscriber_cohorts | Retenção de subscritores e de MRR por mês da primeira subscrição |
O Ask AI, e os clientes MCP cuja chave tenha o âmbito actions:write, recebem também ad_entities (as campanhas, os conjuntos de anúncios e os anúncios das contas de anúncios com escrita ativada) e propose_action, que acrescenta uma alteração proposta à caixa de entrada Actions para um proprietário ou administrador aprovar.
O servidor MCP
O MCP, o Model Context Protocol, permite que apps de IA chamem ferramentas de outros serviços. A ROASaurus disponibiliza um servidor MCP com as mesmas 24 ferramentas só de leitura, para que possa fazer perguntas sobre a sua loja a partir do Claude Code ou de outro cliente MCP que já use.
Endpoint: POST https://app.roasaurus.com/mcp
Header: Authorization: Bearer <store key>:<API key>
Fala MCP Streamable HTTP com respostas JSON (sem server-sent events) e suporta initialize, ping, tools/list e tools/call. Todas as ferramentas de análise estão marcadas como só de leitura. Também pode enviar a chave da loja num cabeçalho X-Roasaurus-Key e apenas a chave de API como bearer token. Ambas as chaves estão no cartão Settings › Orders API da loja. Essa chave de API é a mesma que a API de encomendas usa, por isso também pode enviar encomendas e eventos: mantenha-a tão segura como uma palavra-passe. Regenerá-la desliga todos os clientes que usavam a anterior. Uma chave com nome que tenha apenas o âmbito mcp, criada em Store settings › API & data, funciona sozinha como bearer token e não pode escrever.
As apps de IA compatíveis com OAuth, como o Claude e o ChatGPT, iniciam sessão em vez de usarem uma chave: adicione o endpoint como conector personalizado, inicie sessão no ROASaurus, escolha uma loja e autorize a ligação. Proprietários e administradores podem ligar, e Store settings › API & data lista cada ligação, onde a pode desligar.
Privacidade
O Ask AI envia a sua pergunta e métricas agregadas da loja para a Anthropic, que executa o Claude. Não envia dados de contacto dos seus clientes. Através do MCP, os resultados das ferramentas vão para o cliente de IA que ligar, ao abrigo dos termos desse cliente.
Para quem é
Proprietários que querem um número sem criar um relatório, e profissionais de marketing ou analistas que já trabalham no Claude e querem os dados da loja junto do resto do trabalho. As respostas são tão completas quanto os dados que as sustentam, por isso ligue primeiro o tracking, o investimento da Meta e do TikTok e os seus custos dos produtos.
Limites
- Os períodos são fixos: hoje, ontem ou os últimos 7, 14, 30 ou 90 dias no fuso horário da loja.
- A tabela de anúncios usa uma janela de lookback de 7 dias; a atribuição e o lucro por campanha usam a janela de lookback da loja ou a que pedir.
- As ferramentas não conseguem alterar nada por si próprias. O Ask AI, e os clientes MCP cuja chave tenha o âmbito actions:write, só podem propor alterações aos anúncios para um proprietário ou administrador aprovar.
- Uma chave de API cobre uma loja. Para várias lojas, ligue cada uma.
Construído sobre os mesmos dados first-party
Perguntas e respostas
O que é um servidor MCP?
O MCP (Model Context Protocol) é um padrão aberto que permite que apps de IA chamem ferramentas de outros serviços. O servidor MCP da ROASaurus dá a um cliente de IA ferramentas só de leitura para o lucro, a atribuição, os anúncios, o LTV, o stock, os benchmarks e os alertas de uma loja.
Que apps de IA se podem ligar?
O Claude Code e outros clientes MCP que consigam chamar um servidor Streamable HTTP com um cabeçalho Authorization. O ChatGPT espera um início de sessão com OAuth para servidores MCP personalizados, algo que a ROASaurus ainda não oferece. Use uma chave com nome com o âmbito mcp, criada em Store settings › API & data, ou a chave da loja e a chave de API em Settings › Orders API.
A IA pode alterar as minhas campanhas ou definições?
Não diretamente. O Ask AI, e os clientes MCP cuja chave tenha o âmbito actions:write, podem propor uma alteração a uma campanha, conjunto de anúncios ou anúncio na caixa de entrada Actions, e nada muda até um proprietário ou administrador a aprovar. Nenhuma ferramenta pode editar a sua loja, os seus custos ou as suas definições. A chave de API da loja também pode enviar encomendas e eventos, por isso mantenha-a privada.
Os dados de clientes são enviados para a IA?
O Ask AI envia a sua pergunta e métricas agregadas da loja para a Anthropic, que executa o Claude, e não envia dados de contacto dos seus clientes. Através do MCP, os resultados das ferramentas vão para o cliente de IA que ligar.
Cada venda, associada ao anúncio que a gerou
Tracking server-side, lucro e valor vitalício do cliente numa só app. Teste gratuito de 14 dias, sem cartão de crédito.
Comece o seu teste gratuito →