Validación de la estructura de carga útil de IndexNow para la indexación de búsqueda de Yandex

Una carga útil de la API de IndexNow es un objeto JSON estructurado enviado a través de una solicitud POST a Yandex para activar el rastreo inmediato de páginas nuevas o actualizadas. Esta carga útil debe incluir el dominio host, una clave de verificación y una matriz de URL que requieran reindexación. Al cumplir con los requisitos de formato exactos, los webmasters se aseguran de que el motor de búsqueda procese estas actualizaciones correctamente, evitando los tiempos de espera tradicionales asociados con los programas de rastreo de sitios estándar.

¿Cuáles son los componentes obligatorios de una carga útil de la API de IndexNow?

Para una notificación exitosa, el objeto JSON debe contener campos específicos que el servidor de Yandex espera. Si alguno de estos campos falta o tiene un formato incorrecto, la solicitud devolverá un código de error y las URL no se agregarán a la cola de rastreo. La estructura está diseñada para ser simple pero segura, requiriendo tanto los datos como la prueba de propiedad en una sola transmisión.

• host: El nombre de dominio donde se encuentran las URL (por ejemplo, example.com).
• key: Una cadena de 8 a 128 caracteres hexadecimales utilizada para la autenticación.
• keyLocation: Una URL opcional pero recomendada que apunta a la ubicación del archivo de clave.
• urlList: Una matriz de cadenas que contiene las URL completas que se han actualizado o creado.

El campo host no debe incluir el protocolo (http o https) a menos que lo especifique la guía de implementación para ese punto final específico. La clave debe coincidir con el contenido del archivo de texto alojado en su servidor. Este archivo sirve como un apretón de manos entre su sitio web y el robot de Yandex, confirmando que usted tiene la autoridad para solicitar la indexación para el dominio especificado.

¿Cómo formatear la solicitud JSON para Yandex?

Para enviar la carga útil de la API de IndexNow, debe utilizar el método POST dirigido al punto final de Yandex. Los encabezados de solicitud son tan vitales como el cuerpo. Debe establecer el ‘Content-Type’ en ‘application/json; charset=utf-8’. Esto asegura que el servidor interprete los datos correctamente, especialmente si sus URL contienen caracteres especiales o scripts no latinos.

Validar la estructura de la carga útil es un paso fundamental en el SEO técnico porque incluso una sola comilla faltante o una codificación de caracteres incorrecta puede evitar que sus actualizaciones lleguen al índice de búsqueda.

Equipo de SEO de Alien Road

La urlList puede contener hasta 10,000 URL en una sola solicitud. Cada URL debe ser una ruta absoluta, comenzando con el protocolo. Por ejemplo, ‘https://example.com/new-page’ es válida, mientras que ‘/new-page’ no lo es. Al enviar una solicitud masiva, el servidor procesa la lista y devuelve un código de respuesta que indica si el lote fue aceptado para su procesamiento.

¿Qué errores comunes ocurren durante la validación de la carga útil?

La mayoría de los fallos durante el proceso de validación provienen de pequeños errores de sintaxis o desajustes de configuración. Un problema común es una discrepancia entre la clave proporcionada en el JSON y la clave encontrada en el archivo .txt en el servidor. Si estos no se alinean perfectamente, el servidor de Yandex rechazará la solicitud con un estado 403 Forbidden. Otro error frecuente es la inclusión de URL de un host diferente al especificado en la carga útil.

La codificación de caracteres también juega un papel clave. Si sus URL contienen cirílico u otros caracteres especiales, deben estar correctamente codificadas por porcentaje. El JSON en sí debe estar codificado en UTF-8. No hacer esto podría llevar al servidor a leer mal las rutas de URL, lo que resultaría en errores 400 Bad Request. También es vital evitar enviar URL que no han cambiado, ya que el ruido excesivo puede llevar a una limitación de tasa.

Cómo aplica Alien Road la lógica de IndexNow

En Alien Road, integramos IndexNow directamente en los flujos de trabajo de gestión de contenido de nuestros clientes en Estambul. Comenzamos con una auditoría técnica para identificar qué acciones deberían activar una notificación. Para una cuenta típica, como un sitio de comercio electrónico grande, configuramos scripts automatizados que monitorean la disponibilidad del producto y los cambios de precio. Esto asegura que la carga útil de la API de IndexNow se envíe en el momento en que un producto se queda sin stock.

