MaxStat MCP

Servidor MCP remoto oficial para análises do MAX messenger: pesquise canais e postagens, acompanhe o crescimento do público, visualizações, reações e atividade de publicação.

GitHub

Documentação

MaxStat MCP

Servidor MCP remoto oficial da MaxStat para busca, análise e monitoramento de canais e publicações no mensageiro MAX.

Desenvolvedor e operador: ООО «ФБМ Аналитикс» / FBM Analytics.

Русский · English

Obter token de API gratuito · Conectar MaxStat MCP · Ver todas as 21 ferramentas · Instruções para instalador de IA

Демонстрация MaxStat MCP

A MaxStat hospeda e mantém o servidor MCP. No repositório são publicados manifestos, plugins, skill analítico, configurações de cliente e documentação. A implementação do servidor e os dados da MaxStat não são código aberto.

Português

O que exatamente você pode obter via MaxStat MCP

O agente de IA se conecta ao índice ativo de canais e publicações do MAX e recebe dados estruturados, não fragmentos de resultados de busca ou capturas de tela coletadas manualmente.

Área	Quais dados o MCP retorna
Busca de canais	Nome, descrição, URL, categoria, tipo de acesso, faixas de audiência e números de publicações, ordenação por relevância, data ou audiência
Ficha do canal	ID, nome, descrição, avatar, URL, acesso público ou fechado, inscritos, publicações, categorias, datas e status RKN, quando disponível
Dinâmica de audiência	Valores diários, mínimo, máximo, crescimento absoluto e percentual no período selecionado
Visualizações e reações	Valores totais, médios e máximos por publicação e histórico diário
Atividade do canal	Número de publicações, histórico diário e distribuição por texto, foto, vídeo, arquivos e outros formatos
Busca de publicações	Busca em texto completo com filtros por canal, formato, datas, visualizações e reações
Ficha da publicação	Texto, URL, tipo, anexos, visualizações, total e detalhamento de reações, datas e fonte de reenvio
Histórico da publicação	Valores diários de visualizações e reações
Reenvios	Repostagens encontradas, seus URLs, datas e IDs dos canais de destino
Monitoramento	Webhook para novas publicações do canal ou novas publicações por palavra-chave e categoria
Plano e consumo	Status do plano, período, créditos incluídos, comprados, usados e restantes e histórico de cobranças

Você também pode adicionar um canal MAX público ou acessível por convite à fila de monitoramento da MaxStat.

Escala verificada do índice

Verificado em 29 de julho de 2026	Índice ativo
Canais MAX	408 501
Publicações	86 315 758
Categorias de canais	42
Ferramentas MCP	21

Estes são números de produção em maxstat.ru, não de ambiente de staging. O índice cresce constantemente. Use search_channels, search_posts e get_categories para obter resultados atualizados.

Início rápido

Crie um token no painel da API MaxStat.
Não publique o token nem o adicione ao Git.
Escolha uma plataforma abaixo.
Reinicie o cliente e verifique se as 21 ferramentas MaxStat estão disponíveis.

Parâmetro	Valor
Endpoint	`https://maxstat.ru/api/mcp`
Transporte	Streamable HTTP
Autenticação	Token de API
Cabeçalho	`X-API-Token: <API_TOKEN>`
Variável de ambiente	`MAXSTAT_API_TOKEN`

Instalação por plataforma

Plataforma	Método
Codex / ChatGPT desktop	Marketplace de repositório e plugin nativo Codex
Claude Code	Marketplace compatível com Claude
VS Code	Marketplace Agent Plugins ou `.vscode/mcp.json` direto
GitHub Copilot CLI	Marketplace comum Claude/Copilot
Gemini CLI	Extensão Gemini com configuração protegida de token
Cursor	Instalação por link ou `~/.cursor/mcp.json`
Windsurf	`~/.codeium/windsurf/mcp_config.json`
JetBrains AI Assistant	Configurações MCP da IDE
Claude Desktop	Ponte local `mcp-remote`
Cline	Streamable HTTP remoto de `llms-install.md`
Outros clientes	JSON universal Streamable HTTP

Codex

Antes de iniciar o Codex, salve o token no ambiente:

export MAXSTAT_API_TOKEN="<API_TOKEN>"

Adicione o marketplace e instale o plugin:

codex plugin marketplace add fbmdata/maxstat-mcp
codex plugin add maxstat@maxstat-plugins

O plugin conecta o MCP com o cabeçalho de usuário correto X-API-Token. Não use a configuração Bearer: ela envia outro cabeçalho e não é adequada para a MaxStat.

Para instalação direta sem plugin, combine configs/codex.toml com seu ~/.codex/config.toml:

[mcp_servers.maxstat]
url = "https://maxstat.ru/api/mcp"
env_http_headers = { "X-API-Token" = "MAXSTAT_API_TOKEN" }

Claude Code

export MAXSTAT_API_TOKEN="<API_TOKEN>"
claude plugin marketplace add fbmdata/maxstat-mcp
claude plugin install maxstat@maxstat-plugins

A configuração direta está em configs/claude-code.json.

