FlexQueries SEO MCP

Investigación SEO de pago por uso, backlinks, rankings, auditorías de sitios y visibilidad en IA para clientes de IA compatibles.

Ver en flexqueries.com

Servidor MCP alojado

npx add-mcp 'https://app.flexqueries.com/mcp'

Se instala en Claude Code, Codex, Cursor y más

Documentación

Volver a la documentación

Configurar FlexQueries MCP

Conecta FlexQueries MCP a Claude, ChatGPT, Codex, Cursor, Antigravity, VS Code y Gemini CLI.

FlexQueries MCP permite que clientes de IA compatibles llamen a las mismas herramientas conscientes del proyecto disponibles en la aplicación. Esto incluye investigación de palabras clave y tendencias, SERPs actuales e históricos, dominios y competidores, backlinks, tiendas de aplicaciones, Amazon, visibilidad de IA, investigación local y de comercio, auditorías, seguimiento de rankings, Content Studio, informes de proyectos y datos conectados de Google Search Console y Google Analytics.

La URL del servidor MCP alojado es:

https://app.flexqueries.com/mcp

La primera conexión te envía a través del inicio de sesión de FlexQueries. Después de la autorización, tu cliente MCP puede llamar a las herramientas de FlexQueries con el contexto del proyecto y los alcances de cuenta que aprobaste.

Para el flujo de configuración actual y un endpoint copiable, abre la guía de FlexQueries MCP.

¿API REST o MCP?

Usa MCP para flujos de trabajo conversacionales con agentes. La API REST, versionada por separado, admite 37 operaciones acotadas de investigación/generación, además de lecturas de datos guardados con alcance, trabajos nativos, informes de Google conectados y escrituras de configuración/informes compatibles. REST usa una clave bearer del espacio de trabajo, no tu token OAuth de MCP; ambos aplican los permisos actuales del proyecto y el mismo saldo de pago por uso. Lee el catálogo actual y obtén una cotización antes de comenzar trabajo de pago.

Trabajo guardado y monitoreo de prompt exacto

Usa suggest_monitoring_prompts para plantillas de temas editables y no medidas. Las palabras clave guardadas y las preguntas de clientes pueden proporcionar entradas más específicas. Para investigación fresca de conjuntos de datos de ChatGPT en inglés de EE. UU., llama a quote_prompt_discovery, revisa el precio, luego usa research_prompt_questions con un idempotencyKey persistido y el límite confirmado. El enriquecimiento opcional de páginas de resultados hace una solicitud acotada; lee la advertencia de cobertura si falla. Los valores de demanda del conjunto de datos son estimaciones. Investigar o agregar una pregunta no recopila respuestas de monitoreo.

quote_prompt_monitor calcula el límite de uso por ejecución actual y la retención temporal. create_prompt_monitor guarda una colección; run_prompt_monitor inicia verificaciones de pago contra sus superficies de búsqueda seleccionadas y modelos de API etiquetados. Confirma la cotización antes de una ejecución manual o una autorización recurrente. Las respuestas de la API de Claude/Perplexity no son observaciones de búsqueda de aplicaciones de consumo; sus preguntas están limitadas a 500 caracteres.

Pasa measurement para revisar la entrega Estándar o en Vivo, de una a tres muestras, búsqueda de ChatGPT natural o forced, y answerAnalysisEnabled opcional. Los monitores de búsqueda forzada existentes permanecen forzados hasta que se editen. El límite es de 150 verificaciones de prompt/motor/muestra por ejecución. Después de guardar una colección, llama a quote_prompt_monitor con su configId para obtener un quoteToken vinculado a la revisión, válido por 15 minutos. Envía ese token, el límite de autorización revisado y un idempotencyKey estable a run_prompt_monitor. Una estimación de configuración de inventario no es una autorización de ejecución. Los cambios en la configuración requieren una nueva cotización.

Para etiquetas de modelo opcionales, usa quote_prompt_answer_analysis, verifica enabled, luego aprueba explícitamente analyze_prompt_monitor_answer para una observación guardada. Hace una llamada acotada y sin herramientas a través de las marcas congeladas de la ejecución. Las etiquetas pueden ser incorrectas; las cotizaciones guardadas y los rangos de evidencia permanecen disponibles para revisión. Las interpretaciones anteriores permanecen versionadas, y una nueva versión requiere una nueva acción aprobada.

Usa quote_prompt_source_research antes de research_prompt_sources. Verifica enabled; la interpretación opcional también necesita interpretationEnabled. Selecciona de 1 a 20 URL públicas sin firmar ya observadas en una ejecución guardada propia; analyze agrega interpretación de página con precio separado. Lee instantáneas fechadas a través de list_prompt_source_snapshots y get_prompt_source_snapshot, luego crea opcionalmente un borrador privado gratuito con create_prompt_source_opportunity. Las lecturas y borradores nunca obtienen páginas, llaman a un modelo, envían divulgación o publican cambios.

