4 formas de conectar o Facebook Insights ao Claude em 2026 (modo fácil)

Uma vez conectado, você pode automatizar seus relatórios e análises do Facebook Insights — faça perguntas sobre seus dados, crie dashboards, configure alertas ou envie relatórios prontos para clientes como o abaixo.

Conectar o Facebook Insights ao Claude com MCP

Para este tutorial, vamos usar o método MCP. Aqui está uma explicação rápida do que é o MCP e por que é o melhor caminho para o Facebook Insights.

MCP (Model Context Protocol) é o padrão aberto que permite que ferramentas de IA como Claude, ChatGPT, Claude Code e outras acessem e usem APIs externas — as coisas que fazem ferramentas como o Facebook Insights funcionar nos bastidores. Em vez de construir uma integração personalizada para cada ferramenta de IA que você usa, você instala um MCP e toda IA compatível obtém acesso aos mesmos dados.

Quatro razões pelas quais o MCP vence para o Facebook Insights:

A configuração completa leva menos de 5 minutos e se divide em três passos: conectar o Facebook Insights à Porter, apontar o Claude para o MCP da Porter, e fazer sua primeira pergunta.

1. Conecte seus dados do Facebook Insights à Porter

A Porter fica entre a Graph API da Meta e o Claude. Ela lida com OAuth, limitação de taxa, paginação e toda a infraestrutura para que o Claude veja apenas dados limpos e estruturados.

Cadastre-se na Porter. Crie uma conta gratuita em portermetrics.com. O plano gratuito é suficiente para executar este fluxo completo de ponta a ponta.

Conecte seu perfil do Facebook. Na Porter, clique em Criar → escolha Claude como destino → selecione Facebook Insights como fonte → faça login com o Facebook para conceder acesso às suas Páginas.

Selecione suas Páginas. Escolha as Páginas do Facebook Insights que você deseja que o Claude consulte. Quando você seleciona várias Páginas sob uma única conexão, a Porter automaticamente combina seus dados para que você possa consultá-las como uma só.

Opcional: habilite o armazenamento automático no BigQuery se você estiver conectando várias Páginas com grandes volumes de dados. Isso mantém as respostas do Claude rápidas mesmo em escala.

2. Conecte o MCP ao Claude

A URL do MCP da Porter é o que você cola no Claude. Uma vez adicionada, o Claude pode consultar os dados do Facebook Insights sob demanda em qualquer conversa.

Vá para claude.ai e clique no + ícone no campo de chat para abrir o menu de ferramentas.

No menu que abre, passe o mouse sobre Conectores e clique em Gerenciar conectores.

No painel de Conectores, clique no + botão no topo da lista para começar a adicionar um novo conector.

Escolha Adicionar conector personalizado no menu suspenso que aparece.

Uma caixa de diálogo abre com os campos de nome e URL. Digite Porter no primeiro campo para nomear o conector.

No segundo campo, cole https://mcp.portermetrics.com/mcp. Deixe as configurações avançadas como estão.

Clique em Adicionar no canto inferior direito da caixa de diálogo. O Claude abre uma janela de login — use a mesma conta Google vinculada ao seu workspace da Porter e aprove o acesso.

Assim que a autorização terminar, você verá as ferramentas somente leitura da Porter aparecerem no painel de conectores. Você está pronto para começar a fazer perguntas.

Para um passo a passo mais completo com capturas de tela em cada etapa, veja o tutorial do Porter MCP.

3. Comece a criar perguntas e dashboards

Com a Porter conectada, abra um novo chat no Claude e pergunte qualquer coisa sobre seu Facebook Insights em português simples. O Claude chama a Porter nos bastidores, puxa dados ao vivo da Meta e responde com tabelas, gráficos ou resumos.

Experimente uma destas para verificar se a configuração está funcionando:

Para um catálogo completo de prompts copiar-colar organizados por caso de uso (agências, equipes de marca, criadores e DTC, multicanal), vá para a seção de prompts abaixo.

Outras formas de conectar o Facebook Insights ao Claude

O MCP é o caminho que acabamos de percorrer — e o que recomendamos para a maioria dos profissionais de marketing. Mas não é a única forma de colocar os dados do Facebook Insights na frente do Claude. As alternativas mais comuns são a API direta do Facebook Insights (ou seu MCP oficial, se houver), uma ponte via Google Sheets ao vivo, e o BigQuery para escala. Cada uma tem seus prós e contras — escolha a que se encaixa na forma como sua equipe já trabalha.

