Instagram Planner

Planeja e prepara o feed e os Stories do Instagram direto do Claude Code. O plugin organiza um calendário editorial completo, escreve legendas com variações, sugere os melhores horários de publicação e prepara cada post para envio pelo fluxo de media container da Instagram Graph API.

O que faz

O Instagram Planner ajuda criadores e marcas a saírem do "o que eu posto hoje?" para um plano consistente:

• Monta um calendário semanal de feed e Stories com temas, formatos e objetivos por dia.
• Escreve legendas em PT-BR com variações de tom (direta, narrativa, com pergunta) e chamadas para ação.
• Sugere conjuntos de hashtags por alcance (amplas, de nicho e de marca), respeitando o limite de 30.
• Recomenda o melhor horário de publicação com base na rotina típica do público da conta.
• Prepara o conteúdo para agendamento via Graph API, descrevendo o fluxo de media container (/media → /media_publish).
• Organiza ideias de Stories em sequências (enquete, bastidores, prova social, CTA).

Importante: este plugin planeja e prepara o conteúdo. A publicação efetiva acontece pela Instagram Graph API usando o fluxo de criação de container de mídia, que exige uma conta Profissional (Business ou Creator) vinculada a uma Página do Facebook.

Instalação

1. Copie a pasta instagram-planner para o diretório de plugins do seu Claude Code (por exemplo, ~/.claude/plugins/).
2. Reinicie o Claude Code ou recarregue os plugins.
3. Confirme que os comandos /planejar-semana e /preparar-post aparecem na lista de comandos disponíveis.
4. Configure as variáveis de ambiente descritas na seção Configuração antes de usar recursos que tocam a API.

Comandos disponíveis

• /planejar-semana [nicho e objetivo] — Gera um calendário de 7 dias com posts de feed e Stories, legendas, hashtags e horários.
• /preparar-post [ideia ou tema] — Prepara um único post com variações de legenda, hashtags, melhor horário e os passos do fluxo de media container.

Configuração

O plugin lê duas variáveis de ambiente. Defina-as no seu shell ou em um arquivo .env seguro (nunca versione segredos):

• INSTAGRAM_ACCESS_TOKEN — token de acesso de longa duração da Instagram Graph API, com as permissões instagram_basic e instagram_content_publish.
• INSTAGRAM_BUSINESS_ACCOUNT_ID — ID da conta profissional do Instagram (Instagram Business Account), usado nas chamadas /{ig-user-id}/media.

O agendamento via API segue o padrão de dois passos: primeiro cria-se o container de mídia (POST /{ig-user-id}/media com a URL da imagem e a legenda), depois publica-se o container (POST /{ig-user-id}/media_publish com o creation_id retornado).

Exemplo de uso

/planejar-semana confeitaria artesanal, objetivo aumentar pedidos de encomenda

O plugin vai:

1. Distribuir 7 dias com mix de feed (foto, carrossel, Reels) e Stories.
2. Para cada dia, escrever a legenda principal, duas variações e um bloco de hashtags segmentadas.
3. Sugerir o horário ideal por dia (por exemplo, terça às 12h, sábado às 10h).
4. Indicar quais posts podem ser agendados via Graph API e listar os passos do media container.

Para um único post, use /preparar-post bolo de aniversário tema floral e receba legendas prontas com o melhor horário.

Segurança e limites

• Nunca exponha INSTAGRAM_ACCESS_TOKEN em logs, prints ou repositórios. Use sempre variáveis de ambiente.
• Tokens de longa duração expiram (cerca de 60 dias); renove-os antes do vencimento para não interromper o agendamento.
• A publicação por API exige conta Profissional (Business/Creator) vinculada a uma Página do Facebook; contas pessoais não funcionam.
• A Graph API limita o número de publicações por conta em 24 horas (atualmente 50 posts/dia) — planeje dentro desse teto.
• Stories e Reels têm regras específicas de formato e tamanho; o plugin sinaliza isso, mas confirme antes de publicar.
• Evite hashtags repetidas em excesso e conteúdo idêntico em sequência para não cair em limitações da plataforma.
• Revogue o token no painel do Meta for Developers caso suspeite de qualquer vazamento.