append_prompt_monitor agrega temas y prompts después de una nueva revisión de precios. set_prompt_monitor_prompt archiva o restaura una pregunta sin eliminar su historial. update_prompt_monitor pausa, reanuda, archiva o cambia su frecuencia usando la revisión actual. get_prompt_monitor_history devuelve la cobertura guardada y los recuentos de citas; get_prompt_monitor_answer devuelve una respuesta completa con sus fuentes. Estas lecturas guardadas son gratuitas. Las verificaciones fallidas y no activadas no son observaciones de marcas ausentes.

update_prompt_monitor_inventory mueve, pausa/reanuda o archiva/restaura una selección explícita de hasta 25 IDs de prompt; rename_prompt_monitor_topic preserva las etiquetas de temas históricos. Ambos requieren la revisión actual. Reanudar/restaurar requiere revisión del nuevo límite futuro. edit_prompt_monitor_text crea una nueva versión semántica mientras conserva el prompt y las respuestas anteriores. get_prompt_monitor_aliases y set_prompt_monitor_aliases leen/confirman nombres de marca alternativos para verificaciones futuras. Estos guardados son gratuitos y no inician la recopilación.

get_prompt_monitor_sources agrupa la ejecución de citas guardada completa antes de la paginación firmada y proporciona IDs de respuestas de apoyo. get_prompt_monitor_trends devuelve tasas separadas de menciones escritas/citas, cambios de período coincidente de igual peso y cobertura. Los cambios requieren un 90% de respuestas utilizables en ambos períodos. reanalyze_prompt_monitor_run crea una interpretación gratuita idempotente a partir de respuestas retenidas e identidades objetivo congeladas; las afirmaciones originales permanecen sin cambios. La evidencia de menciones escritas heredadas es desconocida hasta que exista un reanálisis compatible.

list_saved_reports y get_saved_report leen instantáneas de informes existentes. Un gerente puede usar create_saved_report_share con confirmedPublic: true y una caducidad de uno a 30 días, luego listar metadatos o revocar acceso con list_saved_report_shares y revoke_saved_report_share. Obtén el permiso del usuario antes de exponer un informe a través de un enlace bearer público.

Las herramientas de seguimiento de rankings admiten configuraciones de zona horaria/hora del calendario y pin_rank_tracking_keywords. Las auditorías de sitios aceptan renderizado opcional de JavaScript y una ID de autorización de rastreador de Shopify guardada y vinculada al dominio. El renderizado cambia la cotización; las credenciales permanecen en el servidor. Consulta opciones de monitoreo e investigación para límites y detalles de facturación.

Usa reconcile_rank_check para hasta tres tareas de ranking compradas previamente o respuestas de ranking retenidas, o reconcile_prompt_monitor_run para hasta dos verificaciones de prompt retenidas. Estas acciones gratuitas usan la tarea original y las identidades de crédito. Nunca compran reemplazos. Los envíos desconocidos permanecen reservados para revisión; revisa una cotización separada de dispositivo faltante solo después de la reconciliación de estado final.

Usa MCP para un cliente de IA interactivo y la API REST del cliente para scripts e integraciones. Las claves REST y los tokens MCP son credenciales separadas. Ambos usan el saldo del espacio de trabajo del proyecto seleccionado y precios compartidos. REST ofrece operaciones acotadas de investigación/generación, además de gestión de proyectos, trabajos nativos, aprobación recurrente, webhooks de finalización firmados, exportaciones, rutas guardadas/planificación y Content Studio, informes y configuración de seguimiento. No expone todas las herramientas MCP. Consulta la referencia completa de herramientas MCP o descarga esquemas de descubrimiento.

Antes de conectar

Inicia sesión en FlexQueries y crea o elige un proyecto. Copia la URL del servidor en el campo de conexión remota / HTTP Streamable de tu cliente:

https://app.flexqueries.com/mcp

Las conexiones alojadas usan OAuth basado en navegador. No necesitas crear una clave de API ni ingresar un ID de cliente OAuth o secreto. Aprueba la cuenta de FlexQueries que planeas usar, luego regresa a tu cliente y habilita sus herramientas. Las tarifas del cliente son separadas del uso de FlexQueries.

Un cliente autorizado solo puede usar proyectos aprobados dentro de los permisos del espacio de trabajo de esa cuenta. No recibe acceso directo a la base de datos ni credenciales de Google. Las aprobaciones de nuevas conexiones se establecen por defecto en lecturas de datos guardados, con investigación y escrituras desactivadas. Para flujos de trabajo SEO completos, elige Habilitar flujo completo para seleccionar investigación de pago, cambios en trabajo guardado y acceso a todos los proyectos actuales y futuros en el espacio de trabajo. Usa esto solo para un cliente de confianza, revisa los límites de gasto y luego selecciona Autorizar. Puedes mantener acceso de solo lectura o elegir proyectos específicos. Edita permisos y límites o revoca el acceso en Configuración → Clientes MCP conectados.