Nuestro proceso implica crear una clave única para el cliente y colocarla en el directorio raíz. Luego usamos un middleware basado en Python para agrupar las URL y enviarlas a Yandex en grupos de 500 a 1,000 para mantener la eficiencia. Monitoreamos el panel de Yandex Webmaster para rastrear la tasa de éxito de estos pings. Por ejemplo, si un cliente actualiza todo su catálogo, podemos ver que la frecuencia de rastreo aumenta casi de inmediato en los informes de diagnóstico.

Aunque IndexNow es eficiente, no es un sustituto de un mapa del sitio bien configurado. Lo tratamos como una capa de notificación activa que se asienta sobre los métodos de descubrimiento tradicionales para garantizar que el contenido más fresco esté siempre visible.

Equipo de SEO de Alien Road

Entendiendo los códigos de estado HTTP para IndexNow

Cuando envía su carga útil, el servidor de Yandex proporciona retroalimentación inmediata a través de códigos de estado HTTP. Monitorear estos códigos es la forma más efectiva de validar que su implementación está funcionando según lo previsto. Un código de éxito no garantiza la indexación, pero confirma que el motor de búsqueda ha recibido su notificación y ha agregado las URL a su cola de procesamiento.

• 200 OK: La solicitud se procesó con éxito.
• 202 Accepted: La solicitud fue aceptada y las URL están en cola para ser rastreadas.
• 400 Bad Request: La estructura JSON no es válida o el formato es incorrecto.
• 403 Forbidden: La clave no es válida o el archivo de clave no se pudo encontrar en la ubicación especificada.
• 422 Unprocessable Entity: Las URL no son válidas o no coinciden con el host proporcionado.
• 429 Too Many Requests: Ha excedido el límite diario de envíos.

¿Por qué se recomienda el campo keyLocation?

El campo keyLocation le dice al motor de búsqueda exactamente dónde encontrar el archivo de verificación en su servidor. Si bien el protocolo a menudo busca la clave en la raíz del host de forma predeterminada, proporcionar la ruta específica reduce el tiempo de procesamiento y evita posibles errores 403. Esto es particularmente útil para sitios que utilizan estructuras de subcarpetas complejas o aquellos que gestionan múltiples subdominios bajo una sola clave maestra.

Al incluir este campo, proporciona un rastro sólido para que el robot de Yandex lo siga. Si mueve su archivo de clave o utiliza un directorio personalizado por razones de seguridad, el campo keyLocation asegura que el apretón de manos permanezca intacto. Este enfoque detallado de la carga útil de la API de IndexNow evita que el sistema de notificación se rompa durante las migraciones del sitio o las actualizaciones del servidor.

Mejores prácticas para la gestión de listas de URL

La gestión de la urlList requiere un enfoque estratégico. Solo debe incluir URL que hayan experimentado cambios significativos o que sean completamente nuevas. Enviar miles de pings idénticos para páginas que no han cambiado es un uso ineficiente del presupuesto de rastreo. Además, debe verificar que las URL en la lista no estén bloqueadas por robots.txt o configuradas como ‘noindex’, ya que Yandex aún intentará visitarlas, desperdiciando recursos.

También es beneficioso agrupar sus actualizaciones. Si su sistema genera cientos de actualizaciones por minuto, espere y envíelas en una sola solicitud POST cada diez minutos. Esto reduce la cantidad de conexiones que su servidor tiene que abrir y hace que el proceso sea más confiable. La mayoría de los servidores modernos pueden manejar estas transmisiones JSON fácilmente, pero mantener una lista limpia y precisa es una señal de una configuración de SEO técnico sólida.

Pasos para la próxima semana

Para comenzar a usar esta tecnología, primero genere su clave API única y aloje el archivo de texto correspondiente en el directorio raíz de su sitio. Una vez que el archivo sea accesible, realice una prueba manual utilizando una herramienta como cURL o una colección de POSTMAN para enviar una sola URL al endpoint de Yandex. Verifique el código de respuesta para asegurarse de que devuelva un estado 200 o 202. Después de una prueba manual exitosa, puede proceder a automatizar la generación de la carga útil dentro de su CMS o lógica de backend para manejar futuras actualizaciones de contenido automáticamente.