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 の本番環境の数値です。インデックスは 継続的に増加しています。最新の結果を取得するには、search_channels、search_posts、get_categories を 使用してください。

クイックスタート

1. MaxStat API のダッシュボードでトークンを作成します。
2. トークンを公開したり、Git に追加したりしないでください。
3. 以下からプラットフォームを選択します。
4. クライアントを再起動し、MaxStat の 21 個のツールを利用できることを確認します。

パラメーター	値
エンドポイント	https://maxstat.ru/api/mcp
トランスポート	Streamable HTTP
認証	API トークン
ヘッダー	X-API-Token: <API_TOKEN>
環境変数	MAXSTAT_API_TOKEN

プラットフォーム別のインストール

プラットフォーム	方法
Codex / ChatGPT desktop	リポジトリマーケットプレイスとネイティブ Codex プラグイン
Claude Code	Claude 互換マーケットプレイス
VS Code	Agent Plugins マーケットプレイス、または .vscode/mcp.json を直接使用
GitHub Copilot CLI	共通の Claude/Copilot マーケットプレイス
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>"

マーケットプレイスを追加し、プラグインをインストールします。

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 にマーケットプレイスを追加します。

{
  "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 は、同じ互換プラグイン、 スキル、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 を渡してください。このファイルには、リモートの 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 ヘッダー内の環境変数置換を 文書化していないため、プレースホルダーは意図的に残しています。

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	ID で指定した単一チャンネルの詳細カード	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	1 件のサブスクリプション、配信状態、最新のエラー	無料
update_subscription	コールバック URL の変更、一時停止、または再開	無料
delete_subscription	Webhook サブスクリプションの削除	無料

Webhook は公開 HTTPS アドレスからアクセスできる必要があります。

プランと利用状況

ツール	返す内容	クレジット
get_account_subscription	プラン、ステータス、期間、クレジットの状態	無料
get_account_limits	含まれるクレジット、購入済み、使用済み、残りのクレジット	無料
get_account_usage	リクエストごとのクレジット消費履歴（ページ分割）	無料

実際のデータの例

2026 年 7 月 29 日に production へ検証リクエストを送信したところ、次の結果が返されました。

• チャンネル 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 の直接呼び出しでは、同じクレジット残高を使用します。Test Drive は最初の API リクエスト時に有効化され、30 日ごとに 1 000 クレジットが提供されます。

実際の API トークンを issue、PR、設定、ログ、スクリーンショットに決して公開しないでください。脆弱性はSECURITY.mdの手順に従って報告してください。

英語

MaxStat MCP は、AI エージェントがライブの MAX メッセンジャーチャンネルと投稿インデックスに構造化された形でアクセスできるようにします。チャンネルと投稿の検索、日次のオーディエンス数、閲覧数とリアクションの履歴、投稿アクティビティ、添付ファイルとリアクションの詳細、転送の検出、Webhook のモニタリング、アカウントのクレジット利用状況に対応しています。production インデックスは 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 トークンを取得
• API ドキュメント
• API プラン
• ООО «ФБМ Аналитикс» / FBM Analytics
• MAX の MaxStat Insights
• Telegram の FBM API Insights

Лицензия / License

MIT ライセンスが適用されるのは、このリポジトリで公開されているマニフェスト、 プラグイン、スキル、設定、ドキュメント、および補助チェックのみです。このライセンスは、 MaxStat サービス、API、データ、データベース、商標、およびサーバー実装には適用されません。 詳細は NOTICE をご覧ください。