FlexQueries verifica el acceso actual antes de que una herramienta comience y nuevamente antes de devolver resultados privados. Eliminar el acceso al proyecto, deshabilitar escrituras o revocar una conexión puede retener una respuesta que ya se estaba preparando. El trabajo completado antes de la revocación permanece guardado y mantiene su cargo normal; la revocación no revierte ese trabajo. Inspecciona el historial guardado o el ID de operación original después de restaurar el acceso en lugar de comprar un reemplazo. Las listas de proyectos también verifican el acceso a cada proyecto devuelto.

Para una instancia autoalojada, reemplaza esta URL con la URL /mcp de tu instancia y usa su autenticación configurada. Los clientes en la nube, como los conectores remotos de Claude y ChatGPT, necesitan un endpoint accesible públicamente; una URL de localhost en tu computadora no funcionará para ellos.

Claude Desktop, Claude.ai y Cowork

Abre Personalizar → Conectores.
Selecciona + → Agregar conector personalizado y nómbralo FlexQueries.
En el campo de URL del servidor MCP remoto, pega https://app.flexqueries.com/mcp, luego selecciona Agregar.
Selecciona Conectar si se te solicita. Completa el inicio de sesión en el navegador de FlexQueries y aprueba el acceso.
Regresa a tu conversación, habilita FlexQueries en el menú Conectores y elige qué herramientas puede ejecutar Claude.

Las cuentas gratuitas tienen un espacio de conector personalizado. En Team y Enterprise, el propietario de la organización debe agregar el conector primero. Los conectores remotos usan la nube de Anthropic, incluso en la aplicación de escritorio. Consulta la guía de conectores personalizados de Claude.

Para un recorrido con capturas de pantalla y una primera ejecución de investigación, lee la guía de configuración SEO de Claude.

Claude Code

Con Claude Code instalado, ejecuta:

claude mcp add --transport http --scope user flexqueries https://app.flexqueries.com/mcp

Inicia o reinicia Claude Code, ejecuta /mcp, selecciona flexqueries y autentícate. Completa el inicio de sesión en el navegador, regresa a Claude Code y verifica el estado de la conexión con /mcp. El alcance de usuario comparte la conexión entre tus proyectos; usa el alcance local si debe aplicarse solo al repositorio actual. Consulta la guía MCP de Claude Code.

ChatGPT

Abre Configuración → Seguridad e inicio de sesión y habilita Modo desarrollador, si está disponible para tu cuenta y espacio de trabajo.
Abre Plugins, selecciona el botón de más e ingresa FlexQueries como nombre con una descripción como “Herramientas de investigación SEO y proyectos”.
En Conexión, elige un endpoint público e ingresa https://app.flexqueries.com/mcp.
Crea la conexión y completa el inicio de sesión en el navegador de FlexQueries. Revisa las herramientas descubiertas.
Inicia una nueva conversación y agrega FlexQueries desde el menú de herramientas.

Después de que FlexQueries publique nuevas herramientas, usa Actualizar en la conexión en Plugins e inicia una nueva conversación. Consulta la guía de conexión de OpenAI.

Codex CLI

Con Codex CLI instalado, ejecuta ambos comandos:

codex mcp add flexqueries --url https://app.flexqueries.com/mcp
codex mcp login flexqueries

Aprueba el acceso en el navegador. Inicia una nueva sesión de Codex y ejecuta /mcp para verificar la conexión. codex mcp list también muestra los servidores configurados. Consulta la guía MCP de OpenAI.

Codex Desktop y extensión IDE

En la aplicación de escritorio, abre Configuración → Servidores MCP. En la extensión IDE de Codex, abre su menú de engranaje → Servidores MCP.
Selecciona Agregar servidor, nómbralo FlexQueries y elige HTTP Streamable.
Pega https://app.flexqueries.com/mcp en el campo de URL y guarda.
Reinicia el servidor o la extensión, selecciona Autenticar y completa el inicio de sesión en el navegador de FlexQueries.
Inicia una nueva sesión y verifica que FlexQueries esté habilitado.

La CLI, la aplicación de escritorio y la extensión IDE comparten configuración en el mismo host. Si ya agregaste FlexQueries con la CLI, usa esa conexión existente. Consulta la guía MCP de OpenAI.

Cursor

Fusiona esta entrada en mcpServers dentro de ~/.cursor/mcp.json para todos los proyectos, o en .cursor/mcp.json para un solo proyecto. Conserva cualquier servidor existente:

{
  "mcpServers": {
    "flexqueries": {
      "url": "https://app.flexqueries.com/mcp"
    }
  }
}

Guarda, habilita FlexQueries en la configuración de MCP de Cursor y completa el inicio de sesión en el navegador cuando se te solicite. Inicia un chat de agente y confirma que las herramientas estén disponibles. Consulta la guía de MCP de Cursor.

Google Antigravity

En el panel de agente del IDE, abre … → MCP Servers → Manage MCP Servers → View raw config.
Fusiona la configuración a continuación en mcpServers, conservando las entradas existentes, y guarda.
Actualiza la lista de servidores y habilita flexqueries. Antigravity detecta OAuth de FlexQueries automáticamente; completa el inicio de sesión en el navegador cuando se te solicite.
Vuelve al agente y verifica que sus herramientas de FlexQueries estén habilitadas. En la CLI de Antigravity, /mcp abre el administrador para ver el estado de la conexión y recargar.

