GEOly

O servidor MCP remoto oficial do GEOly — visibilidade de marca com IA (GEO) para o seu agente. O GEOly rastreia como as marcas são mencionadas e citadas em mecanismos de IA (ChatGPT, Gemini, Perplexity, Grok, Google AI), e este servidor coloca esses dados — KPIs de visibilidade, participação de concorrentes, fontes de citação, inteligência de mercado e auditorias de site — diretamente no Claude, Cursor, Codex, VS Code ou qualquer cliente MCP.

GitHub

Documentação

English | 简体中文

Servidor MCP GEOly

O servidor MCP remoto oficial para GEOly — visibilidade de marca com IA (GEO) para o seu agente. O GEOly rastreia como marcas são mencionadas e citadas nos mecanismos de IA (ChatGPT, Perplexity, Google AI Mode, Google AI Overview, Gemini, Copilot), e este servidor coloca esses dados — KPIs de visibilidade, participação de concorrentes, fontes de citação, inteligência de mercado e auditorias de site — diretamente no Claude, Cursor, Codex, VS Code ou qualquer cliente MCP.

HTTP hospedado e transmitível, OAuth no navegador. Uma URL, nada para executar localmente:

https://app.geoly.ai/api/mcp

O que seu agente pode fazer

Consulte os mesmos KPIs que você vê no aplicativo — pontuação AIGVR, taxa de menção, taxa de citação por plataforma de IA (get_brand_overview), tendências diárias e agregação controlada sem SQL sobre conjuntos de dados diários (query_analytics).
Encontre pontos cegos. Quais consultas de compradores nunca mencionam sua marca (get_prompt_mention_rates)? Em quais prompts um domínio não consegue ser citado (get_content_opportunities)?
Compare marcas frente a frente — 2 a 4 marcas lado a lado em visibilidade, presença, citações e classificação de categoria nos mecanismos de IA (compare_public_brands).
Mapeie espaços em branco de categoria — cada tópico em uma categoria classificado em pontos fortes (coberto / líder / próximo / defender) e oportunidades (priorizar / lacuna / observar) para sua marca (get_category_whitespace).
Acompanhe o momentum. Quem está ganhando ou perdendo participação de menções nas respostas de IA, período após período (get_category_brand_momentum)?
Veja a demanda de pesquisa por IA — o que as pessoas realmente perguntam à IA no seu espaço de produto, quais marcas vencem essas respostas e quais territórios de demanda cada marca possui (get_public_search_queries).
Observe a prateleira de IA. Quais produtos a IA recomenda mais em cada categoria, quem está subindo semana após semana (list_public_shopping_boards) e o perfil completo de IA de qualquer produto individual (get_public_shopping_product_detail).
Avalie a dificuldade da concorrência — uma "dificuldade de palavra-chave para a era da IA" de 0 a 100 por tópico (get_topic_competition_difficulty).
Perfile a percepção da IA. Como os modelos de IA descrevem uma marca? Aspectos canônicos, polaridade e evidências textuais (get_public_brand_perception).
Audite a prontidão para IA — auditorias de site GEO que cobrem acessibilidade, dados estruturados, estrutura de conteúdo e verificações técnicas (get_audit_detail).

Experimente perguntar

Após conectar, pergunte ao seu agente coisas como:

"Quão visível minha marca esteve nas respostas de IA nos últimos 30 dias e em qual plataforma estou mais fraco?"

"Quais perguntas de compradores nunca nos mencionam? Classifique-as por quantas vezes os concorrentes aparecem no lugar."

"Compare a visibilidade da Anker vs Soundcore na categoria de áudio portátil."

"Onde está o espaço em branco na minha categoria — quais tópicos devemos priorizar?"

"Quais domínios os mecanismos de IA mais citam no meu setor e estamos em algum deles?"

"Quais produtos estão subindo na prateleira de compras de IA esta semana — e em quais tópicos o reddit.com direciona a IA para meu concorrente?"

"Execute minha auditoria de site GEO mais recente e liste os problemas críticos."

