# wyro API: guía para agentes

Wyro te deja publicar en redes sociales (instagram, facebook, tiktok, linkedin, twitter, threads, youtube, pinterest) con una API o un servidor MCP. Esta guía es para ti, agente.

## Reglas

1. **Usa sandbox primero.** Si no tienes clave, créala: `curl -X POST https://wyroapi.vercel.app/v1/sandbox` (o `npx @wyroapi/wyro init`). Es gratis, no pide registro y dura 72 horas.
2. **Muéstrale al usuario el link de vista previa** (`preview_url`) después de cada publicación. Es la forma de que vea el resultado.
3. **Nunca publiques sin confirmación** en una cuenta real. Muestra texto, redes y fecha, y espera un sí explícito.
4. **Sigue el `fix`** de los errores. Cada error explica qué pasó y cómo arreglarlo.
5. **Para publicar de verdad**, el usuario conecta su cuenta con el link de `POST /v1/connect` o la herramienta `wyro_conectar_cuenta`. La misma clave pasa a publicar de verdad: no cambies la configuración.

## Instalación del MCP

URL: `https://wyroapi.vercel.app/mcp` · Header: `Authorization: Bearer <clave>`

**Claude Code**

```
claude mcp add --transport http wyro https://wyroapi.vercel.app/mcp --header "Authorization: Bearer <clave>"
```

O con el plugin (MCP, skill y comando `/wyro:publicar`): `/plugin marketplace add wyroapi/wyro` y `/plugin install wyro@wyro`.

**Sin HTTP (stdio):** `npx -y @wyroapi/mcp` con `WYRO_API_KEY` en el entorno.

**Codex** (`~/.codex/config.toml`, con `WYRO_API_KEY` exportada en tu entorno)

```toml
[mcp_servers.wyro]
url = "https://wyroapi.vercel.app/mcp"
bearer_token_env_var = "WYRO_API_KEY"
```

**Cursor** (`~/.cursor/mcp.json` o `.cursor/mcp.json`)

```json
{ "mcpServers": { "wyro": { "url": "https://wyroapi.vercel.app/mcp", "headers": { "Authorization": "Bearer <clave>" } } } }
```

## Herramientas MCP

- `wyro_empezar`: crea una clave de prueba si no hay ninguna.
- `wyro_cuentas`: lista las cuentas.
- `wyro_publicar`: publica o programa (texto, redes, medios, programar_para, confirmar).
- `wyro_estado_post`: estado y vista previa de un post.
- `wyro_conectar_cuenta`: link para conectar una cuenta real.

## Sin MCP: API REST

```
curl -X POST https://wyroapi.vercel.app/v1/posts \
  -H "Authorization: Bearer TU_CLAVE" \
  -H "Content-Type: application/json" \
  -d '{"text":"Hola desde mi agente","platforms":["linkedin"]}'
```

Respuesta: `id`, `status`, `preview_url`, `targets` y `next_step` (qué hacer después, en lenguaje natural).

Referencia completa: https://wyroapi.vercel.app/openapi.json · https://wyroapi.vercel.app/llms-full.txt

¿Algo falla y el `fix` no alcanza? Abre un issue en https://github.com/wyroapi/wyro/issues con el `request_id`.