{
  "mcpServers": {
    "flexqueries": {
      "serverUrl": "https://app.flexqueries.com/mcp"
    }
  }
}

Las versiones actuales de Antigravity usan ~/.gemini/config/mcp_config.json globalmente o .agents/mcp_config.json por espacio de trabajo. Usa el archivo abierto por tu versión instalada. Antigravity requiere serverUrl, no url ni httpUrl; no se necesitan credenciales OAuth manuales para FlexQueries. Consulta la guía de MCP de Antigravity de Google.

VS Code

Abre la Paleta de comandos y ejecuta MCP: Add Server.
Elige HTTP, pega https://app.flexqueries.com/mcp, nómbralo flexqueries y elige Workspace o Global.
Inicia el servidor, aprueba la confianza y completa el inicio de sesión de FlexQueries en el navegador cuando se te solicite.
Abre el chat de IA de tu editor en modo Agente y habilita FlexQueries a través de Configure Tools.

Alternativamente, fusiona esta entrada en .vscode/mcp.json. Para la configuración global, ejecuta MCP: Open User Configuration:

{
  "servers": {
    "flexqueries": {
      "type": "http",
      "url": "https://app.flexqueries.com/mcp"
    }
  }
}

VS Code usa servers en este archivo, no mcpServers. Consulta la guía de MCP de VS Code.

Gemini CLI

Fusiona esta entrada en mcpServers dentro de ~/.gemini/settings.json o en el .gemini/settings.json de tu proyecto, conservando otras configuraciones y servidores:

{
  "mcpServers": {
    "flexqueries": {
      "httpUrl": "https://app.flexqueries.com/mcp"
    }
  }
}

Inicia o reinicia Gemini CLI, luego ejecuta /mcp auth flexqueries y aprueba el inicio de sesión en el navegador. Usa /mcp list para verificar la conexión y las herramientas. Gemini CLI usa httpUrl para Streamable HTTP. Consulta la guía de MCP de Gemini CLI.

Verifica tu conexión

Envía este mensaje después de la configuración:

Use FlexQueries whoami to verify my account, then list_projects to show my projects and their IDs. Do not run paid research yet.

Estas verificaciones no usan saldo de FlexQueries. Usa un ID de proyecto devuelto para las herramientas posteriores. Conecta Search Console o GA4 en el panel de ese proyecto antes de solicitar sus datos de primera parte. La página Conectar un agente de IA con sesión iniciada lista las herramientas actualmente registradas; tu cliente también puede leer el esquema actual de entrada y salida de cada herramienta durante el descubrimiento.

Facturación y permisos

FlexQueries no tiene suscripción ni tarifa por asiento. Las cuentas nuevas elegibles reciben $1 de saldo inicial, y puedes agregar créditos en Facturación cuando necesites más. Search Console, informes de GA4 conectados y lecturas de datos de proyecto almacenados no usan tu saldo de FlexQueries. Las tarifas del cliente de IA o del proveedor de modelos son separadas.

La guía de facturación explica las retenciones temporales de saldo, el trabajo fallido y parcial, las recargas y los impuestos de pago. Un resultado válido adquirido sin coincidencias puede seguir siendo facturable; la falta de datos no significa automáticamente que la operación falló.

Las llamadas MCP medidas, incluida la investigación de datos, los resúmenes de contenido generados y los trabajos de auditoría, gastan del mismo saldo que la aplicación. El servidor reserva suficiente saldo disponible antes de que comience el trabajo del proveedor de pago y liquida el costo final según el uso. Si el saldo disponible no puede cubrir la solicitud, la llamada se detiene antes de que comience ese trabajo. Una llamada puede generar un cargo cuando tu agente la invoca; no abre una pantalla de confirmación separada de la aplicación. Configura las preferencias de confirmación de herramientas de tu agente y usa el estimador de precios para planificar la carga de trabajo.

Los límites de espacio de trabajo, miembros y proyectos se aplican junto con los límites de conexión MCP. Los topes de REST son separados. Deja la recarga automática desactivada si la billetera financiada debe ser el tope de financiamiento duro. El trabajo recurrente puede gastar más tarde, así que confirma su alcance, tope y frecuencia antes de habilitarlo.

Controles de conexión

Aprueba proyectos seleccionados (o todos los proyectos actuales/futuros), investigación de pago y cambios de trabajo guardado/configuración por separado. El permiso de investigación no otorga escrituras guardadas. Iniciar un trabajo aún requiere el rol de espacio de trabajo relevante, la autoridad del proyecto y el saldo disponible. Los controles se comparten entre todas las concesiones OAuth para el mismo cliente, usuario y espacio de trabajo; autorizar otra conexión para ese cliente no restablece el gasto.

