Automação do Instagram via Rube MCP

Automatize operações do Instagram através do kit de ferramentas do Instagram da Composio via Rube MCP.

Pré-requisitos

• O Rube MCP deve estar conectado (RUBE_SEARCH_TOOLS disponível)
• Conexão ativa do Instagram via RUBE_MANAGE_CONNECTIONS com o kit de ferramentas instagram
• Sempre chame RUBE_SEARCH_TOOLS primeiro para obter os esquemas de ferramentas atuais
• Conta Business ou Creator do Instagram necessária (contas pessoais não são suportadas)

Configuração

Obter Rube MCP: Adicione https://rube.app/mcp como um servidor MCP na sua configuração de cliente. Nenhuma chave de API é necessária — basta adicionar o endpoint e funciona.

1. Verifique se o Rube MCP está disponível confirmando que RUBE_SEARCH_TOOLS responde
2. Chame RUBE_MANAGE_CONNECTIONS com o kit de ferramentas instagram
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para completar o OAuth do Instagram/Facebook
4. Confirme se o status da conexão mostra ATIVO antes de executar quaisquer fluxos de trabalho

Fluxos de Trabalho Principais

1. Criar uma Postagem de Imagem/Vídeo Único

Quando usar: O usuário deseja publicar uma única foto ou vídeo no Instagram

Sequência de ferramentas:

1. INSTAGRAM_GET_USER_INFO - Obter ID do usuário do Instagram [Pré-requisito]
2. INSTAGRAM_CREATE_MEDIA_CONTAINER - Criar um contêiner de mídia com o URL da imagem/vídeo [Obrigatório]
3. INSTAGRAM_GET_POST_STATUS - Verificar se o contêiner de mídia está pronto [Opcional]
4. INSTAGRAM_CREATE_POST ou INSTAGRAM_POST_IG_USER_MEDIA_PUBLISH - Publicar o contêiner [Obrigatório]

Parâmetros chave:

• image_url: URL público da imagem a ser postada
• video_url: URL público do vídeo a ser postado
• caption: Texto da legenda da postagem
• ig_user_id: ID do usuário da conta Business do Instagram

Armadilhas:

• Os URLs de mídia devem ser acessíveis publicamente; URLs privados/autenticados falharão
• Contêineres de vídeo podem levar tempo para processar; consulte GET_POST_STATUS antes de publicar
• A legenda suporta hashtags e menções, mas tem um limite de 2200 caracteres
• Publicar um contêiner que ainda não terminou de processar retorna um erro

2. Criar uma Postagem de Carrossel

Quando usar: O usuário deseja publicar várias imagens/vídeos em uma única postagem de carrossel

Sequência de ferramentas:

1. INSTAGRAM_CREATE_MEDIA_CONTAINER - Criar contêineres individuais para cada item de mídia [Obrigatório, repetir por item]
2. INSTAGRAM_CREATE_CAROUSEL_CONTAINER - Criar o contêiner do carrossel referenciando todos os contêineres de mídia [Obrigatório]
3. INSTAGRAM_GET_POST_STATUS - Verificar a prontidão do contêiner do carrossel [Opcional]
4. INSTAGRAM_POST_IG_USER_MEDIA_PUBLISH - Publicar o carrossel [Obrigatório]

Parâmetros chave:

• children: Matriz de IDs de contêiner de mídia para o carrossel
• caption: Legenda da postagem do carrossel
• ig_user_id: ID do usuário da conta Business do Instagram

Armadilhas:

• Carrosséis exigem de 2 a 10 itens de mídia; menos ou mais falharão
• Cada contêiner filho deve ser criado individualmente antes do contêiner do carrossel
• Todos os contêineres filhos devem ser totalmente processados antes de criar o carrossel
• Mídia mista (imagens + vídeos) é suportada em carrosséis

3. Obter Mídia e Insights

Quando usar: O usuário deseja visualizar suas postagens ou analisar o desempenho das postagens

Sequência de ferramentas:

1. INSTAGRAM_GET_IG_USER_MEDIA ou INSTAGRAM_GET_USER_MEDIA - Listar mídia do usuário [Obrigatório]
2. INSTAGRAM_GET_IG_MEDIA - Obter detalhes para uma postagem específica [Opcional]
3. INSTAGRAM_GET_POST_INSIGHTS ou INSTAGRAM_GET_IG_MEDIA_INSIGHTS - Obter métricas para uma postagem [Opcional]
4. INSTAGRAM_GET_USER_INSIGHTS - Obter insights em nível de conta [Opcional]

Parâmetros chave:

• ig_user_id: ID do usuário da conta Business do Instagram
• media_id: ID da postagem de mídia específica
• metric: Métricas a serem recuperadas (por exemplo, impressões, alcance, engajamento)
• period: Período de tempo para insights (por exemplo, dia, semana, vitalício)

Armadilhas:

• Insights estão disponíveis apenas para contas Business/Creator
• Algumas métricas exigem contagem mínima de seguidores
• Dados de insights podem ter um atraso de até 48 horas
• O parâmetro period deve corresponder ao tipo de métrica

4. Verificar Limites de Publicação

Quando usar: O usuário deseja verificar se pode publicar antes de tentar uma postagem

Sequência de ferramentas:

1. INSTAGRAM_GET_IG_USER_CONTENT_PUBLISHING_LIMIT - Verificar cota de publicação restante [Obrigatório]

Parâmetros chave:

• ig_user_id: ID do usuário da conta Business do Instagram

Armadilhas:

• O Instagram impõe um limite de 25 postagens por janela de 24 horas em rolagem
• O limite de publicação é redefinido em uma base contínua, não à meia-noite
• Verifique os limites antes de operações de postagem em massa para evitar falhas

5. Obter Comentários e Filhos de Mídia

…