MaxStat MCP

Поиск и аналитика каналов и публикаций MAX в вашем AI-клиенте.

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

Русский · English

Получить API-токен · Подключить MaxStat MCP · 15 инструментов MCP · Что нового в MaxStat · Установка через AI-агента

Сервер работает на MaxStat. Здесь — плагины, skill, настройки подключения и документация. Исходный код сервера и базы данных закрыты.

Русский

Что нового

Мониторинг и уведомления. Отслеживайте каналы и ключевые фразы в публикациях и комментариях MAX. Получайте события в MAX, Telegram или на Webhook. Настройка — в личном кабинете.

Новости сервиса, API и MCP · Версии интеграции.

Возможности

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

Мониторинг и Webhook настраиваются в личном кабинете. Через MCP они недоступны. Как настроить мониторинг.

Размер индекса

Источник: MaxStat.

Быстрый старт

1. Создайте токен в личном кабинете MaxStat API.

2. Не публикуйте токен и не добавляйте его в Git.

3. Выберите платформу ниже.

4. Перезапустите клиент и проверьте, что доступны 15 инструментов MaxStat.

Установка по платформам

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. При ручной настройке можно также использовать Authorization: Bearer <API_TOKEN>.

Для прямой установки без плагина объедините 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

Добавьте marketplace в settings.json:

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

Откройте Extensions, найдите @agentPlugins, выберите MaxStat MCP и нажмите Install. Для прямого подключения скопируйте configs/vscode.json в .vscode/mcp.json. VS Code запросит токен в поле пароля.

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.

Gemini CLI

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

Расширение запросит токен и сохранит его как секретную настройку MAXSTAT_API_TOKEN. Инструкции для Gemini — в GEMINI.md.

Cursor

Перед запуском Cursor задайте MAXSTAT_API_TOKEN, затем нажмите кнопку выше. Альтернатива: объедините configs/cursor.json с ~/.cursor/mcp.json.

Cline

Задайте MAXSTAT_API_TOKEN до запуска Cline и передайте агенту llms-install.md. Он настроит подключение к https://maxstat.ru/api/mcp и проверит список инструментов.

Windsurf

Задайте MAXSTAT_API_TOKEN до запуска Windsurf и объедините configs/windsurf.json с ~/.codeium/windsurf/mcp_config.json. Токен подставляется из ${env:MAXSTAT_API_TOKEN}.

JetBrains AI Assistant

Откройте Settings → Tools → AI Assistant → Model Context Protocol (MCP), добавьте HTTP-конфигурацию из configs/jetbrains.json. Вставьте свой токен вместо <API_TOKEN> в настройках IDE.

Claude Desktop

Для Claude Desktop используйте локальный мост из configs/claude-desktop.json. Нужны Node.js и npm. Токен хранится в локальных настройках Claude Desktop. Облачному коннектору нужен OAuth 2.1, который MaxStat пока не поддерживает.

Универсальная конфигурация

Используйте configs/generic-mcp.json:

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

Инструменты MCP

Вызовы оплачиваются кредитами. Цены — в таблицах ниже.

Поиск и каталог

Аналитика каналов

Аналитика публикаций

Тариф и использование

Параметры и ограничения данных

• ID каналов и публикаций передаются строками, включая отрицательные ID. Не преобразуйте их в JavaScript Number: возможна потеря точности.

• В поиске limit — от 1 до 100, offset — от 0; offset + limit не больше 10 000. Для больших выборок уточняйте фильтры.

• search_channels сортирует по subscribers, posts, date или score. Для рейтинга по росту сначала получите кандидатов, затем запросите get_channel_subscribers за один период и отсортируйте их сами. Рейтинг охватывает только выбранные каналы.

• Даты date_from и date_to задаются как YYYY-MM-DD, обе границы включены. Истории каналов без дат используют последние 30 дней. Задавайте обе даты явно для сравнения; отсутствие снимков не означает нулевую аудиторию.

• get_post возвращает найденные пересылки при include_forwards=true. По умолчанию список не запрашивается. Пустой список не доказывает, что пересылок не было.

• search_posts поддерживает is_deleted: true — удалённые публикации, false — доступные, без параметра — обе группы. В карточке есть is_deleted, deleted_at и text_links; позиции ссылок — в единицах UTF-16.

• get_account_usage возвращает items, от новых к старым; limit — 1–100, offset — от 0. request_id связывает списание с запросом.

Ошибки и диагностика

REST API возвращает code, message, request_id и, если есть, details. MCP-клиент может оборачивать эту ошибку в результат вызова инструмента.

При обращении в поддержку передайте request_id, без API-токена. При Unknown tool обновите список инструментов в клиенте. Старые create_channel_subscription, create_keyword_subscription, get_subscriptions, get_subscription, update_subscription и delete_subscription удалены.

Мониторинг в личном кабинете

Настраивайте отслеживания в разделе «Мониторинг». Для активации нужен действующий платный тариф и свободное место: одно место входит в тариф, дополнительные покупаются в кабинете. Приостановленные мониторинги место не занимают.

Одно отслеживание — один канал или один ключевой запрос:

• Запрос содержит до 50 фраз и может искать по всему индексу MaxStat или по списку до 100 каналов. Запрос с таким фильтром занимает одно место.

• Для всех новых публикаций каждого из 50–100 каналов нужны 50–100 отдельных отслеживаний и столько же активных мест.

