MCP Search Console

mcp-search-console

Servidor MCP de Google Search Console multi-cuenta para operadores que necesitan una única superficie MCP en múltiples sitios o clientes sin reiniciar el servidor.

Estado de publicación: paquete beta, versión 0.1.3 de pyproject.toml.

Elige tu camino

Eres...	Empieza aquí	Luego
Conectando el servidor a Claude/Codex/Cursor	docs/start-here.md	Inicio rápido abajo
Auditando el enrutamiento de cuentas o las protecciones destructivas	docs/architecture.md	gsc/server.py
Revisando metadatos de empaquetado o registro	pyproject.toml	server.json

Arquitectura

flowchart TD
  U[AI operator] --> C[MCP client]
  C --> S[FastMCP server]
  S --> M[Account manager]
  M --> F[Accounts config]
  M --> A[OAuth or service-account auth]
  S --> R[Retry wrapper]
  R --> G[Google Search Console API]
  G --> R --> S

Flujo de solicitudes

flowchart TD
  P[Operator asks for analytics or indexing data] --> T[Selected MCP tool]
  T --> A[Resolve named or default account]
  A --> B[Build authenticated GSC client]
  B --> C[Call Search Console endpoint]
  C --> D{API call succeeds?}
  D -- yes --> E[Return normalized JSON]
  D -- retryable --> F[Backoff and retry]
  F --> D
  D -- no --> G[Return error payload]

Inicio rápido

1. Instala el paquete.

python -m pip install mcp-search-console-multi

2. Crea la configuración de cuentas.

mkdir -p ~/.config/mcp-search-console
cp accounts.example.json ~/.config/mcp-search-console/accounts.json

3. Regístralo en tu cliente MCP.

{
  "mcpServers": {
    "search-console": {
      "command": "uvx",
      "args": ["mcp-search-console-multi"],
      "env": {
        "GSC_ACCOUNTS_CONFIG": "/Users/you/.config/mcp-search-console/accounts.json"
      }
    }
  }
}

Herramientas disponibles

Grupo de herramientas	Herramientas	Propósito
Enrutamiento de cuentas	list_accounts, set_default_account, reauthenticate	Inspeccionar cuentas, cambiar valores predeterminados, actualizar autenticación
Inventario de propiedades	list_properties, get_site_details	Descubrir propiedades y permisos accesibles
Analítica de búsqueda	get_search_analytics, get_performance_overview, compare_periods, get_advanced_search_analytics, get_search_by_page	Consultar datos de rendimiento de búsqueda
Inspección y sitemaps	inspect_url, batch_inspect_urls, check_indexing_issues, list_sitemaps, get_sitemap, submit_sitemap, delete_sitemap	Inspeccionar la indexación y gestionar envíos de sitemaps

submit_sitemap y delete_sitemap permanecen detrás del indicador destructivo documentado en docs/start-here.md.

Prueba de ejecución

Afirmación	Prueba
El punto de entrada del paquete es estable	mcp-search-console-multi = "gsc.server:main" en pyproject.toml
El enrutamiento multi-cuenta es de primera clase	AccountManager() y _get_manager() en gsc/server.py
Las llamadas a Search Console se reintentan	with_retry() en gsc/server.py y gsc/retry.py
La autenticación se basa en archivos por cuenta	accounts.example.json y gsc/accounts.py

Mapa del repositorio

Ruta	Propósito
gsc/server.py	Superficie de herramientas FastMCP y normalización de respuestas
gsc/accounts.py	Configuración de cuentas, carga de autenticación, construcción de clientes
gsc/auth/	Implementaciones de autenticación OAuth y de cuenta de servicio
gsc/retry.py	Comportamiento de reintento para fallos transitorios de API
docs/start-here.md	Configuración, entorno, validación, fallos comunes
docs/architecture.md	Mapa de componentes y ciclo de vida de ejecución

Validación

Comprobación	Comando
La importación compila	python -m compileall gsc
El paquete se compila	python -m build
Los enlaces de README/docs permanecen locales	rg '\\]\\(([^)]+\\.md)\\)' README.md docs/

Licencia

MIT