• 🔌 API direta do Facebook Insights (ou MCP oficial) — Converse diretamente com a Graph API da Meta, ou instale o MCP nativo do Facebook Insights se houver. Controle máximo, mas você lida com autenticação, limites de taxa e paginação — e só obtém uma fonte.
• 📊 Google Sheets — Planilha ao vivo ou upload manual de CSV. Auditável, familiar, mais rápido para grandes exportações — mas a agregação acontece na Planilha, não na API.
• 🗄️ Google BigQuery — Para Páginas grandes ou agências executando análises multicliente. O BigQuery agrega; o Claude consulta apenas resumos pré-construídos.

Via API direta do Facebook Insights (ou MCP oficial)

Se você está construindo um produto em torno do Facebook Insights — ou é um desenvolvedor que prefere controlar cada camada da integração — o caminho mais direto é conversar com a Graph API da Meta por conta própria, ou instalar o MCP oficial do Facebook Insights (se houver). A Meta ainda não oferece um MCP oficial para o Facebook Insights, então isso significa escrever chamadas de API diretamente no Claude Code ou em seus próprios scripts. Você precisará seguir os limites de taxa e cotas da Meta e solicitar um Token de Desenvolvedor / acesso à API quando aplicável. De qualquer forma, você pula a Porter e chama a Meta diretamente do seu próprio código ou do Claude Code com requisições HTTP brutas.

Via Google Sheets (planilha ao vivo ou CSV manual)

Se sua equipe já vive no Google Sheets — ou você quer um rastro de papel antes que o Claude toque em qualquer coisa — alimente o Facebook Insights em uma Planilha e depois deixe o Claude ler a Planilha. Você pode automatizar o pipeline Facebook Insights → Sheets com a Porter para que ele atualize diariamente, ou fazer exportações pontuais de CSV da interface nativa do Facebook Insights para análise estática.

Via Google BigQuery (para escala)

Este é o caminho que a maioria das pessoas ignora — e é o que salva você quando sua Página do Facebook Insights fica séria. Uma única Página grande ou uma agência gerenciando 10+ Páginas atingirá limites de taxa da API e problemas de latência ao consultar o Claude diretamente. O Claude literalmente dirá que está demorando demais ou dando timeout em grandes extrações.

O BigQuery resolve isso. Você carrega os dados do Facebook Insights em tabelas do BigQuery em um cronograma e depois conecta o BigQuery ao Claude — seja por um MCP do BigQuery ou via Claude Code com consultas SQL. Em vez de pedir ao Claude para puxar dados brutos do Facebook Insights, você deixa o BigQuery agregar em tabelas pequenas e otimizadas, e o Claude consulta apenas o resultado resumido. Problema de escala resolvido.

Conectando o Facebook Insights ao Claude Code

A maioria dos profissionais de marketing agrupa Claude e Claude Code e perde a maior vantagem de todo o ecossistema MCP. Eles não são a mesma ferramenta — e a diferença importa enormemente quando você começa a trabalhar com dados do Facebook Insights seriamente.

Claude é uma interface de chat. Você faz uma pergunta, o Claude puxa dados ao vivo através do MCP, responde, talvez construa um dashboard rápido dentro da conversa. Ótimo para análises pontuais. O problema: tudo é efêmero. Quer atualizar o dashboard amanhã? Você o regenera do zero. Quer o mesmo relatório toda segunda-feira? Você refaz a pergunta toda segunda-feira.

Claude Code é o Claude rodando dentro do terminal do seu computador. Como ele tem acesso ao seu sistema de arquivos, runtime e outras ferramentas de desenvolvedor, ele não apenas responde perguntas — ele pode construir software real. Scripts persistentes, rotinas agendadas, aplicativos HTML, dashboards internos, integrações que rodam 24/7 sem sua intervenção. Uma vez conectado ao MCP da Porter para o Facebook Insights, uma categoria inteira de trabalho se torna possível.

O que o Claude Code desbloqueia que o Claude sozinho não pode

Casos de uso — o que você pode realmente fazer uma vez que o Facebook Insights está conectado ao Claude

Conectar corretamente é metade da batalha. O valor real aparece no que você faz em seguida. Aqui estão os casos de uso que os usuários da Porter constroem em torno de seus dados do Facebook Insights — desde perguntas simples até fluxos de trabalho completos voltados para clientes.

1. Converse e faça perguntas diretamente