• Для каждого отслеживания действует лимит 1 000 событий в сутки по Москве.

События сохраняются в истории без Webhook. Для доставки добавьте получателя в разделе «Уведомления» и выберите его в мониторинге. Доступны личные чаты, группы и каналы MAX и Telegram, а также Webhook. Для Webhook нужен публичный HTTPS-адрес с действительным сертификатом. Один Webhook можно использовать в нескольких мониторингах. В одном мониторинге можно выбрать не больше одного получателя каждого типа. Лимиты доставки в мессенджеры на получателя: до 10 сообщений в минуту и 100 событий мониторинга в сутки по Москве.

Сервер Webhook должен ответить 2xx за 5 секунд. Перенаправлений и автоматических повторов доставки нет. Сохраняйте событие в очередь и обрабатывайте асинхронно, учитывая event_id для защиты от дублей. После 10 ошибок подряд без успеха за 24 часа Webhook отключается; успешная проверка кнопкой «Проверить» в «Уведомлениях» включает его снова.

Мониторинг собирает новые совпадения после создания или изменения условий. Старые публикации в историю не попадают. История хранится 90 дней. Состояние получателя, историю событий, лимиты и стоимость мест смотрите в кабинете.

Пример на реальных данных

Данные канала MAX • Анонсы на 29 июля 2026 года:

• канал MAX • Анонсы с аудиторией 3 496 789 подписчиков;

• рост с 3 054 001 до 3 496 789 с 30 июня по 29 июля: +442 788 / +14,5%;

• публикацию с 17 888 688 просмотрами и 187 460 реакциями;

• разбивку реакций, дневные истории просмотров и реакций;

• 184 найденных пересылки.

Примеры запросов

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

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

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

Объясни, как в личном кабинете настроить мониторинг фраз «искусственный
интеллект» в 80 выбранных каналах и подключить Webhook.

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

Тарифы и безопасность

MCP входит во все тарифы MaxStat API. MCP и API расходуют общий баланс кредитов. Тариф, остаток кредитов и срок действия смотрите в кабинете или через get_account_subscription и get_account_limits.

Никогда не публикуйте настоящий API-токен в issue, PR, конфигурации, логе или скриншоте. Об уязвимостях сообщайте по инструкции из SECURITY.md.

Related MCP server: telegram-public-mcp-cloudflare

English

What's new

Monitoring and notifications. Track channels and keyword matches in MAX posts and comments. Receive events in MAX, Telegram, or through a webhook. Configure them in the dashboard.

Service, API, and MCP news (Russian) · Integration versions.

Search MAX channels and posts, compare audience growth, views and reactions, and find forwards from your AI client.

As of November 8, 2026: 672,837 channels, 155,837,316 posts, 42 categories. Source: MaxStat.

Connection

Install

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

For VS Code, Cursor, Windsurf, JetBrains AI Assistant, Claude Desktop, and other clients, use configs/. Setup steps are in the Russian section above.

Capabilities

• Search and filter MAX channels and publications.

• Retrieve channel profiles, audience growth, views, reactions, activity, and content-format mix.

• Retrieve post text, attachments, metrics, reaction details, histories, and detected forwards.

• Add a MAX channel to the collection queue; this does not create monitoring.

• Inspect the active MaxStat plan, credit balance, and request-level usage.

See Инструменты MCP for all 15 tools, credit costs, limits, and errors. Channel and post IDs are strings; search pages contain 1–100 items and offset + limit cannot exceed 10,000. Use get_post with include_forwards=true to request detected forwards.

Monitoring and webhooks

Set up monitoring in the dashboard. MCP cannot manage it. The six old webhook-subscription tools have been removed; get_account_subscription returns your billing plan.

An active paid plan includes one monitoring slot; extra slots are purchased separately. Paused monitors do not occupy slots. One monitor tracks one channel or one keyword query of up to 50 phrases, optionally restricted to 100 channels. A query covering 80 channels takes one slot; collecting every new post from 80 channels takes 80 monitors and active slots. Each monitor records up to 1,000 events per Moscow calendar day; history is retained for 90 days.

Webhook delivery needs a public HTTPS endpoint. Add a recipient in Notifications and select it in the monitor. MAX and Telegram support private chats, groups, and channels. Messenger delivery is limited to 10 messages per minute and 100 monitoring events per Moscow calendar day per recipient. One webhook can serve several monitors, with at most one recipient of each type per monitor. Respond with 2xx within five seconds; redirects and automatic delivery retries are not supported. Deduplicate by event_id. A webhook is disabled after ten consecutive failures without a success for 24 hours; a successful dashboard check re-enables it. Historical events are not backfilled.

Cloud connectors

Use a client that can send the X-API-Token header. Hosted ChatGPT and Claude connectors need OAuth 2.1, which MaxStat does not yet support.

Ссылки / Links

• MaxStat MCP

• Получить API-токен / Get a token

• Документация API / API documentation

• Тарифы API / API plans

• ООО «ФБМ Аналитикс» / FBM Analytics

• MaxStat Insights в MAX

• FBM API Insights в Telegram

Лицензия / License

Лицензия MIT покрывает файлы этого репозитория: плагины, skill, конфигурации, документацию и проверки. Условия использования сервиса, API, данных и товарных знаков — отдельно. Подробности — в NOTICE.