El consentimiento identifica al cliente registrado y al espacio de trabajo seleccionado antes de la aprobación. La recomendación de flujo completo es opcional; los permisos no se habilitan sin tu aprobación. Las listas de configuración pueden cargar conexiones y proyectos adicionales. Cancelar descarta las ediciones de permisos no guardadas. Una solicitud de conexión fallida se puede reintentar, y rechazar no requiere un formulario de gasto válido.

Las nuevas políticas muestran $10 por acción, $20 por día UTC y $100 por mes UTC como valores predeterminados editables, pero la investigación está desactivada hasta que se apruebe. Puedes agregar un tope de por vida. Los cargos liquidados y las retenciones activas cuentan para los límites. Reducir un tope o revocar una conexión detiene el nuevo envío, no la liquidación del trabajo ya aprobado. Los hijos en segundo plano y los programas patrocinados por MCP siguen sujetos a la política de la conexión de origen. Las conexiones existentes conservan su acceso anterior sin nuevos topes hasta que se editen o se vuelvan a autorizar; revísalas en Configuración.

La admisión de MCP está limitada a 60 llamadas por cliente/minuto, 120 por espacio de trabajo/minuto y dos llamadas activas por cliente. Las cuotas de infraestructura se aplican también a las llamadas gratuitas. Los límites no reemplazan la configuración de confirmación del propio cliente de IA.

Inicios seguros para reintentos y archivos

Persiste idempotencyKey (16–128 letras, números, guiones o guiones bajos) antes de run_site_audit, run_rank_check, run_aio_monitor, run_prompt_monitor, research_prompt_questions, create_local_review_search o create_merchant_product_search, y antes de crear/actualizar/archivar/restaurar proyectos. Los clientes externos deben proporcionarlo. Reutiliza la identidad y las entradas exactas después de una respuesta perdida. El _meta.operationId del recibo se puede leer con get_agent_operation bajo la misma conexión; esto nunca inicia trabajo de reemplazo. Las herramientas nativas de estado/historial de funciones devuelven resultados guardados. La retención de cargas útiles es de siete días; una identidad vencida no se vuelve ejecutable.

Los reintentos y las lecturas de recibos vuelven a verificar los permisos actuales de espacio de trabajo, proyecto y conexión. Los inicios interrumpidos pueden recuperar un reconocimiento de trabajo nativo guardado sin volver a enviar. Si no existe un reconocimiento confiable, el intento se convierte en indeterminate: inspecciona los trabajos de funciones guardados antes de aprobar un reemplazo. Un reconocimiento confirma el trabajo guardado, no su finalización exitosa. Las fallas registradas siguen siendo fallas incluso si su carga útil de respuesta ya no se conserva.

create_project, update_project, archive_project, restore_project y list_archived_projects requieren rol de gestión y permisos de conexión apropiados; la gestión de proyectos requiere acceso a todos los proyectos. Debe permanecer al menos un proyecto activo. get_google_connections proporciona enlaces de panel seguros para consentimiento humano, no tokens. query_analytics acepta entradas acotadas de fecha/métrica/dimensión/paginación y conserva celdas faltantes/indicadores de privacidad.

export_saved_report devuelve un PDF base64, DOCX o CSV de una tabla desde una instantánea existente sin actualización de pago. Su respuesta incluye tipo MIME, nombre de archivo, longitud en bytes, fecha de instantánea y secciones omitidas. Las descargas están limitadas a 700 KB; las secciones heredadas derivadas de Google se excluyen porque la instantánea guardada carece de procedencia de conexión. Usa las exportaciones del panel para archivos más grandes.

Herramientas de planificación y monitoreo

MCP puede organizar Páginas y objetivos de palabras clave guardados, vincular briefs/Oportunidades existentes, leer resultados orgánicos y referencias de IA, gestionar controles de monitoreo compatibles, registrar/aprobar/verificar propuestas, configurar la entrega de informes aprobados y procesar importaciones de CSV solo de persistencia. Estas usan las concesiones de proyecto actuales. El acceso de visor permite lecturas guardadas, no trabajo de pago ni ediciones. Consulta flujos de trabajo de proyecto y acceso al espacio de trabajo.

Competitor Watch proporciona quote_competitor_watch, create_competitor_watch, update_competitor_watch, run_competitor_watch, set_competitor_watch_active, get_competitor_watch y get_competitor_watch_run. Cita el alcance exacto primero; la creación/inicio requiere el tope confirmado. El monitoreo semanal es opcional y tiene un tope mensual separado. Las herramientas de lectura/historial no actualizan la investigación. Los hallazgos del panel se pueden guardar en Oportunidades o descartarse.

La investigación guiada de oportunidades proporciona get_opportunities, quote_opportunity_research, start_opportunity_research y get_opportunity_research. Cita usando projectId, budgetCredits (1,000 créditos = $1; cero significa solo datos guardados; máximo 10,000) y un focus opcional de balanced, content, links, ai o local. Muestra las verificaciones devueltas, la estimación, la retención temporal y las advertencias al usuario antes de solicitar aprobación. Inicia con el quoteKey exacto, el tope, el enfoque y un UUID estable idempotencyKey. Después de un error de red, reutiliza esa clave; consulta el runId guardado en lugar de iniciar otro trabajo de pago.