Início rápido

Pré-requisito: uma conta GEOly com um workspace e uma marca monitorada (inscreva-se e conclua a integração da marca primeiro — um workspace novo não tem dados para consultar ainda).

Depois: adicione a URL, faça uma chamada de ferramenta, entre quando o navegador abrir. Essa é toda a configuração.

Claude Code

claude mcp add --transport http geoly https://app.geoly.ai/api/mcp

Cursor

Ou adicione ao ~/.cursor/mcp.json:

{
  "mcpServers": {
    "geoly": {
      "url": "https://app.geoly.ai/api/mcp"
    }
  }
}

Claude Desktop

Configurações → Conectores → Adicionar conector personalizado, depois cole https://app.geoly.ai/api/mcp como a URL. O Claude guia você pelo consentimento OAuth no navegador.

ChatGPT

Nas configurações do ChatGPT, ative o modo de desenvolvedor para conectores, depois adicione um conector personalizado com a URL https://app.geoly.ai/api/mcp e conclua o login OAuth. Sim — você pode perguntar ao ChatGPT sobre a visibilidade da sua marca dentro do ChatGPT.

VS Code (GitHub Copilot)

Ou pela linha de comando:

code --add-mcp '{"name":"geoly","type":"http","url":"https://app.geoly.ai/api/mcp"}'

Codex CLI

Instale pelo marketplace de plugins do GEOly — o plugin registra o servidor remoto e executa o fluxo OAuth na instalação, sem configuração manual necessária:

codex plugin marketplace add geoly-ai/codex-plugins
codex plugin add geoly-mcp@geoly

Windsurf

Configurações → Configuração MCP:

{
  "mcpServers": {
    "geoly": {
      "serverUrl": "https://app.geoly.ai/api/mcp"
    }
  }
}

Gemini CLI

gemini mcp add --transport http geoly https://app.geoly.ai/api/mcp

Ou no ~/.gemini/settings.json:

{
  "mcpServers": {
    "geoly": {
      "httpUrl": "https://app.geoly.ai/api/mcp"
    }
  }
}

Cline

O Cline suporta servidores remotos nativamente (observe o streamableHttp em camelCase):

{
  "mcpServers": {
    "geoly": {
      "type": "streamableHttp",
      "url": "https://app.geoly.ai/api/mcp"
    }
  }
}

Se o fluxo do navegador OAuth não for acionado na sua versão do Cline, use a ponte mcp-remote abaixo.

Qualquer outro cliente MCP

Clientes sem suporte nativo a remoto/OAuth podem fazer a ponte por meio de mcp-remote:

{
  "mcpServers": {
    "geoly": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://app.geoly.ai/api/mcp"]
    }
  }
}

GEOly CLI (terminais e CI)

As mesmas ferramentas, empacotadas como uma linha de comando criada para agentes — veja GEOly-Cli:

# macOS / Linux
curl -fsSL https://geoly.ai/install.sh | sh
# Windows
powershell -ExecutionPolicy Bypass -c "irm https://geoly.ai/install.ps1 | iex"

# No login step — the first call opens the browser to authorize
geoly call get_brand_overview --time_range 30d

Autenticação

Rota	Como	Acesso
OAuth (padrão)	Configure a URL sem credenciais. A primeira chamada retorna um desafio em conformidade com padrões (metadados de recurso protegido RFC 9728) que envia seu cliente para uma tela de consentimento no navegador: entre, escolha quais workspaces compartilhar e revise a grade de permissões.	Concessões de leitura/gravação por recurso — leitura é pré-selecionada, gravação permanece desativada a menos que você marque
Token estático (CI / headless)	Gere um token `geom_...` nas configurações do seu workspace GEOly e envie-o como `Authorization: Bearer geom_...`.	Sempre somente leitura

Agências e usuários com vários workspaces: uma única conexão pode abranger todos os workspaces aos quais você pertence, ou fixar um com https://app.geoly.ai/api/mcp?org_id=<id> (obtenha IDs da ferramenta list_organizations).

