GEOly

Español | 简体中文

Servidor MCP de GEOly

El servidor MCP remoto oficial para GEOly — visibilidad de marca con IA (GEO) para tu agente. GEOly rastrea cómo se mencionan y citan las marcas en los motores de IA (ChatGPT, Perplexity, Google AI Mode, Google AI Overview, Gemini, Copilot), y este servidor pone esos datos — KPIs de visibilidad, cuota de competidores, fuentes de citas, inteligencia de mercado y auditorías de sitio — directamente en Claude, Cursor, Codex, VS Code o cualquier cliente MCP.

HTTP alojado y transmisible, OAuth en el navegador. Una URL, nada que ejecutar localmente:

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

Lo que tu agente puede hacer

• Obtén los mismos KPIs que ves en la app — puntuación AIGVR, tasa de mención, tasa de citación por plataforma de IA (get_brand_overview), tendencias diarias y agregación controlada sin SQL sobre conjuntos de datos diarios (query_analytics).
• Encuentra puntos ciegos. ¿Qué consultas de compradores nunca mencionan tu marca (get_prompt_mention_rates)? ¿En qué prompts un dominio no logra ser citado (get_content_opportunities)?
• Compara marcas cara a cara — 2–4 marcas lado a lado en visibilidad, presencia, citas y ranking de categoría en todos los motores de IA (compare_public_brands).
• Mapea el espacio en blanco de la categoría — cada tema en una categoría clasificado en fortalezas (cubierto / líder / cercano / defender) y oportunidades (priorizar / brecha / vigilar) para tu marca (get_category_whitespace).
• Sigue el impulso. ¿Quién gana o pierde Cuota de Mención en las respuestas de IA, período tras período (get_category_brand_momentum)?
• Ve la demanda de búsqueda con IA — qué preguntan realmente las personas a la IA en tu espacio de producto, qué marcas ganan esas respuestas y qué territorios de demanda posee cada marca (get_public_search_queries).
• Observa el estante de IA. Qué productos recomienda más la IA en cada categoría, quién sube semana a semana (list_public_shopping_boards) y el perfil completo de IA de cualquier producto individual (get_public_shopping_product_detail).
• Evalúa la dificultad de competencia — una "dificultad de palabras clave para la era de la IA" de 0–100 por tema (get_topic_competition_difficulty).
• Perfila la percepción de IA. ¿Cómo describen los modelos de IA una marca? Aspectos canónicos, polaridad y evidencia textual (get_public_brand_perception).
• Audita la preparación para IA — auditorías GEO del sitio que cubren accesibilidad, datos estructurados, estructura de contenido y verificaciones técnicas (get_audit_detail).

Prueba preguntando

Una vez conectado, pregúntale a tu agente cosas como:

• "¿Qué tan visible fue mi marca en las respuestas de IA en los últimos 30 días y en qué plataforma soy más débil?"
• "¿Qué preguntas de compradores nunca nos mencionan? Clasifícalas por la frecuencia con la que aparecen los competidores en su lugar."
• "Compara la visibilidad de Anker vs Soundcore en la categoría de audio portátil."
• "¿Dónde está el espacio en blanco en mi categoría? ¿Qué temas deberíamos priorizar?"
• "¿Qué dominios citan más los motores de IA en mi industria y estamos en alguno de ellos?"
• "¿Qué productos están subiendo en el estante de compras con IA esta semana — y en qué temas reddit.com dirige la IA hacia mi competidor?"
• "Revisa mi última auditoría GEO del sitio y enumera los problemas críticos."

Inicio rápido

Requisito previo: una cuenta de GEOly con un espacio de trabajo y una marca monitoreada (regístrate y completa la incorporación de la marca primero — un espacio de trabajo nuevo no tiene datos para consultar aún).

Luego: agrega la URL, haz una llamada de herramienta e inicia sesión cuando se abra el navegador. Esa es toda la configuración.

Claude Code

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

Cursor

O agrégalo a ~/.cursor/mcp.json:

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

Claude Desktop

Configuración → Conectores → Agregar conector personalizado, luego pega https://app.geoly.ai/api/mcp como la URL. Claude te guiará a través del consentimiento OAuth en el navegador.

ChatGPT

En la configuración de ChatGPT, habilita el modo desarrollador para conectores, luego agrega un conector personalizado con la URL https://app.geoly.ai/api/mcp y completa el inicio de sesión OAuth. Sí — puedes preguntarle a ChatGPT sobre la visibilidad de tu marca dentro de ChatGPT.

VS Code (GitHub Copilot)

O desde la línea de comandos:

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

Codex CLI

