mcp-google-business

Google Business Profile MCP

Inglés | Русский

A1 Google Business Profile MCP permite que una aplicación de IA trabaje con las ubicaciones de tu perfil de negocio de Google en lenguaje natural. Inspecciona ubicaciones y rendimiento, responde a reseñas, prepara publicaciones locales y actualiza la información del perfil de forma deliberada.

Se conecta a las API actuales de Business Profile de Google y a la API heredada donde aún residen las reseñas y publicaciones. Una cuenta de Google y las credenciales OAuth por sí solas no son suficientes: Google debe aprobar el Acceso Básico a la API para el proyecto de Cloud.

• 20 herramientas. Datos de ubicaciones y cuentas, rendimiento, reseñas, publicaciones locales, categorías y atributos.
• Puerta de aprobación real. Los proyectos comienzan con 0 QPM; cada llamada a la API falla hasta que Google apruebe la solicitud de Acceso Básico a la API.
• Límite de publicación separado. Una respuesta preparada, publicación o actualización de ubicación cambia la información pública del negocio solo después de que el cliente confirme la operación de escritura.
• Cuatro superficies de API. Account Management, Business Information, Performance y la v4 heredada funcionan a través de un único alcance OAuth business.manage.

Comienza con una pregunta de solo lectura:

Lista mis ubicaciones y muestra las reseñas más recientes que no tengan respuesta.

Conectar el servidor · Explorar casos de uso · Abrir documentación técnica

Véalo funcionar en un minuto

Tú: Lista mis ubicaciones y muestra las reseñas más recientes que no tengan respuesta.

Asistente: Muestra las ubicaciones y las reseñas recientes. No cambia nada.

Tú: Redacta una respuesta a la reseña más reciente de tres estrellas en la ubicación del centro. Discúlpate y ofrece ayuda.

Asistente: Muestra la ubicación, la reseña y la respuesta propuesta, y luego pide confirmación antes de publicarla.

Tú: Confirmo.

Asistente: Publica la respuesta. No altera la reseña, otras ubicaciones ni publicaciones.

Contenido

• Inicio rápido
• Qué puedes pedirle que haga
• Qué puede cambiar
• Cómo obtener acceso
• Configuración
• Datos, límites y trabajo en segundo plano
• Documentación técnica
• Soporte

Inicio rápido

Necesitas Node.js 20+, un perfil de negocio de Google verificado, un cliente OAuth de Google Cloud y una solicitud de Acceso Básico a la API aprobada.

1. Obtén acceso aprobado.
2. Agrega el servidor a tu aplicación de IA.
3. Comienza con la pregunta de solo lectura anterior.

codex mcp add google-business \
  --env GOOGLE_BUSINESS_CLIENT_ID=your_client_id \
  --env GOOGLE_BUSINESS_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_BUSINESS_REFRESH_TOKEN=your_refresh_token \
  -- npx -y mcp-google-business@latest
codex mcp list

claude mcp add \
  --env GOOGLE_BUSINESS_CLIENT_ID=your_client_id \
  --env GOOGLE_BUSINESS_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_BUSINESS_REFRESH_TOKEN=your_refresh_token \
  --transport stdio --scope user google-business \
  -- npx -y mcp-google-business@latest
claude mcp list

{"mcpServers":{"google-business":{"command":"npx","args":["-y","mcp-google-business@latest"],"env":{"GOOGLE_BUSINESS_CLIENT_ID":"your_client_id","GOOGLE_BUSINESS_CLIENT_SECRET":"your_client_secret","GOOGLE_BUSINESS_REFRESH_TOKEN":"your_refresh_token"}}}}

{"servers":{"google-business":{"type":"stdio","command":"npx","args":["-y","mcp-google-business@latest"],"env":{"GOOGLE_BUSINESS_CLIENT_ID":"${input:gbp_client_id}","GOOGLE_BUSINESS_CLIENT_SECRET":"${input:gbp_client_secret}","GOOGLE_BUSINESS_REFRESH_TOKEN":"${input:gbp_refresh_token}"}}},"inputs":[{"type":"promptString","id":"gbp_client_id","description":"Google OAuth client ID"},{"type":"promptString","id":"gbp_client_secret","description":"Google OAuth client secret","password":true},{"type":"promptString","id":"gbp_refresh_token","description":"Google OAuth refresh token","password":true}]}

Qué puedes pedirle que haga

• Listar ubicaciones, categorías, atributos e información actual del perfil.
• Mostrar llamadas, solicitudes de indicaciones e impresiones de palabras clave de búsqueda para un período elegido.
• Encontrar reseñas recientes, redactar una respuesta y publicarla después de la confirmación.
• Preparar, actualizar o eliminar una publicación local.
• Actualizar un campo o atributo de ubicación seleccionado después de mostrar el cambio exacto.

Qué puede cambiar

El cliente de IA controla las confirmaciones; el servidor marca las herramientas para que el cliente pueda distinguir la inspección de un cambio en vivo.

Cómo obtener acceso

Google requiere tanto OAuth como la aprobación del Acceso Básico a la API.

1. Usa un perfil de negocio verificado y activo que haya existido durante al menos 60 días; solicita desde una cuenta de propietario o administrador y ten un sitio web del negocio que coincida con la solicitud.
2. Crea un proyecto de Google Cloud, habilita My Business Account Management API, Business Information API, Business Profile Performance API y Google My Business API (v4 heredada).
3. Envía el formulario de contacto de la API de GBP como Solicitud de Acceso Básico a la API. Antes de la aprobación, la cuota es de 0 QPM; los proyectos aprobados reciben 300 QPM por API.
4. Crea un cliente OAuth, obtén un token de actualización para https://www.googleapis.com/auth/business.manage y establece las tres variables GOOGLE_BUSINESS_*.

Trata el secreto del cliente y el token de actualización como contraseñas. Un token de acceso es una alternativa de corta duración para uso único.

Configuración

* Proporciona el trío OAuth o un token de acceso. Las anulaciones del host de la API están documentadas en la referencia de herramientas.

Datos, límites y trabajo en segundo plano

• Google recibe las solicitudes del perfil. La telemetría anónima incluye datos de instalación y versión, además de nombres de herramientas; nunca secretos OAuth, datos del perfil, argumentos ni indicaciones. Establece ASKADS_TELEMETRY=0 para optar por no participar.
• Límites de edición reales. Los proyectos aprobados reciben 300 QPM por API; Google también limita cada perfil de negocio a 10 ediciones por minuto. Las métricas de rendimiento pueden retrasarse unos días, y las respuestas a reseñas requieren ubicaciones verificadas.
• Sin monitoreo en segundo plano. El servidor se ejecuta solo cuando se le llama. Si tu aplicación de IA admite tareas programadas, puede revisar periódicamente nuevos comentarios o métricas.

Documentación técnica

• Catálogo de capacidades de MCP — páginas orientadas a tareas para cada herramienta.
• Todas las herramientas y entradas
• Documentación de desarrollo
• Documentación de publicación
• Documentación de la API de Google Business Profile

Soporte

¿Encontraste un error o necesitas un escenario? Crea un problema o escribe en Telegram.

¡Llegaste al final!