OpenAdLibrary

npx add-mcp 'https://mcp.openadlibrary.com/mcp'

Documentación de la API y MCP de OpenAdLibrary

Consulta el catálogo público de anuncios de forma programática con los mismos datos seguros contra fugas disponibles en el producto.

Crear y proteger una clave de API

Crea una clave desde Configuración. Una clave se muestra una sola vez cuando se crea, así que guárdala de forma segura y revócala si queda expuesta.

Autenticar solicitudes

Envía la clave en el encabezado x-api-key o como Authorization: Bearer <key>. La misma clave puede autenticar la API REST y el endpoint MCP alojado.

API REST

La API pública expone campos de la biblioteca de anuncios seguros contra fugas y admite filtrado y paginación. También publica la cadena de redireccionamiento detrás de un anuncio — la URL del rastreador donde comienza el clic, cada salto por el que pasa y la URL del anunciante donde termina — a través de /api/v1/ads/{id}/chain, /api/v1/chains/{chainHash} y /api/v1/chains/match. Las URL de la cadena se limpian de credenciales, mientras que los parámetros de atribución como subid, click_id y utm_* permanecen intactos. La API no expone datos privados de cuentas ni identificadores internos. La referencia interactiva se carga en esta página cuando JavaScript está disponible.

Cuotas y respuestas

Las cuentas gratuitas reciben una pequeña asignación diaria; las cuentas suscritas reciben la cuota completa del plan. Consulta la cuota en vivo que se muestra junto a tus claves en Configuración. Una asignación agotada del plan puede devolver 402 Payment Required, mientras que los límites de ráfaga o de tasa del plan suscrito devuelven 429 Too Many Requests.

Endpoint MCP alojado

Conecta un asistente compatible con MCP a https://mcp.openadlibrary.com/mcp y proporciona la clave en el encabezado Authorization. También hay documentación legible por máquina disponible en llms.txt y llms-full.txt.