SlopIA, desde tu código

La misma nota que en la web, en JSON: para tu terminal, tu asistente de IA o cada cambio que subes a GitHub.

La clave

Leer resultados, reglas, dominios publicados y el ranking no necesita clave. Para analizar, sí: entra en tu panel con el correo con el que vigilas o publicaste una web y crea una en «Claves de la API». Cada clave hace 50 análisis al día. Va en la cabecera Authorization:

curl -X POST https://slopia.zetit.cloud/api/v1/analisis \
  -H "Authorization: Bearer slp_tu_clave" \
  -H "Content-Type: application/json" \
  -d '{"url": "zetit.es"}'

La respuesta trae la nota, la letra, el veredicto, los tres fallos que más restan con su arreglo, las 19 señales, lo que midió Chromium y los enlaces al resultado, al informe y al encargo para tu IA. Si la web se analizó en las últimas 24 horas, devuelve ese resultado; con "forzar": true, analiza de nuevo.

Rutas

rutaqué devuelveclave
POST /api/v1/analisisanaliza una web: {"url": "…", "forzar": false}sí
GET /api/v1/analisis/{id}un resultado por su id (el de /r/{id})no
GET /api/v1/analisis/{id}/promptel encargo para arreglarlo con tu IAno
GET /api/v1/reglaslas 19 señales con umbral, peso y arreglono
GET /api/v1/dominios/{dominio}nota e historial de una web del directoriono
GET /api/v1/rankingcifras del ranking anónimono
POST /api/v1/listadospublica una web en el directorio a nombre de su cliente: {"dominio": "…", "email": "…"}de socio
DELETE /api/v1/listados/{dominio}la retira del directorio (solo lo que publicó esa clave)de socio

La especificación completa está en /api/v1/openapi.json (OpenAPI 3). Los errores llegan como {"error": "código", "mensaje": "…"}: 401 sin_clave, 429 cupo_agotado, 422 no_se_pudo_analizar (robots.txt que no lo permite, web caída…).

En la terminal

Sin instalar nada, con Node 18 o más reciente:

export SLOPIA_CLAVE=slp_tu_clave
npx slopia zetit.es
npx slopia zetit.es --json        # el JSON de la API
npx slopia zetit.es --minimo 7    # sale con error si la nota baja de 7

En tu asistente de IA (MCP)

SlopIA es también un servidor MCP en https://slopia.zetit.cloud/mcp. Con Claude Code:

claude mcp add --transport http slopia https://slopia.zetit.cloud/mcp \
  --header "Authorization: Bearer slp_tu_clave"

Y en cualquier cliente que admita servidores MCP por HTTP, la misma dirección y la misma cabecera. Herramientas: analizar_web, ver_resultado, encargo_para_arreglar, reglas y nota_de_dominio. Sin clave funcionan todas menos analizar.

En cada pull request (GitHub Action)

Analiza la web de vista previa de cada cambio, comenta la nota en el pull request y lo para si baja del mínimo que pongas:

- uses: Zet-IT/slopia-action@v1
  with:
    url: ${{ steps.deploy.outputs.preview_url }}
    clave: ${{ secrets.SLOPIA_CLAVE }}
    minimo: 7

Límites y uso justo

  • 50 análisis al día por clave y hasta cinco claves por correo.
  • Las claves de socio, como la de Zet-IT Cloud, publican en el directorio sin verificación porque la plataforma ya sabe qué webs aloja; al cliente le llega un aviso con cómo retirarla.
  • SlopIA respeta el robots.txt de cada web: si no deja pasar a SlopIA, no la analiza.
  • Los resultados son privados: solo los ve quien tiene su id. La API no lista análisis ajenos.

Crear mi clave