PreTestAds

Avalie anúncios em vídeo/imagem antes de gastar — atenção prevista comparada com 76 melhores anúncios do TikTok; $5 USDC por execução via x402, ou créditos de conta via servidor remoto OAuth.

GitHubExperimente este MCPPatrocinado

Documentação

PreTestAds Agent Scripts

Scripts de código aberto para pontuar anúncios em vídeo/imagem com o modelo neural PreTestAds (AdCortex™, treinado em dados de resposta cerebral por fMRI) — a partir de qualquer plataforma LLM popular usando sua própria chave de API, ou de qualquer agente compatível com x402 com uma carteira de criptomoedas.

Sem conta PreTestAds. Sem chave de API PreTestAds. Cada execução de pontuação custa $5,00 USDC, pago por requisição via protocolo x402 (HTTP 402) na Solana ou Base.

O que a API faz

POST https://pretestads.com/api/v1/score — envie um anúncio em vídeo (MP4/MOV/AVI) ou imagem (JPG/PNG/WebP) por URL ou upload de arquivo. Você recebe um ID de job; 5–8 minutos depois, GET https://pretestads.com/api/v1/score/{id} (grátis) retorna:

Pontuação 0–100 (percentil vs. 76 anúncios TikTok de melhor desempenho) com um rótulo: fraco (<40) / moderado (40–69) / forte (70+)
Força do Gancho (primeiros 3s), Segundo de Queda de Atenção, Momento de Pico, Sinal de Compra
Série temporal de engajamento por segundo

Há também um endpoint de $0,50 para baixar qualquer um dos 76 vídeos de referência: GET https://pretestads.com/api/benchmarks/{ad_id}/video.

Documentação completa do agente: pretestads.com/api-for-ai-agents · llms.txt

O que há neste repositório

Diretório	O quê	Chave de API necessária
`python/score_ad.py`	CLI de agente x402 simples — pagar, enviar, consultar	nenhuma (apenas uma carteira)
`python/openai_agent.py`	Agente de chamada de função OpenAI	`OPENAI_API_KEY`
`python/anthropic_agent.py`	Agente de uso de ferramentas Claude	`ANTHROPIC_API_KEY`
`python/gemini_agent.py`	Agente de chamada de função Gemini	`GEMINI_API_KEY`
`python/langchain_tool.py`	Ferramenta LangChain + loop de agente	chave do provedor
`python/crewai_tool.py`	Ferramenta CrewAI + exemplo de crew	chave do provedor
`python/download_benchmark_video.py`	Comprar um vídeo de referência ($0,50)	nenhuma
`javascript/score-ad.mjs`	CLI de agente x402 simples (Node)	nenhuma
`javascript/openai-agent.mjs`	Agente de chamada de função OpenAI	`OPENAI_API_KEY`
`javascript/anthropic-agent.mjs`	Agente de uso de ferramentas Claude	`ANTHROPIC_API_KEY`
`javascript/gemini-agent.mjs`	Agente de chamada de função Gemini	`GEMINI_API_KEY`
`javascript/vercel-ai-tool.mjs`	Ferramenta Vercel AI SDK	chave do provedor
`javascript/langchainjs-tool.mjs`	Ferramenta LangChain.js	chave do provedor
`javascript/download-benchmark-video.mjs`	Comprar um vídeo de referência ($0,50)	nenhuma
`mcp-server/`	Servidor MCP — use a partir do Claude Desktop, Claude Code, Cursor, etc.	nenhuma
`skills/score-ads/`	Skill Claude Code / Cowork	nenhuma

Cada script paga com sua carteira, assinado localmente: defina SOLANA_PRIVATE_KEY (base58) e/ou EVM_PRIVATE_KEY (0x-hex, Base). As chaves privadas nunca saem da sua máquina — elas apenas assinam o payload de pagamento.

Início rápido (sem LLM, apenas pontue um anúncio)

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

Início rápido (agente LLM com sua chave 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"

O LLM decide quando chamar a ferramenta score_ad; a ferramenta paga $5 USDC via x402, aguarda o resultado e devolve a pontuação ao modelo para interpretação.

Como funciona o fluxo x402

POST /api/v1/score sem pagamento → HTTP 402 com um array accepts (preço, ativo USDC, rede, payTo para Solana e Base).
Seu SDK de cliente x402 assina uma autorização de pagamento USDC com sua chave local.
Repita o POST com o cabeçalho de pagamento → o servidor verifica + liquida via facilitador → HTTP 202 com {id, status_url, payment}.
Consulte GET /api/v1/score/{id} (grátis) até que status seja complete (~5–8 min).

Um pagamento = uma execução. Provas de pagamento repetidas são rejeitadas. Mídia inválida (422) nunca é cobrada.

Configuração da carteira

Solana: uma carteira com USDC e um pouco de SOL. Exporte a chave secreta base58.
Base: uma carteira com USDC e um pouco de ETH na Base. Exporte a chave privada 0x.
Use uma hot wallet dedicada apenas com o que você pretende gastar — esses scripts leem a chave de uma variável de ambiente.

Variáveis de ambiente

Veja .env.example. Nunca faça commit de um .env real.

Licença

MIT — veja LICENSE.