Auditoría de visibilidad Guía MCP Panel de control Marca blanca Suscripción API REST Tracking IA

Plugin de Tracking

Instalar el Plugin de Tracking de AI Labs Audit

Detecte crawls de bots IA y referidos en su sitio web. 6 metodos de instalacion: WordPress, PHP, Node.js, Python, Cloudflare Worker o pixel JavaScript.

Requisitos previos

Antes de instalar el plugin de tracking, necesita crear una clave Tracking desde el dashboard de AI Labs Audit. Esto le dara sus 4 credenciales:

Ir a API e Integraciones

Inicie sesion en su cuenta AI Labs Audit y vaya a la pagina API e Integraciones.

Crear una clave Tracking

Haga clic en Crear una clave, seleccione el rol Client, elija el cliente, luego seleccione el tipo de clave Tracking IA (trk_live_...) y confirme.

Copie sus 4 credenciales

Un dialogo mostrara sus credenciales. Copielas todas inmediatamente, el HMAC Secret no se mostrara de nuevo:

API Key — su clave de tracking unica (formato: trk_live_...)
HMAC Secret — clave secreta para firmar payloads (nunca exponer del lado cliente)
Client ID — su identificador de cliente que vincula los datos a su cuenta
API URL — el endpoint: https://ailabsaudit.com/api/v1

Importante

El HMAC Secret solo se muestra una vez al momento de la creacion. Si lo pierde, debera crear una nueva clave Tracking.

Cumple con GDPR

El tracker no recopila datos personales. Solo detecta user-agents de bots IA y dominios de referidos IA. Sin cookies, sin rastreo de IP, sin fingerprinting.

Plugin WordPress

El plugin de WordPress es la forma mas facil de comenzar. Gestiona todo automaticamente: deteccion de bots IA, almacenamiento de eventos y envio programado.

Instalacion

Tiene dos opciones para instalar el plugin:

Opcion A: Subir via FTP / Gestor de archivos

Descargue el plugin desde GitHub y suba la carpeta ailabsaudit-tracker a /wp-content/plugins/.

Opcion B: Instalar desde el admin de WordPress

Vaya a Plugins > Anadir nuevo > Subir plugin, seleccione el archivo ZIP y haga clic en Instalar ahora.

Configuracion

Activar el plugin

Vaya a Plugins en su admin de WordPress, encuentre AI Labs Audit Tracker y haga clic en Activar.

Ingresar sus credenciales

Navegue a Configuracion > AI Labs Audit e ingrese su API Key, HMAC Secret, Client ID y API URL.

Probar la conexion

Haga clic en el boton "Test Connection" para verificar que sus credenciales son correctas y que los eventos pueden enviarse.

Como funciona

< 1ms deteccion

La deteccion de bots agrega menos de 1 milisegundo por carga de pagina.

Almacenamiento de eventos

Los eventos se almacenan en WP transient y se envian via WP-Cron cada 5 minutos.

Actualizacion diaria

Las firmas de bots y las listas de dominios de referidos se actualizan diariamente desde la API.

Compatible con cache de objetos

Funciona perfectamente con Redis, Memcached y otras soluciones de cache de objetos.

Cumple con GDPR

El plugin no recopila ningun dato personal. Solo detecta cadenas de user-agent de bots IA y dominios de referidos IA. Sin cookies, sin direcciones IP, sin rastreo de visitantes reales.

PHP Generico

Para sitios PHP que no sean WordPress, use el tracker PHP independiente con auto-deteccion integrada. Instalelo via Composer o copiando el archivo unico.

Instalacion

Composer

composer require ailabsaudit/tracker

Alternativamente, descargue AilabsTracker.php desde el repositorio GitHub e incluyalo directamente.

Ejemplo de uso

PHP

use AilabsAudit\Tracker\AilabsTracker;

$tracker = new AilabsTracker(
    apiKey: 'your-api-key',
    apiSecret: 'your-hmac-secret',
    clientId: 'your-client-id',
    apiUrl: 'https://ailabsaudit.com/api/v1',
    enableDetection: true,
    bufferStorage: '/tmp/ailabs_buffer.json'
);

