Auditor IA para desarrolladores y agentes de IA

Auditor IA revisa listas de prospectos B2B en busca de registros inválidos, incompletos, duplicados y contradictorios, y devuelve decisiones estructuradas procesar, revisar, verificar y descartar antes de que gastes en enriquecimiento o actives una campaña. La misma cuenta, créditos e historial que la aplicación web.

Usa Auditor IA antes de enriquecer, importar a un CRM o activar una lista de prospectos B2B.

La muestra (primeros 250 registros) es gratis. Una auditoría completa cuesta 1 crédito por registro y se cobra una sola vez. Los límites de ritmo solo frenan ráfagas y sobrecarga: no hay cuota mensual ni tope de volumen.

1. Crea una clave API

Inicia sesión, abre Cuenta → Claves API y crea una clave. Se muestra una sola vez: guárdala en un gestor de secretos o en una variable de entorno. Puedes fijar un límite diario de créditos por clave y revocarlas cuando quieras.

2. Conecta un agente de IA (MCP)

Servidor MCP remoto (Streamable HTTP, sin estado) en https://pilot.useauditoria.com/mcp

Claude Code

claude mcp add --transport http auditor-ia https://pilot.useauditoria.com/mcp \
  --header "Authorization: Bearer $AUDITOR_IA_API_KEY"

Cursor

Añadir a Cursor

El botón instala el servidor con la cabecera Authorization: Bearer ${env:AUDITOR_IA_API_KEY}. Define AUDITOR_IA_API_KEY en tu entorno y reinicia Cursor. Nunca pongas una clave en un enlace.

~/.cursor/mcp.json

{
  "mcpServers": {
    "auditor-ia": {
      "url": "https://pilot.useauditoria.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:AUDITOR_IA_API_KEY}"
      }
    }
  }
}

Codex

# ~/.codex/config.toml
[mcp_servers.auditor-ia]
url = "https://pilot.useauditoria.com/mcp"
bearer_token_env_var = "AUDITOR_IA_API_KEY"

Cualquier otro cliente MCP: usa la URL de arriba con la cabecera Authorization: Bearer <API key>.

Inicia sesión con OAuth (Claude y otros clientes OAuth)

Los clientes compatibles con la autorización MCP (OAuth 2.1 con PKCE y registro dinámico de clientes) se conectan solo con la URL: inicias sesión en Auditor IA, revisas los permisos solicitados y apruebas. Permisos: audit:read, audit:write (ejecuta auditorías y gasta créditos), balance:read. Gestiona o desconecta aplicaciones en Cuenta → Aplicaciones conectadas. Las claves API siguen funcionando igual.

https://pilot.useauditoria.com/.well-known/oauth-authorization-server · https://pilot.useauditoria.com/.well-known/oauth-protected-resource/mcp

Herramientas

3. API REST

Especificación legible por máquinas: /openapi.json · /llms.txt

Estimación (nunca cobra)

curl -s https://pilot.useauditoria.com/api/v1/audits/estimate -H "Authorization: Bearer $AUDITOR_IA_API_KEY" \
  -H "Content-Type: text/csv" --data-binary @leads.csv

Muestra gratuita

curl -s https://pilot.useauditoria.com/api/v1/audits -H "Authorization: Bearer $AUDITOR_IA_API_KEY" \
  -H "Content-Type: application/json" \
  -d "$(jq -Rs '{csv: ., file_name: "leads.csv", mode: "sample"}' leads.csv)"

Auditoría completa (de pago, idempotente)

curl -s https://pilot.useauditoria.com/api/v1/audits -H "Authorization: Bearer $AUDITOR_IA_API_KEY" \
  -H "Idempotency-Key: leads-2026-09-27-0001" \
  -F file=@leads.csv -F mode=full -F max_credits=5000

Consultar una auditoría y su CSV anotado

curl -s https://pilot.useauditoria.com/api/v1/audits/AUDIT_ID -H "Authorization: Bearer $AUDITOR_IA_API_KEY"
curl -s -o annotated.csv https://pilot.useauditoria.com/api/v1/audits/AUDIT_ID/annotated.csv -H "Authorization: Bearer $AUDITOR_IA_API_KEY"
curl -s https://pilot.useauditoria.com/api/v1/balance -H "Authorization: Bearer $AUDITOR_IA_API_KEY"

Python

import os, requests

API = "https://pilot.useauditoria.com/api/v1"
H = {"Authorization": f"Bearer {os.environ['AUDITOR_IA_API_KEY']}"}
csv = open("leads.csv", encoding="utf-8").read()

est = requests.post(f"{API}/audits/estimate", json={"csv": csv}, headers=H).json()
audit = requests.post(
    f"{API}/audits",
    json={"csv": csv, "mode": "full", "max_credits": est["full_audit_cost_credits"]},
    headers={**H, "Idempotency-Key": "leads-2026-09-27-0001"},
).json()
print(audit["classifications"])

Idempotencia y cobro

• Las auditorías completas requieren Idempotency-Key (cabecera REST) o aceptan idempotency_key (MCP; se deriva del contenido si se omite). Reintentar con la misma clave y archivo devuelve la misma auditoría con idempotent_replay: true y sin nuevo cobro.
• El mismo archivo auditado completo en cualquier superficie (web, REST, MCP) nunca se cobra dos veces: una nueva solicitud devuelve 409 ALREADY_PROCESSED con el id existente. Para reauditarlo a propósito, envía rerun: true con una clave nueva.
• Reutilizar una clave para otro archivo devuelve 409 IDEMPOTENCY_KEY_REUSED.
• Si una auditoría completa falla después del débito, los créditos se reembolsan automáticamente.
• max_credits rechaza cualquier auditoría que cueste más (422, sin cobro). El límite diario de una clave se aplica de forma atómica (422 SPEND_GUARD_EXCEEDED).

Errores

Todos los errores usan {"error": {"code", "message", …}}.

Límites

• CSV: UTF-8, hasta 20 MB y 100.000 registros por solicitud.
• Por clave: ráfagas de hasta 30 solicitudes (10/segundo sostenido) y 3 auditorías simultáneas (429 RATE_LIMITED con Retry-After).
• Capacidad global (todas las auditorías, y las completas por separado): 503 BUSY con Retry-After si está saturada momentáneamente.
• Los CSV anotados se conservan 14 días.

Más

Terms · Privacy · Support