Visual Studio Code

Adicione o marketplace em settings.json:

{
  "chat.plugins.marketplaces": ["fbmdata/maxstat-mcp"]
}

Abra Extensions, procure por @agentPlugins, selecione MaxStat MCP e clique em Install. Para conexão direta, copie configs/vscode.json para .vscode/mcp.json: o VS Code solicitará o token com segurança via entrada de senha.

GitHub Copilot CLI

export MAXSTAT_API_TOKEN="<API_TOKEN>"
copilot plugin marketplace add fbmdata/maxstat-mcp
copilot plugin install maxstat@maxstat-plugins

Claude Code, VS Code e GitHub Copilot CLI usam o mesmo plugin, skill e configuração MCP compatíveis.

Gemini CLI

gemini extensions install https://github.com/fbmdata/maxstat-mcp

A extensão solicitará MAXSTAT_API_TOKEN como configuração sensível e o conectará ao cabeçalho X-API-Token. As instruções do Gemini estão em GEMINI.md.

Cursor

Antes de iniciar o Cursor, defina MAXSTAT_API_TOKEN e clique no botão acima. Alternativa: combine configs/cursor.json com ~/.cursor/mcp.json.

Cline

Defina MAXSTAT_API_TOKEN antes de iniciar o Cline e entregue ao agente llms-install.md. O arquivo contém a configuração do servidor Streamable HTTP remoto e a verificação de conexão. Pacote npm local não é necessário: a MaxStat hospeda e mantém o servidor em https://maxstat.ru/api/mcp.

Windsurf

Defina MAXSTAT_API_TOKEN antes de iniciar o Windsurf e combine configs/windsurf.json com ~/.codeium/windsurf/mcp_config.json. A configuração usa a substituição nativa de ${env:MAXSTAT_API_TOKEN}.

JetBrains AI Assistant

Abra Settings → Tools → AI Assistant → Model Context Protocol (MCP), adicione a configuração HTTP de configs/jetbrains.json e substitua <API_TOKEN> localmente na IDE. O JetBrains ainda não documenta a substituição de variável de ambiente em cabeçalhos MCP, então o placeholder foi mantido intencionalmente.

Claude Desktop

O conector personalizado em nuvem do Claude não aceita um X-API-Token personalizado arbitrário. Até a implementação do OAuth 2.1, use a ponte local de configs/claude-desktop.json. São necessários Node.js e npm; o token é salvo apenas na configuração local do Claude Desktop.

Configuração universal

Use configs/generic-mcp.json:

{
  "mcpServers": {
    "maxstat": {
      "type": "streamable-http",
      "url": "https://maxstat.ru/api/mcp",
      "headers": {
        "X-API-Token": "<API_TOKEN>"
      }
    }
  }
}

Todas as 21 ferramentas

Busca e catálogo

Ferramenta	O que retorna ou faz	Créditos
`get_categories`	Categorias e quantidade atual de canais em cada categoria	Grátis
`search_channels`	Fichas de canais filtradas, ordenadas e paginadas	3
`get_channel`	Ficha completa de um canal por identificador	1
`add_channel`	Adiciona um canal público ou invite-only à fila	Grátis
`search_posts`	Publicações filtradas, ordenadas e paginadas	3

Análise de canais

Ferramenta	O que retorna	Créditos
`get_channel_subscribers`	Mínimo, máximo, crescimento absoluto e percentual e histórico diário	5
`get_channel_views`	Visualizações totais, médias e máximas e histórico diário	5
`get_channel_likes`	Reações totais, médias e máximas e histórico diário	5
`get_channel_posts`	Número de publicações, formatos e histórico diário de atividade	5

Análise de publicações

Ferramenta	O que retorna	Créditos
`get_post`	Conteúdo, anexos, métricas, fonte de reenvio e repostagens encontradas	1
`get_post_views`	Número atual de visualizações e histórico diário	5
`get_post_likes`	Total de reações, detalhamento por tipo e histórico diário	5

Monitoramento por webhook

Ferramenta	O que retorna ou faz	Créditos
`create_channel_subscription`	Assina um callback HTTPS público para novas publicações do canal	Criação grátis; 2 por entrega
`create_keyword_subscription`	Assina callback para publicações por consulta e categoria	Criação grátis; 3 por entrega
`get_subscriptions`	Lista de assinaturas com filtros por status e tipo	Grátis
`get_subscription`	Uma assinatura, estado de entrega e último erro	Grátis
`update_subscription`	Alteração de callback URL, pausa ou retomada	Grátis
`delete_subscription`	Exclusão de assinatura de webhook	Grátis

O webhook deve estar acessível em um endereço HTTPS público.

Plano e uso

Ferramenta	O que retorna	Créditos
`get_account_subscription`	Plano, status, período e estado dos créditos	Grátis
`get_account_limits`	Créditos incluídos, comprados, usados e restantes	Grátis
`get_account_usage`	Histórico paginado de cobranças por consultas	Grátis

Exemplo com dados reais

Uma consulta de verificação à produção em 29 de julho de 2026 retornou:

canal MAX • Анонсы com audiência de 3 496 789 inscritos;
crescimento de 3 054 001 para 3 496 789 de 30 de junho a 29 de julho: +442 788 / +14,5%;
publicação com 17 888 688 visualizações e 187 460 reações;
detalhamento de reações, históricos diários de visualizações e reações;
184 reenvios encontrados.

Os valores mostram a estrutura de uma resposta real e não constituem promessa de métricas fixas do produto.

Exemplos de consultas

Найди 20 технологических каналов MAX с максимальным приростом подписчиков за
последние 30 дней. Верни ссылки, текущую аудиторию и процент роста.

Сравни пять каналов по аудитории, средним просмотрам, реакциям, частоте
публикаций и распределению форматов.

Найди публикации об ипотеке за июль. Верни ссылки, текст, вложения, просмотры,
детальные реакции и найденные пересылки.

Подпиши webhook на новые публикации со словами «искусственный интеллект» в
категории «Технологии».

Покажи мой тариф MaxStat, остаток кредитов и десять последних списаний.

Planos e segurança

O MCP está incluído em todos os planos da MaxStat API sem custo adicional. O MCP e as chamadas diretas à API usam um saldo único de créditos. O Test Drive é ativado na primeira chamada à API e fornece 1 000 créditos a cada 30 dias.

Nunca publique um token de API real em issue, PR, configuração, log ou captura de tela. Reporte vulnerabilidades seguindo as instruções em SECURITY.md.

Inglês

O MaxStat MCP dá aos agentes de IA acesso estruturado ao índice de canais e publicações do mensageiro MAX. Ele oferece suporte à descoberta de canais e publicações, audiência diária, históricos de visualizações e reações, atividade de publicação, detalhes de anexos e reações, detecção de reenvios, monitoramento de webhooks e uso de créditos da conta. O índice de produção foi verificado em 29 de julho de 2026 com 408,501 canais, 86,315,758 publicações, 42 categorias de canais e 21 ferramentas MCP.

Conexão

Parâmetro	Valor
Endpoint	`https://maxstat.ru/api/mcp`
Transporte	Streamable HTTP
Cabeçalho	`X-API-Token: <API_TOKEN>`
Painel de token	maxstat.ru/dashboard/api

Instalação

Codex

export MAXSTAT_API_TOKEN="<API_TOKEN>"
codex plugin marketplace add fbmdata/maxstat-mcp
codex plugin add maxstat@maxstat-plugins

Claude Code

export MAXSTAT_API_TOKEN="<API_TOKEN>"
claude plugin marketplace add fbmdata/maxstat-mcp
claude plugin install maxstat@maxstat-plugins

GitHub Copilot CLI

export MAXSTAT_API_TOKEN="<API_TOKEN>"
copilot plugin marketplace add fbmdata/maxstat-mcp
copilot plugin install maxstat@maxstat-plugins

Gemini CLI

gemini extensions install https://github.com/fbmdata/maxstat-mcp

Para VS Code, Cursor, Windsurf, JetBrains AI Assistant, Claude Desktop e clientes genéricos, use o diretório configs/ incluído no repositório. A seção em russo acima contém instruções detalhadas específicas para cada cliente.

Recursos

Pesquisar e filtrar canais e publicações do MAX.
Obter perfis de canais, crescimento de audiência, visualizações, reações, atividade e mix de formatos de conteúdo.
Obter texto de publicações, anexos, métricas, detalhes de reações, históricos e reenvios detectados.
Criar e gerenciar assinaturas de webhook por canal ou palavra-chave.
Inspecionar o plano MaxStat ativo, o saldo de créditos e o uso por requisição.

O contrato completo das 21 ferramentas e os custos de créditos estão documentados em Todas as 21 ferramentas.

Limite de autenticação

Esta versão oferece suporte a clientes que podem enviar o cabeçalho personalizado X-API-Token. Publicar como um conector de nuvem totalmente hospedado do ChatGPT ou Claude exige uma implementação separada de OAuth 2.1.

Licença

A licença MIT se aplica apenas aos manifestos, plugins, skills, configurações, documentação e verificações auxiliares publicados neste repositório. A licença não se aplica ao serviço MaxStat, à API, aos dados, aos bancos de dados, às marcas registradas e à implementação do servidor. Detalhes estão disponíveis em NOTICE.

MaxStat MCP

Documentação

MaxStat MCP

Português

O que exatamente você pode obter via MaxStat MCP

Escala verificada do índice

Início rápido

Instalação por plataforma

Codex

Claude Code

Visual Studio Code

GitHub Copilot CLI

Gemini CLI

Cursor

Cline

Windsurf

JetBrains AI Assistant

Claude Desktop

Configuração universal

Todas as 21 ferramentas

Busca e catálogo

Análise de canais

Análise de publicações

Monitoramento por webhook

Plano e uso

Exemplo com dados reais

Exemplos de consultas

Planos e segurança

Inglês

Conexão

Instalação

Codex

Claude Code

GitHub Copilot CLI

Gemini CLI

Recursos

Limite de autenticação

Links

Licença