Instala a través del mercado de complementos de GEOly — el complemento registra el servidor remoto y ejecuta el flujo OAuth en la instalación, sin configuración manual necesaria:

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

Windsurf

Configuración → Configuración de MCP:

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

Gemini CLI

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

O en ~/.gemini/settings.json:

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

Cline

Cline admite servidores remotos de forma nativa (nota el streamableHttp en camelCase):

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

Si el flujo del navegador OAuth no se activa en tu versión de Cline, usa el puente mcp-remote a continuación en su lugar.

Cualquier otro cliente MCP

Los clientes sin soporte nativo remoto/OAuth pueden conectarse a través de mcp-remote:

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

CLI de GEOly (terminales y CI)

Las mismas herramientas, empaquetadas como una línea de comandos diseñada para agentes — consulta 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

Autenticación

Vía	Cómo	Acceso
OAuth (predeterminado)	Configura la URL sin credenciales. La primera llamada devuelve un desafío conforme a estándares (metadatos de recurso protegido RFC 9728) que envía a tu cliente a una pantalla de consentimiento del navegador: inicia sesión, elige qué espacios de trabajo compartir y revisa la cuadrícula de permisos.	Concesiones de lectura/escritura por recurso — la lectura está preseleccionada, la escritura permanece desactivada a menos que la marques
Token estático (CI / sin interfaz)	Genera un token geom_... en la configuración de tu espacio de trabajo de GEOly y envíalo como Authorization: Bearer geom_....	Siempre de solo lectura

Agencias y usuarios con múltiples espacios de trabajo: una sola conexión puede abarcar todos los espacios de trabajo a los que perteneces, o fijar uno con https://app.geoly.ai/api/mcp?org_id=<id> (obtén los IDs de la herramienta list_organizations).

Seguridad y acceso a datos

• El servidor solo lee datos de los espacios de trabajo que compartes explícitamente en la pantalla de consentimiento OAuth — nada más allá de ese alcance.
• El acceso de escritura es opcional por recurso en la pantalla de consentimiento y cubre exactamente 4 herramientas (crear prompt / tema / competidor, activar monitoreo). Las conexiones de múltiples espacios de trabajo y los tokens estáticos son siempre de solo lectura, sin excepciones.
• Revoca una conexión en cualquier momento desde la configuración de tu espacio de trabajo de GEOly; las credenciales almacenadas en caché del cliente dejan de funcionar inmediatamente.
• El endpoint es HTTP transmisible sin estado sobre TLS. No se instala ni ejecuta nada en tu máquina.

Herramientas

Más de 60 herramientas. La superficie se adapta a tu acceso — las conexiones de una sola marca omiten las herramientas de enrutamiento, las conexiones de solo lectura omiten las herramientas de escritura.

Monitoreo de marca — resumen y KPIs (4)

Herramienta	Qué devuelve
get_brand_overview	KPIs principales: puntuación AIGVR, tasas de mención/citación, estadísticas por plataforma — coincide con los números de la app
get_brand_citations_daily	Tendencia diaria de AIGVR / tasa de mención / tasa de citación
query_analytics	Agregación controlada (sin SQL) sobre conjuntos de datos diarios — dimensiones, métricas, filtros, subconjuntos de texto de prompts
resolve_my_brand_public	Puente desde tu marca monitoreada hasta su perfil público de inteligencia de mercado

Monitoreo de marca — prompts y respuestas (8)

Herramienta	Qué devuelve
get_prompt_list	Buscar/enumerar prompts monitoreados con estadísticas de visibilidad
get_prompt_detail	Un prompt completo: rendimiento por plataforma, AIGVR, Cuota de Modelo, menciones de competidores
get_prompt_record_summaries	Último registro de monitoreo por plataforma para un prompt
list_prompt_records	Historial completo de ejecución de un prompt en un rango de tiempo, paginado — trabajo de tendencias diarias
get_prompt_record_detail	Una respuesta de IA monitoreada completa: texto, citas, sentimiento
get_prompt_citations	Citas para un prompt — lista de URLs cruda o deduplicada con porcentaje de participación
get_prompt_mention_rates	Tasa de mención por prompt, ascendente — descubrimiento de puntos ciegos
get_brand_search_queries	Raíces de demanda de expansión de consultas: las búsquedas web reales que la IA ejecutó al responder tus prompts (ChatGPT, 90 días)

Monitoreo de marca — citas, dominios y páginas (5)

Herramienta	Qué devuelve
get_citation_overview	Distribución de dominios de citas + desglose de propiedad en toda la marca
get_domain_detail	Perfil de citas de un dominio: tendencia, páginas, prompts, plataformas, regiones
get_page_detail	Detalle de citas de una URL de página: tendencia, distribución de prompts, fragmentos de texto
get_url_reference_detail	Referencias de una URL en citas y fuentes de búsqueda
get_content_opportunities	Análisis de brechas de contenido: prompts donde un dominio tiene citas bajas o nulas

