API e MCP para criadores

Antes de tudo: o token

Tudo aqui usa um token pessoal, que começa com isc_. Crie o seu no painel, aba Integração, e guarde: ele aparece uma vez só. O token cria, muda e publica as suas tralhas e lê os seus números; saques e dados de Pix nunca passam por ele. Ainda não é criador? Comece aqui, é grátis.

Todos os seus vídeos de uma vez

Copie o texto abaixo e cole no seu agente (Claude Code, Codex, Cursor). Ele conecta na iscabox, pergunta os seus canais se precisar, passa por todos os vídeos, cria e publica uma tralha para cada um, põe o link na descrição de cada vídeo e a sua página na bio. Antes de mudar qualquer coisa ele mostra o plano e espera você confirmar. No painel, o mesmo texto já vem com o seu endereço.

Quero que você coloque os links da iscabox em todos os meus vídeos de pesca.

Sou criador na iscabox (iscabox.com). Minha página é https://www.iscabox.com/@SEU_ENDERECO. Cada vídeo vira uma "tralha": a lista do equipamento que eu usei naquela pescaria, com links de compra que me pagam comissão.

1. Conexão. Use o servidor MCP da iscabox para criadores: https://www.iscabox.com/mcp/criadores, com o cabeçalho "Authorization: Bearer <token>". Se ele ainda não estiver configurado, me peça o token (eu crio em https://www.iscabox.com/painel?tab=integracao, em "Seus tokens") e configure. No Claude Code:
   claude mcp add --transport http iscabox-criadores https://www.iscabox.com/mcp/criadores --header "Authorization: Bearer <token>"

2. Canais. Se você ainda não souber, me pergunte quais são os meus canais (YouTube, Instagram, TikTok) e liste os vídeos de pesca de cada um, do mais recente para o mais antigo.

3. Tralhas. Chame list_my_tralhas antes, para não repetir um vídeo que já tem tralha. Para cada vídeo que falta:
   - import_video com o link do vídeo;
   - confira os itens do rascunho: tire o que eu não usei e, se a versão de um item (tamanho, relação, libragem) não estiver clara no vídeo, deixe sem versão, nunca invente;
   - create_tralha com um nome curto que descreva a pescaria (ex.: "Tucunaré de superfície no Rio Negro");
   - publish_tralha, e guarde o link e os textos que ele devolve para cada rede.
   Se um vídeo não citar nenhum equipamento, pule e me avise.

4. Descrições. Em cada vídeo, acrescente o link da tralha na descrição (ou na legenda), usando o texto pronto que publish_tralha devolveu para aquela rede. Não apague nada do que já está lá. Se você não tiver acesso para editar (YouTube Studio, a API do YouTube com o meu login, Instagram, TikTok), me diga o que precisa, ou me entregue a lista vídeo por vídeo com o texto para eu colar.

5. Bio. Confira se a bio de cada canal já tem https://www.iscabox.com/@SEU_ENDERECO. Se não tiver, acrescente, ou me passe o texto para eu colar.

6. Antes de mudar qualquer descrição ou bio, me mostre o plano (quais vídeos, que tralha para cada um) e espere eu confirmar. No fim, me dê um resumo em tabela: vídeo, tralha, link, descrição atualizada (sim ou não).

MCP de criadores

Para assistentes que falam Model Context Protocol. Transporte Streamable HTTP, sem sessão, com o token no cabeçalho.

• Endereçohttps://www.iscabox.com/mcp/criadores
• CabeçalhoAuthorization: Bearer isc_…

claude mcp add --transport http iscabox-criadores https://www.iscabox.com/mcp/criadores \
  --header "Authorization: Bearer SEU_TOKEN"

{
  "mcpServers": {
    "iscabox-criadores": {
      "url": "https://www.iscabox.com/mcp/criadores",
      "headers": { "Authorization": "Bearer SEU_TOKEN" }
    }
  }
}

Os conectores do claude.ai e do ChatGPT pedem login por OAuth, que este servidor ainda não tem. Use um agente que aceite o cabeçalho acima.

• import_videoLê um vídeo seu (YouTube, Reels ou TikTok) e devolve o rascunho da tralha com o equipamento citado.
• get_video_importO estado de uma leitura de vídeo que ainda está sendo feita.
• set_import_speciesRefaz o rascunho para outro peixe.
• create_tralhaCria a tralha a partir do rascunho, com a versão de cada item.
• update_tralhaMuda o nome, os itens ou a versão fixada de cada item.
• publish_tralhaPublica na sua página e devolve o link e os textos prontos para cada rede.
• list_my_tralhasLista as suas tralhas, publicadas e rascunhos.
• get_earningsVisitas, cliques, vendas, ganhos e saldo.

API de criadores

As mesmas operações por HTTP, em JSON. Mande Authorization: Bearer SEU_TOKEN em cada chamada; o endereço base é https://www.iscabox.com.

• POST /api/creator/videosLê um vídeo. Corpo: { url, caption?, species? }
• GET /api/creator/videos/{id}O estado de uma leitura de vídeo.
• GET /api/creator/tralhasAs suas tralhas.
• POST /api/creator/tralhasCria uma tralha. Corpo: { importId?, name, species?, items }
• PATCH /api/creator/tralhas/{id}Muda nome ou itens. Corpo: { name?, items? }
• POST /api/creator/tralhas/{id}/publishPublica e devolve o link e os textos.
• GET /api/creator/stats?days=30Visitas, cliques, vendas e ganhos por tralha.
• GET /api/creator/moneySaldo: disponível, aguardando a loja e já recebido.

Cada item de items é { type, productPath, selectedMainVariants? }, como vem no rascunho da leitura do vídeo. Sem selectedMainVariants, o seguidor escolhe a versão.

# 1. Lê o vídeo e recebe o rascunho
curl -X POST https://www.iscabox.com/api/creator/videos \
  -H "Authorization: Bearer SEU_TOKEN" -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/watch?v=SEU_VIDEO"}'

# 2. Cria a tralha com os itens do rascunho
curl -X POST https://www.iscabox.com/api/creator/tralhas \
  -H "Authorization: Bearer SEU_TOKEN" -H "Content-Type: application/json" \
  -d '{"importId": "ID_DA_LEITURA", "name": "Tucunaré de superfície", "items": [...]}'

# 3. Publica e recebe o link
curl -X POST https://www.iscabox.com/api/creator/tralhas/ID_DA_TRALHA/publish \
  -H "Authorization: Bearer SEU_TOKEN"

Leitura pública das páginas

Sem token, para mostrar as suas tralhas no seu site ou num bot. Os links de compra continuam passando pela iscabox, então as vendas continuam caindo no seu nome.

• GET /api/v1/creators/{handle}A página de um criador: as tralhas publicadas.
• GET /api/v1/creators/{handle}/{tralha}Uma tralha, com cada item e o menor preço de hoje.
• GET /api/v1/creators/{handle}/{tralha}/storyA tralha como imagem de story (JPEG 1080x1920), pronta para postar.

Limites

• MCP de criadores: 30 chamadas por minuto e 1.000 por dia, por criador
• Leitura de vídeo: 6 por minuto e 60 por dia
• Criar, mudar e publicar tralhas: 60 por minuto

Um 429 traz Retry-After e qual limite estourou. Precisa de mais para o seu catálogo inteiro? Fale com a gente.