Conecta tu agente a casi cualquier plataforma con Printing Press

# Conecta tu agente a casi cualquier plataforma con Printing Press

> Guía de Jaime Herrera (VisiumAI) · versión 2026-10-20 · https://visiumai.com/guias/printing-press.md

## Para ti

Cuando conectas tu agente de IA a tus herramientas, el trabajo que te quita es enorme. Hasta que llegas a una
plataforma que no se deja conectar porque no tiene API pública, y te toca seguir haciéndolo a mano. Printing Press
(open source, licencia MIT) resuelve eso: le da a tu agente un conector para casi cualquier plataforma web.

- **Si la plataforma tiene API documentada,** Printing Press la estudia y fabrica el conector.
- **Si no tiene API pública,** tú navegas la página como siempre mientras Printing Press graba cómo habla con sus
  servidores. De ahí deduce la API que usa por dentro y fabrica el conector igual.
- **Antes de fabricar nada,** revisa su librería: hoy tiene **590 conectores listos** (Skool, Zillow, Airbnb, Notion,
  Gmail, Spotify, Shopify…) que se instalan con un solo comando.

Cada conector trae tres piezas: un **CLI** (lo que tu agente usa desde la terminal, gastando pocos tokens), un
**servidor MCP** (para apps de chat como Claude o ChatGPT) y una **skill** que le enseña a tu agente a usarlo.

**Qué necesitas:** Claude Code (el camino más probado) o Codex, y Node.js. Para fabricar conectores nuevos, también Go
1.26.9 o más nuevo; tu agente te ayuda a instalarlo si falta.

**Cómo usarla:** abre tu agente y pégale esto:

> Lee completa https://visiumai.com/guias/printing-press.md y sigue la guía paso a paso.

Te preguntará qué plataforma quieres conectar, te mostrará un plan y esperará tu OK antes de instalar nada. Instalar un
conector de la librería toma unos 5 minutos; fabricar uno nuevo, de 30 a 60.

---

## Para el agente

Vas a conectar a la persona con la que trabajas a una o varias plataformas usando Printing Press
(github.com/mvanhorn/cli-printing-press) y su librería de conectores (github.com/mvanhorn/printing-press-library).
Sigue los pasos en orden.

### Reglas de ejecución

1. **Lee la guía completa antes de empezar.** Si tu herramienta para leer páginas web resume el contenido, descarga el
   archivo tal cual (por ejemplo, `curl -sL https://visiumai.com/guias/printing-press.md`): los comandos se copian
   literalmente.
2. **Primero el plan.** Después de la entrevista (paso 1), muestra un plan corto con lo que vas a instalar y los
   comandos que vas a correr, y espera el OK de la persona.
3. **Primero la librería.** Antes de fabricar un conector, busca si ya existe (paso 3). Fabricar uno nuevo cuesta
   tiempo y tokens; instalar uno hecho, casi nada.
4. **Credenciales fuera del chat.** Las llaves, tokens y contraseñas que pida un conector van en variables de entorno o
   en el gestor de secretos del sistema, y las pone la persona. Nunca las escribas en el chat, en el código ni en un
   repo.
5. **Las capturas de tráfico son secretas.** Un archivo HAR o una captura del navegador lleva las cookies y los tokens de
   la sesión de la persona. No lo subas a ningún lado, no lo agregues a git y bórralo cuando termines.
6. **Primero leer, después escribir.** Prueba cada conector con comandos de solo lectura (buscar, listar). Cualquier
   acción que publique, borre, compre o mande algo en la plataforma necesita el OK explícito de la persona.
7. **Usa el idioma de la persona** para hablarle y para explicarle los comandos.

### Paso 1. Entrevista

Haz estas preguntas en un solo mensaje:

1. **¿Qué plataforma o plataformas quieres conectar?** Si tienes la dirección web, pásala.
2. **¿Qué quieres que haga tu agente ahí?** Por ejemplo: buscar, revisar, comparar, publicar, sacar reportes. De esto
   salen las pruebas del paso 6.
3. **¿Qué agente usas?** Claude Code, Codex u otro. Si usas una app de chat sin terminal (Claude, ChatGPT), te
   conviene el servidor MCP del conector.
4. **¿Qué sistema operativo usas?** Windows, macOS o Linux.
5. **¿Tienes cuenta en esa plataforma?** Muchos conectores usan tu sesión o una llave de tu cuenta.

### Paso 2. Requisitos

Revisa lo que ya está instalado:

```bash
node -v          # Node.js (para npx)
npx -v
go version       # Go 1.26.9 o más nuevo; solo hace falta para fabricar conectores nuevos (paso 5)
```

Si falta Node.js o Go, propón instalar la versión oficial (nodejs.org, go.dev/dl) y espera el OK. En Windows, los
comandos de esta guía corren en Git Bash o en WSL; el instalador de Printing Press es un script de bash.

### Paso 3. ¿Ya existe en la librería?

Busca cada plataforma en el catálogo (no instala nada):

```bash
npx -y @mvanhorn/printing-press-library search <plataforma> --json
npx -y @mvanhorn/printing-press-library list --json            # el catálogo completo
```

También se puede ver en printingpress.dev. Si el conector existe, sigue con el paso 4. Si no existe, salta al paso 5.

### Paso 4. Instalar un conector de la librería

```bash
npx -y @mvanhorn/printing-press-library install <nombre>
```

El instalador baja el CLI y su skill (`/pp-<nombre>`) en un solo paso; acepta el nombre corto (`skool`) o el del
binario (`skool-pp-cli`). Varios a la vez: `install skool notion gmail`.