Monitoreo de marca — competidores, temas y sentimiento (9)

Herramienta	Qué devuelve
get_competitor_list	Competidores rastreados para la marca
get_competitor_overview	Comparación de competidores entre prompts
get_competitor_cooccurrence	Co-ocurrencia de marca + competidor, con texto de respuesta opcional
get_competitor_polarity	Veredicto de IA: polaridad de preferencia por respuesta frente a cada competidor (perdemos / empate / ganamos, pérdida neta)
get_platform_matrix	Matriz de marca + competidores × plataforma, o temas × plataforma
get_topic_analytics	Análisis por tema: sentimiento, competidores, tipos de respuesta, tendencias
get_sentiment_dashboard	Distribución de sentimiento, tendencias, comparación de plataformas
get_risk_context_sources	Veredicto de IA: dominios citados sobrerrepresentados en respuestas negativas / mixtas, con elevación (ventana de 7 días)
get_brand_mention_samples	Respuestas de IA recientes que mencionan la marca: texto crudo + sentimiento + contexto

Auditorías de sitio y GA4 (4)

Herramienta	Qué devuelve
get_audit_list	Auditorías GEO del sitio (diagnósticos de preparación para IA), historial paginado
get_audit_detail	Una auditoría completa: puntuaciones por categoría, problemas críticos/advertencias/superados
get_ga4_traffic_data	Integración GA4: sesiones, vistas de página, distribución
get_ga4_page_data	Nivel de página GA4: vistas, sesiones, tasa de rebote, fuentes de tráfico

Inteligencia de mercado — resolver y navegar (4)

Herramienta	Qué devuelve
search_public_entities	Resolvedor de texto libre: marca / categoría / tema / nombre de producto o dominio → IDs públicos (productos vía include_products)
list_public_topics	Navegar temas públicos, con filtros de estado/búsqueda
list_public_locales	Pares válidos {país, idioma} para una entidad
get_available_platforms	Qué plataformas de IA tienen datos para un alcance, ordenadas por volumen

Inteligencia de mercado — temas (10)

Herramienta	Qué devuelve
get_public_topic_overview	Resumen de un tema público
get_public_topic_brand_leaderboard	Tabla de líderes de marcas clasificadas por Cuota de Mención
get_public_topic_som_trend	Tendencia diaria de Cuota de Mención
get_public_topic_prompt_matrix	Mapa de calor prompt × marca (porcentaje de SoM por prompt)
list_public_topic_prompts	Cada prompt bajo un tema, con marca líder y participación
get_public_topic_prompt_detail	Un prompt: desglose por marca, registros recientes, dominios de citas principales
get_public_topic_record_detail	Una respuesta de IA pública: texto con fragmentos, citas, marcas mencionadas
get_public_topic_citation_domains	Tabla de líderes de dominios de citas para el tema
get_public_topic_commerce	Agregado de comercio: tasa de activación, estadísticas de precios, canales minoristas
get_topic_competition_difficulty	Dificultad de visibilidad de IA 0–100, como la dificultad de palabras clave SEO

Inteligencia de mercado — marcas (5)

Herramienta	Qué devuelve
get_public_brand	Una marca pública en todos los temas, facetada: visibilidad, presencia, competidores, citas, ranking
get_public_brand_rank_citation	Rankings de Google AI Overview × citas de IA: cobertura, cuatro cuadrantes de conteo de búsquedas, desplazadores y detalle paginado por búsqueda
get_public_brand_perception	Perfil de percepción de IA: aspectos canónicos + polaridad + evidencia
get_public_brand_perception_aspect_mentions	Profundización: menciones de fuentes detrás de un aspecto de percepción
compare_public_brands	Comparación lado a lado de 2–4 marcas en una faceta

Inteligencia de mercado — categorías, espacio en blanco y impulso (3)

Herramienta	Qué devuelve
get_public_category	Una categoría de espacio de producto, facetada: tabla de líderes, tendencia de SoM, temas, dominios de citas
get_category_whitespace	Mapa de oportunidades: fortalezas (cubierto / líder / cercano / defender) vs oportunidades (priorizar / brecha / vigilar)
get_category_brand_momentum	Cambio de Cuota de Mención período tras período: ascendentes vs descendentes

Inteligencia de mercado — consultas de búsqueda con IA (2)

