# wyro API

> wyro API es la API y el servidor MCP para que agentes de IA (Claude Code, Codex, Cursor, n8n) publiquen en Instagram, Facebook, TikTok, LinkedIn, X, Threads, YouTube y Pinterest. En español. Se prueba sin registro: una clave de prueba sale en un comando.

## Empezar en 1 comando

```
curl -X POST https://wyroapi.vercel.app/v1/sandbox
```

Devuelve `api_key` (dura 72 horas). Todo lo que publiques con esa clave es simulado, gratis y devuelve un `preview_url` para mostrarle al usuario.

## Endpoints principales (base https://wyroapi.vercel.app/v1, header Authorization: Bearer <api_key>)

- POST /v1/sandbox: crea una clave de prueba. Sin autenticación.
- GET /v1/accounts: cuentas disponibles (simuladas o reales).
- POST /v1/posts: publica o programa. Body: {"text": "...", "platforms": ["instagram"], "media": [{"url": "https://..."}], "scheduled_at": "ISO 8601"}.
- GET /v1/posts/{id}: estado y links de vista previa.
- POST /v1/connect: {"platform": "instagram"} devuelve el link para que el humano conecte su cuenta real.

Redes: instagram, facebook, tiktok, linkedin, twitter, threads, youtube, pinterest. Instagram y Pinterest necesitan imagen o video; TikTok y YouTube, video.

## MCP

URL: https://wyroapi.vercel.app/mcp (Streamable HTTP). Header: Authorization: Bearer <api_key>. Sin clave, solo funciona wyro_empezar.

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

## Reglas para agentes

- Usa la clave de prueba primero. Es gratis y no publica nada real.
- Siempre muéstrale al usuario el preview_url.
- Nunca publiques en una cuenta real sin confirmación explícita del usuario.
- Los errores traen code, message, fix y docs_url: sigue el fix.

## Más

- [Guía para agentes](https://wyroapi.vercel.app/AGENTS.md)
- [Documentación completa en un archivo](https://wyroapi.vercel.app/llms-full.txt)
- [OpenAPI](https://wyroapi.vercel.app/openapi.json)
- [Docs: publicar](https://wyroapi.vercel.app/docs/publicar.md)
- [Docs: errores](https://wyroapi.vercel.app/docs/errores.md)
- [CLI](https://wyroapi.vercel.app/docs/cli.md): npx @wyroapi/wyro init
- [Precios](https://wyroapi.vercel.app/pricing.md): probar gratis; USD 5 por cuenta al mes
- [Tarjeta del servidor MCP](https://wyroapi.vercel.app/.well-known/mcp/server-card.json)
- [Novedades](https://wyroapi.vercel.app/changelog.md)
- [Plugin de Claude Code, ejemplos y soporte](https://github.com/wyroapi/wyro): /plugin marketplace add wyroapi/wyro

## Guías

- [Programar posts](https://wyroapi.vercel.app/docs/programar.md)
- [Imágenes, videos, carruseles y Reels](https://wyroapi.vercel.app/docs/imagenes-y-videos.md)
- [Publicar en varias redes a la vez](https://wyroapi.vercel.app/docs/varias-redes.md)
- [Publicar en Instagram desde Claude Code](https://wyroapi.vercel.app/blog/instagram-desde-claude-code.md)
- [API de Instagram sin App Review](https://wyroapi.vercel.app/blog/instagram-api-sin-app-review.md)
- [Instagram, TikTok y LinkedIn con n8n](https://wyroapi.vercel.app/blog/n8n-instagram-tiktok-linkedin.md)
- [Cómo diseñar un MCP para publicar](https://wyroapi.vercel.app/blog/mcp-de-redes-sociales.md)

## Por red

- [API y MCP de Instagram](https://wyroapi.vercel.app/instagram-api.md)
- [API y MCP de Facebook](https://wyroapi.vercel.app/facebook-api.md)
- [API y MCP de TikTok](https://wyroapi.vercel.app/tiktok-api.md)
- [API y MCP de LinkedIn](https://wyroapi.vercel.app/linkedin-api.md)
- [API y MCP de X](https://wyroapi.vercel.app/x-api.md)
- [API y MCP de Threads](https://wyroapi.vercel.app/threads-api.md)
- [API y MCP de YouTube](https://wyroapi.vercel.app/youtube-api.md)
- [API y MCP de Pinterest](https://wyroapi.vercel.app/pinterest-api.md)

## Casos de uso

- [Publicar sin aprobaciones de Meta ni TikTok](https://wyroapi.vercel.app/sin-aprobaciones.md)
- [Agencias: las redes de todos tus clientes](https://wyroapi.vercel.app/agencias.md)
- [n8n: plantilla para publicar desde tus flujos](https://wyroapi.vercel.app/n8n.md)

## Comparativas

- [Alternativa a Ayrshare](https://wyroapi.vercel.app/alternativa-a-ayrshare.md)
- [Alternativa a Upload-Post](https://wyroapi.vercel.app/alternativa-a-upload-post.md)
- [API de Instagram de Meta o wyro](https://wyroapi.vercel.app/vs-api-de-meta.md)