El trabajo reutiliza la evidencia de proyecto guardada, compra solo investigación acotada aprobada y conserva sus resultados en Oportunidades. El uso exitoso se liquida de la retención; el resto se libera. Las búsquedas vacías válidas pueden costar créditos, las verificaciones no disponibles no se recompran automáticamente y la medición de primera parte requiere acceso de Google coincidente. El Agente Flex AI integrado puede leer, citar y verificar el progreso, pero no puede lanzar una retención de investigación separada dentro de su autorización de gasto de chat; aprueba ese trabajo en Oportunidades o con el flujo MCP externo dedicado.

Las lecturas compartidas de resultados de Google están limitadas a 10 por espacio de trabajo por minuto y validan el acceso actual a la propiedad conectada, incluso antes de devolver informes privados en caché. Las importaciones de CSV no enriquecen métricas ni inician verificaciones de clasificación. Una verificación de propuesta comprueba la versión aprobada en una página pública acotada; no edita el sitio ni establece causalidad de ingresos. Los destinatarios de informes deben confirmar antes de la entrega y no obtienen acceso interactivo al proyecto.

La conexión de Search Console usa acceso de solo lectura a Google. Esto no hace que todo el servidor MCP sea de solo lectura: los agentes también pueden guardar palabras clave e iniciar trabajos compatibles en proyectos autorizados.

Preguntas sobre la conexión de Search Console

¿Puedo conectar Google Search Console específicamente a Claude Code? Sí. Usa el comando de configuración de Claude Code anterior, completa la autenticación en el navegador y selecciona un proyecto con una propiedad de Search Console conectada. FlexQueries gestiona la aplicación OAuth de Google, por lo que no necesitas tu propio proyecto de Google Cloud.

¿Es este un servidor MCP de Google Search Console que instalo yo mismo? No. https://app.flexqueries.com/mcp es un servidor remoto alojado. Agrégalo a un cliente MCP compatible e inicia sesión; no hay servidor local de Search Console ni archivo de credenciales que mantener.

Herramientas disponibles

El MCP de FlexQueries expone herramientas para flujos de trabajo de investigación SEO:

Investiga palabras clave con volumen, dificultad, CPC, intención y demanda disponible en búsqueda con IA.
Amplía las frases de búsqueda con el Autocompletado de Google.
Compara tendencias de palabras clave, regiones, patrones de audiencia y búsquedas relacionadas o en aumento.
Inspecciona los resultados orgánicos actuales de Google y compara las instantáneas históricas de SERP disponibles.
Encuentra filas exactas de palabra clave, página, posición, volumen, CPC, intención y tráfico para un dominio o página.
Compara competidores en SERP, brechas de dominio, páginas o carpetas exactas y tráfico en un conjunto objetivo proporcionado.
Inspecciona las tecnologías del dominio y las señales públicas de registro.
Busca negocios locales cerca de una coordenada, obtén resultados de Maps o Local Finder, inspecciona perfiles de negocio, lee las preguntas y respuestas de Google Business y ejecuta consultas de reseñas.
Lista las palabras clave guardadas de un proyecto de FlexQueries.
Guarda palabras clave útiles de vuelta en FlexQueries.
Inicia auditorías de sitio, verifica su estado e inspecciona los problemas de las páginas.
Compara la visibilidad de marca, investiga indicaciones en modelos de IA compatibles, lee citas y fallos parciales, gestiona monitores de visibilidad programados e inspecciona las fuentes del Modo IA de Google.
Crea y configura rastreadores de posiciones, gestiona palabras clave, estima costos, inicia verificaciones y lee posiciones e historial guardados.
Resume la huella orgánica de un dominio.
Encuentra palabras clave por las que un dominio ya posiciona.
Verifica resúmenes de backlinks, redes de referencia, brechas de enlaces en páginas exactas e historial de backlinks.
Descubre listados de Apple App Store y Google Play, métricas de aplicaciones, palabras clave de posicionamiento, competidores e intersecciones de palabras clave.
Investiga la demanda de palabras clave en Amazon, búsquedas relacionadas, posiciones ASIN, competidores e intersecciones de productos.
Busca resultados de productos compatibles de Amazon y Google Shopping, incluidos trabajos asíncronos de resultados de productos.
Busca en Bing, Google News, Imágenes, Eventos, Conjuntos de datos y YouTube donde la superficie de investigación seleccionada sea compatible.
Lee el rendimiento de primera parte de Google Search Console (clics, impresiones, CTR, posición).
Inspecciona el estado de indexación, rastreo y canónico para URL específicas (hasta 10 por llamada).

Contenido, análisis y trabajo continuo