Segurança e acesso a dados

O servidor só lê dados de workspaces que você compartilha explicitamente na tela de consentimento OAuth — nada além desse escopo.
O acesso de gravação é opcional por recurso na tela de consentimento e cobre exatamente 4 ferramentas (criar prompt / tópico / concorrente, acionar monitoramento). Conexões de vários workspaces e tokens estáticos são sempre somente leitura, sem exceções.
Revogue uma conexão a qualquer momento nas configurações do seu workspace GEOly; as credenciais em cache do cliente param de funcionar imediatamente.
O endpoint é HTTP transmitível sem estado sobre TLS. Nada é instalado ou executado na sua máquina.

Ferramentas

Mais de 60 ferramentas. A superfície se adapta ao seu acesso — conexões de marca única pulam as ferramentas de roteamento, conexões somente leitura pulam as ferramentas de gravação.

Monitoramento de marca — visão geral e KPIs (4)

Ferramenta	O que retorna
`get_brand_overview`	KPIs principais: pontuação AIGVR, taxas de menção/citação, estatísticas por plataforma — corresponde aos números no aplicativo
`get_brand_citations_daily`	Tendência diária de AIGVR / taxa de menção / taxa de citação
`query_analytics`	Agregação controlada (sem SQL) sobre conjuntos de dados diários — dimensões, métricas, filtros, subconjuntos de texto de prompt
`resolve_my_brand_public`	Ponte da sua marca monitorada para seu perfil público de inteligência de mercado

Monitoramento de marca — prompts e respostas (8)

Ferramenta	O que retorna
`get_prompt_list`	Pesquisar/listar prompts monitorados com estatísticas de visibilidade
`get_prompt_detail`	Um prompt completo: desempenho por plataforma, AIGVR, participação do modelo, menções de concorrentes
`get_prompt_record_summaries`	Registro de monitoramento mais recente por plataforma para um prompt
`list_prompt_records`	Histórico completo de execução de um prompt em um intervalo de tempo, paginado — trabalho de tendência diária
`get_prompt_record_detail`	Uma resposta de IA monitorada completa: texto, citações, sentimento
`get_prompt_citations`	Citações para um prompt — lista de URLs bruta ou deduplicada com % de participação
`get_prompt_mention_rates`	Taxa de menção por prompt, crescente — descoberta de pontos cegos
`get_brand_search_queries`	Raízes de demanda de fanout de consulta: as pesquisas web reais que a IA executou ao responder seus prompts (ChatGPT, 90 dias)

Monitoramento de marca — citações, domínios e páginas (5)

Ferramenta	O que retorna
`get_citation_overview`	Distribuição de domínios de citação + detalhamento de propriedade na marca
`get_domain_detail`	Perfil de citação de um domínio: tendência, páginas, prompts, plataformas, regiões
`get_page_detail`	Detalhe de citação de uma URL de página: tendência, distribuição de prompts, trechos de texto
`get_url_reference_detail`	Referências de uma URL em citações e fontes de pesquisa
`get_content_opportunities`	Análise de lacuna de conteúdo: prompts onde um domínio tem poucas ou nenhuma citação

Monitoramento de marca — concorrentes, tópicos e sentimento (9)

Ferramenta	O que retorna
`get_competitor_list`	Concorrentes rastreados para a marca
`get_competitor_overview`	Comparação de concorrentes entre prompts
`get_competitor_cooccurrence`	Coocorrência de marca + concorrente, com texto de resposta opcional
`get_competitor_polarity`	Veredito de IA: polaridade de preferência por resposta vs cada concorrente (perdemos / empate / vencemos, perda líquida)
`get_platform_matrix`	Matriz de marca + concorrentes × plataforma, ou tópicos × plataforma
`get_topic_analytics`	Análise por tópico: sentimento, concorrentes, tipos de resposta, tendências
`get_sentiment_dashboard`	Distribuição de sentimento, tendências, comparação de plataformas
`get_risk_context_sources`	Veredito de IA: domínios citados super-representados em respostas negativas / mistas, com elevação (janela de 7 dias)
`get_brand_mention_samples`	Respostas de IA recentes mencionando a marca: texto bruto + sentimento + contexto