// Llamar al inicio de su front controller
$tracker->detect();

Como funciona

Auto-deteccion es opt-in (enableDetection: false por defecto) para compatibilidad. Cuando esta habilitado, detect() identifica automaticamente bots IA y referidos de la solicitud actual.
Buffer: los eventos se persisten en un archivo JSON (LOCK_EX para seguridad de concurrencia) y se envian en lote.
Actualizacion API: las firmas de bots y listas de dominios de referidos se actualizan automaticamente desde la API (TTL 24h, soporte ETag).

Requisitos

PHP 7.4+, ext-curl, ext-json.

Node.js

Para backends Node.js (Express, Fastify, Next.js, etc.), use el paquete npm oficial con middleware Express integrado y auto-deteccion.

Instalacion

npm

npm install @ailabsaudit/tracker-node

Alternativamente, copie src/index.js desde el repositorio GitHub.

Ejemplo de uso

JavaScript

const { AilabsTracker, createMiddleware } = require('@ailabsaudit/tracker-node');

const tracker = new AilabsTracker({
  apiKey: 'your-api-key',
  apiSecret: 'your-hmac-secret',
  clientId: 'your-client-id',
  apiUrl: 'https://ailabsaudit.com/api/v1',
  enableDetection: true,
});

// Middleware Express — detecta bots y referidos automaticamente
app.use(createMiddleware(tracker));

// Apagado limpio — envia el buffer restante
process.on('SIGTERM', () => tracker.shutdown());

Como funciona

Auto-deteccion es opt-in (enableDetection: false por defecto). Cuando esta habilitado, el middleware detecta automaticamente bots IA y referidos en cada solicitud.
Buffer: buffer en memoria (max 500 eventos), enviado cada 5 min, debounce 30s. Reintento x3 en errores 5xx/429.
Actualizacion API: las firmas de bots y listas de referidos se actualizan desde la API (TTL 24h, soporte ETag).

Apagado limpio

tracker.shutdown() envia los eventos en buffer restantes y detiene todos los timers. Esencial para no perder eventos al detener su proceso.

Requisitos

Node.js 14+. Sin dependencias externas.

Python

Para backends Python (Django, Flask, FastAPI, etc.), use el paquete pip con middleware WSGI/ASGI y auto-deteccion.

Instalacion

pip

pip install ailabsaudit-tracker

Alternativamente, copie tracker.py desde el repositorio GitHub.

Ejemplo de uso

Python (Flask)

from ailabsaudit_tracker import AilabsTracker, WsgiMiddleware

tracker = AilabsTracker(
    api_key="your-api-key",
    api_secret="your-hmac-secret",
    client_id="your-client-id",
    api_url="https://ailabsaudit.com/api/v1",
    enable_detection=True,
)

# Middleware WSGI — detecta bots y referidos automaticamente
app.wsgi_app = WsgiMiddleware(app.wsgi_app, tracker)

# Apagado limpio — envia el buffer restante
import atexit
atexit.register(tracker.shutdown)

Como funciona

Auto-deteccion es opt-in (enable_detection=False por defecto). Cuando esta habilitado, el middleware detecta automaticamente bots IA y referidos en cada solicitud.
Buffer: buffer en memoria thread-safe (max 500 eventos), enviado cada 5 min via un hilo daemon timer. Reintento x3 en errores 5xx/429.
Actualizacion API: las firmas de bots y listas de referidos se actualizan desde la API en un hilo en segundo plano (TTL 24h, soporte ETag).

Apagado limpio

tracker.shutdown() envia los eventos en buffer restantes y detiene todos los hilos timer. Esencial para no perder eventos al detener su proceso (Gunicorn, uWSGI, etc.).

Requisitos

Python 3.8+. Sin dependencias externas. Compatible con WSGI (Flask, Django) y ASGI (FastAPI, Starlette).

Cloudflare Worker

Despliegue el tracker como un Cloudflare Worker para interceptar y analizar solicitudes en el borde, sin impacto en su servidor de origen.

