MaxStat MCP

MaxStat MCP

Официальный удалённый MCP-сервер MaxStat для поиска, аналитики и мониторинга каналов и публикаций в мессенджере MAX.

Разработчик и оператор: ООО «ФБМ Аналитикс» / FBM Analytics.

Русский · English

Получить бесплатный API-токен · Подключить MaxStat MCP · Посмотреть все 21 инструмент · Инструкция для AI-установщика

MaxStat размещает и обслуживает MCP-сервер. В репозитории опубликованы манифесты, плагины, аналитический skill, клиентские конфигурации и документация. Серверная реализация и данные MaxStat не являются открытым исходным кодом.

Русский

Что именно можно получить через MaxStat MCP

AI-агент подключается к живому индексу каналов и публикаций MAX и получает структурированные данные, а не фрагменты поисковой выдачи или вручную собранные скриншоты.

Область	Какие данные возвращает MCP
Поиск каналов	Название, описание, URL, категория, тип доступа, диапазоны аудитории и числа публикаций, сортировка по релевантности, дате или аудитории
Карточка канала	ID, название, описание, аватар, URL, публичный или закрытый доступ, подписчики, публикации, категории, даты и статус РКН, когда он доступен
Динамика аудитории	Дневные значения, минимум, максимум, абсолютный и процентный рост за выбранный период
Просмотры и реакции	Суммарные, средние и максимальные значения на публикацию и дневная история
Активность канала	Число публикаций, дневная история и распределение по тексту, фото, видео, файлам и другим форматам
Поиск публикаций	Полнотекстовый поиск с фильтрами по каналу, формату, датам, просмотрам и реакциям
Карточка публикации	Текст, URL, тип, вложения, просмотры, сумма и разбивка реакций, даты и источник пересылки
История публикации	Дневные значения просмотров и реакций
Пересылки	Найденные репосты, их URL, даты и ID каналов назначения
Мониторинг	Webhook на новые публикации канала или новые публикации по ключевому слову и категории
Тариф и расход	Статус тарифа, период, включённые, купленные, использованные и оставшиеся кредиты и история списаний

Также можно добавить публичный или доступный по приглашению канал MAX в очередь отслеживания MaxStat.

已验证的索引规模

截至 2026 年 7 月 29 日已验证	实时索引
MAX 频道	408 501
帖子	86 315 758
频道类别	42
MCP 工具	21

这些是 maxstat.ru 上生产环境的数据，并非 staging 环境。索引会持续增长。使用 search_channels、search_posts 和 get_categories 获取最新结果。

快速开始

1. 在 MaxStat API 个人中心创建令牌。
2. 不要公开令牌，也不要将其添加到 Git 中。
3. 在下方选择平台。
4. 重启客户端，并确认 MaxStat 的 21 个工具均可用。

参数	值
Endpoint	https://maxstat.ru/api/mcp
传输方式	Streamable HTTP
身份验证	API 令牌
请求头	X-API-Token: <API_TOKEN>
环境变量	MAXSTAT_API_TOKEN

按平台安装

平台	方式
Codex / ChatGPT desktop	Marketplace 仓库和原生 Codex 插件
Claude Code	兼容 Claude 的 marketplace
VS Code	Agent Plugins marketplace 或直接配置 .vscode/mcp.json
GitHub Copilot CLI	通用 Claude/Copilot marketplace
Gemini CLI	Gemini 扩展，支持安全的令牌配置
Cursor	通过链接安装或配置 ~/.cursor/mcp.json
Windsurf	~/.codeium/windsurf/mcp_config.json
JetBrains AI Assistant	IDE 的 MCP 设置
Claude Desktop	本地桥接 mcp-remote
Cline	使用 llms-install.md 中的远程 Streamable HTTP 配置
其他客户端	通用 Streamable HTTP JSON

Codex

启动 Codex 前，将令牌保存到环境变量中：

export MAXSTAT_API_TOKEN="<API_TOKEN>"

添加 marketplace 并安装插件：

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

该插件会使用正确的自定义请求头 X-API-Token 连接 MCP。 请勿使用 Bearer 配置：它会发送不同的请求头，不适用于 MaxStat。

如需不通过插件直接安装，请将 configs/codex.toml 合并到你的 ~/.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

直接配置文件位于 configs/claude-code.json。

Visual Studio Code

在 settings.json 中添加 marketplace：

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

打开 Extensions，搜索 @agentPlugins，选择 MaxStat MCP，然后点击 Install。如需直接连接，请将 configs/vscode.json 复制到 .vscode/mcp.json：VS Code 会通过 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 和 GitHub Copilot CLI 使用同一个兼容的插件、 skill 和 MCP 配置。

Gemini CLI

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

该扩展会将 MAXSTAT_API_TOKEN 作为敏感设置进行提示，并将其添加到 X-API-Token 请求头中。Gemini 使用说明见 GEMINI.md。

Cursor

启动 Cursor 前，设置 MAXSTAT_API_TOKEN，然后点击上方按钮。 或者，将 configs/cursor.json 合并到 ~/.cursor/mcp.json。

Cline

在启动 Cline 前设置 MAXSTAT_API_TOKEN，并将 llms-install.md 提供给 Agent。该文件包含远程 Streamable HTTP 服务的配置和连接检查。无需本地 npm 包： MaxStat 在 https://maxstat.ru/api/mcp 托管并运行服务。

Windsurf

在启动 Windsurf 前设置 MAXSTAT_API_TOKEN，并将 configs/windsurf.json 合并到 ~/.codeium/windsurf/mcp_config.json。该配置使用原生 ${env:MAXSTAT_API_TOKEN} 替换。

