Cómo validar el microformato hCard con el validador de Yandex

Validar el microformato hCard requiere utilizar el validador de datos estructurados de Yandex para comprobar si hay errores en tu marcado de contacto. Pegas tu URL o código en la herramienta para confirmar que la raíz vcard y los elementos obligatorios como fn, org y adr están presentes. Esto garantiza que Yandex Business pueda extraer correctamente la dirección física y el número de teléfono de tu organización para los resultados de búsqueda en regiones compatibles como Rusia o Kazajistán.

¿Qué es el validador de datos estructurados de Yandex?

El validador de datos estructurados de Yandex es una herramienta especializada dentro del panel de Yandex Webmaster diseñada para verificar cómo el motor de búsqueda analiza los microformatos, Schema.org y otros marcados semánticos. Para hCard, busca específicamente la clase vcard y sus propiedades asociadas. El uso de esta herramienta es un paso clave antes de enviar tu sitio para su indexación, ya que evita fallos en la extracción de datos que podrían impedir que tu negocio aparezca en mapas o en fragmentos de búsqueda local.

Cuando utilizas el validador, puedes proporcionar un enlace directo a una página en vivo o pegar un bloque de código HTML. La herramienta analiza la jerarquía de tus etiquetas y resalta los campos obligatorios faltantes o el anidamiento incorrecto. Esta retroalimentación inmediata permite a los desarrolladores solucionar problemas en el código antes de que el robot de Yandex visite el sitio.

¿Qué propiedades de hCard son obligatorias para Yandex?

Yandex tiene un conjunto estricto de requisitos para aceptar datos de organizaciones en su directorio de empresas. Si estas propiedades específicas faltan o tienen un formato incorrecto, el validador las marcará como errores. El motor requiere una identificación clara de la entidad comercial y una ubicación física que los usuarios puedan visitar.

• vcard: El elemento raíz que debe envolver toda la demás información de contacto.
• fn y org: El nombre completo y el nombre de la organización. Yandex exige que estos tengan el mismo valor.
• adr: El contenedor de la dirección física que debe incluir datos detallados de la ubicación.
• locality: La ciudad o localidad donde se encuentra el negocio.
• tel: Un número de teléfono válido que incluya el código de ciudad y de país.

El error más común que vemos es separar las clases fn y org. Yandex prefiere que estén en el mismo elemento, como una sola etiqueta span. Este simple ajuste a menudo resuelve las advertencias de validación de inmediato.

Equipo de SEO de Alien Road

¿Por qué el validador muestra errores para las propiedades anidadas?

Las reglas de procesamiento de marcado para hCard son bastante específicas sobre cómo deben estructurarse los elementos. Un problema frecuente ocurre cuando los desarrolladores anidan propiedades que el estándar no permite explícitamente. Por ejemplo, colocar un número de teléfono (tel) dentro de un bloque de dirección (adr) puede provocar un procesamiento incorrecto. A menudo, el validador no reconocerá el número de teléfono si está enterrado dentro de la jerarquía de la dirección.

Las reglas establecen que ciertas propiedades pueden anidarse dentro de la clase adr para proporcionar una ubicación detallada. Estas incluyen country-name, region, locality, street-address, extended-address y postal-code. Cualquier otro dato, como un logotipo o una dirección de correo electrónico, debe permanecer fuera del bloque adr pero aún dentro de la raíz vcard. Seguir estos límites estructurales es una forma sólida de garantizar que tus datos se lean correctamente.

Cómo aplica Alien Road la validación de hCard

Cuando Alien Road gestiona un proyecto para un cliente que apunta al mercado de la CEI, seguimos un proceso de verificación detallado. Comenzamos auditando la página de contacto existente para garantizar que la dirección física coincida con la prevista para Yandex Business. Dado que Yandex solo procesa estas tarjetas para Rusia, Ucrania, Bielorrusia y Kazajistán, primero confirmamos la relevancia regional del negocio.

En un compromiso típico, por ejemplo, para una cadena minorista en Almaty, implementamos bloques vcard separados para cada sucursal que tenga un número de teléfono único o una dirección específica. Usamos la etiqueta abbr con el atributo title para los números de teléfono para garantizar que el formato legible por máquina sea perfecto mientras se mantiene el texto visible fácil de usar para las personas. Una vez que el código está en funcionamiento, lo ejecutamos a través del validador de datos estructurados de Yandex y documentamos el estado ‘válido’ antes de pasar a la siguiente fase de la estrategia de SEO.

