Configuración de cookies

Las cookies necesarias mantienen el sitio funcionando. La analítica muestra qué páginas son útiles. Puedes cambiar tu elección en cualquier momento desde el pie de página.

Política de cookies de este sitio — todos los detalles: categorías de cookies, cómo guardamos tu elección en el navegador y cómo retirar el consentimiento.

Necesarias

Funciones básicas del sitio y tu elección de consentimiento. Siempre activas.

Analítica

Ayuda a entender cómo se usa el sitio. Se carga solo si lo permites.

GitHubDescargar ZIP

Integración con Yandex Webmaster

Lee las consultas de búsqueda de Yandex Webmaster por URL para un host que hayas verificado, y guarda las filas junto a tu rastreo. Solo lectura, con un token OAuth, gratis dentro de la cuota de la API de Webmaster.

Ver en GitHubInicio rápido

Qué hace

  • Terminal: opciones de seohead webmaster-url-queries

Consultas por URL

webmaster-url-queries devuelve las consultas de búsqueda de una página exacta (--url) o de un grupo de páginas (--url-contains). Las filas de URL y las de consulta se mantienen separadas. El CTR y la posición media no se suman entre páginas.

  • --max-urls y --max-queries-per-url fijan límites explícitos, y la respuesta indica cuándo ha truncado el resultado.
  • --start-date y --end-date filtran las filas diarias.
  • Yandex mantiene su propio periodo móvil, así que un rango antiguo se rechaza como no disponible.

Acceso

Necesitas el ID de un host verificado en tu cuenta de Yandex Webmaster y un token OAuth de esa cuenta. El token va en YANDEX_WEBMASTER_TOKEN o en su archivo de token. SpiderHead no crea cuentas ni inicia sesión por ti. provider-discover puede listar los hosts que ve el token.

  • La petición es de solo lectura y no escribe nada en Yandex.
  • Sin ID de host, el comando no se ejecuta.
  • SpiderHead comprueba el host contra tu cuenta antes de pedir las consultas.

Guárdalo junto al rastreo

sources-sync puede guardar la evidencia diaria de Webmaster en un historial SQLite local, así acumulas datos más allá de lo que devuelve la API en una sola consulta. evidence-join adjunta filas indexadas por URL a un rastreo y lista candidatas a páginas huérfanas para revisar. Ninguno de los dos pasos cambia el rastreo.

  • Usa --source webmaster o webmaster_history con sources-sync.
  • Las URL que solo aparecen en el rastreo, las que son solo externas y las que no se pueden emparejar se mantienen nombradas y separadas.
  • Las filas guardadas pueden incluir consultas y URL, así que mantén esos archivos fuera de Git.

Tres pasos, un análisis guardado

  1. Apunta a un host verificado

    El comando necesita un ID de host de Yandex Webmaster de un sitio que hayas verificado, más el token OAuth configurado en local. Sin el ID de host no se ejecuta.

  2. Pide consultas de una URL

    Pide una página exacta con --url, o un grupo con --url-contains. Los límites son explícitos: --max-urls y --max-queries-per-url, con --start-date y --end-date opcionales.

  3. Une las filas a tu rastreo

    Mantén separadas las filas de URL y las de consulta. El paso evidence-join adjunta las filas indexadas por URL a un rastreo y lista candidatas a páginas huérfanas para revisar, sin cambiar el rastreo.

Un solo comando

bash
seohead webmaster-url-queries --url https://example.com/

Primero, instala SpiderHead: guía de instalación. Cada comando también funciona como herramienta MCP para agentes de IA.

Qué necesitas

  • Un ID de host verificado en Yandex Webmaster (--host-id)
  • Un token OAuth de Yandex con acceso a ese host
  • Una URL exacta o una subcadena de URL

Límites

  • Solo se pueden leer los hosts verificados en tu propia cuenta.
  • Yandex conserva los datos de consultas durante un periodo móvil limitado. Un rango de fechas que termina hace más de 14 días se rechaza.
  • Los resultados tienen un límite, y un resultado truncado se marca como tal.
  • Otras operaciones de Webmaster, como la indexación y los diagnósticos, se ejecutan con provider-collect, no con este comando.

Preguntas

¿Necesito un host verificado en Yandex Webmaster?
Sí. El comando recibe un ID de host verificado (--host-id) y un token OAuth configurado en tu equipo. SpiderHead no crea cuentas ni inicia sesión por ti.
¿Cambia algo en Yandex o en mi sitio?
No. Es una petición de solo lectura. Devuelve estadísticas de consultas de las URL que indiques y no escribe nada ni en Yandex ni en el sitio.
¿Se suman clics y posiciones entre páginas?
No. Cada URL conserva sus propias filas de consultas. El CTR y la posición media no se suman entre páginas, y la respuesta indica los límites que aplicó.
¿Cuánto cuesta?
Nada más allá de la cuota de la API de Yandex Webmaster. El conjunto de herramientas indica que el proveedor es gratuito dentro de esa cuota.
¿Puedo guardar un historial más allá de la ventana de la API?
Sí, con sources-sync. Guarda la evidencia diaria de Webmaster en un historial SQLite local, así puedes acumular datos con el tiempo. No puede recuperar los días que Yandex ya no devuelve.
¿Puedo usarlo desde un asistente de IA?
Sí. El servidor MCP local expone la misma operación como seo_webmaster_url_queries.

Sigue explorando

Del blog y el glosario

Yandex WebmasterGlosario

Más de este grupo · Fuentes de datos

Integración con Google Search ConsoleFunciónDatos de GA4 y Yandex MetrikaFunciónInforme de Core Web Vitals de CrUXFunciónAnalizador de logs de servidorFunciónComprobador de backlinks para una lista de donantesFunciónHerramienta para crear el núcleo semánticoFunción

Pruébalo en tu propio sitio

Descargar ZIPTodas las funciones