# Que tus usuarios publiquen en Instagram, TikTok, LinkedIn y 5 redes más desde tu producto.

> Tus usuarios conectan sus cuentas con el login oficial de cada red y vuelven a tu app, sin crear cuenta en Wyro. Una API para 8 redes, sin app review.

Infraestructura de publicación para agentes de IA. URL: https://wyroapi.com/para-saas

Funciona con Claude Code, Codex, Cursor, n8n, Make, Zapier y cualquier cliente MCP o HTTP.

## Probar en 60 segundos, sin registro

Clave de prueba (72 horas, todo simulado):

```bash
curl -X POST https://wyroapi.com/v1/sandbox
```

O pega este prompt en tu agente (reemplaza TU_CLAVE por la clave):

```
Instala wyro para que puedas publicar en mis redes.
1) Agrega el MCP: claude mcp add --transport http wyro https://wyroapi.com/mcp --header "Authorization: Bearer TU_CLAVE"
   (si usas Codex o Cursor, la guía está en https://wyroapi.com/AGENTS.md)
   Si el MCP no queda disponible en esta sesión, usa la API REST con la misma clave: https://wyroapi.com/llms.txt
2) Publica un post de prueba en Instagram que diga "Hola desde mi agente", con esta imagen: https://picsum.photos/seed/wyro/1080/1080
   Después muéstrame el link de vista previa.
3) Explícame cómo conectar mi cuenta real cuando quiera publicar de verdad.
```

## ¿Qué es Wyro?

Una sola integración para que tu agente, tu app o tu flujo publique en 8 redes sociales. Conectas cada cuenta una vez y publicas con una llamada. Solo APIs oficiales.

De esto nos encargamos nosotros:

- **Aprobaciones de cada red.** Apps de desarrollador, revisiones y verificación del negocio.
- **Tokens y permisos.** La conexión de cada cuenta, su renovación y sus permisos.
- **Formatos y límites.** Lo que pide cada red: medios, largo del texto y límites de uso.
- **Cambios de API.** Cuando una red cambia su API, tu integración sigue igual.

Un video en 3 redes, una sola llamada:

```bash
curl -X POST https://wyroapi.com/v1/posts \
  -H "Authorization: Bearer TU_CLAVE" \
  -H "Content-Type: application/json" \
  -d '{"text":"Lanzamos algo nuevo",
       "platforms":["instagram","linkedin","tiktok"],
       "media":[{"url":"https://tu-sitio.com/video.mp4","type":"video"}]}'
```

## ¿Por qué usar Wyro?

- **Sin app review, una API para 8 redes.** No registras una app en Meta, TikTok ni LinkedIn ni pasas sus revisiones. El mismo POST /v1/posts publica en Instagram, Facebook, TikTok, LinkedIn, X, Threads, YouTube y Pinterest.
- **Login oficial y de vuelta a tu app.** Tu usuario abre un link, autoriza con el login oficial de la red y vuelve a tu return_url con el account_id. Nunca crea una cuenta en Wyro ni te da su contraseña.
- **Una clave por workspace y webhooks.** Cada cliente tuyo es un workspace con su clave y sus cuentas, aislado de los demás. Un webhook firmado te avisa cuando un post sale o falla, y cuando una cuenta se conecta o se desconecta.

## ¿Cómo se integra? El flujo de partner, de punta a punta

1. **Creas un workspace por cliente.** Desde tu backend, con tu token de partner. external_id es el id del cliente en tu sistema y la llamada es idempotente. La primera respuesta trae su api_key y su webhook_secret, que no se vuelven a mostrar.

```
curl -X POST https://wyroapi.com/v1/partner/workspaces \
  -H "Authorization: Bearer $PARTNER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"external_id":"cliente-123","webhook_url":"https://api.tu-saas.com/webhooks/wyro"}'
```

2. **Pides un link de conexión.** Con la clave de ese workspace. Lo muestras como un botón «Conectar Instagram» en tu producto. El link va firmado y vence en 24 horas.

