Pular para o conteúdo
Criar conta grátis

Instagram API & MCP

Seu produto no Instagram, por API e MCP

Publique, agende, responda comentários e DMs e leia métricas pela Meta oficial. Do seu backend com uma chave, ou do seu agente com login no navegador.

Conta e console grátis. O uso da API é licenciado por conta Instagram.

$ claude mcp add --transport http keymatic https://ig.keymatic.com.br/api/mcp
Servidor MCP keymatic adicionado (HTTP)
$ claude
> /mcp  →  keymatic  →  autenticar
Abrindo o navegador para autorizar…
✓ Conectado a @suaconta

Funciona com

  • Claude Code
  • Codex
  • Cursor
  • VS Code
  • Gemini CLI
  • qualquer cliente MCP

produto

O que a sua integração faz no Instagram

REST e MCP chamam as mesmas operações, na mesma fila e com as mesmas franquias. Você escolhe a interface; o comportamento é um só.

  • Publicar

    Foto, Reels, carrossel e stories, com legenda.

    POST /publicacoes
  • Agendar

    Até 30 dias à frente. Cancele enquanto a operação não saiu.

    executar_em
  • Insights

    Métricas do perfil e de cada publicação.

    GET /insights
  • Comentários

    Leia por publicação e responda em nome da conta.

    POST /comentarios/{id}/respostas
  • Moderação

    Oculte comentários sem sair do seu produto.

    POST /comentarios/{id}/ocultacao
  • Direct

    Leia conversas e responda dentro da janela de 24 h aberta pela pessoa.

    GET /conversas
  • Automações

    Regras de resposta automática gerenciadas pela API REST.

    POST /automacoes
  • Mídia

    Importe imagem até 12 MiB e MP4 até 100 MB para publicar.

    POST /midias/importacoes
  • Operações

    Escritas idempotentes, com estado consultável do início ao fim.

    GET /operacoes/{id}

Publicação e insights dependem das permissões que a Meta concede ao aplicativo. A documentação marca cada rota.

como-funciona

Do cadastro à primeira chamada em três passos

  1. 01

    Crie sua conta

    Cadastro grátis no Keymatic Developers. O console abre na hora.

  2. 02

    Conecte o Instagram

    Pelo login oficial da Meta. Você escolhe a conta profissional e as permissões.

  3. 03

    Instale ou integre

    Adicione o MCP ao seu cliente com login no navegador, ou crie uma chave para o seu backend.

Agentes, pelo MCP

Login no navegador. Nenhuma chave no arquivo de configuração.

Instalação do MCP por cliente

Claude Code

claude mcp add --transport http keymatic https://ig.keymatic.com.br/api/mcp

# depois, dentro do Claude Code:
/mcp   # escolha keymatic e autentique no navegador

Codex

codex mcp add keymatic --url https://ig.keymatic.com.br/api/mcp
codex mcp login keymatic   # abre o navegador para autorizar

Cursor

// .cursor/mcp.json
{
  "mcpServers": {
    "keymatic": { "url": "https://ig.keymatic.com.br/api/mcp" }
  }
}

Seu backend, por REST

Chave de servidor com escopo. Escritas exigem Idempotency-Key e devolvem 202 com a operação.

Chamadas REST

GET perfil

curl "$KEYMATIC_URL/api/instagram/perfil" \
  -H "Authorization: Bearer $KEYMATIC_INSTAGRAM_KEY"

POST publicação

curl -X POST "$KEYMATIC_URL/api/instagram/publicacoes" \
  -H "Authorization: Bearer $KEYMATIC_INSTAGRAM_KEY" \
  -H "Idempotency-Key: lancamento-colecao-verao" \
  -H "Content-Type: application/json" \
  -d '{
    "formato": "carrossel",
    "arquivos": ["$MIDIA_1", "$MIDIA_2"],
    "legenda": "Coleção de verão no ar",
    "executar_em": "2026-11-20T12:00:00-03:00"
  }'

# 202 Accepted
# {"operacao_id": "…", "estado": "agendada", "executar_em": "…"}

plataformas

Para plataformas com muitos clientes