¿Se pueden validar varias sucursales en una sola página?

Sí, es posible validar varias ubicaciones en una sola página, pero debes seguir reglas específicas sobre cómo se agrupan. Si las sucursales comparten el mismo nombre y datos de contacto, como un solo número de centro de llamadas, puedes enumerar varias direcciones dentro de una tarjeta. Sin embargo, si las sucursales tienen nombres diferentes, números de teléfono únicos o direcciones de correo electrónico diferentes, debes crear un contenedor vcard separado para cada ubicación.

Yandex busca específicamente direcciones reales que las personas puedan visitar. Validar la dirección de una oficina legal o registrada que no atiende a clientes suele ser una pérdida de tiempo, ya que el objetivo de este marcado es ayudar a los usuarios a encontrar ubicaciones comerciales físicas. Al utilizar el validador, asegúrate de que cada vcard sea distinta y contenga todas las propiedades obligatorias de forma independiente.

Comprender el desglose del elemento adr

El componente de dirección es donde ocurren la mayoría de los errores técnicos. Para pasar la validación, el elemento adr debe desglosarse en sus partes constituyentes. Proporcionar una sola cadena de texto como dirección no suele ser suficiente para que el motor categorice la ubicación con precisión.

• country-name: El nombre del país (por ejemplo, Kazajistán).
• region: El estado o provincia, que es obligatorio si el nombre de la localidad no es único.
• locality: El nombre de la ciudad o asentamiento.
• street-address: El número de edificio específico y el nombre de la calle.
• extended-address: Detalles adicionales como el número de oficina, el piso o el nombre del centro de negocios.
• postal-code: El código postal estándar para el área.

Recuerda que Yandex Business es el destino final para estos datos. Si tu localidad no está claramente definida dentro de la etiqueta adr, es posible que el sistema no coloque tu negocio en el mapa correctamente, incluso si el resto del marcado es técnicamente válido.

Equipo de SEO de Alien Road

¿Cómo probar tus datos de contacto en busca de errores?

Las pruebas implican un flujo de trabajo simple dentro de la interfaz de Yandex Webmaster. Primero, navega a la sección ‘Tools’ y selecciona ‘Datos estructurados validator’. Verás un área de texto y un campo de entrada de URL. Si aún estás en la fase de desarrollo, copia tu fragmento de HTML y pégalo en el área de texto. Si tu sitio ya está en funcionamiento, introduce la URL de tu página de contacto.

Después de hacer clic en el botón de verificación, la herramienta generará un informe. Una validación exitosa mostrará una marca de verificación verde o un mensaje que indica que se encontró la hCard sin errores. Si hay problemas, la herramienta proporciona una lista de errores específicos, como ‘Missing mandatory field: org’ o ‘Incorrect nesting of tel’. Debes solucionar estos errores uno por uno hasta que el informe esté limpio.

Por dónde empezar esta semana

Comienza auditando tu página de contacto principal para ver si ya existe algún marcado hCard. Utiliza el validador de datos estructurados de Yandex para comprobar el estado actual de tu página. Si el validador no encuentra marcado o identifica errores, sigue estos pasos para resolverlos:

• Envuelve tu información de contacto en un div con la clase ‘vcard’.
• Asegúrate de que el nombre de la organización esté marcado con las clases ‘fn’ y ‘org’.
• Divide tu dirección en subpropiedades específicas como ‘locality’ y ‘street-address’.
• Comprueba que tu número de teléfono esté en formato internacional dentro del atributo title de una etiqueta ‘abbr’.
• Vuelve a ejecutar el validador para confirmar que todos los errores han desaparecido.

Una vez que la validación sea exitosa, puedes estar seguro de que Yandex indexará correctamente la ubicación de tu negocio. Si prefieres no usar marcado, también puedes enviar tus datos a través de la sección ‘Site geography’ en la consola de Yandex Webmaster, lo que sirve como una alternativa confiable para llevar tus detalles a Yandex Business.