PreTestAds

Scripts de Agente PreTestAds

Scripts de código abierto para puntuar anuncios de video/imagen con el PreTestAds modelo neuronal (AdCortex™, entrenado con datos de respuesta cerebral por fMRI) — desde cualquier plataforma LLM popular usando tu propia clave de API, o desde cualquier agente compatible con x402 que tenga una billetera de criptomonedas.

Sin cuenta de PreTestAds. Sin clave de API de PreTestAds. Cada ejecución de puntuación cuesta $5.00 USDC, pagado por solicitud mediante el protocolo x402 (HTTP 402) en Solana o Base.

Qué hace la API

POST https://pretestads.com/api/v1/score — envía un anuncio de video (MP4/MOV/AVI) o imagen (JPG/PNG/WebP) mediante URL o carga de archivo. Recibes un ID de trabajo; 5–8 minutos después, GET https://pretestads.com/api/v1/score/{id} (gratis) devuelve:

• Puntuación 0–100 (percentil vs. 76 anuncios de TikTok de alto rendimiento) con una etiqueta: débil (<40) / moderada (40–69) / fuerte (70+)
• Fuerza del gancho (primeros 3s), caída de atención por segundo, momento pico, señal de compra
• Serie temporal de interacción por segundo

También existe un endpoint de $0.50 para descargar cualquiera de los 76 videos de referencia: GET https://pretestads.com/api/benchmarks/{ad_id}/video.

Documentación completa para agentes: pretestads.com/api-for-ai-agents · llms.txt

Qué hay en este repositorio

Directorio	Qué es	¿Necesita tu clave de API?
python/score_ad.py	CLI de agente x402 simple — paga, envía, consulta	ninguna (solo una billetera)
python/openai_agent.py	Agente de función-calling de OpenAI	OPENAI_API_KEY
python/anthropic_agent.py	Agente de uso de herramientas de Claude	ANTHROPIC_API_KEY
python/gemini_agent.py	Agente de función-calling de Gemini	GEMINI_API_KEY
python/langchain_tool.py	Herramienta de LangChain + bucle de agente	clave del proveedor
python/crewai_tool.py	Herramienta de CrewAI + ejemplo de crew	clave del proveedor
python/download_benchmark_video.py	Comprar un video de referencia ($0.50)	ninguna
javascript/score-ad.mjs	CLI de agente x402 simple (Node)	ninguna
javascript/openai-agent.mjs	Agente de función-calling de OpenAI	OPENAI_API_KEY
javascript/anthropic-agent.mjs	Agente de uso de herramientas de Claude	ANTHROPIC_API_KEY
javascript/gemini-agent.mjs	Agente de función-calling de Gemini	GEMINI_API_KEY
javascript/vercel-ai-tool.mjs	Herramienta del SDK de IA de Vercel	clave del proveedor
javascript/langchainjs-tool.mjs	Herramienta de LangChain.js	clave del proveedor
javascript/download-benchmark-video.mjs	Comprar un video de referencia ($0.50)	ninguna
mcp-server/	Servidor MCP — usar desde Claude Desktop, Claude Code, Cursor, etc.	ninguna
skills/score-ads/	Habilidad de Claude Code / Cowork	ninguna

Cada script paga con tu billetera, firmando localmente: establece SOLANA_PRIVATE_KEY (base58) y/o EVM_PRIVATE_KEY (0x-hex, Base). Las claves privadas nunca salen de tu máquina — solo firman el payload de pago.

Inicio rápido (sin LLM, solo puntúa un anuncio)

Python:

cd python && pip install -r requirements.txt
SOLANA_PRIVATE_KEY=<base58> python score_ad.py https://example.com/ad.mp4
# or a local file:
EVM_PRIVATE_KEY=0x... python score_ad.py ~/Desktop/ad.mp4

Node:

cd javascript && npm install
EVM_PRIVATE_KEY=0x... node score-ad.mjs https://example.com/ad.mp4

Inicio rápido (agente LLM con tu clave de API)

cd python && pip install -r requirements.txt openai
OPENAI_API_KEY=sk-... SOLANA_PRIVATE_KEY=<base58> \
  python openai_agent.py "Score this ad and tell me how to improve it: https://example.com/ad.mp4"

El LLM decide cuándo llamar a la herramienta score_ad; la herramienta paga $5 USDC mediante x402, espera el resultado y entrega la puntuación al modelo para que la interprete.

Cómo funciona el flujo x402

1. POST /api/v1/score sin pago → HTTP 402 con un array de accepts (precio, activo USDC, red, payTo para Solana y Base).
2. Tu SDK de cliente x402 firma una autorización de pago USDC con tu clave local.
3. Reintenta el POST con el encabezado de pago → el servidor verifica y liquida mediante el facilitador → HTTP 202 con {id, status_url, payment}.
4. Consulta GET /api/v1/score/{id} (gratis) hasta que status sea complete (~5–8 min).

Un pago = una ejecución. Las pruebas de pago repetidas se rechazan. El contenido no válido (422) nunca se cobra.

Configuración de la billetera

• Solana: una billetera con USDC y un poco de SOL. Exporta la clave secreta base58.
• Base: una billetera con USDC y un poco de ETH en Base. Exporta la clave privada 0x.
• Usa una billetera caliente dedicada solo con lo que planeas gastar — estos scripts leen la clave de una variable de entorno.

Variables de entorno

Consulta .env.example. Nunca subas un .env real.

Licencia

MIT — ver LICENSE.