Auditorias de site e GA4 (4)

Ferramenta	O que retorna
`get_audit_list`	Auditorias de site GEO (diagnósticos de prontidão para IA), histórico paginado
`get_audit_detail`	Uma auditoria completa: pontuações por categoria, problemas críticos/aviso/aprovados
`get_ga4_traffic_data`	Integração GA4: sessões, visualizações de página, distribuição
`get_ga4_page_data`	Nível de página GA4: visualizações, sessões, taxa de rejeição, fontes de tráfego

Inteligência de mercado — resolver e navegar (4)

Ferramenta	O que retorna
`search_public_entities`	Resolvedor de texto livre: marca / categoria / tópico / nome de produto ou domínio → IDs públicos (produtos via `include_products`)
`list_public_topics`	Navegar por tópicos públicos, com filtros de status/pesquisa
`list_public_locales`	Pares válidos {país, idioma} para uma entidade
`get_available_platforms`	Quais plataformas de IA têm dados para um escopo, ordenadas por volume

Inteligência de mercado — tópicos (10)

Ferramenta	O que retorna
`get_public_topic_overview`	Visão geral de um tópico público
`get_public_topic_brand_leaderboard`	Ranking de marcas por participação de menções
`get_public_topic_som_trend`	Tendência diária de participação de menções
`get_public_topic_prompt_matrix`	Mapa de calor de prompt × marca (SoM % por prompt)
`list_public_topic_prompts`	Todos os prompts sob um tópico, com marca líder e participação
`get_public_topic_prompt_detail`	Um prompt: detalhamento por marca, registros recentes, principais domínios de citação
`get_public_topic_record_detail`	Uma resposta de IA pública: texto com trechos, citações, marcas mencionadas
`get_public_topic_citation_domains`	Ranking de domínios de citação para o tópico
`get_public_topic_commerce`	Agregado de comércio: taxa de ativação, estatísticas de preço, canais de varejo
`get_topic_competition_difficulty`	Dificuldade de visibilidade de IA 0–100, como dificuldade de palavra-chave SEO

Inteligência de mercado — marcas (5)

Ferramenta	O que retorna
`get_public_brand`	Uma marca pública em tópicos, facetada: visibilidade, presença, concorrentes, citações, classificação
`get_public_brand_rank_citation`	Rankings do Google AI Overview × citações de IA: cobertura, quatro quadrantes de contagem de pesquisa, deslocadores e detalhe paginado por pesquisa
`get_public_brand_perception`	Perfil de percepção de IA: aspectos canônicos + polaridade + evidências
`get_public_brand_perception_aspect_mentions`	Detalhamento: menções de fonte por trás de um aspecto de percepção
`compare_public_brands`	Comparação lado a lado de 2 a 4 marcas em uma faceta

Inteligência de mercado — categorias, espaço em branco e momentum (3)

Ferramenta	O que retorna
`get_public_category`	Uma categoria de espaço de produto, facetada: ranking, tendência de SoM, tópicos, domínios de citação
`get_category_whitespace`	Mapa de oportunidades: pontos fortes (coberto / líder / próximo / defender) vs oportunidades (priorizar / lacuna / observar)
`get_category_brand_momentum`	Mudança de participação de menções período a período: subidas vs quedas

Inteligência de mercado — consultas de pesquisa de IA (2)

Ferramenta	O que retorna
`get_public_search_queries`	Demanda de busca por IA para um espaço de produto: consultas, temas, panorama de marcas, territórios de demanda
`get_public_search_query_detail`	Detalhamento de uma consulta ou tema: marcas, prompts, principais fontes

Inteligência de mercado — compras (4)

