> Página «Para desarrolladores y agentes de IA» de Psyseal en español, en Markdown limpio para agentes de IA (página web: https://psyseal.com/docs?lang=es). Resumen: https://psyseal.com/llms.txt

# Para desarrolladores y agentes de IA

Cómo correr el escáner gratis desde una terminal, un cliente MCP o una skill de agente, y la API pública de Psyseal: estado de los sellos, la llave de firma y los pases x402. Para leer un sello no necesitas cuenta ni llave.

## Corre el escáner gratis

```
npx psyseal-scan --lang es
```

- Necesita Node.js 20 o más reciente. Solo lee archivos: no usa la red, no escribe y no corre otros programas. Agrega `--path` y una carpeta para revisar cualquier carpeta de agente, o `--json` para un reporte en JSON.
- Código (MIT-0): [github.com/psyseal/psyseal-scan](https://github.com/psyseal/psyseal-scan). Paquete de npm: [psyseal-scan](https://www.npmjs.com/package/psyseal-scan).
- La [descarga en zip](https://psyseal.com/download/psyseal-0.3.3.zip) trae el mismo escáner y además los programas de limpieza y sello de los planes de pago ([guía](https://psyseal.com/guia)).

## Úsalo como servidor MCP

La misma revisión de solo lectura como una herramienta, `scan_agents`, por stdio, para Claude, Cursor, Codex y otros clientes MCP:

```
{
  "mcpServers": {
    "psyseal-scan": {
      "command": "npx",
      "args": ["-y", "psyseal-scan", "mcp"]
    }
  }
}
```

Claude Code

```
claude mcp add psyseal-scan -- npx -y psyseal-scan mcp
```

Nombre en el registro oficial de MCP: `io.github.psyseal/psyseal-scan`.

## Instálalo como skill de agente

OpenClaw (ClawHub)

```
openclaw skills install @psyseal/psyseal-scan
```

Claude Code, Cursor, Codex, Gemini CLI y otros agentes

```
npx skills add psyseal/psyseal-scan
```

## Lee un sello (API pública)

Dirección base `https://seal.psyseal.com`. Solo GET, sin llave y con CORS abierto. `<id>` es el código de 12 caracteres de un sello.

- `GET /<id>`: la página pública.
- `GET /<id>.json`: el estado (`active`, `suspended`, `expired` o `voided`: vigente, suspendido, vencido o anulado), los datos firmados, la firma y la dirección de la llave.
- `GET /<id>.svg`: la insignia. Agrega `?lang=es` para español.
- `GET /.well-known/psyseal-seal-key.json`: la llave pública Ed25519, en formato JWK.
- `GET /health`: estado del servicio.

```
curl -s https://seal.psyseal.com/<id>.json
```

La firma (`sig`, en base64url) es Ed25519 sobre los datos en JSON con las llaves ordenadas y sin espacios. Psyseal firma los resultados que manda el programa del dueño; no los verifica por su cuenta. Un sello no es una certificación oficial ni una auditoría.

## Paga con x402 (el agente paga solo)

- Dos pases de 30 días en USDC sobre Base (`eip155:8453`), x402 versión 2, que no se renuevan solos: el pase completo, limpieza y sello, 8.99 USDC en `POST /api/x402/pass`; el pase de sello, 0.99 USDC en `POST /api/x402/seal`, que se cobra solo si las revisiones pasan.
- Sin pago, la respuesta es 402 con el encabezado `PAYMENT-REQUIRED`. La cartera del agente firma el pago y lo vuelve a mandar en el encabezado `PAYMENT-SIGNATURE`.
- Los programas del zip preparan la petición: `node scripts/psyseal-fix.mjs --apply --x402` y `node scripts/psyseal-seal.mjs --x402`.
- Solo si se paga desde Estados Unidos, Canadá, Australia, Nueva Zelanda, Japón, Singapur, Hong Kong, Suiza o Noruega; desde otros países la respuesta es 451 y aplican los planes con tarjeta. Solo con autorización del dueño.

## Archivos para máquinas

- [OpenAPI 3.1](https://psyseal.com/openapi.json) de la API pública.
- [Manifiesto de plugin](https://psyseal.com/.well-known/ai-plugin.json).
- [llms.txt](https://psyseal.com/llms.txt): resumen para modelos de lenguaje.
- [Índice de la API](https://psyseal.com/api) en JSON.