O caso de uso mais simples — e ainda o que 80% dos profissionais de marketing começam. Abra o Claude, faça uma pergunta, obtenha uma resposta baseada em dados ao vivo.

É a forma mais rápida de substituir uma verificação diária do Facebook Page Insights. Mas o chat é o básico — os casos de uso interessantes vêm a seguir.

2. Combine o Facebook Insights com seus dados de vendas (Meta Ads, Shopify, HubSpot)

É aqui que uma visão 360° fica real. Quando você conecta o Facebook Insights e sua fonte de receita (Meta Ads para amplificação social paga, Shopify para rastreamento de conversão de e-commerce, e HubSpot para nutrição de leads), o Claude pode mapear posts e Reels da Página para leads qualificados ou compras reais — usando datas de posts, nomes de campanhas e parâmetros UTM — e oferecer atribuição de conteúdo a receita que nenhum número de plataforma pode.

O Claude lida com as datas de posts e mapeamento de UTM e junções. Você obtém um relatório de atribuição de conteúdo a receita pronto para o cliente que nenhuma plataforma individual pode gerar por conta própria.

3. Alertas e notificações automatizados no Slack ou Gmail

Com o Claude Code você pode transformar o monitoramento do Facebook Insights em uma rotina que roda sozinha. Conecte o MCP da Porter (para os dados) junto com um MCP do Slack ou Gmail (para entrega), depois escreva uma tarefa agendada do Claude Code que puxa a performance toda manhã e notifica você apenas quando algo realmente precisa de atenção.

Sem dashboards, sem verificações diárias. O relatório vem até você — e apenas quando importa.

4. Apresentações prontas para clientes com dados ao vivo (Gamma, HTML, PDF)

Uma dor comum de agências: você envia aos clientes um link de dashboard do Looker Studio — e gasta uma hora explicando um dashboard quebrado. Com o Claude você pode construir a própria apresentação — como um deck Gamma, uma página HTML personalizada, ou um PDF — populada com números ao vivo a cada vez.

A apresentação se torna um artefato de entrega que você envia ao cliente, não um dashboard que depende de outra ferramenta permanecer no ar. Sem iframe quebrado, sem prompts de login, apenas o conteúdo.

Campos e métricas do Facebook Insights que você pode consultar com o Claude

Antes de começar a escrever prompts, ajuda saber quais dados estão realmente disponíveis. O MCP da Porter dá ao Claude acesso a 277 campos e métricas do Facebook Insights em todos os níveis de relatório, desde totais da Página até posts individuais, Reels, vídeos e avaliações, mais detalhamentos por Cidade, País, idade, gênero, tipo de post e hora do dia. E a mesma URL de MCP também desbloqueia mais de 25 outras fontes — então o Claude pode combinar o Facebook Insights com Google Ads, GA4, Shopify, HubSpot e mais em um único prompt.

Para o dicionário de dados completo, veja Todos os campos e métricas do Facebook Insights.

Prompts que você pode copiar e colar hoje

1. Para agências

Melhor para gerentes de mídia social e coordenadores de marketing executando relatórios de Página multicliente.

*”Mostre-me meus 5 posts principais por engajamentos de post nos últimos 30 dias em uma tabela ranqueada.”* *”Compare meu Alcance orgânico deste mês versus o mês passado e destaque a mudança.”* *”Por que minhas impressões totais da Página caíram ontem? Puxe o detalhamento por Hora do dia.”* *”Elabore um relatório semanal de cliente usando minha taxa de engajamento da Página (Alcance) dos últimos 7 dias.”*

2. Para equipes de marca

Melhor para equipes de marca monitorando saúde da marca, sentimento e performance de temas de conteúdo ao longo do tempo.

*”Sinalize qualquer post onde minha taxa de engajamento de post caiu mais de 20 por cento este trimestre.”* *”Como meu alcance orgânico de posts se compara ao meu alcance pago de posts esta semana?”* *”Qual País me dá a maior taxa de engajamento da Página (Impressões), mas o menor número de novas curtidas da Página no mês passado?”* *”Cruze meus posts principais por alcance total de posts com minhas visualizações de Reels dos últimos 14 dias.”*

3. Para criadores e DTC

Melhor para criadores de conteúdo monetizando vídeos através de ad breaks e marcas DTC rastreando performance de Reels e vídeos.

