naia GEO Autopilot
Execute AI visibility analyses, consult GEO reports, generate and edit content, and create execution plans through Naia.
Servidor MCP hospedado
npx add-mcp 'https://naia.today/api/v1/mcp'Instala no Claude Code, Codex, Cursor e outros
Documentação
API, MCP e npm para GEO em ferramentas de IA | naia
Fonte: https://naia.today/developers
Model Context Protocol
Execute o naia a partir do
agente que você já usa.
naia fala MCP. Conecte Claude Code, Cursor, Codex, Windsurf, VS Code, Replit ou Lovable ao today.naia/platform e envie análises GEO, planos de execução e conteúdo humanizado sem sair da conversa.
Obter chave de API Instale em 30 segundos GitHub
Testado com Claude Code· Cursor· Codex· Windsurf· VS Code· Replit· Lovable· MCP Registry· npm·
Como é uma chamada
O mesmo JSON-RPC que todo cliente fala.
Um servidor, um protocolo. Peça ao assistente para listar ferramentas, preparar uma configuração de marca e, em seguida, iniciar uma análise. O servidor retorna IDs que o assistente pode consultar.
Requisição
jsonCopy
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "autopilot_start_analysis",
"arguments": {
"brandId": "abc123",
"models": ["gemini", "chatgpt"]
}
}
}
Resposta
jsonCopy
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"runId": "run_xyz",
"status": "pending",
"creditsReserved": 8,
"pollWith": "autopilot_get_run_status"
}
}
Seis ritmos, um servidor
Quem executa o naia a partir do editor.
Equipes de marketing
Dê instruções ao assistente e veja-o redigir um trimestre de conteúdo GEO humanizado com o plano anexado.
autopilot_create_execution_plan
Redação e editorial
Agende a matriz padrão de análise do ChatGPT, Gemini e Perplexity. Adicione cobertura específica quando o projeto exigir.
autopilot_start_analysis
E-commerce
Audite a cobertura de categorias na busca por IA e gere páginas de destino onde as citações caem.
autopilot_supermemory_scan
Agência e estúdio
Alterne configurações de marca, pause um agente para um cliente e coloque uma execução manual na fila para outro.
autopilot_list_brands
Guardião da marca
Persista tom de voz, frases proibidas e posicionamento do produto. O assistente os recupera antes de cada execução.
autopilot_memory_create
Devtools e SaaS
Chame as mesmas ferramentas MCP do seu backend via JSON-RPC. Entregue visibilidade em IA dentro do seu aplicativo.
JSON-RPC 2.0
40 ferramentas em destaque
Autopilot e naia Index em um único MCP.
-
autopilot_list_brandsLista as marcas Autopilot disponíveis para a chave de API
gratuito
-
autopilot_prepare_brand_setupGera o documento de configuração e aprovação da marca antes de qualquer execução
gratuito
-
autopilot_start_analysisInicia uma análise GEO Enterprise aprovada. Aplica a lista aprovada como o conjunto de prompts da marca, portanto, em uma marca com análise paga, uma lista diferente é recusada, a menos que replaceExistingPrompts=true; para apenas atualizar um relatório, use autopilot_refresh_report. Custo do prompt: 10 créditos por prompt na primeira análise de uma marca, com cada mecanismo cobrado uma vez; em uma marca que já concluiu uma análise paga, 3 créditos por prompt, mais os créditos de cada mecanismo em cada prompt (prompt x mecanismo), com coordenação e visibilidade cobradas uma vez
créditos
-
autopilot_refresh_reportAtualiza o relatório de uma marca já analisada reutilizando os prompts atuais, como o botão Atualizar do painel; chame sem confirmed para obter o plano e o custo e, depois, com confirmed=true. Nunca altera prompts, tópicos, concorrentes ou mecanismos. Quando os prompts são executados (forçados ou quando a janela semanal expira), cada prompt é executado em cada mecanismo e custa 3 créditos, mais os créditos de cada mecanismo por prompt (prompt x mecanismo), com coordenação e visibilidade cobradas uma vez; por exemplo, 20 prompts no ChatGPT e no Gemini custam 20 x (3 + 5 + 2) + 1 + 3 = 204 créditos; quando reutiliza as respostas da semana, nenhum prompt é executado e apenas os mecanismos uma vez, coordenação e visibilidade são cobrados (11 créditos no mesmo exemplo)
créditos
-
autopilot_get_run_statusConsulta uma execução do Autopilot até que ela seja concluída
gratuito
-
autopilot_get_reportLê dados de relatório, visibilidade e auditoria técnica
gratuito
-
autopilot_export_reportExporta um relatório concluído como CSV, Excel ou PDF
gratuito
-
autopilot_create_execution_planGera um plano de execução GEO com fases e tarefas
10 créditos
-
autopilot_get_execution_planLê o plano, as fases e o progresso das tarefas
gratuito
-
autopilot_generate_contentGera conteúdo GEO humanizado com a voz da marca
50 créditos
-
autopilot_get_contentLê o status e o rascunho do conteúdo gerado
gratuito
-
autopilot_update_contentEdita o rascunho de conteúdo salvo, briefing, título, status ou coleção
gratuito
-
autopilot_content_coversGera ou refaz imagens de capa (16:9 por padrão) para conteúdo e posts publicados de Pages, com lista numerada de opções e prévia antes da cobrança
gratuito
-
autopilot_run_technical_auditExecuta auditoria técnica GEO no site da marca
gratuito
-
autopilot_diagnose_publishedDiagnostica a citabilidade de posts publicados nos mecanismos de IA
gratuito
-
autopilot_memory_listLista as memórias da marca usadas em cada geração
gratuito
-
autopilot_memory_createCria ou atualiza uma entrada de memória da marca
gratuito
-
autopilot_supermemory_scanCria uma varredura SuperMemoria no domínio da marca
gratuito
-
autopilot_supermemory_searchPesquisa nós da SuperMemoria por tópico
gratuito
-
autopilot_get_creditsLê créditos, estimativas de custo por operação e o campo pricingRules com a regra de cobrança de prompts
gratuito
-
autopilot_get_traffic_reportLê o grupo Traffic: Search Console, GA (sessões de referência de IA), Social, PageSpeed e Off-Site Presence, com atualização e resumos
gratuito
-
autopilot_refresh_traffic_reportAtualiza o grupo Traffic a partir das contas conectadas da marca; PageSpeed apenas quando solicitado
PageSpeed 10 créditos
-
autopilot_get_suggestionsSugestões proativas e prontas para execução para a marca: tendências do Google da semana, perguntas de IA em que a marca está ausente, reaproveitamento para YouTube, LinkedIn e Reddit, naia Page e agentes semanais
gratuito
-
autopilot_automation_createCria um agente de marca: um prompt salvo que o naia executa em um agendamento, opcionalmente dentro de um período (startsAt, endsAt); dryRun pré-visualiza agendamento, próximas execuções, orçamento e e-mail
gratuito
-
autopilot_automation_updateEdita um agente: prompt, agendamento, período, orçamento, e-mail ou pausa e retoma
gratuito
-
autopilot_automation_listLista os agentes da marca com agendamento, período, estado, última execução e contagem real de execuções
gratuito
-
autopilot_automation_run_nowExecuta um agente agora; a execução cobra créditos até o orçamento do agente
gratuito
-
autopilot_automation_deleteExclui um agente e seu histórico de execuções, após prévia e confirmed=true
gratuito
-
autopilot_create_artifactCria o site de conteúdo naia Pages da marca, já ativo; criações com falha não são cobradas e novas tentativas são gratuitas
10 créditos
-
autopilot_get_artifact_configLê o estado do domínio da naia Page, os dois registros DNS a criar e, quando estiver no ar, o checklist principal do site com trechos prontos para colar
gratuito
-
autopilot_verify_artifact_domainVerifica o domínio personalizado agora e emite o certificado; o naia também verifica a cada 15 minutos e envia e-mail ao proprietário quando ele entra no ar
gratuito
-
naia_index_list_categoriesLista categorias públicas do naia Index e status de publicação
gratuito
-
naia_index_get_rankingsLê um ranking de categoria com pontos de visibilidade, share of voice (shareOfVoice, derivado, válido apenas dentro da categoria e rodada), posições nos mecanismos e histórico de líderes
gratuito
-
naia_index_get_historyLê o histórico mensal da marca e compara com outra marca
gratuito
-
naia_index_compare_categoriesCompara líderes ou a mesma marca entre categorias
gratuito
-
naia_index_compare_periodsCompara a evolução mensal dos líderes de categoria
gratuito
-
naia_index_get_overall_rankingLê o ranking geral do Brasil nas categorias atuais
gratuito
-
naia_index_get_methodologyLê a metodologia pública estruturada: pontuação, definição de share of voice, princípio de medição, regra prática de empate e cadência
gratuito
-
naia_index_list_studiesLista estudos medidos e publicados do naia Index
gratuito
-
naia_index_get_studyLê um instantâneo de estudo publicado por slug
gratuito
Instale em 30 segundos
Escolha seu cliente e cole o trecho.
HTTP remoto para clientes compatíveis, npm stdio para clientes baseados em comando. Clientes com suporte a MCP OAuth (Claude Code, claude.ai, Cursor, VS Code, ChatGPT) conectam com login universal: adicione a URL sem cabeçalhos e aprove no navegador, sem precisar copiar chave de API. As sessões duram até 180 dias e podem ser revogadas a qualquer momento no painel. O mesmo servidor também está listado no MCP Registry oficial como today.naia/platform.
Claude CodeCursorCodexWindsurfVS Codenpm stdioReplitLovablecURL
bashCopy
# Universal login (OAuth): your browser opens to sign in and approve
claude mcp add --transport http naia \
https://naia.today/api/v1/mcp
# Alternative with API key (headless automations)
claude mcp add --transport http naia \
https://naia.today/api/v1/mcp \
--header "Authorization: Bearer naia_YOUR_KEY"
Como funciona
Quatro passos, da chave à primeira execução.
01
Conecte com sua conta
Adicione a URL do servidor e seu cliente abrirá o navegador para você entrar e aprovar (OAuth). Prefere automação headless? Gere uma chave de API em /dashboard/settings/api.
02
Conecte o cliente
Cole o trecho da aba de instalação. O assistente detecta 19 ferramentas automaticamente.
03
Prepare e aprove
Peça ao assistente para preparar a configuração da marca. Aprove o documento. Sem cobranças surpresa.
04
Execute e publique
Dispare análises, elabore planos de execução e gere conteúdo humanizado. A consulta permanece no chat.
Também disponível
API REST para integrações de backend.
O servidor MCP é a superfície principal. As mesmas operações também estão disponíveis como endpoints REST quando você incorpora o naia no seu próprio produto.
Especificação OpenAPI Descritor MCP
-
POST``/api/public/ai-readiness/embedGera ou lê um relatório de AI Readiness para um domínio de parceiro na lista de permissões
-
POST``/api/v1/analysesDispara uma execução de análise GEO
-
POST``/api/v1/contentGera conteúdo humanizado (50 créditos)
-
POST``/api/v1/execution-plansGera um plano de execução (10 créditos)
-
GET``/api/v1/businessesLista os negócios que sua chave pode ler
-
GET``/api/v1/businesses/{id}/trafficLê Search Console, GA, Social, PageSpeed e Off-Site Presence de uma marca
-
POST``/api/v1/businesses/{id}/traffic/refreshAtualiza o grupo Traffic (gratuito por padrão; PageSpeed 10 créditos quando solicitado)
-
GET``/api/v1/creditsLê o saldo atual e a prévia de custos
-
POST``/api/v1/mcpPonto de entrada JSON-RPC usado por todo cliente MCP
Embed de parceiro
AI Readiness com chave de API com escopo.
Crie uma chave com o escopo AI Readiness no painel, armazene-a no backend do parceiro e chame o naia a partir de uma rota de servidor. Nunca coloque a chave em JavaScript do navegador, HTML, localStorage, strings de consulta ou variáveis de ambiente públicas.
O domínio do parceiro também deve estar na lista de permissões do naia. Use origens HTTPS como https://partner.com e https://www.partner.com.
tsCopy
// Partner backend route. Keep NAIA_API_KEY in server secrets.
export async function POST() {
const response = await fetch("https://naia.today/api/public/ai-readiness/embed", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.NAIA_API_KEY}`,
"Content-Type": "application/json",
"Accept": "application/json"
},
body: JSON.stringify({ domain: "partner.com" })
});
return new Response(await response.text(), {
status: response.status,
headers: { "Content-Type": "application/json" }
});
}
jsCopy
// Browser code calls your own backend, never naia directly with a key.
const response = await fetch("/api/naia-ai-readiness", { method: "POST" });
const payload = await response.json();
FAQ
Quatro perguntas antes de conectar.
Por que MCP em vez de curl?
O assistente chama as ferramentas do naia a partir da conversa, com argumentos estruturados e memória de marca consistente. Você permanece no editor, mantém a trilha de auditoria e o assistente faz a orquestração.
As ferramentas pagas são executadas automaticamente?
Não. As ferramentas de leitura são executadas. As ferramentas pagas exigem primeiro um documento de aprovação (autopilot_prepare_brand_setup) e, em seguida, autorização explícita. Os custos são exibidos antes da confirmação.
Quais clientes são compatíveis hoje?
Qualquer cliente MCP HTTP. Testado com Claude Code, Cursor, Codex, Windsurf, VS Code, Replit e Lovable. O proxy npm stdio cobre clientes baseados em comando.
Preciso copiar uma chave de API?
Não mais. Clientes com suporte a MCP OAuth conectam com login universal: o servidor responde 401, o cliente descobre os endpoints OAuth, abre o navegador, você entra e aprova. A sessão dura até 180 dias via refresh token e pode ser revogada a qualquer momento no painel. As chaves de API continuam disponíveis para automações headless.
Também existe uma API REST?
Sim. As mesmas operações estão disponíveis como endpoints REST em /api/v1, registrados na especificação OpenAPI. Use REST quando incorporar o naia no seu próprio backend.
Seu editor.
A voz da sua marca. Nosso mecanismo GEO.