roistat-mcp について
roistat-mcpは、Roistatのマーケティング分析データを照会するMCPサーバーです。リード、訪問、チャネル、費用、連携情報を扱います。リポジトリはアーカイブされ、開発はWWmcpに移行しました。
主な機能
- 01訪問、リード、売上の分析
- 02流入元とUTM付き訪問の表示
- 03ステータスによるリード絞り込み
- 04チャネルのROI、CPL、売上分析
- 05期間別の広告費集計
- 06接続済み連携の一覧
活用シーン
- 01期間を指定してチャネル別ROIを比較
- 02当日の訪問と流入元を確認
- 03ステータス別にリードを確認
- 04広告費と接続済み連携を確認
MCP 対応
MCPクライアントにRoistat API用の6つのツールを提供し、APIキーとプロジェクトIDが必要です。stdioとStreamable HTTPに対応し、開発はWWmcpに移行しています。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
2掲載時のツール一覧 · 2 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| to | string | はい | 期間の終了日(YYYY-MM-DD) |
| from | string | はい | 期間の開始日(YYYY-MM-DD) |
| limit | number | いいえ | 応答内の最大行数 |
| metrics | array | いいえ | 指標:visitCount、leadCount、orderCount、revenue、visits2leads、visits2orders など。 |
| dimensions | array | いいえ | グループ化項目:marker(ソース)、landing_page、region、keyword など。 |
詳細
🗄 リポジトリはアーカイブ済みです
開発は theYahia/WWmcp に移行しました。CIS、MENA、アフリカ、LATAM、東南アジアなど、非西洋圏の API 向け MCP サーバーのモノレポジトリです。共通コア
@theyahia/mcp-core、統一された CI、統一されたリリースパイプラインを備えています。ここにあったものの最新版はこちらです:
servers/roistat/npm パッケージは従来どおりです —
@theyahia/roistat-mcp。これまでどおりインストールして使用できます。 このリポジトリは今後更新されません。課題やプルリクエストは WWmcp にお寄せください。アーカイブ済み — 開発は theYahia/WWmcp に移行しました。 非西洋圏の API 向け MCP サーバーのモノレポジトリです。 このパッケージの最新版は
servers/roistat/にあります。 npm パッケージ@theyahia/roistat-mcpに変更はありません。 課題やプルリクエストはそちらにお寄せください。
Roistat MCP — AI との対話で実現するアトリビューション分析とリード単価
各チャネルからのリード単価を AI に尋ねたり、広告費と売上を突き合わせたり、手動でレポートを作成せずに Roistat のリードをエクスポートしたりする方法をお探しなら、これがその答えです。Roistat API を利用する 6 つのツールで、リード、広告チャネル、費用、分析、連携を扱えます。API キーとプロジェクト ID が必要です。
インストール
Claude Desktop
{
"mcpServers": {
"roistat": {
"command": "npx",
"args": ["-y", "@theyahia/roistat-mcp"],
"env": {
"ROISTAT_API_KEY": "ваш_ключ",
"ROISTAT_PROJECT_ID": "ваш_id_проекта"
}
}
}
}
Claude Code
claude mcp add roistat \
-e ROISTAT_API_KEY=ваш_ключ \
-e ROISTAT_PROJECT_ID=ваш_id_проекта \
-- npx -y @theyahia/roistat-mcp
Streamable HTTP
npx @theyahia/roistat-mcp --http --port 3000
# POST /mcp — MCP endpoint
# GET /health — health check
Smithery
設定は smithery.yaml にあります。必須パラメーター:ROISTAT_API_KEY、ROISTAT_PROJECT_ID。
認証
| 変数 | 必須 | 説明 |
|---|---|---|
ROISTAT_API_KEY | はい | Roistat プロジェクトの API キー |
ROISTAT_PROJECT_ID | はい | Roistat のプロジェクト ID |
ベース URL:https://cloud.roistat.com/api/v1/
ツール(6)
| ツール | 説明 |
|---|---|
get_analytics | 分析:流入、問い合わせ、売上、流入元別の ROI |
get_visits | 流入元と UTM タグを含む流入一覧 |
get_leads | ステータスで絞り込めるリード(問い合わせ) |
get_channels | 広告チャネルの効果:ROI、CPL、売上 |
get_costs | 期間別に集計した広告費 |
get_integrations | 接続済み連携(CRM、分析)の一覧 |
スキル(プロンプト)
| スキル | 説明 |
|---|---|
skill-analytics | 期間別分析 — 主要指標と上位 3 件の流入元の概要 |
skill-channels | 広告チャネルの効果 — ROI の比較と予算に関する推奨事項 |
リクエスト例
Какой ROI у рекламных каналов за последний месяц?
Покажи визиты за сегодня
Сколько лидов пришло за неделю?
Какие интеграции подключены?
Сравни затраты по каналам за март
Roistat 紹介プログラム
| 種類 | 手数料 |
|---|---|
| 法人 | 顧客の支払い額の 25% |
| 個人事業主 | 顧客の支払い額の 50% |
開発
npm install
npm test # Vitest
npm run dev # stdio (tsx)
npm run start:http # HTTP-сервер
ライセンス
MIT
Telegram: @vhodvai
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。