Ahora puedes configurar la Protección contra Bots de Kinsta y obtener analíticas detalladas del tráfico de bots a través de la API de Kinsta.

Hemos añadido 13 nuevos endpoints que te permiten comprobar y modificar los niveles de protección, bloquear los rastreadores de IA, gestionar la configuración de automatización de WordPress y crear reglas de excepción personalizadas. También puedes consultar estadísticas que muestran cómo se clasifica el tráfico, cómo se gestionan las solicitudes y qué fuentes generan más actividad.

Estas novedades te permiten incorporar la protección contra bots en tus herramientas de gestión del sitio, sistemas de monitorización y flujos de trabajo automatizados.

Comprueba y cambia los niveles de protección contra bots

Dos nuevos endpoints te permiten consultar y cambiar el nivel de protección contra bots de un entorno de WordPress.

El endpoint Get bot protection level devuelve la configuración actual del entorno:

curl --request GET \
  --url https://api.kinsta.com/v2/sites/environments/{env_id}/bot-protection/level \
  --header 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Por ejemplo, la respuesta que aparece a continuación muestra que el entorno está configurado para bloquear el tráfico automatizado:

{
  "bot_protection": {
    "id": "54fb80af-576c-4fdc-ba4f-b596c83f15a1",
    "level": "block-automations"
  }
}

Puedes usar el nuevo endpoint Establecer nivel de protección contra bots para cambiar entre los cuatro niveles disponibles:

  • block-malicious-traffic bloquea el tráfico malicioso conocido como parte de la protección básica de Kinsta.
  • block-automations bloquea el tráfico automatizado y malicioso.
  • challenge-bots también solicita autenticación a los posibles bots y al tráfico no clasificado.
  • challenge-everyone aplica pruebas a todo el tráfico no verificado, incluidos los visitantes que probablemente sean humanos.

Por ejemplo, si en un sitio se detecta un aumento de los casos de scraping o de solicitudes automáticas sospechosas, puedes activar la función Desafiar bots:

curl --request PUT \
  --url https://api.kinsta.com/v2/sites/environments/{env_id}/bot-protection/level \
  --header 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  --header 'Content-Type: application/json' \
  --data '{
    "level": "challenge-bots"
  }'

La API devuelve una respuesta 202 con un ID de operación:

{
  "message": "Setting a bot protection level in progress. Use the operation_id to check the status.",
  "status": 202,
  "operation_id": "environment:set-bot-protection-level-54fb80af-576c-4fdc-ba4f-b596c83f15a1"
}

Puedes usar el operation_id devuelto para seguir la solicitud hasta que el cambio se haya completado.

Unos niveles de protección más altos pueden afectar a las solicitudes automáticas legítimas y, en el nivel más estricto, suponer dificultades para los visitantes. Comprueba cómo afecta el nivel seleccionado al tráfico habitual de tu sitio antes de aplicarlo de forma más generalizada.

Bloquear o desbloquear rastreadores de IA

La API también ofrece dos endpoints para gestionar la configuración Bloquear rastreadores de IA. Puedes usar el endpoint Get AI crawler block status (Obtener estado de bloqueo de rastreadores de IA) para comprobar si el bloqueo está activado:

curl --request GET \
  --url https://api.kinsta.com/v2/sites/environments/{env_id}/bot-protection/ai-crawlers \
  --header 'Authorization: Bearer <YOUR_TOKEN_HERE>'

La respuesta incluye el campo ai_crawlers_blocking, que indica si la configuración está enabled o disabled.

Para cambiar la configuración, envía una solicitud PUT a la misma ruta:

curl --request PUT \
  --url https://api.kinsta.com/v2/sites/environments/{env_id}/bot-protection/ai-crawlers \
  --header 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  --header 'Content-Type: application/json' \
  --data '{
    "status": "enabled"
  }'

Si estableces el status en enabled, se bloquearán los rastreadores de IA, incluidos los rastreadores verificados que recopilan contenido de sitios web para el entrenamiento de IA y fines relacionados. Usa disabled para desactivar esta restricción específica.

La configuración Bloquear rastreadores de IA de Kinsta no bloquea a los rastreadores tradicionales de motores de búsqueda, como Googlebot y Bingbot, ni a los rastreadores de búsqueda de IA, como OAI-SearchBot, ni a los agentes de IA iniciados por los usuarios, como ChatGPT-User. Sin embargo, las solicitudes procedentes de estas fuentes pueden seguir siendo objeto de control bajo niveles de protección más estrictos si muestran un comportamiento excesivo.