Content Studio: lee briefs, clústeres de palabras clave y sugerencias de enlaces internos; genera un brief informado por SERP de pago; puntúa y guarda un borrador; aplica etiquetas de clúster; o elimina un brief.
Análisis e informes: lee los totales de GA4 conectados y las páginas de destino sin cargo de uso de FlexQueries, además de informes de proyecto que combinan datos de auditoría, posiciones, Search Console y GA4.
Investigación de dominios: accede a tablas paginadas de palabras clave y páginas principales, competidores, brechas de contenido, estimaciones de tráfico e historial de visibilidad.
Inteligencia SERP: analiza lotes de palabras clave, inspecciona brechas en la página y solicita capturas de pantalla SERP compatibles.
Palabras clave guardadas: navega por la lista completa, edita etiquetas, elimina palabras clave y actualiza métricas.
Verificaciones recurrentes: crea, actualiza, pausa y ejecuta monitores de posiciones o visibilidad con IA; gestiona programaciones de auditoría y auditorías guardadas. Crear una programación permite ejecuciones de pago futuras, así que acuerda el alcance y la frecuencia primero.

El Agente Flex AI integrado utiliza las mismas herramientas vinculadas al proyecto. La administración de la cuenta, la adición de fondos y el consentimiento de la cuenta de Google permanecen en el panel. Gestiona los clientes autorizados en Configuración → Clientes MCP conectados, donde cada conexión se puede revocar de inmediato.

Cómo leer los resultados correctamente

Las herramientas devuelven datos estructurados junto con texto legible por el modelo. Las herramientas de espacio de trabajo respaldadas por servicios colocan su resultado completo bajo data; las herramientas de investigación existentes mantienen sus campos con nombre documentados. Un objeto meta identifica el proyecto y enlaza de vuelta al panel. El cliente puede descubrir el esquema de entrada y salida de cada herramienta a través de MCP.

La dificultad de palabra clave (KD) mide la dificultad de posicionamiento orgánico de 0 a 100. La competencia publicitaria es una métrica separada de búsqueda de pago y no reemplaza a la KD. Las métricas faltantes no están disponibles, no son cero búsquedas ni posicionamientos fáciles.

Verificar métricas de palabras clave del panel, REST keywords.metrics y MCP get_keyword_metrics conservan cada frase solicitada. En los países de base de datos primaria compatibles, sus cotizaciones incluyen un respaldo de volumen por lotes para frases sin volumen informado. Las estimaciones faltantes permanecen nulas; un cero proporcionado sigue siendo cero. La competencia publicitaria no es KD orgánica. Otros países compatibles pueden proporcionar volumen sin KD o intención.

MCP acepta hasta 700 frases por consulta. Verifica la cobertura antes de almacenar en caché el resultado y mantiene el máximo cotizado antes de llamadas de pago. Cada fila de resultado incluye check_status. Un lote fallido o no verificado no es un resultado exitoso sin datos. La reutilización de caché nueva no agrega cargo de consulta. Los flujos de trabajo de palabras clave locales y seguimiento de posiciones utilizan volumen local con KD nacional donde sea compatible; no sustituyen el volumen nacional por volumen local faltante.

Las ejecuciones de palabras clave del panel ahora guardan sus configuraciones de entrada y resultados. Abre un resultado guardado para revisarlo sin gastar créditos, o elige Actualizar resultados después de revisar la cotización actual. Varias frases exactas se ejecutan como un lote. Varias frases de descubrimiento abren pestañas de ideas separadas marcadas como No ejecutado hasta que las inicies. Las verificaciones opcionales de volumen con IA tienen su propio resultado y se pueden reintentar sin repetir la investigación base exitosa.

Países y campos legibles

Usa countryCode con un código ISO de dos letras compatible, como US, GB o DE, en herramientas de investigación basadas en país. Omítelo para usar el valor predeterminado del mercado del proyecto de esa herramienta. Para un lote de consultas, establece el país en cada consulta o semilla. Los idiomas siguen siendo códigos cortos como en o de. Maps y Local Finder usan near.latitude, near.longitude y near.zoom opcional (4–18), no un radio de distancia. Un zoom más alto reduce el área; el zoom omitido usa 17 para Maps o 9 para Local Finder. La búsqueda de directorios de negocios y Google Business Q&A tienen entradas de radio separadas. Algunas herramientas tienen una cobertura de mercado más limitada, que validan antes de comenzar la investigación.

Los resultados de proyectos, rastreadores y palabras clave guardadas incluyen campos legibles country y countryCode. Los campos numéricos antiguos locationCode de entrada y salida siguen disponibles para clientes existentes. Al proporcionar ambos identificadores, deben referirse al mismo país.

get_backlinks_profile acepta grouping: "strongest_per_domain" (el valor predeterminado) o "all_links". El alias antiguo mode sigue siendo compatible. Los resultados de negocios locales, SERP local, Q&A y posicionamiento de dominio usan campos planos de FlexQueries como reviewCount, rank, searchVolume y estimatedTraffic; no devuelven envoltorios de respuesta del proveedor. Los valores faltantes permanecen nulos.

Las búsquedas de productos y reseñas devuelven ID de trabajo de FlexQueries que comienzan con job_. Pasa ese ID sin cambios a la herramienta de resultados correspondiente. Los ID de trabajo guardados antiguos siguen funcionando, y ver un resultado guardado completado no reinicia la investigación ni cobra de nuevo.

