ForHosting KIT · SEO

Comprobar canonical

Una etiqueta canonical que apunta silenciosamente a la URL equivocada es una de las formas más rápidas de ver desaparecer una página de los resultados de búsqueda mientras todo lo demás parece normal. Este endpoint lee el canonical declarado en cada página enviada, lo sigue y confirma con claridad si resuelve donde debería.

● EstableGratis · en su navegador

Ejecutar — gratis Cómo funciona y API

Úselo desde WebAPIEmailApp prontoTelegram pronto

El fallo que nadie nota a simple vista

Una etiqueta canonical no genera error, no redirige ni muestra ninguna advertencia en el navegador; simplemente le indica a un rastreador cuál URL es la autoritativa, y si esa URL es incorrecta, una página perfectamente válida puede terminar autocanibalizándose al declarar como canonical a otra página, o peor, apuntar a una URL que ya no existe. Como la página en sí se muestra con normalidad, muchos equipos descubren el problema recién cuando cae el posicionamiento y alguien finalmente revisa el código fuente.

Qué se comprueba

Para cada URL enviada, la tarea extrae el enlace canonical declarado, normaliza ambas URLs (protocolo, barra final, parámetros de consulta) y reporta si el canonical es autorreferencial, apunta a una URL distinta, está ausente, o forma una cadena: un canonical que apunta a una página que a su vez tiene su propio canonical hacia otro lado, algo que los buscadores generalmente no siguen más allá de un salto. También marca los canonicals que apuntan a una URL con estado distinto de 200, ya que un canonical hacia una página rota equivale, en la práctica, a no tener canonical.

Por qué existe esta etiqueta

El atributo rel=canonical se introdujo en 2009 específicamente para resolver el contenido duplicado: el mismo producto listado bajo tres parámetros de URL, el mismo artículo accesible con y sin barra final, versiones para imprimir junto al original. Funciona solo cuando es preciso; un canonical es una sugerencia fuerte, no una redirección, así que uno incorrecto no simplemente deja de ayudar, sino que puede desviar activamente la señal de posicionamiento hacia la página equivocada.

Dónde suele fallar

La navegación por facetas y la paginación son las fuentes más comunes de errores de canonical: un listado filtrado que canonicaliza hacia la página sin filtrar pierde la capacidad de posicionar por una consulta específica, mientras que una serie paginada que canonicaliza en bloque hacia la primera página puede sacar la segunda y siguientes del índice. Los sitios multilingües agregan otra capa, donde un canonical que apunta por error a otro idioma en vez del equivalente correcto es un fallo frecuente y difícil de detectar.

Automatizar la verificación

Como el endpoint es asíncrono, el mapa de canonicals de un sitio completo puede verificarse en una sola llamada por lotes: el task_id se devuelve de inmediato y el informe llega al webhook al terminar el rastreo. Ejecutarlo tras cada despliegue que toque plantillas detecta regresiones antes de que cuesten un ciclo de posicionamiento, a un costo lo bastante bajo como para correrlo sobre miles de URLs sin pensarlo dos veces.

Qué puede hacer con ella

Auditoría de navegación por facetas

Verificar que las páginas de listado filtradas y ordenadas canonicalicen correctamente en lugar de colapsar todas hacia la categoría base.

Verificación posterior al despliegue

Correr el verificador justo después de un cambio de plantilla para detectar un canonical que empezó a apuntar por error a un dominio de pruebas o al dominio antiguo.

Limpieza de contenido duplicado

Confirmar que las versiones imprimibles, AMP o con parámetros de una página canonicalizan de vuelta hacia la única URL prevista.

Validación de migración entre dominios

Durante un cambio de dominio, comprobar que los canonicals del dominio nuevo se apuntan a sí mismos en vez de seguir referenciando al antiguo.

Preguntas frecuentes

¿Qué verifica exactamente una API de comprobación de canonical?

Extrae el enlace rel=canonical de cada página enviada, resuelve y normaliza la URL de destino, y reporta si es autorreferencial, está desajustada, ausente, forma una cadena o apunta a una URL rota.

¿Puede detectar cadenas de canonical?

Sí; si un canonical apunta a una página que a su vez tiene su propio canonical hacia otro lugar, el informe marca la cadena, algo que los buscadores generalmente no siguen más allá de un salto.

¿Un canonical es lo mismo que una redirección?

No. Un canonical es una sugerencia para los buscadores sobre la URL preferida; la página en sí se sigue cargando con normalidad, y por eso los desajustes pasan inadvertidos sin una verificación dedicada.

¿Cuánto cuesta cada solicitud?

0.002 dólares por solicitud, cobrados solo cuando la verificación se completa con éxito; las solicitudes fallidas se reintentan hasta tres veces y nunca se cobran.

¿Hay prueba gratuita?

La herramienta de arriba es gratis en su navegador. La API es de pago: cada llamada se descuenta de su saldo prepago de ForHosting KIT — se recarga desde $10.00 (no caduca), se paga el precio publicado de cada solicitud, y una llamada sin saldo devuelve HTTP 402. Sin suscripción, sin tokens, y una tarea fallida no se cobra.

¿Cómo llegan los resultados?

Por webhook firmado, la opción recomendada para flujos automatizados, o mediante un enlace firmado válido por 24 horas.

¿Puedo comprobar los canonicals de todo un sitemap en una sola llamada?

Sí, se envía un lote de URLs en una sola solicitud y la tarea devuelve un desglose por URL cuando termina el rastreo.

¿Funciona en sitios multilingües?

Sí, y ahí es especialmente útil, porque detecta un canonical que por error apunta a otra versión de idioma en lugar de a la URL correcta del mismo idioma.

Para desarrolladores — acceso por API

Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.

Endpoint de API

POSThttps://api.kit.forhosting.com/seo/canonical-check

¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, y pronto desde nuestra app, el email y Telegram.

Llámela desde su stack

curl -X POST https://api.kit.forhosting.com/seo/canonical-check \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d &#39;{"url":"https://ejemplo.com"}'

const res = await fetch("https://api.kit.forhosting.com/seo/canonical-check", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "url": "https://ejemplo.com"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/seo/canonical-check",
    headers={"Authorization": f"Bearer {os.environ[&#39;KIT_KEY']}"},
    json={
    "url": "https://ejemplo.com"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/seo/canonical-check", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => &#39;{"url":"https://ejemplo.com"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"url":"https://ejemplo.com"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/seo/canonical-check", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Ejemplo de solicitud

{
  "url": "https://ejemplo.com"
}

Ejemplo de respuesta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "seo.canonical_check",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.

Precio

Por solicitud$0.002

Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.

Errores

HTTP	Código	Significado
`401`	`unauthorized`	API key ausente o inválida.
`402`	`insufficient_balance`	El saldo no cubre el precio de la tarea.
`404`	`unknown_type`	El tipo de tarea no existe.
`429`	`rate_limited`	Demasiadas peticiones. Use el webhook en vez de sondear.

Ver la documentación completa del KIT →

Ejecutar — gratis