Herramienta	Qué devuelve
get_public_search_queries	Demanda de búsqueda con IA para un espacio de producto: consultas, temas, panorama de marcas, territorios de demanda
get_public_search_query_detail	Desglose de una consulta o tema: marcas, prompts, fuentes principales

Inteligencia de mercado — compras (4)

Herramienta	Qué devuelve
list_public_shopping_boards	El ranking de líderes de IA en el estante entre categorías: populares / emergentes / nuevos con cambios de posición semanales
get_public_shopping_product_detail	Análisis completo de IA de un producto: estantes, tendencia semanal, rivales, canales
list_public_shopping_products	Resumen de compras para un segmento de espacio de producto: productos, canales, rangos de precios
get_public_shopping_card_detail	Vista previa de una tarjeta de producto: evidencia, temas, prompts, ofertas minoristas

Dominios de fuentes públicas (3)

Herramienta	Qué devuelve
get_public_sources_overview	Dominios de fuentes más citados en todos los temas públicos, cada uno con su puntuación de DA de IA
get_public_source_domain_detail	Un dominio de fuente de citas: cobertura, marcas co-ocurrentes, tarjeta de puntuación completa de DA de IA opcional
get_public_source_brand_conduit	Los temas donde un dominio de fuente dirige la atención de IA hacia una marca

Herramientas de escritura (4)

Requieren acceso de escritura otorgado en la pantalla de consentimiento de OAuth. Los tokens estáticos y las conexiones de múltiples espacios de trabajo permanecen de solo lectura.

Herramienta	Qué hace
create_prompt	Crear un nuevo prompt de monitoreo
create_topic	Crear un tema de prompt
create_competitor	Añadir un competidor para rastrear
trigger_prompt	Ejecutar monitoreo para un prompt ahora (consume créditos)

Informes, descubrimiento y enrutamiento (5)

Herramienta	Qué devuelve
get_agent_ready_scans	Historial de escaneos de Agent Readiness para el usuario conectado
get_agent_ready_scan_detail	Resultado completo del escaneo de Agent Readiness por ID
list_organizations	Espacios de trabajo a los que la conexión puede acceder (modo de múltiples espacios de trabajo)
list_brands	Marcas en el espacio de trabajo (modo de múltiples marcas)
get_current_date	Hora del servidor, para validación de rangos de fechas

Planes y acceso

Grupo de herramientas	Disponibilidad
Monitoreo de marcas, auditorías, GA4, informes	Cualquier espacio de trabajo activo de GEOly
Inteligencia de mercado (temas, marcas, categorías, consultas de búsqueda, compras)	Plan Grow y superior
Dominios de fuentes públicas	Todas las conexiones
Herramientas de escritura	Acceso de escritura otorgado en el consentimiento de OAuth, espacio de trabajo único

Las consultas pesadas de inteligencia de mercado pueden contar para las cuotas del plan, y trigger_prompt consume créditos de monitoreo. Consulta www.geoly.ai para los planes.

Solución de problemas

• La primera llamada devuelve 401 — eso es el apretón de manos de OAuth por diseño; tu cliente debería abrir un navegador. Si no lo hace, el cliente carece de soporte de OAuth remoto: puentea con mcp-remote (ver arriba).
• 402 Pago requerido — la suscripción del espacio de trabajo está inactiva.
• Faltan herramientas de inteligencia de mercado — los grupos de herramientas de tema / marca / categoría / consulta de búsqueda / compras requieren el plan Grow o superior. (Las dos herramientas de dominios de fuentes públicas son separadas y están disponibles en todas las conexiones).
• Faltan herramientas de escritura — el acceso de escritura no se otorgó en el consentimiento, estás en un token estático, o la conexión abarca múltiples espacios de trabajo (las escrituras son solo de espacio de trabajo único). Re-autentica y marca las permisos de escritura que necesites.
• Abrir la URL en un navegador muestra 405 — es esperado; el endpoint es HTTP de flujo solo POST, no una página web.

Proyectos relacionados

Proyecto	Qué es
GEOly-Cli	Las mismas herramientas como CLI, construido para agentes y CI
agent-skills	Habilidades que enseñan a los agentes de IA a usar este servidor correctamente
codex-plugins	Mercado de plugins de Codex: este servidor + la habilidad geoly-mcp

Soporte

Este repositorio documenta el servidor MCP alojado de GEOly. Los problemas con la documentación y ejemplos de configuración son bienvenidos aquí; para preguntas sobre cuentas, planes o datos, contáctanos a través de www.geoly.ai.

Licencia

La documentación y los ejemplos en este repositorio están licenciados bajo MIT. El servicio GEOly en sí es un producto comercial.

---

www.geoly.ai · GEOly CLI · © GEOly