Esto te ofrece un control independiente sobre la recopilación automatizada de contenido mediante IA sin cambiar el nivel de protección general de tu sitio.

Consulta la documentación de la API Block or unblock AI crawlers (Bloquear o desbloquear rastreadores de IA) para obtener todos los detalles sobre la solicitud y la respuesta.

Controla las automatizaciones de WordPress

Algunas funcionalidades e integraciones de WordPress dependen de solicitudes automatizadas a tu sitio web. Entre ellas pueden encontrarse servicios externos que acceden a la API REST de WordPress, plugins que intercambian datos con servicios de terceros o plataformas de automatización que envían webhooks.

Dos nuevos endpoints te permiten comprobar y controlar si las automatizaciones típicas de WordPress están permitidas a través de la protección contra bots.

El endpoint Get WP automations allow status devuelve la configuración actual:

{
  "bot_protection": {
    "id": "54fb80af-576c-4fdc-ba4f-b596c83f15a1",
    "wp_automations": "enabled"
  }
}

A continuación, puedes usar el endpoint Allow or block WP automations para cambiarla. Por ejemplo, la siguiente solicitud activa las automatizaciones típicas de WordPress:

curl --request PUT \
  --url https://api.kinsta.com/v2/sites/environments/{env_id}/bot-protection/wp-automations \
  --header 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  --header 'Content-Type: application/json' \
  --data '{
    "status": "enabled"
  }'

La solicitud devuelve un ID de operación que puedes usar para hacer un seguimiento del cambio. Esta configuración utiliza una lista de permitidos administrada por Kinsta que incluye los endpoints y servicios habituales de WordPress. Puede resultarte útil cuando una protección contra bots más estricta interfiera con una integración externa o un proceso automatizado del que dependa tu sitio.

Las solicitudes que se originan desde el propio contenedor del sitio o desde la infraestructura interna administrada por Kinsta ya están permitidas, así que las tareas internas normales de WordPress no se ven afectadas por esta configuración.

Añadir, consultar y eliminar excepciones de la protección contra bots

A veces necesitas reglas más específicas de las que ofrece un nivel de protección general. Por ejemplo, puede que quieras permitir solicitudes de un servicio de monitorización de confianza sin dejar de bloquear el resto del tráfico automatizado.

Tres endpoints te permiten gestionar excepciones a la protección contra bots para entornos individuales de WordPress.

Puedes crear una excepción utilizando el endpoint Add bot protection exception rule (Añadir regla de excepción a la protección contra bots). Cada regla tiene tres campos obligatorios:

  • type identifica qué se va a comparar: ip, path, user_agent o country.
  • action determina qué ocurre con el tráfico que coincida: skip, challenge o block.
  • value contiene la dirección IP, la ruta, el agente de usuario o el país con los que se debe coincidir.

Por ejemplo, la siguiente solicitud añade una excepción que permite que las solicitudes procedentes de una dirección IP de confianza eludan las reglas de protección contra bots:

curl --request POST \
  --url https://api.kinsta.com/v2/sites/environments/{env_id}/bot-protection/exception-rules \
  --header 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  --header 'Content-Type: application/json' \
  --data '{
    "type": "ip",
    "action": "skip",
    "value": "192.0.2.1"
  }'

La API devuelve un ID de operación cuando acepta la solicitud. Para consultar las excepciones configuradas, usa el endpoint Get bot protection exception rules (Obtener reglas de excepción de protección contra bots):

curl --request GET \
  --url https://api.kinsta.com/v2/sites/environments/{env_id}/bot-protection/exception-rules \
  --header 'Authorization: Bearer <YOUR_TOKEN_HERE>'

La respuesta muestra las reglas, incluyendo sus ID, los valores que coinciden y las acciones:

{
  "bot_protection": {
    "id": "54fb80af-576c-4fdc-ba4f-b596c83f15a1",
    "exception_rules": [
      {
        "id": "ip:skip:192.0.2.1",
        "type": "ip",
        "action": "skip",
        "value": "192.0.2.1"
      }
    ],
    "has_custom_waf_rules": false
  }
}

Puedes usar el ID de la regla con el nuevo endpoint Remove bot protection exception rule (Eliminar regla de excepción de protección contra bots):

curl --request DELETE \
  --url https://api.kinsta.com/v2/sites/environments/{env_id}/bot-protection/exception-rules \
  --header 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  --header 'Content-Type: application/json' \
  --data '{
    "exception_rule_id": "ip:skip:192.0.2.1"
  }'

Las excepciones se aplican a entornos individuales, así que una regla creada para un entorno staging no se aplica automáticamente al de producción.

