MaxStat MCP
Servidor MCP remoto oficial para el análisis de mensajería de MAX: busca canales y publicaciones, realiza un seguimiento del crecimiento de la audiencia, las vistas, las reacciones y la actividad de publicación.
Documentación
MaxStat MCP
Servidor MCP remoto oficial de MaxStat para búsqueda, análisis y monitoreo de canales y publicaciones en el mensajero MAX.
Desarrollador y operador: ООО «ФБМ Аналитикс» / FBM Analytics.
Obtener un API-token gratuito · Conectar MaxStat MCP · Ver las 21 herramientas · Guía para instalador de IA
MaxStat aloja y mantiene el servidor MCP. En el repositorio se publican manifiestos, plugins, la skill analítica, configuraciones de cliente y documentación. La implementación del servidor y los datos de MaxStat no son de código abierto.
Español
Qué se puede obtener exactamente a través de MaxStat MCP
El agente de IA se conecta al índice activo de canales y publicaciones de MAX y recibe datos estructurados, no fragmentos de resultados de búsqueda ni capturas de pantalla recopiladas manualmente.
| Área | Qué datos devuelve el MCP |
|---|---|
| Búsqueda de canales | Nombre, descripción, URL, categoría, tipo de acceso, rangos de audiencia y número de publicaciones, ordenación por relevancia, fecha o audiencia |
| Ficha del canal | ID, nombre, descripción, avatar, URL, acceso público o cerrado, suscriptores, publicaciones, categorías, fechas y estado de РКН, cuando está disponible |
| Dinámica de audiencia | Valores diarios, mínimo, máximo, crecimiento absoluto y porcentual para el período seleccionado |
| Vistas y reacciones | Valores totales, medios y máximos por publicación e historial diario |
| Actividad del canal | Número de publicaciones, historial diario y distribución por texto, foto, video, archivos y otros formatos |
| Búsqueda de publicaciones | Búsqueda de texto completo con filtros por canal, formato, fechas, vistas y reacciones |
| Ficha de publicación | Texto, URL, tipo, adjuntos, vistas, suma y desglose de reacciones, fechas y fuente de reenvío |
| Historial de publicación | Valores diarios de vistas y reacciones |
| Reenvíos | Reposts encontrados, sus URL, fechas e IDs de los canales de destino |
| Monitoreo | Webhook para nuevas publicaciones del canal o nuevas publicaciones por palabra clave y categoría |
| Tarifa y consumo | Estado de la tarifa, período, créditos incluidos, comprados, usados y restantes, e historial de cobros |
También se puede añadir un canal de MAX público o accesible por invitación a la cola de seguimiento de MaxStat.
Escala verificada del índice
| Verificado el 29 de julio de 2026 | Índice activo |
|---|---|
| Canales MAX | 408 501 |
| Publicaciones | 86 315 758 |
| Categorías de canales | 42 |
| Herramientas MCP | 21 |
Estos son indicadores de producción en maxstat.ru, no del entorno de
staging. El índice crece constantemente. Utilice search_channels,
search_posts y get_categories para obtener resultados actualizados.
Inicio rápido
- Cree un token en el panel personal de MaxStat API.
- No publique el token ni lo añada a Git.
- Elija la plataforma a continuación.
- Reinicie el cliente y compruebe que las 21 herramientas de MaxStat están disponibles.
| Parámetro | Valor |
|---|---|
| Endpoint | https://maxstat.ru/api/mcp |
| Transporte | Streamable HTTP |
| Autorización | API-token |
| Cabecera | X-API-Token: <API_TOKEN> |
| Variable de entorno | MAXSTAT_API_TOKEN |
Instalación por plataformas
| Plataforma | Método |
|---|---|
| Codex / ChatGPT desktop | Repositorio-marketplace y plugin nativo de Codex |
| Claude Code | Marketplace compatible con Claude |
| VS Code | Agent Plugins marketplace o .vscode/mcp.json directo |
| GitHub Copilot CLI | Marketplace común de Claude/Copilot |
| Gemini CLI | Extensión de Gemini con configuración protegida del token |
| Cursor | Instalación por enlace o ~/.cursor/mcp.json |
| Windsurf | ~/.codeium/windsurf/mcp_config.json |
| JetBrains AI Assistant | Ajustes MCP del IDE |
| Claude Desktop | Puente local mcp-remote |
| Cline | Streamable HTTP remoto desde llms-install.md |
| Otros clientes | JSON universal de Streamable HTTP |
Codex
Antes de iniciar Codex, guarde el token en el entorno:
export MAXSTAT_API_TOKEN="<API_TOKEN>"
Añada el marketplace e instale el plugin:
codex plugin marketplace add fbmdata/maxstat-mcp
codex plugin add maxstat@maxstat-plugins
El plugin conecta el MCP con la cabecera de usuario correcta
X-API-Token. No utilice la configuración Bearer: envía otra cabecera
y no es adecuada para MaxStat.
Para la instalación directa sin plugin, combine
configs/codex.toml con su
~/.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
La configuración directa se encuentra en
configs/claude-code.json.
Visual Studio Code
Añada el marketplace en settings.json:
{
"chat.plugins.marketplaces": ["fbmdata/maxstat-mcp"]
}
Abra Extensions, busque @agentPlugins, seleccione MaxStat MCP y haga clic
en Install. Para la conexión directa, copie
configs/vscode.json en .vscode/mcp.json: VS Code
solicitará el token de forma segura mediante password input.
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 y GitHub Copilot CLI utilizan el mismo plugin compatible, la misma skill y la misma configuración MCP.
Gemini CLI
gemini extensions install https://github.com/fbmdata/maxstat-mcp
La extensión solicitará MAXSTAT_API_TOKEN como ajuste sensible y lo conectará
a la cabecera X-API-Token. Las instrucciones de Gemini se encuentran en
GEMINI.md.
Cursor
Antes de iniciar Cursor, defina MAXSTAT_API_TOKEN y luego haga clic en el botón
anterior. Alternativa: combine
configs/cursor.json con ~/.cursor/mcp.json.
Cline
Defina MAXSTAT_API_TOKEN antes de iniciar Cline y entregue al agente
llms-install.md. El archivo contiene la configuración del
servidor remoto Streamable HTTP y la verificación de conexión. No se necesita
un paquete npm local: MaxStat aloja y mantiene el servidor en https://maxstat.ru/api/mcp.
Windsurf
Defina MAXSTAT_API_TOKEN antes de iniciar Windsurf y combine
configs/windsurf.json con
~/.codeium/windsurf/mcp_config.json. La configuración utiliza la sustitución
nativa de ${env:MAXSTAT_API_TOKEN}.
JetBrains AI Assistant
Abra Settings → Tools → AI Assistant → Model Context Protocol (MCP),
añada la configuración HTTP de
configs/jetbrains.json y reemplace <API_TOKEN>
localmente en el IDE. JetBrains todavía no documenta la sustitución de
variable de entorno en las cabeceras MCP, por lo que el placeholder se deja
a propósito.
Claude Desktop
El connector personalizado de Claude en la nube no acepta una
X-API-Token de usuario arbitraria. Hasta la implementación de OAuth 2.1,
utilice el puente local de
configs/claude-desktop.json. Se requieren
Node.js y npm; el token se guarda solo en la configuración local de Claude
Desktop.
Configuración universal
Utilice configs/generic-mcp.json:
{
"mcpServers": {
"maxstat": {
"type": "streamable-http",
"url": "https://maxstat.ru/api/mcp",
"headers": {
"X-API-Token": "<API_TOKEN>"
}
}
}
}
Las 21 herramientas
Búsqueda y catálogo
| Herramienta | Qué devuelve o hace | Créditos |
|---|---|---|
get_categories | Categorías y número actual de canales en cada categoría | Gratis |
search_channels | Fichas de canales filtradas, ordenadas y paginadas | 3 |
get_channel | Ficha completa de un canal por identificador | 1 |
add_channel | Añade un canal público o invite-only a la cola | Gratis |
search_posts | Publicaciones filtradas, ordenadas y paginadas | 3 |
Analítica de canales
| Herramienta | Qué devuelve | Créditos |
|---|---|---|
get_channel_subscribers | Mínimo, máximo, crecimiento absoluto y porcentual e historial diario | 5 |
get_channel_views | Vistas totales, medias y máximas e historial diario | 5 |
get_channel_likes | Reacciones totales, medias y máximas e historial diario | 5 |
get_channel_posts | Número de publicaciones, formatos e historial diario de actividad | 5 |
Analítica de publicaciones
| Herramienta | Qué devuelve | Créditos |
|---|---|---|
get_post | Contenido, adjuntos, métricas, fuente de reenvío y reposts encontrados | 1 |
get_post_views | Número actual de vistas e historial diario | 5 |
get_post_likes | Número total de reacciones, desglose por tipo e historial diario | 5 |
Monitoreo por webhook
| Herramienta | Qué devuelve o hace | Créditos |
|---|---|---|
create_channel_subscription | Suscribe un callback HTTPS público a nuevas publicaciones del canal | Creación gratis; 2 por entrega |
create_keyword_subscription | Suscribe un callback a publicaciones por consulta y categoría | Creación gratis; 3 por entrega |
get_subscriptions | Lista de suscripciones con filtros por estado y tipo | Gratis |
get_subscription | Una suscripción, estado de entrega y último error | Gratis |
update_subscription | Cambio de callback URL, pausa o reanudación | Gratis |
delete_subscription | Eliminación de la suscripción webhook | Gratis |
El webhook debe ser accesible a través de una dirección HTTPS pública.
Tarifa y uso
| Herramienta | Qué devuelve | Créditos |
|---|---|---|
get_account_subscription | Tarifa, estado, período y estado de los créditos | Gratis |
get_account_limits | Créditos incluidos, comprados, usados y restantes | Gratis |
get_account_usage | Historial paginado de cobros por consultas | Gratis |
Ejemplo con datos reales
Una consulta de verificación a producción el 29 de julio de 2026 devolvió:
- el canal MAX • Анонсы con una audiencia de 3 496 789 suscriptores;
- crecimiento de 3 054 001 a 3 496 789 del 30 de junio al 29 de julio: +442 788 / +14,5%;
- publicación con 17 888 688 vistas y 187 460 reacciones;
- desglose de reacciones, historiales diarios de vistas y reacciones;
- 184 reenvíos encontrados.
Los valores muestran la estructura de una respuesta real y no constituyen una promesa de métricas fijas del producto.
Ejemplos de consultas
Найди 20 технологических каналов MAX с максимальным приростом подписчиков за
последние 30 дней. Верни ссылки, текущую аудиторию и процент роста.
Сравни пять каналов по аудитории, средним просмотрам, реакциям, частоте
публикаций и распределению форматов.
Найди публикации об ипотеке за июль. Верни ссылки, текст, вложения, просмотры,
детальные реакции и найденные пересылки.
Подпиши webhook на новые публикации со словами «искусственный интеллект» в
категории «Технологии».
Покажи мой тариф MaxStat, остаток кредитов и десять последних списаний.
Planes y seguridad
El MCP está incluido en todos los planes de MaxStat API sin coste adicional. El MCP y las llamadas directas a la API comparten un mismo saldo de créditos. Test Drive se activa con la primera solicitud a la API y proporciona 1 000 créditos cada 30 días.
Nunca publiques un token real de la API en issues, PR, configuraciones, registros o
capturas de pantalla. Informa sobre vulnerabilidades siguiendo las instrucciones de
SECURITY.md.
Inglés
MaxStat MCP proporciona a los agentes de IA acceso estructurado al índice en vivo de canales y publicaciones del mensajero MAX. Admite descubrimiento de canales y publicaciones, audiencia diaria, historiales de vistas y reacciones, actividad de publicación, detalles de adjuntos y reacciones, detección de reenvíos, monitoreo de webhooks y uso de créditos de la cuenta. El índice de producción fue verificado el 29 de julio de 2026 con 408 501 canales, 86 315 758 publicaciones, 42 categorías de canales y 21 herramientas MCP.
Conexión
| Parámetro | Valor |
|---|---|
| Endpoint | https://maxstat.ru/api/mcp |
| Transporte | Streamable HTTP |
| Cabecera | X-API-Token: <API_TOKEN> |
| Panel de tokens | maxstat.ru/dashboard/api |
Instalación
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 y
clientes genéricos, usa el directorio configs/ incluido en el repositorio. La
sección en ruso anterior contiene instrucciones detalladas específicas para cada cliente.
Capacidades
- Buscar y filtrar canales y publicaciones de MAX.
- Obtener perfiles de canales, crecimiento de audiencia, vistas, reacciones, actividad y combinación de formatos de contenido.
- Obtener texto de publicaciones, adjuntos, métricas, detalles de reacciones, historiales y reenvíos detectados.
- Crear y gestionar suscripciones webhook por canal o palabra clave.
- Inspeccionar el plan MaxStat activo, el saldo de créditos y el uso a nivel de solicitud.
El contrato completo de las 21 herramientas y los costos de créditos están documentados en Todas las 21 herramientas.
Límite de autenticación
Esta versión admite clientes que pueden enviar la cabecera personalizada X-API-Token.
Publicar como conector en la nube totalmente alojado de ChatGPT o Claude requiere una
implementación separada de OAuth 2.1.
Enlaces / Links
- MaxStat MCP
- Obtener token de API / Get a token
- Documentación de la API / API documentation
- Planes de API / API plans
- ООО «ФБМ Аналитикс» / FBM Analytics
- MaxStat Insights en MAX
- FBM API Insights en Telegram
Licencia / License
MIT se aplica únicamente a los manifiestos, plugins, skills, configuraciones, documentación
y comprobaciones auxiliares publicados en este repositorio. La licencia no se aplica al
servicio MaxStat, la API, los datos, las bases de datos, las marcas comerciales ni la
implementación del servidor. Los detalles se proporcionan en NOTICE.