Instalacion

Instalar Wrangler

Si aun no tiene Wrangler instalado:

Terminal

npm install -g wrangler

Configurar wrangler.toml

Clone el repositorio GitHub y edite wrangler.toml para establecer la variable API_URL.

wrangler.toml

[vars]
API_URL = "https://ailabsaudit.com/api/v1"

Configurar secretos

Agregue sus credenciales como secretos del Cloudflare Worker (nunca se exponen en el codigo):

Terminal

wrangler secret put API_KEY
wrangler secret put API_SECRET
wrangler secret put CLIENT_ID

Desplegar

Despliegue el Worker en la red edge de Cloudflare:

Terminal

wrangler deploy

Como funciona

Deteccion en el borde

Intercepta solicitudes GET en el borde de Cloudflare, antes de que lleguen a su servidor de origen.

90+ firmas de bots

Detecta mas de 90 firmas de user-agent de bots IA incluyendo GPTBot, ClaudeBot, Bingbot AI, etc.

30+ referidos IA

Identifica trafico de mas de 30 dominios de referidos IA como ChatGPT, Perplexity, You.com, etc.

Fire-and-forget

Los eventos se envian de forma asincrona via ctx.waitUntil() sin impacto en la latencia.

Actualizacion dinamica

Las firmas de bots y las listas de referidos IA se actualizan dinamicamente desde la API via la Cloudflare Cache API (TTL 24h). Si la API no esta disponible, el Worker recurre a sus listas codificadas incluidas en el despliegue.

Pixel JavaScript

Un tracker ligero del lado del cliente (< 2 KB) que se agrega como una unica etiqueta de script. Ideal para sitios estaticos, landing pages o cuando no tiene acceso del lado del servidor.

Instalacion

Agregue la siguiente etiqueta de script a su HTML, justo antes de la etiqueta de cierre </body>:

HTML

<script src="/path/to/tracker.js"
  data-tracker-id="YOUR_TRACKER_ID"
  data-api-url="https://ailabsaudit.com/api/v1/collect">
</script>

Que rastrea

page_view

Rastrea automaticamente cada vista de pagina con URL e informacion de referido.

page_leave

Captura eventos de salida de pagina con el tiempo en la pagina y la profundidad de scroll.

click

Rastrea eventos de clic en enlaces y elementos interactivos.

Nota de seguridad

Los payloads del lado del cliente no estan firmados (los secretos HMAC no pueden exponerse en el navegador). Los payloads se validan del lado del servidor por dominio de origen. Asegurese de que su dominio este registrado en su configuracion de AI Labs Audit.

Verificacion

Una vez que haya desplegado el tracker, verifique que todo funciona correctamente desde su dashboard de AI Labs Audit.

Abrir su dashboard

Inicie sesion en su cuenta AI Labs Audit y navegue a la pagina de Tracking de su cliente.

Verificar los crawls de bots

Los crawls de bots IA deberian empezar a aparecer minutos despues del despliegue. Busque entradas de GPTBot, ClaudeBot, Bingbot y otros crawlers IA.

Verificar los referidos IA

El trafico referido desde plataformas IA (ChatGPT, Perplexity, Copilot, etc.) tambien aparecera en el dashboard a medida que ocurra.

Revisar los detalles del evento

Haga clic en cualquier evento para ver los detalles completos: user-agent, URL rastreada, marca de tiempo, codigo de estado y tamano de respuesta.

Consejo

Si no ve datos despues de unos minutos, verifique sus credenciales en la configuracion del plugin y asegurese de que su servidor puede acceder a https://ailabsaudit.com/api/v1. Para WordPress, verifique que WP-Cron este funcionando correctamente.

Listo para rastrear la visibilidad IA?

Instale el tracker en minutos y comience a monitorear la actividad de bots IA en su sitio web.

Ver en GitHub Obtener sus credenciales

¿Listo para auditar tu visibilidad en IA?

Crea tu cuenta gratuita y recibe 1000 créditos de bonificación.

Crear cuenta gratuita