*”Liste meus vídeos de pior performance por visualizações de vídeos da Página nos últimos 60 dias com seu Comprimento do vídeo.”* *”Projete meus novos seguidores da Página para o próximo mês com base na tendência dos últimos 3 meses.”* *”Me alerte quando minha taxa de visualização de 30s de vídeos da Página cair abaixo de 15 por cento este mês.”* *”Compare o tempo de visualização de vídeos de posts Reels desta semana versus a semana passada em um gráfico simples.”*

4. Multicanal

Melhor para equipes combinando o Facebook Insights com outras fontes de marketing e receita.

*”Cruze meu alcance total da Página do Facebook com as sessões do Google Analytics 4 nos últimos 30 dias.”* *”Por que minhas reações de post dispararam na terça-feira? Puxe também meus compartilhamentos de post e contagem de comentários de post.”* *”Qual Cidade tem o maior consumos únicos da Página, mas o menor número de novas curtidas únicas da Página este mês?”* *”Elabore um resumo mensal para minha equipe usando meu alcance orgânico e taxa de engajamento da Página (Alcance).”*

Limites, autenticação e boas práticas para o Facebook Insights via Claude

*”Estávamos puxando Insights de Página para 50 páginas em paralelo e de repente começamos a receber o código de erro 80006 — as chamadas de API foram limitadas. Levou 2 horas para descobrir que estávamos atingindo o limite de taxa por usuário porque não implementamos backoff exponencial.”* — Discussão de desenvolvedor no Stack Overflow sobre limitação da Graph API da Meta, 2024

Esta é a história de terror mais comum com a API do Facebook Insights: não é um banimento, mas uma limitação silenciosa que quebra seu pipeline de relatórios. Uma agência de marketing executando relatórios semanais de clientes em dezenas de Páginas é especialmente vulnerável. O custo real não é a suspensão da conta — é o atraso de 2 a 4 horas enquanto você diagnostica por que seu dashboard “automatizado” de repente mostra dados desatualizados, mais o retrabalho manual para reexecutar consultas com ritmo adequado. Diferentemente do Meta Ads (onde a automação ruim pode acionar banimentos permanentes), o Facebook Insights é somente leitura — o modelo de fiscalização da Meta limita agressivamente, mas raramente suspende.

A limitação de taxa da Meta é baseada em cotas e padrões, não baseada em ferramenta. A Meta não limita contas porque você usou o Claude ou um MCP. Ela limita por causa de como a API foi usada: requisições paralelas em rajada, paginação ausente, ou exceder tetos de chamadas por usuário/por aplicativo. Consultas somente leitura de Insights de Página com ritmo adequado, batching e backoff são seguras. Rajadas paralelas em dezenas de Páginas sem tratamento de limitação de taxa não são.

Os três padrões que levam a relatórios imprecisos do Facebook Insights

Após revisar documentos oficiais e threads da comunidade, três padrões aparecem repetidamente.

1. Rajadas de API paralelas em várias Páginas. Disparar requisições simultâneas para buscar Insights para 10+ Páginas do mesmo token de aplicativo/usuário aciona os Limites de Taxa de Prevenção de Abuso da Meta (código de erro 80006 ou série 17xx). Os sistemas da Meta sinalizam isso como “tráfego em rajada” mesmo se cada chamada individual for legítima. O resultado não é um banimento — é limitação que retorna `error_subcode: 2446079` e força um período de cooldown. Fonte: Documentos de Limitação de Taxa da Graph API da Meta — “Limitamos um aplicativo ou usuário quando qualquer um atinge um limite de taxa.” Em vez disso, serialize as requisições ou use batching com um máximo de 50 IDs por chamada.

2. Ignorar paginação e limites de batching. Solicitar todas as 277 métricas para um intervalo de datas completo de 2 anos em uma única chamada de API retorna dados incompletos ou estimados. A API de Insights da Meta pagina grandes conjuntos de resultados, e requisições sem batching contam fortemente contra sua cota. Uma única chamada sem batching “pegar tudo” pode consumir 10–20% do seu orçamento de 200 chamadas por hora. Fonte: Melhores Práticas da Graph API da Meta — “Use requisições em batch para reduzir o número de conexões HTTP.” Em vez disso, pagine por intervalo de datas (janelas de 7 dias) e faça batching de requisições de métricas.