```
curl -X POST https://wyroapi.com/v1/connect \
  -H "Authorization: Bearer $WORKSPACE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"instagram","return_url":"https://app.tu-saas.com/redes/conectada"}'
```

3. **Tu usuario autoriza en la red.** Abre el connect_url, va directo a la autorización oficial de la red, sin login en Wyro, y vuelve a tu return_url con el resultado (o con wyro_status=error y el motivo).

```
https://app.tu-saas.com/redes/conectada?wyro_status=connected&account_id=acc_…&platform=instagram&username=…
```

4. **Publicas con account_ids.** Con la clave del workspace. Sin scheduled_at sale en el momento. El estado final llega a tu webhook_url como post.published, post.partial o post.failed.

```
curl -X POST https://wyroapi.com/v1/posts \
  -H "Authorization: Bearer $WORKSPACE_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Nuevo lanzamiento","account_ids":["acc_…"],"media":[{"url":"https://tu-saas.com/img/lanzamiento.jpg"}],"scheduled_at":"2026-12-01T10:00:00-03:00"}'
```

### Endpoints que vas a usar

- `POST /v1/partner/workspaces`: Crea el workspace de un cliente (token de partner).
- `POST /v1/partner/workspaces/{id}/key`: Rota su clave: la anterior deja de funcionar al instante.
- `DELETE /v1/partner/workspaces/{id}`: Da de baja al cliente: desconecta sus cuentas y revoca la clave.
- `POST /v1/connect`: Link firmado de conexión, con tu return_url.
- `GET /v1/accounts`: Cuentas conectadas de ese workspace.
- `POST /v1/posts`: Publica o programa en las cuentas que elijas.
- `PUT /v1/webhooks`: Cambia la URL de eventos del workspace.

## ¿Cómo conecto Wyro a mi agente o a mi app?

Tres formas de entrar. La misma API detrás.

- **MCP** (para agentes): Claude Code, Codex y Cursor publican con herramientas. Nada que instalar ni hostear: es un servidor remoto.
- **API REST** (para tu app o tu flujo): Un POST /v1/posts desde cualquier lenguaje, n8n, Make o Zapier.
- **CLI** (para la terminal): npx @wyroapi/wyro init crea tu clave de prueba y la guarda en .env.

### Claude

```
// Claude web, escritorio o Cowork
Personalizar → Conectores → Agregar conector personalizado

Nombre: wyro
URL:    https://wyroapi.com/mcp/k/TU_CLAVE
```

### Claude Code

```
claude mcp add --transport http wyro https://wyroapi.com/mcp \
  --header "Authorization: Bearer TU_CLAVE"
```

### Codex

```
export WYRO_API_KEY=TU_CLAVE

# ~/.codex/config.toml
[mcp_servers.wyro]
url = "https://wyroapi.com/mcp"
bearer_token_env_var = "WYRO_API_KEY"
```

### Cursor

```
// .cursor/mcp.json
{
  "mcpServers": {
    "wyro": {
      "url": "https://wyroapi.com/mcp",
      "headers": {
        "Authorization": "Bearer TU_CLAVE"
      }
    }
  }
}
```

### curl

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

## ¿En qué redes puede publicar mi agente?

Ocho redes, una API. En todas puedes publicar ya o programar.

- **Instagram:** Fotos, carruseles y Reels. https://wyroapi.com/instagram-api
- **TikTok:** Videos con descripción. https://wyroapi.com/tiktok-api
- **Facebook:** Posts con texto, foto o video. https://wyroapi.com/facebook-api
- **LinkedIn:** Posts con texto, imagen o video. https://wyroapi.com/linkedin-api
- **X:** Posts de hasta 280 caracteres. https://wyroapi.com/x-api
- **Threads:** Posts con texto, imagen o video. https://wyroapi.com/threads-api
- **YouTube:** Videos con descripción. https://wyroapi.com/youtube-api
- **Pinterest:** Pines con imagen o video. https://wyroapi.com/pinterest-api

