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.

Ver fonte

  • autopilot_list_brands

    Lista as marcas Autopilot disponíveis para a chave de API

    gratuito

  • autopilot_prepare_brand_setup

    Gera o documento de configuração e aprovação da marca antes de qualquer execução

    gratuito

  • autopilot_start_analysis

    Inicia 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_report

    Atualiza 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_status

    Consulta uma execução do Autopilot até que ela seja concluída

    gratuito

  • autopilot_get_report

    Lê dados de relatório, visibilidade e auditoria técnica

    gratuito

  • autopilot_export_report

    Exporta um relatório concluído como CSV, Excel ou PDF

    gratuito

  • autopilot_create_execution_plan

    Gera um plano de execução GEO com fases e tarefas

    10 créditos

  • autopilot_get_execution_plan

    Lê o plano, as fases e o progresso das tarefas

    gratuito

  • autopilot_generate_content

    Gera conteúdo GEO humanizado com a voz da marca

    50 créditos

  • autopilot_get_content

    Lê o status e o rascunho do conteúdo gerado

    gratuito

  • autopilot_update_content

    Edita o rascunho de conteúdo salvo, briefing, título, status ou coleção

    gratuito

  • autopilot_content_covers

    Gera 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_audit

    Executa auditoria técnica GEO no site da marca

    gratuito

  • autopilot_diagnose_published

    Diagnostica a citabilidade de posts publicados nos mecanismos de IA

    gratuito

  • autopilot_memory_list

    Lista as memórias da marca usadas em cada geração

    gratuito

  • autopilot_memory_create

    Cria ou atualiza uma entrada de memória da marca

    gratuito

  • autopilot_supermemory_scan

    Cria uma varredura SuperMemoria no domínio da marca

    gratuito

  • autopilot_supermemory_search

    Pesquisa nós da SuperMemoria por tópico

    gratuito

  • autopilot_get_credits

    Lê créditos, estimativas de custo por operação e o campo pricingRules com a regra de cobrança de prompts

    gratuito

  • autopilot_get_traffic_report

    Lê 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_report

    Atualiza o grupo Traffic a partir das contas conectadas da marca; PageSpeed apenas quando solicitado

    PageSpeed 10 créditos

  • autopilot_get_suggestions

    Sugestõ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_create

    Cria 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_update

    Edita um agente: prompt, agendamento, período, orçamento, e-mail ou pausa e retoma

    gratuito

  • autopilot_automation_list

    Lista os agentes da marca com agendamento, período, estado, última execução e contagem real de execuções

    gratuito

  • autopilot_automation_run_now

    Executa um agente agora; a execução cobra créditos até o orçamento do agente

    gratuito

  • autopilot_automation_delete

    Exclui um agente e seu histórico de execuções, após prévia e confirmed=true

    gratuito

  • autopilot_create_artifact

    Cria 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_config

    Lê 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_domain

    Verifica 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_categories

    Lista categorias públicas do naia Index e status de publicação

    gratuito

  • naia_index_get_rankings

    Lê 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_history

    Lê o histórico mensal da marca e compara com outra marca

    gratuito

  • naia_index_compare_categories

    Compara líderes ou a mesma marca entre categorias

    gratuito

  • naia_index_compare_periods

    Compara a evolução mensal dos líderes de categoria

    gratuito

  • naia_index_get_overall_ranking

    Lê o ranking geral do Brasil nas categorias atuais

    gratuito

  • naia_index_get_methodology

    Lê 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_studies

    Lista estudos medidos e publicados do naia Index

    gratuito

  • naia_index_get_study

    Lê 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/embed

    Gera ou lê um relatório de AI Readiness para um domínio de parceiro na lista de permissões

  • POST``/api/v1/analyses

    Dispara uma execução de análise GEO

  • POST``/api/v1/content

    Gera conteúdo humanizado (50 créditos)

  • POST``/api/v1/execution-plans

    Gera um plano de execução (10 créditos)

  • GET``/api/v1/businesses

    Lista os negócios que sua chave pode ler

  • GET``/api/v1/businesses/{id}/traffic

    Lê Search Console, GA, Social, PageSpeed e Off-Site Presence de uma marca

  • POST``/api/v1/businesses/{id}/traffic/refresh

    Atualiza o grupo Traffic (gratuito por padrão; PageSpeed 10 créditos quando solicitado)

  • GET``/api/v1/credits

    Lê o saldo atual e a prévia de custos

  • POST``/api/v1/mcp

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

Obter chave de API Ver preços