Saltar al contenido
Tecrübetecrube.com
Herramientas del asistente · Informes

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éditos

Propiedades 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éditos

Informe 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ámetroTipoDescripción
site_urlOpcionalstringPropiedad de Search Console, p. ej. https://example.com/ o sc-domain:example.com. Omitir para usar la predeterminada conectada.
start_dateOpcionalstringYYYY-MM-DD
end_dateOpcionalstringYYYY-MM-DD
daysOpcionalinteger (1–480)ventana que termina hoy cuando se omiten las fechas (por defecto 28)
dimensionsOpcionalarray<query | page | country | device | date | searchAppearance>por defecto [query]
filtersOpcionalarray<object>filtros de dimensión combinados con AND (p. ej. query notContains marca, page equals URL)
exclude_termsOpcionalarray<string>términos de marca a excluir de query (informe sin marca)
pageOpcionalstringlimitar a la URL de una página
countryOpcionalstringISO 3166-1 alpha-3, p. ej. TUR
deviceOpcionalDESKTOP | MOBILE | TABLET—
search_typeOpcionalweb | image | video | news | discover | googleNews—
row_limitOpcionalinteger (1–5000)—
start_rowOpcionalinteger (0–…)—
compare_previousOpcionalbooleanobtiene también el periodo inmediatamente anterior de igual duración y añade anterior/variación por fila
order_byOpcionalclicks | impressions | ctr | position | clicks_change | impressions_change | ctr_change | position_change—
orderOpcionalasc | desc—

search_console_top_queries

Lectura1 créditos

Principales consultas por clics (o impresiones/ctr/posición) del periodo; pasa exclude_terms con palabras de marca para una lista sin marca.

ParámetroTipoDescripción
site_urlOpcionalstringPropiedad de Search Console, p. ej. https://example.com/ o sc-domain:example.com. Omitir para usar la predeterminada conectada.
start_dateOpcionalstringYYYY-MM-DD
end_dateOpcionalstringYYYY-MM-DD
daysOpcionalinteger (1–480)ventana que termina hoy cuando se omiten las fechas (por defecto 28)
filtersOpcionalarray<object>filtros de dimensión combinados con AND (p. ej. query notContains marca, page equals URL)
exclude_termsOpcionalarray<string>términos de marca a excluir de query (informe sin marca)
pageOpcionalstringlimitar a la URL de una página
countryOpcionalstringISO 3166-1 alpha-3, p. ej. TUR
deviceOpcionalDESKTOP | MOBILE | TABLET—
limitOpcionalinteger (1–1000)—
order_byOpcionalclicks | impressions | ctr | position—

search_console_low_ctr_pages

Lectura2 créditos

Pá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ámetroTipoDescripción
site_urlOpcionalstringPropiedad de Search Console, p. ej. https://example.com/ o sc-domain:example.com. Omitir para usar la predeterminada conectada.
start_dateOpcionalstringYYYY-MM-DD
end_dateOpcionalstringYYYY-MM-DD
daysOpcionalinteger (1–480)ventana que termina hoy cuando se omiten las fechas (por defecto 28)
filtersOpcionalarray<object>filtros de dimensión combinados con AND (p. ej. query notContains marca, page equals URL)
exclude_termsOpcionalarray<string>términos de marca a excluir de query (informe sin marca)
pageOpcionalstringlimitar a la URL de una página
countryOpcionalstringISO 3166-1 alpha-3, p. ej. TUR
deviceOpcionalDESKTOP | MOBILE | TABLET—
dimensionOpcionalpage | query—
min_impressionsOpcionalnumber—
max_ctrOpcionalnumberporcentaje, por defecto 2
limitOpcionalinteger (1–500)—

inspect_url

Lectura1 créditos

Inspecció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ámetroTipoDescripción
urlObligatoriostringURL completa dentro de la propiedad
site_urlOpcionalstringPropiedad de Search Console, p. ej. https://example.com/ o sc-domain:example.com. Omitir para usar la predeterminada conectada.

list_sitemaps

Lectura1 créditos

Sitemaps 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ámetroTipoDescripción
site_urlOpcionalstringPropiedad de Search Console, p. ej. https://example.com/ o sc-domain:example.com. Omitir para usar la predeterminada conectada.

gsc_inspect_urls

Lectura2 créditos

Inspecció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ámetroTipoDescripción
urlsObligatorioarray<string>URL completas de la propiedad
site_urlOpcionalstringPropiedad de Search Console, p. ej. https://example.com/ o sc-domain:example.com. Omítelo para usar la predeterminada conectada.
limitOpcionalinteger (1–50)cuántas de urls se inspeccionan (por defecto 20)
crawled_sinceOpcionalstringYYYY-MM-DD; marca qué URL rastreó Google de nuevo en esa fecha o después

search_console_vs_ads

Lectura2 créditos

Orgá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ámetroTipoDescripción
site_urlOpcionalstringPropiedad de Search Console, p. ej. https://example.com/ o sc-domain:example.com. Omitir para usar la predeterminada conectada.
daysOpcionalinteger (1–90)—
filtersOpcionalarray<object>filtros de dimensión combinados con AND (p. ej. query notContains marca, page equals URL)
exclude_termsOpcionalarray<string>términos de marca a excluir de query (informe sin marca)
pageOpcionalstringlimitar a la URL de una página
countryOpcionalstringISO 3166-1 alpha-3, p. ej. TUR
deviceOpcionalDESKTOP | MOBILE | TABLET—
limitOpcionalinteger (1–500)—

Herramientas de escritura5 herramientas

submit_sitemap

Escritura2 créditos

Enví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ámetroTipoDescripción
sitemap_urlObligatoriostring—
site_urlOpcionalstringPropiedad 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éditos

Elimina un sitemap de Search Console. Pasa por vista previa y aprobación; se aplica solo cuando el usuario aprueba.

ParámetroTipoDescripción
sitemap_urlObligatoriostring—
site_urlOpcionalstringPropiedad 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éditos

Añ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ámetroTipoDescripción
site_urlObligatoriostringhttps://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éditos

Inicia 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éditos

Elige 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ámetroTipoDescripción
serviceObligatoriosearch_console | ga4 | business_profile | youtube | tag_manager—
resourceOpcionalstringid 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.