Dois caminhos

Existem dois jeitos de publicar o que o time de criativos gerou. O caminho B, recomendado, sem token e sem app de desenvolvedor. E o caminho A, só para carrossel, publicando direto pela API do Instagram com o Claude. Escolha o B se você quer terminar rápido e sem burocracia técnica. O A vale para quem quer automatizar a publicação de verdade.

Caminho B (recomendado): publicar sem token

B1. Preparar a pasta. Peça ao Claude para montar a pasta publicar com as imagens numeradas em JPEG 1080x1350 e a legenda em legenda.txt (até 2200 caracteres e 30 hashtags):

Cole no Claude

Prepara a pasta de publicação do carrossel que a gente fez hoje.
1. Copia as imagens para uma pasta nova chamada "publicar", numeradas na ordem (01, 02, 03...).
2. Converte todas para JPEG e confere se estão em 1080x1350 (4:5). Se alguma estiver em outra proporção, me avisa antes de mexer.
3. Salva a legenda final em "publicar/legenda.txt", com no máximo 2200 caracteres e no máximo 30 hashtags.
4. Se tiver vídeo, copia para a mesma pasta e me diz a duração e a proporção.
5. No fim, me mostra a lista dos arquivos e a legenda para eu revisar. Não publica nada.

B2. Publicar pelo celular. Leve os arquivos da pasta publicar para o celular por AirDrop, Drive ou e-mail. Evite o WhatsApp: ele reduz a qualidade da imagem. Publique o carrossel normalmente pelo app, e o vídeo como Reel.

B3. Publicar pelo Meta Business Suite. O Instagram só aparece lá se estiver ligado a uma Página do Facebook (a mesma ligação da etapa de conectar a Meta).

Caminho A: publicar pelo Claude, só para carrossel

Este caminho publica pela API oficial do Instagram. É mais técnico e exige as etapas abaixo, feitas uma vez.

A1. Conta profissional. Se sua conta do Instagram é privada, ela precisa virar pública.

A2. Ligar a uma Página do Facebook. Mesma exigência do caminho B3.

A3. Conta de desenvolvedor e app. Em developers.facebook.com, criar uma conta de desenvolvedor e um app do tipo Empresa.

A4. Gerar o token. No Graph API Explorer (developers.facebook.com/tools/explorer), gerar um token marcando as permissões instagram_basic, instagram_content_publish, pages_show_list e pages_read_engagement (acrescente ads_management e ads_read se você também usa o Gerenciador de Negócios). O token dura cerca de uma hora. Anote a versão da API usada (por exemplo, v21.0).

A5. Descobrir o ID da sua conta. No próprio Graph API Explorer:

Cole no Claude

me/accounts?fields=name,instagram_business_account

A6. Guardar o token e a chave do imgBB em arquivo, nunca no chat.

Cole no Claude

nano ~/.instagram.env

Cole no Claude

INSTAGRAM_ACCESS_TOKEN=COLE_AQUI_O_TOKEN
IMGBB_API_KEY=COLE_AQUI_A_CHAVE_DO_IMGBB

Cole no Claude

chmod 600 ~/.instagram.env

Atalhos do nano: Ctrl+O, Enter para salvar, Ctrl+X para sair. A chave do imgBB se cria em api.imgbb.com (é usada só para hospedar as imagens em um endereço público temporário antes de publicar).

A7. Conferir a skill de publicação.

Cole no Claude

/list-skills

Se a skill coreai-publicar-instagram não aparecer instalada:

Cole no terminal

bash instalar.sh

A8. Colar o pedido de publicação. Só publica depois que você escrever "pode publicar":

Cole no Claude

Quero publicar no Instagram o carrossel que fizemos hoje, usando a skill coreai-publicar-instagram.
Dados: ID da conta [NÚMERO DO PASSO A5], usuário [SEU @ SEM A ARROBA], versão da API [VERSÃO DO PASSO A4].
Regras:
1. O token e a chave do imgBB estão em ~/.instagram.env. Carrega esse arquivo no comando, sem nunca mostrar, imprimir ou copiar o valor deles.
2. Converte as imagens para JPEG em 1080x1350 e sobe no imgBB para ter os endereços públicos.
3. Monta o plano e roda a prévia. Me mostra a conta, as imagens na ordem e a legenda inteira.
4. Roda a verificação de leitura e confirma que o usuário retornado é o meu.
5. Para e espera, só publica quando eu escrever "pode publicar".
6. Depois de publicar, me dá o link do post.

Se a publicação falhar no meio do caminho, confira o seu perfil no Instagram antes de rodar o pedido de novo (às vezes a peça já subiu parcialmente).

Formatos aceitos

Peça	Formato	Regras
Carrossel	JPEG	2 a 10 imagens, 1080x1350 (4:5), até 8 MB cada
Reels	MP4 ou MOV, H.264, AAC	proporção 9:16, de 3 segundos a 15 minutos, até 300 MB
Legenda	texto	até 2200 caracteres, 30 hashtags, 20 menções

Erros comuns da Meta

Sintoma	Causa	Solução
Erro 190	token inválido ou expirado	gerar um token novo no A4 e trocar em `~/.instagram.env`
Erro 10, ou entre 200 e 299	permissão faltando	gerar o token de novo, marcando as quatro permissões do A4
`instagram_business_account` não aparece	conta pessoal, ou Instagram não ligado à página	rever A1 e A2
Erro 9004, subcódigo 2207052	a Meta não achou a imagem no endereço	subir de novo no imgBB e testar o link em aba anônima
Erro 36003, subcódigo 2207009	proporção errada	ajustar a imagem para 1080x1350
Erro 36000, subcódigo 2207004	imagem acima de 8 MB	comprimir o JPEG
PNG recusado	formato não aceito	a API só aceita JPEG
Imagens cortadas no carrossel	proporções diferentes entre as imagens	o Instagram corta pelo formato da primeira imagem. Deixar todas em 1080x1350
Erro 9007, subcódigo 2207027	mídia ainda processando	esperar um minuto e conferir o perfil
Erro 9, subcódigo 2207042	mais de 100 publicações pela API em 24 horas	publicar no dia seguinte, ou usar o caminho B
Erro 25, subcódigo 2207050	conta com restrição	resolver direto no app do Instagram
Legenda cortada ou recusada	mais de 2200 caracteres ou 30 hashtags	enxugar o texto
Vídeo pelo caminho A	a skill deste pacote não publica vídeo	vídeo sempre vai pelo caminho B
Pedido de código de segurança ao entrar	aparelho novo reconhecido pela Meta	ter o e-mail ou celular da conta à mão
Colou o token no chat sem querer	exposição acidental	gerar outro token no A4 e trocar no arquivo

Nunca guarde o token ou a chave do imgBB direto na conversa com o Claude: sempre em ~/.instagram.env, com permissão 600.