Herramientas de Search Console
Rendimiento de consultas y páginas, páginas con CTR bajo, inspección de URL, sitemaps y comparación con anuncios.
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 lectura8 herramientas
list_search_console_sites
Lectura1 créditosPropiedades verificadas de Search Console que la cuenta de Google conectada puede leer, con el nivel de permiso y la propiedad por defecto usada cuando se omite site_url.
Esta herramienta no recibe parámetros.
search_console_query
Lectura1 créditosInforme de rendimiento de Search Console (clics, impresiones, ctr %, posición media) para cualquier rango de fechas por consulta, página, país, dispositivo, fecha o searchAppearance, con filtros AND. compare_previous=true añade el periodo anterior equivalente y la variación por fila; order_by=clicks_change con order=asc lista las mayores caídas. Requiere una cuenta de Google conectada; si no, devuelve connected=false.
| Parámetro | Tipo | Descripción |
|---|---|---|
site_urlOpcional | string | Propiedad de Search Console, p. ej. https://example.com/ o sc-domain:example.com. Omitir para usar la predeterminada conectada. |
start_dateOpcional | string | YYYY-MM-DD |
end_dateOpcional | string | YYYY-MM-DD |
daysOpcional | integer (1–480) | ventana que termina hoy cuando se omiten las fechas (por defecto 28) |
dimensionsOpcional | array<query | page | country | device | date | searchAppearance> | por defecto [query] |
filtersOpcional | array<object> | filtros de dimensión combinados con AND (p. ej. query notContains marca, page equals URL) |
exclude_termsOpcional | array<string> | términos de marca a excluir de query (informe sin marca) |
pageOpcional | string | limitar a la URL de una página |
countryOpcional | string | ISO 3166-1 alpha-3, p. ej. TUR |
deviceOpcional | DESKTOP | MOBILE | TABLET | — |
search_typeOpcional | web | image | video | news | discover | googleNews | — |
row_limitOpcional | integer (1–5000) | — |
start_rowOpcional | integer (0–…) | — |
compare_previousOpcional | boolean | obtiene también el periodo inmediatamente anterior de igual duración y añade anterior/variación por fila |
order_byOpcional | clicks | impressions | ctr | position | clicks_change | impressions_change | ctr_change | position_change | — |
orderOpcional | asc | desc | — |
search_console_top_queries
Lectura1 créditosPrincipales consultas por clics (o impresiones/ctr/posición) del periodo; pasa exclude_terms con palabras de marca para una lista sin marca.
| Parámetro | Tipo | Descripción |
|---|---|---|
site_urlOpcional | string | Propiedad de Search Console, p. ej. https://example.com/ o sc-domain:example.com. Omitir para usar la predeterminada conectada. |
start_dateOpcional | string | YYYY-MM-DD |
end_dateOpcional | string | YYYY-MM-DD |
daysOpcional | integer (1–480) | ventana que termina hoy cuando se omiten las fechas (por defecto 28) |
filtersOpcional | array<object> | filtros de dimensión combinados con AND (p. ej. query notContains marca, page equals URL) |
exclude_termsOpcional | array<string> | términos de marca a excluir de query (informe sin marca) |
pageOpcional | string | limitar a la URL de una página |
countryOpcional | string | ISO 3166-1 alpha-3, p. ej. TUR |
deviceOpcional | DESKTOP | MOBILE | TABLET | — |
limitOpcional | integer (1–1000) | — |
order_byOpcional | clicks | impressions | ctr | position | — |
search_console_low_ctr_pages
Lectura2 créditosPáginas (o consultas) con muchas impresiones pero bajo CTR: candidatas a reescribir el título/meta descripción. Por defecto: impresiones ≥ 1000 y ctr < 2 %. Ordenadas por impresiones.
| Parámetro | Tipo | Descripción |
|---|---|---|
site_urlOpcional | string | Propiedad de Search Console, p. ej. https://example.com/ o sc-domain:example.com. Omitir para usar la predeterminada conectada. |
start_dateOpcional | string | YYYY-MM-DD |
end_dateOpcional | string | YYYY-MM-DD |
daysOpcional | integer (1–480) | ventana que termina hoy cuando se omiten las fechas (por defecto 28) |
filtersOpcional | array<object> | filtros de dimensión combinados con AND (p. ej. query notContains marca, page equals URL) |
exclude_termsOpcional | array<string> | términos de marca a excluir de query (informe sin marca) |
pageOpcional | string | limitar a la URL de una página |
countryOpcional | string | ISO 3166-1 alpha-3, p. ej. TUR |
deviceOpcional | DESKTOP | MOBILE | TABLET | — |
dimensionOpcional | page | query | — |
min_impressionsOpcional | number | — |
max_ctrOpcional | number | porcentaje, por defecto 2 |
limitOpcional | integer (1–500) | — |
inspect_url
Lectura1 créditosInspección de URL: indexada o no, estado de cobertura, último rastreo, estado de robots/indexación, canónica de Google frente a la del usuario, usabilidad móvil y veredictos de resultados enriquecidos. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
urlObligatorio | string | URL completa dentro de la propiedad |
site_urlOpcional | string | Propiedad de Search Console, p. ej. https://example.com/ o sc-domain:example.com. Omitir para usar la predeterminada conectada. |
list_sitemaps
Lectura1 créditosSitemaps enviados para la propiedad con la última fecha de envío/descarga, indicador de pendiente, recuento de avisos y errores y recuento por tipo de contenido.
| Parámetro | Tipo | Descripción |
|---|---|---|
site_urlOpcional | string | Propiedad de Search Console, p. ej. https://example.com/ o sc-domain:example.com. Omitir para usar la predeterminada conectada. |
gsc_inspect_urls
Lectura2 créditosInspección de URL por lotes: veredicto de indexación, cobertura, último rastreo, canónica de Google y veredicto móvil de muchas URL en una sola llamada, con un resumen (indexadas / no indexadas / nunca rastreadas; rastreadas de nuevo desde una fecha). Cada URL se inspecciona por separado; un fallo no detiene el resto. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
urlsObligatorio | array<string> | URL completas de la propiedad |
site_urlOpcional | string | Propiedad de Search Console, p. ej. https://example.com/ o sc-domain:example.com. Omítelo para usar la predeterminada conectada. |
limitOpcional | integer (1–50) | cuántas de urls se inspeccionan (por defecto 20) |
crawled_sinceOpcional | string | YYYY-MM-DD; marca qué URL rastreó Google de nuevo en esa fecha o después |
search_console_vs_ads
Lectura2 créditosOrgánico frente a pagado en los mismos términos: clics/impresiones/posición de Search Console por consulta junto a impresiones, clics, gasto y conversiones de términos de búsqueda de Google Ads de los últimos N días (por defecto 28). Si Google Ads no está conectado, la columna de pago queda vacía con una nota.
| Parámetro | Tipo | Descripción |
|---|---|---|
site_urlOpcional | string | Propiedad de Search Console, p. ej. https://example.com/ o sc-domain:example.com. Omitir para usar la predeterminada conectada. |
daysOpcional | integer (1–90) | — |
filtersOpcional | array<object> | filtros de dimensión combinados con AND (p. ej. query notContains marca, page equals URL) |
exclude_termsOpcional | array<string> | términos de marca a excluir de query (informe sin marca) |
pageOpcional | string | limitar a la URL de una página |
countryOpcional | string | ISO 3166-1 alpha-3, p. ej. TUR |
deviceOpcional | DESKTOP | MOBILE | TABLET | — |
limitOpcional | integer (1–500) | — |
Herramientas de escritura5 herramientas
submit_sitemap
Escritura2 créditosEnvía (o reenvía) un sitemap a Search Console. Crea un elemento de aprobación con una vista previa de la propiedad y la URL del sitemap; se envía a Google solo tras la aprobación y solo con una cuenta conectada.
| Parámetro | Tipo | Descripción |
|---|---|---|
sitemap_urlObligatorio | string | — |
site_urlOpcional | string | Propiedad de Search Console, p. ej. https://example.com/ o sc-domain:example.com. Omitir para usar la predeterminada conectada. |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
delete_sitemap
EscrituraIrreversible2 créditosElimina un sitemap de Search Console. Pasa por vista previa y aprobación; se aplica solo cuando el usuario aprueba.
| Parámetro | Tipo | Descripción |
|---|---|---|
sitemap_urlObligatorio | string | — |
site_urlOpcional | string | Propiedad de Search Console, p. ej. https://example.com/ o sc-domain:example.com. Omitir para usar la predeterminada conectada. |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
gsc_add_site
Escritura2 créditosAñade un sitio web como propiedad de Search Console. Abre un elemento de aprobación; la propiedad se añade sin verificar y hay que verificar la propiedad en Search Console (DNS o HTML) antes de que aparezcan datos.
| Parámetro | Tipo | Descripción |
|---|---|---|
site_urlObligatorio | string | https://example.com/ (prefijo de URL) o sc-domain:example.com |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
connect_search_console
Escritura0 créditosInicia la conexión de Google Search Console: 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.
select_google_resource
Escritura0 créditosElige el único recurso de Google con el que la cuenta trabaja por defecto: una propiedad de Search Console, una propiedad de GA4, una ubicación de Business Profile, un canal de YouTube o un contenedor de Tag Manager. Sin resource lista las opciones. La elección se valida contra la cuenta real y se usa siempre que se llama a una herramienta sin un recurso explícito.
| Parámetro | Tipo | Descripción |
|---|---|---|
serviceObligatorio | search_console | ga4 | business_profile | youtube | tag_manager | — |
resourceOpcional | string | id o nombre de las opciones; omítelo para listar las opciones y la elección actual; 'none' la borra |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.