# A API do Pinterest para o seu agente, sem criar um app do Pinterest.

> Publique pins com imagem ou vídeo no Pinterest a partir do Claude Code, Codex, Cursor ou do seu código. Teste grátis em 60 segundos.

Infraestrutura de publicação para agentes de IA. URL: https://wyroapi.com/pt/pinterest-api

Funciona com Claude Code, Codex, Cursor, n8n, Make, Zapier e qualquer cliente MCP ou HTTP.

## Teste em 60 segundos, sem cadastro

Chave de teste (72 horas, tudo simulado):

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

Ou cole este prompt no seu agente (troque SUA_CHAVE pela chave):

```
Instale o wyro para você poder publicar nas minhas redes.
1) Adicione o MCP: claude mcp add --transport http wyro https://wyroapi.com/mcp --header "Authorization: Bearer SUA_CHAVE"
   (se você usa Codex ou Cursor, o guia está em https://wyroapi.com/AGENTS.md)
   Se o MCP não ficar disponível nesta sessão, use a API REST com a mesma chave: https://wyroapi.com/pt/llms.txt
2) Publique um post de teste no Instagram dizendo "Olá do meu agente", com esta imagem: https://picsum.photos/seed/wyro/1080/1080
   Depois me mostre o link da prévia.
3) Me explique como conectar minha conta real quando eu quiser publicar de verdade.
```

## O que é o Wyro?

Uma única integração para o seu agente, o seu app ou o seu fluxo publicar em 8 redes sociais. Você conecta cada conta uma vez e publica com uma chamada. Só APIs oficiais.

Disso a gente cuida:

- **As aprovações de cada rede.** Apps de desenvolvedor, revisões e verificação da empresa.
- **Tokens e permissões.** A conexão de cada conta, a renovação e as permissões.
- **Formatos e limites.** O que cada rede exige: mídia, tamanho do texto e limites de uso.
- **Mudanças de API.** Quando uma rede muda a API, a sua integração continua igual.

Um vídeo em 3 redes, uma única chamada:

```bash
curl -X POST https://wyroapi.com/v1/posts \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"text":"Lançamos uma novidade",
       "platforms":["instagram","linkedin","tiktok"],
       "media":[{"url":"https://seu-site.com/video.mp4","type":"video"}]}'
```

## Por que usar o Wyro?

- **Sem app do Pinterest.** Você não cria app de desenvolvedor nem passa por revisões. Conecta sua conta do Pinterest e pronto.
- **Prévia antes de publicar.** Com a chave de teste, cada post devolve um link que mostra como ficaria no Pinterest.
- **A mesma API para 8 redes.** Se amanhã você quiser publicar também em outra rede, troca uma palavra em platforms.

## Como publico no Pinterest com uma chamada?

Um POST com o texto e a rede. A resposta traz o link da prévia e o próximo passo para o seu agente.

```bash
curl -X POST https://wyroapi.com/v1/posts \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"text":"Ideias para o seu próximo lançamento","platforms":["pinterest"],"media":[{"url":"https://seu-site.com/pin.jpg","type":"image"}]}'
```

Resposta:

```json
{
  "id": "post_7O7Tob2kXq9LmA3p",
  "status": "published",
  "simulated": true,
  "preview_url": "https://wyroapi.com/p/k3x9a1Qz7B",
  "next_step": "Mostre a prévia ao usuário: https://wyroapi.com/p/k3x9a1Qz7B . É uma simulação: nada foi publicado em nenhuma rede. Para publicar de verdade, ele conecta a conta em: https://wyroapi.com/conectar?c=…&red=pinterest"
}
```

### Requisitos do Pinterest

- Imagem ou vídeo obrigatório.
- Até 500 caracteres de texto.

## Como conecto o Wyro ao meu agente ou ao meu app?

Três formas de entrar. A mesma API por trás.

- **MCP** (para agentes): Claude Code, Codex e Cursor publicam com ferramentas. Nada para instalar nem hospedar: é um servidor remoto.
- **API REST** (para o seu app ou fluxo): Um POST /v1/posts de qualquer linguagem, n8n, Make ou Zapier.
- **CLI** (para o terminal): npx @wyroapi/wyro init cria a sua chave de teste e salva no .env.

### Claude

```
// Claude web, desktop ou Cowork
Personalizar → Conectores → Adicionar conector personalizado

Nome:   wyro
URL:    https://wyroapi.com/mcp/k/SUA_CHAVE
```

### Claude Code

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

### Codex

```
export WYRO_API_KEY=SUA_CHAVE

# ~/.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 SUA_CHAVE"
      }
    }
  }
}
```

### curl

```
curl -X POST https://wyroapi.com/v1/posts \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"text":"Olá do meu agente","platforms":["linkedin"]}'
```

## Em quais redes o meu agente pode publicar?

Oito redes, uma API. Em todas você pode publicar na hora ou agendar.

- **Instagram:** Fotos, carrosséis e Reels. https://wyroapi.com/pt/instagram-api
- **TikTok:** Vídeos com legenda. https://wyroapi.com/pt/tiktok-api
- **Facebook:** Posts com texto, foto ou vídeo. https://wyroapi.com/pt/facebook-api
- **LinkedIn:** Posts com texto, imagem ou vídeo. https://wyroapi.com/pt/linkedin-api
- **X:** Posts de até 280 caracteres. https://wyroapi.com/pt/x-api
- **Threads:** Posts com texto, imagem ou vídeo. https://wyroapi.com/pt/threads-api
- **YouTube:** Vídeos com descrição. https://wyroapi.com/pt/youtube-api
- **Pinterest:** Pins com imagem ou vídeo. https://wyroapi.com/pt/pinterest-api

## Quanto custa?

- **Sandbox:** grátis, sem cadastro nem cartão. Contas simuladas de todas as redes, prévias para compartilhar, chave válida por 72 horas.
- **Builder:** USD 5 por conta por mês, no cartão. Publicação real em todas as redes, 7 dias de teste com 1 conta.
- **Acesso fundador:** USD 15 por mês, vagas limitadas, preço fixo enquanto você continuar assinando. Até 5 contas, tudo do Builder, canal direto com a equipe.

## Perguntas frequentes

### Posso publicar um pin sem imagem?

Não. O Pinterest precisa de uma imagem ou de um vídeo em media.

### Posso agendar pins?

Sim. Envie scheduled_at com uma data ISO 8601; no MCP, use o argumento programar_para.

### Preciso de um app do Pinterest?

Não. Você conecta a sua conta pelo link do Wyro.

### Preciso me cadastrar para testar?

Não. A chave de teste sai com um comando ou já vem dentro do prompt desta página, e dura 72 horas.

### Publica de verdade?

Com a chave de teste tudo é simulado e você recebe uma prévia. Quando você conecta sua conta, a mesma chave publica de verdade.

### Funciona com Codex, Cursor ou n8n?

Sim. É um servidor MCP remoto e uma API REST: funciona com qualquer agente ou ferramenta que use MCP ou HTTP.

### Minha conta pode ser suspensa ou perder alcance por publicar com o Wyro?

Publicamos pelas APIs oficiais de cada rede, não automatizando o navegador. As regras de cada rede sobre spam e conteúdo continuam valendo.

### Quanto custa?

Testar é grátis. Publicar de verdade custa USD 5 por conta por mês.

## Para agentes

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