JetBrains AI Assistant

打开 Settings → Tools → AI Assistant → Model Context Protocol (MCP)， 添加 configs/jetbrains.json 中的 HTTP 配置，并在 IDE 中 本地替换 <API_TOKEN>。JetBrains 目前尚未说明 MCP headers 中是否支持环境变量 替换，因此有意保留了占位符。

Claude Desktop

Claude 云端自定义连接器不接受任意用户提供的 X-API-Token。在支持 OAuth 2.1 之前，请使用 configs/claude-desktop.json 中的本地桥接程序。需要 Node.js 和 npm；令牌仅保存在 Claude Desktop 的本地配置中。

通用配置

使用 configs/generic-mcp.json：

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

全部 21 个工具

搜索和目录

工具	返回或执行的内容	积分
get_categories	各类别及每个类别中当前的频道数量	免费
search_channels	筛选、排序并分页返回频道卡片	3
get_channel	根据标识符返回单个频道的完整卡片	1
add_channel	将公开或仅限邀请的频道添加到队列	免费
search_posts	筛选、排序并分页返回帖子	3

频道分析

工具	返回内容	积分
get_channel_subscribers	最低值、最高值、绝对增长、百分比增长及每日历史数据	5
get_channel_views	总浏览量、平均浏览量、最高浏览量及每日历史数据	5
get_channel_likes	总反应数、平均反应数、最高反应数及每日历史数据	5
get_channel_posts	帖子数量、格式及每日活动历史数据	5

帖子分析

工具	返回内容	积分
get_post	内容、附件、指标、转发来源和找到的转发	1
get_post_views	当前浏览量及每日历史数据	5
get_post_likes	反应总数、按类型细分的反应数及每日历史数据	5

Webhook 监控

工具	返回或执行的内容	积分
create_channel_subscription	将公开的 HTTPS 回调订阅到频道的新发布内容	创建免费；每次送达扣 2 积分
create_keyword_subscription	将回调订阅到符合查询和类别条件的发布内容	创建免费；每次送达扣 3 积分
get_subscriptions	按状态和类型筛选订阅列表	免费
get_subscription	单个订阅、送达状态和最近一次错误	免费
update_subscription	修改回调 URL、暂停或恢复	免费
delete_subscription	删除 Webhook 订阅	免费

Webhook 必须可通过公开的 HTTPS 地址访问。

套餐与用量

工具	返回内容	积分
get_account_subscription	套餐、状态、周期和积分状态	免费
get_account_limits	已包含、已购买、已使用和剩余积分	免费
get_account_usage	按页显示的请求扣费历史	免费

真实数据示例

2026 年 7 月 29 日向生产环境发送的验证请求返回了：

• 频道 MAX • Анонсы，拥有 3 496 789 名订阅者；
• 6 月 30 日至 7 月 29 日期间，订阅者从 3 054 001 增至 3 496 789： +442 788 / +14,5%；
• 一条发布内容，拥有 17 888 688 次浏览和 187 460 个反应；
• 反应明细，以及每日浏览和反应历史；
• 找到 184 条转发。

这些数值展示了真实响应的结构，并不代表产品保证提供固定指标。

请求示例

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

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

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

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

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

套餐与安全

MCP 包含在所有 MaxStat API 套餐中，无需额外付费。MCP 和直接调用 API 使用同一积分余额。首次发送 API 请求时会激活 Test Drive，每 30 天提供 1 000 积分。

切勿在 issue、PR、配置、日志或屏幕截图中公开真实的 API 令牌。请按照 SECURITY.md 中的说明报告漏洞。

English

MaxStat MCP 为 AI Agent 提供对实时 MAX messenger 频道和发布内容索引的结构化访问。它支持发现频道和发布内容、查询每日受众、浏览量和反应历史、发布活动、附件和反应详情、转发检测、Webhook 监控以及账户积分用量。生产环境索引已于 2026 年 7 月 29 日验证，包含 408,501 个频道、86,315,758 条发布内容、42 个频道类别和 21 个 MCP 工具。

连接

参数	值
端点	https://maxstat.ru/api/mcp
传输方式	Streamable HTTP
标头	X-API-Token: <API_TOKEN>
令牌管理面板	maxstat.ru/dashboard/api

安装

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

对于 VS Code、Cursor、Windsurf、JetBrains AI Assistant、Claude Desktop 和 通用客户端，请使用已纳入版本控制的 configs/ 目录。上文的俄语部分 包含针对各客户端的详细说明。

功能

• 搜索和筛选 MAX 频道及出版物。
• 获取频道资料、受众增长、浏览量、回应、活动情况及内容格式组合。
• 获取帖子文本、附件、指标、回应详情、历史记录及检测到的转发。
• 创建和管理频道或关键词 Webhook 订阅。
• 查看当前 MaxStat 套餐、额度余额及单次请求用量。

完整的 21 项工具约定及额度费用见 全部 21 项工具。

身份验证边界

此版本支持能够发送自定义 X-API-Token 标头的客户端。 要将其发布为完全托管的 ChatGPT 或 Claude 云连接器，需要单独实现 OAuth 2.1。

链接 / Links

• MaxStat MCP
• 获取 API 令牌 / Get a token
• API 文档 / API documentation
• API 套餐 / API plans
• ООО «ФБМ Аналитикс» / FBM Analytics
• MAX 中的 MaxStat Insights
• Telegram 中的 FBM API Insights

许可证 / License

MIT 仅适用于此仓库中发布的清单、插件、skill、配置、文档和辅助检查。 该许可证不适用于 MaxStat 服务、API、数据、数据库、商标和服务器端实现。 详情请参阅 NOTICE。