Produto · API e MCP
API de visibilidade em IA: seus dados, na sua stack
A Howseen monitora como o ChatGPT, o Gemini, o Perplexity e as respostas de IA do Google falam sobre sua marca. A API REST e o servidor MCP colocam esses dados nos seus scripts, nos dashboards dos seus clientes e no seu assistente de IA.
Por Raphaël Aubry, fundador da Howseen AI · Atualizado em 
Definição
O que é uma API de visibilidade em IA?
Uma API de visibilidade em IA retorna, como dados, como os mecanismos de IA respondem às perguntas dos seus compradores: quais marcas eles citam, em qual posição, com quais fontes, por mecanismo e ao longo do tempo.
Dashboards são ótimos para visualizar. Relatórios para clientes, alertas semanais e BI interno precisam dos números em si. A Howseen os disponibiliza de duas formas: uma API REST somente leitura que retorna JSON, e um servidor MCP remoto que permite a um assistente de IA ler os mesmos dados e agir sobre eles.
Por que isso importa
Por que exportar dados de visibilidade em IA?
Porque os compradores agora param na resposta da IA, os números que mostram se a IA cita você precisam estar nos mesmos relatórios que tráfego e receita.
Em uma análise do Pew Research Center sobre buscas no Google, as pessoas clicaram em um resultado tradicional em 8% das visitas quando um resumo de IA aparecia, contra 15% sem ele. O Gartner previu que o volume de buscas cairia 25% até 2026 por causa dos chatbots de IA e assistentes virtuais. O Google documenta que o AI Overviews e o AI Mode constroem respostas a partir de várias buscas relacionadas (Google Search Central, AI features and your website).
“Por trás dos panos, o AI Mode usa nossa técnica de query fan-out, dividindo sua pergunta em subtópicos e disparando várias consultas simultaneamente em seu nome.”
Uma API transforma essa mudança em um número que sua equipe já acompanha: em um relatório semanal, um dashboard de BI ou um alerta quando um concorrente ultrapassa você.
API REST
O que a API REST retorna
A API REST é JSON somente leitura, com filtros de intervalo de datas e mecanismo e paginação, autenticada com uma chave pessoal.
- Marcas: os sites monitorados na conta.
- Visibilidade: % das respostas de IA que citam a marca, share of voice, posição, por mecanismo e ao longo do tempo.
- Prompts: as perguntas dos compradores monitoradas, com resultados por pergunta.
- Concorrentes: quem a IA cita ao lado de você, ou no seu lugar.
- Fontes: os domínios e páginas que a IA cita nas suas perguntas.
- Respostas: as respostas reais da IA, com as marcas citadas e as URLs citadas.
- Ações e artigos: o plano de ação e os artigos que a Howseen escreveu para a marca.
curl -H "Authorization: Bearer hs_live_YOUR_KEY" \ "https://app.howseen.ai/api/v1/brands/BRAND_ID/visibility?from=2026-09-01&engine=chatgpt"
Servidor MCP
O servidor MCP: pergunte ao seu assistente de IA e depois aja
O servidor MCP em https://app.howseen.ai/api/mcp permite que Claude, ChatGPT, Cursor ou Codex leiam sua visibilidade em IA e, com uma chave que permita, ajam sobre ela.
Pergunte “em quais perguntas o ChatGPT cita um concorrente e não a nós?”, “em quais sites deveríamos aparecer primeiro?” ou “o que mudou desde a última varredura?” em palavras simples. As ferramentas de leitura funcionam com qualquer chave. As ferramentas de ação (adicionar prompts, redigir um artigo, publicá-lo no seu site, solicitar indexação, criar um relatório compartilhado) exigem uma chave com ações habilitadas, e cada ação mostra uma prévia antes de ser aplicada.
A configuração leva 2 minutos: crie uma chave em Configurações, API e assistentes de IA, depois cole o comando pronto para o seu aplicativo. Comandos e a lista completa de ferramentas: a página do MCP e o repositório público howseen-mcp no GitHub.
Sua visibilidade em IA, onde você já trabalha
O teste gratuito de 3 dias inclui a API e o servidor MCP. Cancele em 1 clique.
Planos
Quais planos incluem a API e o servidor MCP?
A API REST e o servidor MCP estão incluídos nos planos Pro e Business, e no teste gratuito de 3 dias.
| Starter | Pro | Business | |
|---|---|---|---|
| Preço | €39/mês | €79/mês | a partir de €219/mês |
| Perguntas de compradores | 20 | 50 | 100 a 300, compartilhadas por 3 marcas |
| Motores de IA | 3: ChatGPT, Gemini, AI Overviews | 5: + Perplexity, AI Mode | 5 + Claude |
| Execuções | a cada 3 dias | a cada 3 dias | diariamente (Claude a cada 3 dias) |
| Concorrentes por marca | 3 | 5 | 5 |
| Artigos a cada 30 dias | 4 | 15 por marca | 30 para a conta |
Agências que gerenciam vários clientes: o Business compartilha de 100 a 300 perguntas entre 3 marcas e adiciona relatórios white-label. Preços na página de preços.
Perguntas respondidas
Existe uma API para monitoramento de visibilidade em IA?+
Sim. A Howseen tem uma API REST em JSON somente leitura (URL base https://app.howseen.ai/api/v1) para visibilidade, prompts, concorrentes, fontes, respostas, ações e artigos, além de um servidor MCP remoto para assistentes de IA.
Como faço a autenticação?+
Com uma chave pessoal criada em Configurações, API e assistentes de IA, enviada como Authorization: Bearer <key>. Aplicativos que não conseguem enviar cabeçalhos podem passá-la na URL do MCP como ?key=, que então deve ser mantida em sigilo como uma senha.
Quais assistentes de IA funcionam com o servidor MCP?+
Qualquer cliente que suporte servidores MCP remotos via Streamable HTTP, incluindo Claude Code, Claude.ai, ChatGPT, Cursor e Codex.
O servidor MCP pode alterar coisas na minha conta?+
Somente com uma chave que tenha ações habilitadas. Cada ação (adicionar prompts, redigir ou publicar um artigo, solicitar indexação, criar um relatório) mostra uma prévia antes e só é aplicada quando confirmada.
De qual plano eu preciso?+
Pro ou Business. O teste gratuito de 3 dias inclui a API e o servidor MCP.
Leve sua visibilidade em IA para a sua própria stack
Comece um teste gratuito de 3 dias, crie uma chave e consulte seus dados em 2 minutos.
