Herramientas de Perfil de Empresa
Ubicaciones, reseñas y respuestas, publicaciones, multimedia, actualización de categorías e información, estadísticas de rendimiento.
Los nombres y descripciones se generan directamente desde el código del servidor; las descripciones son la traducción del texto que ve el asistente, los nombres de herramientas y parámetros no cambian.
Herramientas de lectura11 herramientas
list_gbp_locations
Lectura1 créditosUbicaciones de Google Business Profile (nombre, teléfono, sitio web, horario, categoría, dirección, descripción) con una auditoría de información faltante por ubicación. Solo lectura.
Esta herramienta no recibe parámetros.
list_gbp_reviews
Lectura1 créditosReseñas de una o todas las ubicaciones de los últimos N días (puntuación, texto, estado de respuesta) más la puntuación media. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
locationOpcional | string | id de ubicación, locations/ID o nombre de la ubicación |
daysOpcional | integer (1–365) | — |
min_ratingOpcional | integer (1–5) | — |
max_ratingOpcional | integer (1–5) | — |
unreplied_onlyOpcional | boolean | — |
limitOpcional | integer (1–200) | reviews read per location (default 50) |
summary_onlyOpcional | boolean | only average rating, total and unanswered count |
offsetOpcional | integer (0–…) | skip this many matching reviews per location |
draft_gbp_review_replies
Lectura2 créditosRedacta respuestas corteses para las reseñas sin responder con puntuación igual o inferior a max_rating (por defecto 3 estrellas). No se publica nada; muestra los borradores al usuario y llama a reply_gbp_review para los que apruebe.
| Parámetro | Tipo | Descripción |
|---|---|---|
locationOpcional | string | id de ubicación, locations/ID o nombre de la ubicación |
daysOpcional | integer (1–365) | — |
max_ratingOpcional | integer (1–5) | — |
toneOpcional | string | p. ej. 'kısa, resmi, özür dileyen' |
gbp_insights
Lectura1 créditosEstadísticas de la ficha en el periodo: impresiones (búsqueda/mapas), clics al sitio web, llamadas, solicitudes de indicaciones, conversaciones, reservas; por ubicación y totales. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
locationOpcional | string | id de ubicación, locations/ID o nombre de la ubicación |
daysOpcional | integer (1–540) | — |
dailyOpcional | boolean | — |
gbp_vs_ads
Lectura3 créditosPanorama local comparado: estadísticas de Business Profile, gasto/clics/conversiones de campañas locales de Google Ads y clics orgánicos de Search Console (consultas por ciudad). Cada fuente informa con honestidad si no está conectada. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
locationOpcional | string | id de ubicación, locations/ID o nombre de la ubicación |
cityOpcional | string | — |
daysOpcional | integer (1–540) | — |
list_gbp_media
Lectura1 créditosFotos y vídeos de una o todas las ubicaciones de Business Profile: categoría de ubicación (portada, perfil, exterior, interior, equipo…), URL de Google, tamaño, visualizaciones, más un recuento por categoría y los espacios clave vacíos. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
locationOpcional | string | id de ubicación, locations/ID o nombre de la ubicación |
categoryOpcional | COVER | PROFILE | EXTERIOR | INTERIOR | PRODUCT | AT_WORK | FOOD_AND_DRINK | MENU | COMMON_AREA | ROOMS | TEAMS | ADDITIONAL | — |
limitOpcional | integer (1–500) | — |
gbp_location_details
Lectura1 créditosTodo sobre una ubicación de Business Profile: título, dirección, teléfonos, sitio web, descripción, categorías, horario habitual, lista de servicios, enlace de Google Maps, place id y el enlace directo 'escribir una reseña'. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
locationOpcional | string | id de ubicación, locations/ID o título; omítelo para usar la ubicación seleccionada (o la única) |
services_limitOpcional | integer (0–500) | — |
gbp_search_categories
Lectura1 créditosBusca por nombre en la lista de categorías de Business Profile de Google (p. ej. 'dentist') y obtiene id de categoría (categories/gcid:…) para update_gbp_categories o gbp_create_location. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
queryObligatorio | string | — |
regionOpcional | string | país de dos letras, por defecto TR |
languageOpcional | string | — |
limitOpcional | integer (1–100) | — |
gbp_search_keywords
Lectura1 créditosTérminos de búsqueda que la gente usó en la Búsqueda de Google y en Maps antes de que apareciera la ficha, con impresiones mensuales, para una ubicación. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
locationOpcional | string | id de ubicación, locations/ID o título; omítelo para usar la ubicación seleccionada (o la única) |
monthsOpcional | integer (1–18) | meses completos hacia atrás desde el mes pasado (por defecto 3) |
limitOpcional | integer (1–500) | — |
offsetOpcional | integer (0–…) | — |
include_low_volumeOpcional | boolean | lista también los términos que Google solo indica como 'menos de N' |
gbp_list_posts
Lectura1 créditosPublicaciones locales ya publicadas en una ubicación de Business Profile, de la más reciente a la más antigua: id, tipo, texto, estado, llamada a la acción y enlace. Usa el id con gbp_update_post o gbp_delete_post. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
locationOpcional | string | id de ubicación, locations/ID o título; omítelo para usar la ubicación seleccionada (o la única) |
limitOpcional | integer (1–100) | — |
gbp_verification_options
Lectura1 créditosMétodos de verificación que Google ofrece para una ficha (postal, llamada, SMS, correo electrónico, instantánea), verificaciones pasadas y pendientes, y si la cuenta ya la gestiona. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
locationOpcional | string | id de ubicación, locations/ID o título; omítelo para usar la ubicación seleccionada (o la única) |
languageOpcional | string | — |
Herramientas de escritura15 herramientas
update_gbp_location
Escritura2 créditosActualiza el teléfono, sitio web, horario habitual, horario especial (festivos), descripción o nombre de una ubicación. La vista previa muestra el campo, el valor anterior y el nuevo; se aplica solo tras la aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
locationObligatorio | string | id de ubicación, locations/ID o nombre de la ubicación |
phoneOpcional | string | — |
websiteOpcional | string | — |
hoursOpcional | object | {'pazartesi': '09:00-18:00', 'cumartesi': '10:00-14:00, 15:00-19:00', 'pazar': 'kapalı'} |
special_hoursOpcional | array<object> | — |
descriptionOpcional | string | — |
titleOpcional | string | — |
additional_phonesOpcional | array<string> | replaces the extra numbers (max 2); changing only phone keeps them |
clear_additional_phonesOpcional | boolean | — |
address_linesOpcional | array<string> | — |
cityOpcional | string | — |
regionOpcional | string | province / state |
postal_codeOpcional | string | — |
countryOpcional | string | two-letter country code, e.g. TR |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
reply_gbp_review
Escritura2 créditosPublica una respuesta a una reseña (texto dictado por el usuario o aprobado desde draft_gbp_review_replies). Elemento de aprobación; nada se publica antes de aprobarse.
| Parámetro | Tipo | Descripción |
|---|---|---|
locationObligatorio | string | id de ubicación, locations/ID o nombre de la ubicación |
review_idObligatorio | string | — |
replyObligatorio | string | — |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_gbp_post
Escritura2 créditosPublica una entrada de Business Profile (novedad, evento, oferta o alerta) en todas o algunas ubicaciones. Primero vista previa; se publica solo tras la aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
summaryObligatorio | string | — |
topic_typeOpcional | STANDARD | EVENT | OFFER | ALERT | — |
cta_typeOpcional | BOOK | ORDER | SHOP | LEARN_MORE | SIGN_UP | CALL | — |
cta_urlOpcional | string | — |
image_urlOpcional | string | — |
locationsOpcional | array<string> | omitir para todas las ubicaciones |
languageOpcional | string | — |
event_titleOpcional | string | — |
start_dateOpcional | string | — |
end_dateOpcional | string | — |
coupon_codeOpcional | string | — |
termsOpcional | string | — |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
update_gbp_categories
Escritura2 créditosCambia la categoría principal y/o las adicionales de una ubicación. Los nombres se resuelven contra la lista de categorías de Google (los nombres ambiguos devuelven los candidatos en lugar de adivinar). La vista previa muestra las categorías anteriores y nuevas; se aplica solo tras la aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
locationObligatorio | string | id de ubicación, locations/ID o nombre de la ubicación |
primary_categoryOpcional | string | nombre visible de la categoría (p. ej. 'Diş kliniği') o id categories/gcid:… |
additional_categoriesOpcional | array<string> | sustituye todas las categorías adicionales (máx. 9) |
add_categoriesOpcional | array<string> | — |
remove_categoriesOpcional | array<string> | — |
regionOpcional | string | país de dos letras para la lista de categorías, por defecto TR |
languageOpcional | string | idioma de los nombres de categoría, por defecto el del usuario |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
upload_gbp_media
Escritura2 créditosAñade una foto o vídeo desde una URL pública a una o varias ubicaciones de Business Profile con una categoría de ubicación (portada, perfil, exterior, interior, producto, equipo…). Primero vista previa; se sube solo tras la aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
locationOpcional | string | id de ubicación, locations/ID o nombre de la ubicación |
locationsOpcional | array<string> | varias ubicaciones a la vez |
source_urlOpcional | string | URL http(s) pública de la foto/vídeo; Google la descarga |
source_urlsOpcional | array<string> | several photos/videos in one call |
media_formatOpcional | PHOTO | VIDEO | — |
categoryOpcional | COVER | PROFILE | EXTERIOR | INTERIOR | PRODUCT | AT_WORK | FOOD_AND_DRINK | MENU | COMMON_AREA | ROOMS | TEAMS | ADDITIONAL | ubicación del medio; COVER y PROFILE deben ser fotos |
descriptionOpcional | string | — |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
connect_business_profile
Escritura0 créditosInicia la conexión de Google Business Profile: devuelve un enlace de autorización de un solo uso que el usuario abre (el mismo flujo que connect_account). Nada se conecta hasta que el usuario inicie sesión.
Esta herramienta no recibe parámetros.
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
gbp_create_location
Escritura5 créditosCrea una NUEVA ficha de Business Profile (un negocio nuevo en Maps/Búsqueda). La vista previa muestra la ficha exacta; solo se crea tras la aprobación y aún necesita verificación (gbp_verification_options) antes de aparecer.
| Parámetro | Tipo | Descripción |
|---|---|---|
titleObligatorio | string | — |
address_linesObligatorio | array<string> | — |
cityOpcional | string | — |
regionOpcional | string | — |
postal_codeOpcional | string | — |
countryObligatorio | string | código de país de dos letras, p. ej. TR |
primary_categoryObligatorio | string | nombre de categoría o categories/gcid:… (gbp_search_categories) |
phoneOpcional | string | — |
websiteOpcional | string | — |
hoursOpcional | object | {'pazartesi': '09:00-18:00', 'pazar': 'kapalı'} (días de la semana en turco) |
descriptionOpcional | string | — |
accountOpcional | string | cuenta de Business Profile; por defecto la conectada |
languageOpcional | string | — |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
gbp_start_verification
Escritura3 créditosInicia la verificación de una ficha con uno de los métodos de gbp_verification_options. Elemento de aprobación; después Google envía un código que se introduce con gbp_complete_verification.
| Parámetro | Tipo | Descripción |
|---|---|---|
locationOpcional | string | id de ubicación, locations/ID o título; omítelo para usar la ubicación seleccionada (o la única) |
methodObligatorio | ADDRESS | EMAIL | PHONE_CALL | SMS | AUTO | — |
phoneOpcional | string | para PHONE_CALL / SMS |
emailOpcional | string | para EMAIL |
mailer_contactOpcional | string | nombre del destinatario de la postal (ADDRESS) |
languageOpcional | string | — |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
gbp_complete_verification
Escritura2 créditosCompleta una verificación pendiente con el PIN que envió Google (postal, SMS, llamada o correo electrónico). Elemento de aprobación; el PIN se enmascara en la vista previa.
| Parámetro | Tipo | Descripción |
|---|---|---|
verificationObligatorio | string | nombre de la verificación locations/…/verifications/… o su id |
pinObligatorio | string | — |
locationOpcional | string | id de ubicación, locations/ID o título; omítelo para usar la ubicación seleccionada (o la única) |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
gbp_manage_services
Escritura3 créditosAñade, elimina o reemplaza servicios en la lista de Servicios de una ubicación (nombre libre o id de servicio predefinido de Google, con descripción y precio opcionales). La vista previa muestra la lista antigua y la nueva; se aplica solo tras la aprobación. La lista actual está en gbp_location_details.
| Parámetro | Tipo | Descripción |
|---|---|---|
locationOpcional | string | id de ubicación, locations/ID o título; omítelo para usar la ubicación seleccionada (o la única) |
actionObligatorio | add | remove | replace | — |
servicesObligatorio | array<object> | — |
languageOpcional | string | — |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
gbp_social_links
Escritura2 créditosLee o configura los enlaces de redes sociales y de citas de un Business Profile (Instagram, Facebook, X, LinkedIn, YouTube, TikTok, Pinterest, WhatsApp, citas). Sin links/remove solo lee; los cambios abren un elemento de aprobación con los enlaces antiguos y nuevos.
| Parámetro | Tipo | Descripción |
|---|---|---|
locationOpcional | string | id de ubicación, locations/ID o título; omítelo para usar la ubicación seleccionada (o la única) |
linksOpcional | object | {platform: url}; plataformas: instagram, facebook, twitter, linkedin, youtube, tiktok, pinterest, whatsapp, appointment |
removeOpcional | array<string> | plataformas cuyo enlace se elimina |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
gbp_update_post
Escritura3 créditosEdita sin eliminarla una publicación de Business Profile ya publicada (texto y/o botón de llamada a la acción). Primero vista previa; se aplica solo tras la aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
locationOpcional | string | id de ubicación, locations/ID o título; omítelo para usar la ubicación seleccionada (o la única) |
postObligatorio | string | id o nombre completo de la publicación de gbp_list_posts |
summaryOpcional | string | — |
cta_typeOpcional | BOOK | ORDER | SHOP | LEARN_MORE | SIGN_UP | CALL | — |
cta_urlOpcional | string | — |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
gbp_delete_post
EscrituraIrreversible2 créditosElimina PERMANENTEMENTE una publicación de Business Profile. Nunca se aplica automáticamente: siempre espera la aprobación explícita del usuario.
| Parámetro | Tipo | Descripción |
|---|---|---|
locationOpcional | string | id de ubicación, locations/ID o título; omítelo para usar la ubicación seleccionada (o la única) |
postObligatorio | string | id o nombre completo de la publicación de gbp_list_posts |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
gbp_update_photo_category
Escritura2 créditosMueve una foto que ya está en el perfil a otra categoría de ubicación (portada, perfil, exterior, interior…) sin sustituirla, conservando sus visualizaciones e historial. Primero vista previa; se aplica solo tras la aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
locationOpcional | string | id de ubicación, locations/ID o título; omítelo para usar la ubicación seleccionada (o la única) |
media_idObligatorio | string | media_key de list_gbp_media |
categoryObligatorio | COVER | PROFILE | EXTERIOR | INTERIOR | PRODUCT | AT_WORK | FOOD_AND_DRINK | MENU | COMMON_AREA | ROOMS | TEAMS | ADDITIONAL | — |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
gbp_delete_photo
EscrituraIrreversible2 créditosElimina PERMANENTEMENTE una foto o un vídeo de un Business Profile. Nunca se aplica automáticamente: siempre espera la aprobación explícita del usuario.
| Parámetro | Tipo | Descripción |
|---|---|---|
locationOpcional | string | id de ubicación, locations/ID o título; omítelo para usar la ubicación seleccionada (o la única) |
media_idObligatorio | string | media_key de list_gbp_media |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.