Ferramenta	O que retorna
`list_public_shopping_boards`	O ranking de líderes da prateleira de IA entre categorias: destaques / novatos / entrantes com mudanças de posição semana a semana
`get_public_shopping_product_detail`	Análise completa de IA de um produto: prateleiras, tendência semanal, concorrentes, canais
`list_public_shopping_products`	Visão geral de compras para um recorte de espaço de produto: produtos, canais, faixas de preço
`get_public_shopping_card_detail`	Prévia de um cartão de produto: evidências, tópicos, prompts, ofertas de varejo

Domínios de fontes públicas (3)

Ferramenta	O que retorna
`get_public_sources_overview`	Domínios de fontes mais citados em todos os tópicos públicos, cada um com sua pontuação de DA de IA
`get_public_source_domain_detail`	Um domínio de fonte de citação: cobertura, marcas co-ocorrentes, scorecard completo opcional de DA de IA
`get_public_source_brand_conduit`	Os tópicos em que um domínio de fonte direciona a atenção da IA para uma marca

Ferramentas de escrita (4)

Exigem acesso de escrita concedido na tela de consentimento OAuth. Tokens estáticos e conexões multi-workspace permanecem somente leitura.

Ferramenta	O que faz
`create_prompt`	Criar um novo prompt de monitoramento
`create_topic`	Criar um tópico de prompt
`create_competitor`	Adicionar um concorrente para acompanhar
`trigger_prompt`	Executar monitoramento para um prompt agora (consome créditos)

Relatórios, descoberta e roteamento (5)

Ferramenta	O que retorna
`get_agent_ready_scans`	Histórico de varreduras de Prontidão do Agente para o usuário conectado
`get_agent_ready_scan_detail`	Resultado completo da varredura de Prontidão do Agente por ID
`list_organizations`	Workspaces que a conexão pode acessar (modo multi-workspace)
`list_brands`	Marcas no workspace (modo multi-marca)
`get_current_date`	Hora do servidor, para validação de intervalo de datas

Planos e acesso

Grupo de ferramentas	Disponibilidade
Monitoramento de marca, auditorias, GA4, relatórios	Qualquer workspace GEOly ativo
Inteligência de mercado (tópicos, marcas, categorias, consultas de busca, compras)	Plano Grow e superior
Domínios de fontes públicas	Todas as conexões
Ferramentas de escrita	Acesso de escrita concedido no consentimento OAuth, workspace único

Consultas pesadas de inteligência de mercado podem contar para as cotas do plano, e trigger_prompt consome créditos de monitoramento. Veja www.geoly.ai para planos.

Solução de problemas

A primeira chamada retorna 401 — isso é o handshake OAuth por design; seu cliente deve abrir um navegador. Se não abrir, o cliente não tem suporte a OAuth remoto: faça a ponte com mcp-remote (veja acima).
402 Payment Required — a assinatura do workspace está inativa.
Ferramentas de inteligência de mercado ausentes — os grupos de ferramentas de tópico / marca / categoria / consulta de busca / compras exigem o plano Grow ou superior. (As duas ferramentas de domínio de fontes públicas são separadas e disponíveis em todas as conexões.)
Ferramentas de escrita ausentes — o acesso de escrita não foi concedido no consentimento, você está em um token estático, ou a conexão abrange vários workspaces (escritas são apenas para workspace único). Reautentique e marque as permissões de escrita que você precisa.
Abrir a URL em um navegador mostra 405 — esperado; o endpoint é HTTP transmissível somente POST, não uma página web.

Projetos relacionados

Projeto	O que é
GEOly-Cli	As mesmas ferramentas como CLI, construídas para agentes e CI
agent-skills	Habilidades que ensinam agentes de IA a usar este servidor corretamente
codex-plugins	Marketplace de plugins Codex: este servidor + a habilidade geoly-mcp

Suporte

Este repositório documenta o servidor MCP GEOly hospedado. Problemas com documentação e exemplos de configuração são bem-vindos aqui; para questões de conta, plano ou dados, fale conosco pelo www.geoly.ai.

Licença

Documentação e exemplos neste repositório são licenciados sob MIT. O serviço GEOly em si é um produto comercial.