Seus clientes conectam o próprio Instagram numa página hospedada pela Keymatic, sem criar conta na Keymatic. Você recebe uma chave filha, limitada às permissões que o cliente aprovou.

  • km_proj_… gerencia só conexões. Não lê nem escreve dados do Instagram.
  • URLs de retorno exatas, cadastradas no projeto. Até cinco por projeto.
  • Revogar a concessão desliga as chaves filhas no REST, no MCP e na fila.
  1. 01seu appcria uma sessão com a chave do projeto
  2. 02keymaticpágina hospedada com o login oficial da Meta
  3. 03seu clienteescolhe o Instagram e as permissões
  4. 04seu apprecebe o code na URL de retorno e troca por uma chave filha
Criar sessão de conexão

Sessão hospedada

curl -X POST "$KEYMATIC_URL/api/instagram/conexoes/sessoes" \
  -H "Authorization: Bearer $KEYMATIC_PROJECT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url_retorno": "https://app.seucrm.com/keymatic/retorno",
    "state": "cliente-4821",
    "permissoes": ["ler", "mensagens", "responder"]
  }'

# 201 → redirecione o navegador do cliente para "url"

seguranca

Chaves que fazem só o que você deixou

CRM produçãoativa
km_api_••••••••••••7f3a
conta
@suaconta
expira
em 90 dias
limite
60 req/min
  • ler
  • mensagens
  • responder
  • moderar
  • publicar
Exemplo ilustrativo
  • Escopo mínimo

    Cada chave carrega só as permissões que você marcou: ler, mensagens, responder, moderar ou publicar.

  • Uma conta por chave

    A chave fica presa a um Instagram. Não existe conta_id para trocar no caminho.

  • Mostrada uma vez

    O segredo aparece só na criação. Depois o console mostra apenas o prefixo.

  • Prazo e revogação

    Validade de 1 a 365 dias. Revogar vale na hora, no REST e no MCP.

  • Token da Meta fica aqui

    O token da Meta é guardado cifrado e nunca sai da Keymatic. Você só lida com chaves Keymatic.

  • Isolamento por tenant

    Dados de cada conta ficam separados no banco. Objeto de outro tenant responde 404.

precos

Um preço por Instagram conectado

Criar conta e explorar o console é grátis. A licença entra quando você liga a API ou o MCP numa conta.

Instagram API & MCP

R$119/mês por conta Instagram

Licença mensal. REST e MCP na mesma licença: um segundo protocolo ou uma nova chave não cobram de novo.

Criar conta grátis

Incluído por licença, todo mês

operações
10.000
publicações
100
DMs
1.000
de mídia
1 GiB
  • Franquias somadas entre as licenças: três contas viram um só saldo de 30.000 operações.
  • Consultar uso, estado de operação e cancelar não consome franquia.
  • Os limites da Meta continuam valendo, com ou sem franquia sobrando.

faq

Perguntas frequentes

Não achou aqui? A documentação cobre autenticação, limites e erros rota por rota.

Criar conta custa alguma coisa?

Não. A conta e o console são grátis. Para chamar a API ou o MCP em nome de um Instagram, essa conta precisa de uma licença de R$ 119 por mês.

Preciso criar um app na Meta?

Não. O Instagram é conectado pelo login oficial da Meta no aplicativo da Keymatic. Algumas capacidades, como publicação e insights, dependem das permissões que a Meta concede a esse aplicativo; a documentação marca cada uma.

Quando usar REST e quando usar MCP?

REST é para o backend do seu produto: chamadas determinísticas com chave de servidor. MCP é para agentes como Claude Code, Codex e Cursor. Os dois usam o mesmo motor, a mesma licença e as mesmas franquias.

Posso mandar DM para qualquer pessoa?

Não. As regras da Meta valem: a resposta só sai para quem escreveu para a conta, dentro de 24 horas e sem opt-out. A Keymatic confere tudo de novo antes do envio.

O que acontece se uma publicação falhar no meio?

Toda escrita é uma operação com Idempotency-Key. Repetir a mesma chave com o mesmo corpo devolve a mesma operação, sem publicar duas vezes. Se o resultado ficar incerto, consulte o estado antes de tentar de novo.

E o WhatsApp?

Ainda não existe API de WhatsApp para desenvolvedores. Está nos planos; o Developers oferece integração com Instagram hoje.

Conecte o primeiro Instagram hoje

Crie a conta grátis, conecte pelo login da Meta e faça a primeira chamada do seu agente ou do seu backend.