mcpField
R
roistat-mcp

roistat-mcp

ローカル
github.com/theYahiaデータ・分析08 週間前に更新

roistat-mcp について

roistat-mcpは、Roistatのマーケティング分析データを照会するMCPサーバーです。リード、訪問、チャネル、費用、連携情報を扱います。リポジトリはアーカイブされ、開発はWWmcpに移行しました。

主な機能

  1. 01訪問、リード、売上の分析
  2. 02流入元とUTM付き訪問の表示
  3. 03ステータスによるリード絞り込み
  4. 04チャネルのROI、CPL、売上分析
  5. 05期間別の広告費集計
  6. 06接続済み連携の一覧

活用シーン

  1. 01期間を指定してチャネル別ROIを比較
  2. 02当日の訪問と流入元を確認
  3. 03ステータス別にリードを確認
  4. 04広告費と接続済み連携を確認

MCP 対応

MCPクライアントにRoistat API用の6つのツールを提供し、APIキーとプロジェクトIDが必要です。stdioとStreamable HTTPに対応し、開発はWWmcpに移行しています。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"theyahia-roistat": {
"command": "npx",
"args": [
"-y",
"@theyahia/roistat-mcp"
],
"env": {
"ROISTAT_API_KEY": "<ROISTAT_API_KEY>"
}
}
}
}
起動コマンドnpx -y @theyahia/roistat-mcp
設定が必要な環境変数
ROISTAT_API_KEYシークレットAPI key

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@theyahia/roistat-mcp1.0.1

ツール

2

掲載時のツール一覧 · 2 週間前に更新

パラメーター型必須説明
tostringはい期間の終了日(YYYY-MM-DD)
fromstringはい期間の開始日(YYYY-MM-DD)
limitnumberいいえ応答内の最大行数
metricsarrayいいえ指標:visitCount、leadCount、orderCount、revenue、visits2leads、visits2orders など。
dimensionsarrayいいえグループ化項目: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 が必要です。

npm License: MIT

インストール

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%

詳細:roistat.com/referral

開発

npm install
npm test          # Vitest
npm run dev       # stdio (tsx)
npm run start:http  # HTTP-сервер

ライセンス

MIT


Telegram: @vhodvai

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。