Resumo da Notícia
Contexto Geral
Apresenta o meta-insights-mcp, um servidor MCP que expõe insights de negócios do Meta (Facebook/Instagram) pelas APIs Graph e Marketing, utilizando um token de acesso de System User. O conteúdo detalha instalação, configuração por variáveis de ambiente, ferramentas disponíveis, verificação com MCP Inspector, comandos de desenvolvimento/execução e procedimentos de publicação.
Principais Pontos
- Instalação: pip install meta-insights-mcp; alternativas incluem uv add meta-insights-mcp ou execução ad hoc com uvx meta-insights-mcp.
- Configuração por variáveis de ambiente, com leitura pelo servidor; exigência de META_ACCESS_TOKEN.
- Exemplos de configuração em clientes MCP (Claude Desktop e Claude Code), com opções de comando via uvx, execução direta meta-insights-mcp após instalação, ou fallback em módulo (python -m meta_insights_mcp).
- Ferramentas user-scoped:
- list_meta_assets (contas de anúncios e Páginas visíveis pelo token)
- check_token_status (escopos, app e expiração do token)
- get_ad_account_insights (desempenho de anúncios por conta)
- get_campaign_insights (insights de uma campanha)
- list_campaigns (campanhas de uma conta)
- get_page_insights (insights orgânicos de Página)
- get_post_insights (insights de um post de Página)
- list_page_posts (posts recentes de uma Página)
- Ferramentas business-scoped (ativas quando META_BUSINESS_ID está definida):
- list_business_assets (ativos do negócio: contas de anúncios, Páginas, IG, System Users)
- list_owned_ad_accounts (contas de anúncios do negócio)
- list_owned_pages (Páginas do negócio)
- list_client_ad_accounts (contas de anúncios compartilhadas com o negócio)
- list_business_system_users (System Users do negócio)
- Requisito de configuração no Meta Business Manager antes do retorno de dados; uso de check_token_status para verificar escopos e expiração.
- Orientação: se list_meta_assets retornar arrays vazios, o token está válido, porém o System User não tem ativos atribuídos; ajustar nas Configurações de Negócios da Meta.
- MCP Inspector (interface em navegador fornecida pela Anthropic) permite chamar ferramentas diretamente para validar o funcionamento antes de conectar ao Claude.
- Comandos de desenvolvimento/execução: mcp dev meta_insights_mcp/server.py; execução direta do servidor (stdio) com meta-insights-mcp.
- Passos de desenvolvimento local: git clone, criação de venv, instalação editável (pip install -e .) e uso do MCP Inspector.
- Publicação: criação de wheel e sdist (python -m build); envio ao TestPyPI com twine para validação; instalação a partir do TestPyPI; posterior envio ao PyPI.
- Licença: MIT.
Informações Essenciais
O meta-insights-mcp é um servidor MCP para acesso a insights de negócios do Meta via APIs Graph e Marketing, operando com token de System User e configurado por variáveis de ambiente. Oferece ferramentas para listar ativos, verificar status de token e obter insights de contas de anúncios, campanhas, Páginas e posts, com opções adicionais para escopo de negócio mediante META_BUSINESS_ID. O conteúdo inclui exemplos de configuração em clientes MCP, verificação via MCP Inspector, instruções de execução local, orientação para ajustes de permissões no Business Manager, procedimentos de publicação em TestPyPI/PyPI e indicação de licença MIT.
Fonte: pypi.org