Después:

1. **Lee la skill y el README del conector** para saber qué variables de entorno necesita. Explícale a la persona cuáles
   son y dónde conseguirlas, y espera a que las configure (regla 4).
2. **Reinicia la sesión del agente** si la skill nueva no aparece.
3. **Si la persona quiere el servidor MCP** (para una app de chat), instálalo con Go y regístralo en su agente. En
   Claude Code:

   ```bash
   go install github.com/mvanhorn/printing-press-library/<ruta>/cmd/<nombre>-pp-mcp@latest
   claude mcp add <nombre>-pp-mcp -- <nombre>-pp-mcp
   ```

   La `<ruta>` está en el catálogo (por ejemplo, `library/media-and-entertainment/skool`).

Sigue con el paso 6.

### Paso 5. Fabricar un conector nuevo

**5.1 Instala Printing Press** (una sola vez). Instala el generador y sus skills para Claude Code:

```bash
curl -fsSL https://raw.githubusercontent.com/mvanhorn/cli-printing-press/main/scripts/install.sh | bash
```

Para Codex, agrega `-s -- --agent codex` al final. Si el script no corre, haz la instalación manual:

```bash
go install github.com/mvanhorn/cli-printing-press/v4/cmd/cli-printing-press@latest
npx -y skills@latest add mvanhorn/cli-printing-press/skills --skill '*' -g -a claude-code -y   # o -a codex
```

Verifica con `cli-printing-press --version`. Si dice "command not found", agrega la carpeta de binarios de Go
(`~/go/bin`) al `PATH`. Después, **reinicia la sesión del agente** para que cargue el comando `/printing-press`.

**5.2 Elige cómo empezar**, según la plataforma:

| Caso | Comando (dentro de Claude Code o Codex) |
|---|---|
| Tiene API documentada | `/printing-press <Plataforma>` |
| No tiene API pública | `/printing-press https://<dirección de la plataforma>` |
| La captura en vivo no funciona | `/printing-press --har ./captura.har` |

Para ahorrar tokens de Claude, agrega `codex` al final (`/printing-press <Plataforma> codex`): la parte de escribir
código la hace Codex.

**5.3 Si no tiene API pública,** Printing Press abre un navegador y graba el tráfico. **No navega solo: lo hace la
persona.** Pídele que inicie sesión y recorra las acciones que quiere automatizar (buscar, abrir un elemento, pasar de
página, filtrar). Cuantas más acciones recorra, más completo sale el conector.

Si la captura en vivo no encuentra nada útil, pídele que exporte un HAR: en el navegador, herramientas de desarrollador →
pestaña Red (Network) → hacer las acciones → clic derecho → "Guardar todo como HAR". Después usa la tercera fila de la
tabla y recuerda la regla 5.

**5.4 Deja que termine.** El proceso investiga, genera, verifica y califica el conector; toma de 30 a 60 minutos.
Produce `<plataforma>-pp-cli`, `<plataforma>-pp-mcp` y su skill, y los deja en `~/printing-press/library/<plataforma>`.
Al final aparece una calificación de calidad.

### Paso 6. Prueba y entrega

1. Corre dos o tres comandos de **solo lectura** que respondan lo que la persona pidió en el paso 1, y muéstrale el
   resultado.
2. Explícale cómo pedírtelo de ahora en adelante en lenguaje normal; por ejemplo: "usa el conector de Skool y dime qué
   publicaciones de esta semana tienen más comentarios".
3. Si quiere acciones que escriban (publicar, responder, actualizar), pruébalas una vez con ella y con su OK
   (regla 6).
4. Termina con un resumen: conectores instalados, dónde quedaron, variables de entorno que usan y cómo pedirle cosas
   a su agente.

### Si algo falla

- **`/printing-press` o `/pp-<nombre>` no aparecen:** reinicia la sesión del agente. Para revisar la instalación:
  `npx -y skills@latest list -g -a claude-code` (o `-a codex --json`).
- **`cli-printing-press: command not found`:** falta `~/go/bin` en el `PATH`.
- **Error 401 al probar:** falta la llave o expiró. `cli-printing-press auth doctor` dice qué variable falta.
- **La captura del navegador no encuentra nada:** el sitio usa websockets, gRPC o bloqueos fuertes contra bots. Prueba
  con un HAR (paso 5.3).
- **Un conector que funcionaba dejó de hacerlo:** una API escondida puede cambiar sin aviso. Vuelve a fabricarlo con
  `/printing-press-reprint <plataforma>`.
- **Apps solo de escritorio o de celular:** no hay navegador que examinar; Printing Press funciona con plataformas web.

---

## Para ti: cómo sacarle provecho

- **Empieza por la librería.** Lo más probable es que alguien ya haya fabricado el conector que necesitas.
- **Pídele lo que la app no te deja hacer.** Muchos conectores guardan una copia local de tus datos: tu agente puede
  comparar, filtrar y cruzar información que la app solo te enseña de una en una.
- **CLI para tu agente, MCP para tus apps de chat.** El CLI gasta menos tokens porque tu agente filtra la respuesta
  antes de leerla; el MCP se conecta con un par de clics en Claude o ChatGPT.
- **Combínalos.** Con varios conectores, tu agente puede pasar información de una plataforma a otra: de tu comunidad a
  tu CRM, de tu calendario a tus reportes.

---

Guía de **Jaime Herrera**, VisiumAI (visiumai.com). Publico sobre automatización con IA en YouTube
(youtube.com/@jaime_herrerag) e Instagram (@jaimeherrera.ia).