## ¿Cuánto cuesta?

- **Sandbox:** gratis, sin registro ni tarjeta. Cuentas simuladas de todas las redes, vistas previas para compartir, clave válida por 72 horas.
- **Builder:** USD 5 por cuenta al mes, con tarjeta. Publicación real en todas las redes, 7 días de prueba con 1 cuenta.
- **Acceso fundador:** USD 15 al mes, cupos limitados, precio fijo mientras sigas suscrito. Hasta 5 cuentas, todo lo de Builder, canal directo con el equipo.

## Preguntas frecuentes

### ¿Mis usuarios tienen que crear una cuenta en Wyro?

No. Tus usuarios nunca crean una cuenta en Wyro: abren el link de conexión y autorizan directo en la red. Para que no haya sorpresas: no es una marca blanca completa. El link pasa por el dominio de Wyro y la pantalla de consentimiento de la red muestra el nombre de la app aprobada que hace la conexión, no el de tu producto.

### ¿Quién ve qué?

Cada cliente tuyo es un workspace con su propia clave. Con esa clave solo se ven y se usan sus cuentas: un account_id de otro workspace devuelve 404. Tú, con el token de partner, ves tus workspaces y sus cuentas conectadas. Tus usuarios solo ven tu producto y, en el paso de conexión, la red.

### ¿Cómo conectan sus redes mis usuarios?

Desde un botón en tu producto que abre el connect_url. Inician sesión con el login oficial de la red (Instagram, TikTok, LinkedIn…) y autorizan; nunca te dan su contraseña. Vuelven a tu return_url con wyro_status=connected y el account_id, o con wyro_status=error y el motivo, por ejemplo cancelled.

### ¿Qué pasa si una cuenta se desconecta?

Te llega el evento account.disconnected a tu webhook y la cuenta aparece con status disconnected en GET /v1/accounts. Publicar en ella devuelve el error account_disconnected. Le pides a tu usuario que la vuelva a conectar con un link nuevo de POST /v1/connect. También puedes desconectarla tú con DELETE /v1/accounts/{id}.

### ¿Podemos mantener nuestra interfaz?

Sí. Todo se hace por API desde tu backend: el botón de conectar, el editor, el calendario y los estados los diseñas tú. El único paso fuera de tu producto es la autorización en la red, y al terminar tu usuario vuelve a tu return_url.

### ¿Cuánto cuesta para un SaaS?

El precio público es USD 5 por cuenta conectada al mes, sin cargo por usuario ni por post. Si tus usuarios van a conectar muchas cuentas, las condiciones por volumen las hablamos en una llamada. El token de partner lo habilitamos nosotros; mientras tanto puedes probar la publicación gratis con una clave de prueba y cuentas simuladas.

### ¿Necesito registrarme para probar?

No. La clave de prueba sale en un comando o viene dentro del prompt de esta página, y dura 72 horas.

### ¿Publica de verdad?

Con la clave de prueba todo es simulado y devuelve una vista previa. Cuando conectas tu cuenta, la misma clave publica de verdad.

### ¿Necesito una app aprobada por Meta o TikTok?

No. Wyro ya tiene acceso a las APIs oficiales; tú solo conectas tu cuenta.

### ¿Qué cuenta de Instagram necesito?

Una cuenta profesional (Business o Creator), como pide Instagram.

### ¿Funciona con Codex, Cursor o n8n?

Sí. Es un servidor MCP remoto y una API REST: funciona con cualquier agente o herramienta que use MCP o HTTP.

### ¿Me pueden suspender la cuenta o bajar el alcance por publicar con Wyro?

Publicamos por las APIs oficiales de cada red, no automatizando el navegador. Igual rigen las reglas de cada red sobre spam y contenido.

### ¿Cuánto cuesta?

Probar es gratis. Publicar de verdad cuesta USD 5 por cuenta al mes.

## Para agentes

- https://wyroapi.com/llms.txt
- https://wyroapi.com/AGENTS.md
- https://wyroapi.com/openapi.json