La acción skip omite las reglas de protección contra bots, pero no anula la seguridad subyacente de la plataforma de Kinsta ni la protección contra vulnerabilidades.

Analiza el tráfico de bots a través de la API

Además de los nueve endpoints para gestionar la protección contra bots, hemos añadido cuatro endpoints a la sección de Analíticas.

Estos te proporcionan datos sobre las solicitudes que llegan a tu sitio web, cómo clasifica Kinsta ese tráfico y qué ocurre con esas solicitudes después de que la protección contra bots las evalúe.

Mira cómo gestiona la protección contra bots el tráfico entrante

El nuevo endpoint Get bot traffic flow devuelve los totales de solicitudes por clasificación de tráfico y resultado de la protección.

Puedes usarlo para ver cuántas solicitudes se clasificaron como probablemente humanas, probablemente bots, rastreadores de IA u otros tipos de tráfico, y cuántas se permitieron, se sometieron a verificación o se bloquearon.

Por ejemplo, la siguiente solicitud recupera datos de los últimos 30 días:

curl --request GET \
  --url 'https://api.kinsta.com/v2/sites/environments/{env_id}/analytics/bot-protection/traffic-flow?company_id={company_id}&time_span=30_days' \
  --header 'Authorization: Bearer <YOUR_TOKEN_HERE>'

La respuesta contiene tres secciones principales dentro de traffic_flow: traffic_types, results y flows. El objeto flows relaciona cada clasificación de tráfico con sus resultados de protección.

Esto te permite ver qué ha pasado con el tráfico, en lugar de fijarte solo en el recuento total de solicitudes bloqueadas.

Realiza un seguimiento del tráfico de bots y de los resultados de protección a lo largo del tiempo

Hay dos endpoints adicionales que ofrecen analíticas de series temporales:

  • Get bot traffic requests over time (Obtener solicitudes de tráfico de bots a lo largo del tiempo) devuelve el recuento de solicitudes agrupadas por clasificación de tráfico.
  • Get bot protection results over time  (Ver resultados de protección contra bots a lo largo del tiempo) devuelve el número de solicitudes permitidas, cuestionadas o bloqueadas durante el periodo seleccionado.

Ambos devuelven datos por hora cuando time_span está configurado en 24_hours, y datos diarios para periodos más largos.

Por ejemplo, el endpoint requests-over-time (solicitudes a lo largo del tiempo) devuelve datos en este formato:

{
  "analytics": {
    "requests_over_time": [
      {
        "traffic_type": "likely_humans",
        "label": "Likely humans",
        "total": 10572,
        "timeline": [
          {
            "date": "2026-09-14T00:00:00.000Z",
            "requests": 5286
          }
        ]
      }
    ]
  }
}

Estos datos pueden ayudarte a investigar aumentos inusuales en el tráfico y ver si los cambios en la configuración de protección contra bots afectan al número de solicitudes cuestionadas o bloqueadas.

Identifica las principales fuentes de tráfico de bots

El nuevo endpoint Get bot traffic top breakdown ofrece más detalles sobre las fuentes que hay detrás de cada clasificación de tráfico. Muestra las rutas, los agentes de usuario, los países y las direcciones IP más solicitados, junto con el número de solicitudes correspondientes.

Por ejemplo, si tu sitio web experimenta un aumento repentino de solicitudes automatizadas, puedes comprobar si esas solicitudes se concentran en /wp-login.php, en una ruta de API concreta o si provienen de direcciones IP específicas.

El endpoint devuelve la información enanalytics.top_requests_breakdown, con arrays separados top_paths, top_user_agents, top_countries y top_ips para cada categoría de tráfico.

Los cuatro nuevos endpoints de analíticas admiten 24_hours,7_days,30_daysy60_days, siendo7_days el valor por defecto. También puedes usar los parámetros opcionalesfrom y to para solicitar un intervalo de fechas personalizado. Cada solicitud requiere un parámetro de consultacompany_id.

Incorpora la protección contra bots a tus flujos de trabajo de gestión del sitio

Con estos endpoints, puedes incluir la configuración de la protección contra bots junto con otras tareas administradas a través de la API de Kinsta.

Por ejemplo, una herramienta de monitorización puede recuperar análisis del tráfico de bots durante un pico de tráfico, mientras que un sistema de gestión interno puede comprobar el nivel de protección actual de un entorno y aplicar una configuración diferente cuando sea necesario. También puedes gestionar excepciones para servicios de confianza sin tener que configurar cada entorno manualmente.

Encuentra los formatos completos de solicitud y respuesta en la referencia de la API de protección contra bots de WordPress y en la documentación de la API de Analíticas de Kinsta.