Los enlaces de capturas de pantalla SERP usan el dominio de FlexQueries y permanecen disponibles hasta 90 días. Ábrelos mientras estés conectado a una cuenta con acceso al proyecto. Un enlace de captura de pantalla no otorga acceso a los datos de otro espacio de trabajo.

Sigue hasMore y nextPage / nextOffset para palabras clave guardadas y filas de auditoría. Mantén los filtros y el ID de auditoría devuelto sin cambios mientras paginas. Una primera página devuelta no es el informe completo. Search Console y las herramientas de investigación del proveedor también exponen sus propios campos de paginación.

Una verificación iniciada devuelve un identificador de trabajo, no investigación terminada. Lee get_rank_tracker, get_aio_monitoring o get_audit_status para seguir su estado. Las instantáneas anteriores pueden permanecer disponibles mientras se ejecuta un nuevo trabajo. Preserva fechas y configuraciones de mercado, distingue las estimaciones de tráfico del proveedor de los análisis de primera parte y trata las métricas faltantes o las respuestas fallidas del modelo como no disponibles en lugar de cero.

Qué hacer después de la configuración

Una vez que FlexQueries MCP esté conectado, usa las guías de flujo de trabajo del agente para trabajos de SEO enfocados.

Comienza con un flujo de trabajo enfocado en lugar de pedirle a tu agente que "haga SEO" de manera amplia.

Usa configuración de proyecto SEO para capturar tus objetivos de SEO y el contexto del sitio web en un espacio de trabajo local.
Usa entrenador de SEO si eres nuevo en SEO o no estás seguro de qué flujo de trabajo ejecutar primero.
Usa investigación de palabras clave para descubrir oportunidades de palabras clave.
Usa panorama competitivo para mapear un mercado antes de elegir competidores o páginas.
Usa análisis de competidores para estudiar a un competidor.
Usa agrupación de palabras clave para convertir palabras clave en grupos de páginas.
Usa prospección de enlaces para encontrar prospectos de divulgación para un activo enlazable.

Solución de problemas

Cada conexión externa puede ejecutar dos herramientas a la vez. Las ráfagas cortas esperan hasta diez segundos por un espacio; esperar no compra investigación. Si la conexión sigue ocupada, espera unos segundos antes de reintentar. Los límites de velocidad de solicitudes siguen aplicándose en todo el cliente y el espacio de trabajo; no abras conexiones adicionales para evadirlos.

Los permisos y límites de gasto se verifican nuevamente después de que se admite una llamada en cola. Cancelar una llamada en espera no inicia investigación. Si una llamada de pago se interrumpe o su resultado es incierto, verifica el trabajo original o el resultado guardado antes de solicitar nuevo trabajo de pago; una solicitud de reemplazo puede incurrir en otro cargo.

Las cotizaciones aceptan el idempotencyKey opcional que se muestra en su esquema de entrada. Mantén la clave de idempotencia requerida sin cambios al verificar o reanudar una operación aceptada.

Si tu cliente no puede conectarse, verifica que la URL del servidor sea exactamente https://app.flexqueries.com/mcp.

Si no aparecen herramientas, actualiza o reinicia la conexión, completa la autenticación, habilita sus herramientas e inicia un nuevo chat. Un cliente puede almacenar en caché una lista de herramientas antigua.

Si la autorización falla, desconecta el servidor de FlexQueries en tu cliente, agrégalo nuevamente y repite el flujo de inicio de sesión.

Si el navegador termina la aprobación pero una devolución de llamada 127.0.0.1 o localhost dice que rechazó la conexión, la devolución de llamada pertenece a tu cliente MCP local, no a FlexQueries. Mantén el cliente en ejecución, inicia Autenticar o su comando de inicio de sesión MCP nuevamente desde ese cliente y termina el nuevo flujo del navegador sin reutilizar una URL de devolución de llamada antigua. Las devoluciones de llamada locales no pueden completarse en una computadora diferente, un shell sin interfaz o después de que el cliente haya cerrado su listener temporal.

Si falta una herramienta lanzada recientemente, actualiza las herramientas en caché del servidor o elimina y vuelve a agregar la conexión, luego inicia una nueva conversación. La página IA y MCP con sesión iniciada es el catálogo actual.

Si tu agente no puede encontrar un proyecto, pídele que liste los proyectos de FlexQueries primero y usa el ID de proyecto devuelto en llamadas de herramientas posteriores.

Datos estructurados

{
  "@context": "https://schema.org",
  "@type": "BreadcrumbList",
  "itemListElement": [
    {
      "@type": "ListItem",
      "position": 1,
      "name": "Home",
      "item": "https://flexqueries.com/"
    },
    {
      "@type": "ListItem",
      "position": 2,
      "name": "Docs",
      "item": "https://flexqueries.com/docs"
    },
    {
      "@type": "ListItem",
      "position": 3,
      "name": "Set up FlexQueries MCP",
      "item": "https://flexqueries.com/docs/mcp"
    }
  ]
}