3. Solicitar detalhamentos excessivos em uma única consulta. Adicionar múltiplos `breakdowns` (por exemplo, idade + gênero + cidade + país + hora) a uma única chamada de Insights multiplica o volume de dados e aciona limitação em volumes menores de chamadas. Os sistemas da Meta estimam métricas quando os dados subjacentes se tornam muito granulares, levando a agregações imprecisas que parecem corretas, mas não são. Fonte: Insights da API de Marketing da Meta — Métricas Estimadas — “Algumas métricas podem ser estimadas quando os dados estão indisponíveis ou incompletos.” Em vez disso, solicite uma dimensão de detalhamento por consulta e combine os resultados em sua camada de análise (por exemplo, Claude com MCP da Porter).

Todos os três comportamentos acionam limitação de cota ou degradação da qualidade dos dados. Se você quer usar o Claude para o Facebook Insights com segurança, ritme suas requisições, faça batching de forma inteligente e limite os detalhamentos a uma dimensão por consulta.

O protocolo de escalabilidade de 5 regras

Com base nos limites de taxa documentados da Meta e nos comportamentos que realmente causaram falhas de pipeline — não em suposições:

• Limite as chamadas da Graph API a 200 por hora por usuário. O Limite de Taxa da Plataforma da Meta aloca ~200 chamadas/hora por usuário por aplicativo para consultas de Insights de Página. Exceder isso aciona limitação para aquele usuário enquanto o pool total do aplicativo permanece inalterado. Fonte: Limitação de Taxa da Graph API da Meta Se você ignorar isso, sua sessão de MCP travará no meio da conversa enquanto o Claude espera por respostas de API que a Meta está atrasando.

• Limite as chamadas da Marketing API ao seu nível de Caso de Uso de Negócio (BUC). Para Acesso Padrão: 5.000 + 40 × Número de Audiências Personalizadas Ativas por hora por conta de anúncio. Para Acesso Avançado: 190.000 + 40 × Número de Audiências Personalizadas Ativas por hora por conta de anúncio. Fonte: Limites de Taxa BUC da API de Marketing da Meta Se você ignorar isso, seus fluxos de trabalho de relatórios automatizados falharão silenciosamente com o código de erro 80004.

• Faça requisições em batch com um máximo de 50 IDs por chamada. A Meta suporta batching de múltiplos IDs de objeto em uma única requisição HTTP, mas exceder 50 IDs por batch faz a requisição falhar ou ser processada parcialmente. Fonte: Requisições em Batch da Graph API da Meta Se você ignorar isso, desperdiçará cota em chamadas falhas e receberá dados incompletos de volta.

• Implemente backoff exponencial com o cabeçalho `Retry-After`. Quando limitado (HTTP 429 ou código de erro 80006), a Meta retorna um cabeçalho `Retry-After` indicando segundos para esperar. Um backoff adequado começa em 2 segundos e dobra a cada nova tentativa (2s → 4s → 8s → 16s). Fonte: Tratamento de Erros da Graph API da Meta Se você ignorar isso, seu código martelará os servidores da Meta e estenderá a janela de limitação de minutos para horas.

• Limite as dimensões de detalhamento a uma por consulta e use janelas de datas de 7 dias. A Meta estima métricas quando os detalhamentos são muito granulares ou os intervalos de datas excedem os dados brutos disponíveis. Solicitar `idade,gênero` juntos em uma chamada com um intervalo de 90 dias retorna valores estimados que não somam ao total sem detalhamento. Fonte: Melhores Práticas de Insights da API de Marketing da Meta Se você ignorar isso, o Claude analisará dados “que parecem precisos” mas são na verdade estimativa estatística da Meta — levando a conclusões incorretas sobre sua audiência.

O que o MCP da Porter faz de diferente: ele impõe esses limites de taxa e salvaguardas no nível da plataforma. O conector MCP do Facebook Insights da Porter é somente leitura por padrão — ele nunca escreve na sua Página, eliminando os vetores de abuso que acionam a fiscalização mais rigorosa da Meta. A plataforma implementa backoff exponencial automático com análise do cabeçalho `Retry-After`, então a limitação nunca quebra sua conversa no Claude. As requisições são feitas em batch internamente (respeitando o limite de 50 IDs) e ritmadas ao longo de janelas de tempo para ficar bem abaixo do teto de 200 chamadas/hora/usuário. Os detalhamentos são pré-configurados em padrões sensatos (por exemplo, uma dimensão por vez) para que você obtenha métricas brutas e não estimadas em vez de dados estatisticamente combinados. Esse é o comportamento que os sistemas automatizados da Meta tratam com elegância — somente leitura, ritmado, em batch e limitado a `read_insights` + `pages_read_engagement` apenas.

Perguntas frequentes