mixpanel-automation

Rube MCP による Mixpanel の自動化

Rube MCP 経由で Composio の Mixpanel ツールキットを使用し、Mixpanel のプロダクト分析を自動化します。

ツールキットのドキュメント：composio.dev/toolkits/mixpanel

前提条件

• Rube MCP に接続済みである必要があります（RUBE_SEARCH_TOOLS が利用可能）
• ツールキット mixpanel のアクティブな Mixpanel 接続が RUBE_MANAGE_CONNECTIONS 経由で必要です
• 最新のツールスキーマを取得するため、必ず最初に RUBE_SEARCH_TOOLS を呼び出してください

セットアップ

Rube MCP を取得する：クライアントの設定で https://rube.app/mcp を MCP サーバーとして追加します。API キーは不要です。エンドポイントを追加するだけで動作します。

1. RUBE_SEARCH_TOOLS が応答することを確認し、Rube MCP が利用可能であることを確認します
2. ツールキット mixpanel を指定して RUBE_MANAGE_CONNECTIONS を呼び出します
3. 接続が ACTIVE でない場合は、返された認証リンクに従って Mixpanel の認証を完了します
4. ワークフローを実行する前に、接続ステータスが ACTIVE と表示されることを確認します

主なワークフロー

1. イベントデータを集計する

使用する場面：イベント数や合計を取得したい場合、またはイベントの経時的な傾向を追跡したい場合

ツールの順序：

1. MIXPANEL_GET_ALL_PROJECTS - プロジェクト ID を取得するため、プロジェクトを一覧表示します［前提条件］
2. MIXPANEL_AGGREGATE_EVENT_COUNTS - イベント数と集計値を取得します［必須］

主なパラメーター：

• event：集計するイベント名、またはイベント名の配列
• from_date / to_date：'YYYY-MM-DD' 形式の日付範囲
• unit：時間の粒度（'minute'、'hour'、'day'、'week'、'month'）
• type：集計タイプ（'general'、'unique'、'average'）
• where：イベントプロパティのフィルター式

注意点：

• 日付形式は 'YYYY-MM-DD' である必要があります。他の形式ではエラーになります
• イベント名は大文字と小文字が区別されます。Mixpanel プロジェクトで使用されている正確な名前を指定してください
• where フィルターには Mixpanel の式構文を使用します（例：properties["country"] == "US"）
• Mixpanel のプランによっては、日付範囲に上限がある場合があります

2. セグメンテーション クエリを実行する

使用する場面：詳細な分析のため、プロパティごとにイベントを分類したい場合

ツールの順序：

1. MIXPANEL_QUERY_SEGMENTATION - セグメンテーション分析を実行します［必須］

主なパラメーター：

• event：セグメント化するイベント名
• from_date / to_date：'YYYY-MM-DD' 形式の日付範囲
• on：セグメント化に使用するプロパティ（例：properties["country"]）
• unit：時間の粒度
• type：カウントタイプ（'general'、'unique'、'average'）
• where：フィルター式
• limit：返すセグメントの最大数

注意点：

• on パラメーターには Mixpanel のプロパティ式構文を使用します
• プロパティ参照は properties["prop_name"] 形式で指定する必要があります
• カーディナリティの高いプロパティでセグメンテーションを行うと、結果が上限で制限されます。limit を使用してください
• 結果は、セグメンテーションに使用したプロパティと時間単位でグループ化されます

3. ファネルを分析する

使用する場面：コンバージョンファネルを追跡し、離脱ポイントを特定したい場合

ツールの順序：

1. MIXPANEL_LIST_FUNNELS - ファネル ID を特定するため、保存済みファネルを一覧表示します［前提条件］
2. MIXPANEL_QUERY_FUNNEL - ファネル分析を実行します［必須］

主なパラメーター：

• funnel_id：クエリ対象の保存済みファネルの ID
• from_date / to_date：日付範囲
• unit：時間の粒度
• where：フィルター式
• on：ファネルのセグメント化に使用するプロパティ
• length：日数で指定するコンバージョン期間

注意点：

• funnel_id は必須です。事前に LIST_FUNNELS で特定してください
• ファネルは事前に Mixpanel UI で作成する必要があります。API でクエリできるのは既存のファネルのみです
• コンバージョン期間（length）のデフォルト値は状況によって異なるため、正確な結果を得るには明示的に設定してください
• セグメンテーションを含む大きな日付範囲を指定すると、応答が非常に大きくなることがあります

4. ユーザープロフィールを管理する

使用する場面：Mixpanel のユーザープロフィールを検索または更新したい場合

ツールの実行順序：

1. MIXPANEL_QUERY_PROFILES - ユーザープロフィールを検索して絞り込みます［必須］
2. MIXPANEL_PROFILE_BATCH_UPDATE - 複数のユーザープロフィールを更新します［任意］

主なパラメーター：

• where：プロフィールのプロパティに対するフィルター式（例：properties["plan"] == "premium"）
• output_properties：結果に含めるプロパティ名の配列
• page：ページネーションのページ番号
• session_id：一貫したページネーションのためのセッション ID（最初のレスポンスから取得）
• 一括更新の場合：$distinct_id とプロパティ操作を含むプロフィール更新の配列

注意点：

• プロフィールの検索結果はページ分割されます。一貫したページネーションには、最初のレスポンスの session_id を使用してください
• where では、プロフィールのプロパティに Mixpanel の式構文を使用します
• BATCH_UPDATE はプロフィールに操作（$set、$unset、$add、$append）を適用します
• 一括更新にはリクエストごとのプロフィール数の上限があります。上限を超える更新は分割してください
• プロフィールのプロパティ名では大文字と小文字が区別されます

5. コホートを管理する

使用する場面：ユーザーコホートを一覧表示または分析したい場合

ツールの実行順序：

1. MIXPANEL_COHORTS_LIST - 保存済みのコホートをすべて一覧表示します［必須］

主なパラメーター：

• 必須パラメーターはありません。アクセス可能なコホートがすべて返されます
• レスポンスにはコホートの id、name、description、count が含まれます

注意点：

• コホートは Mixpanel の UI で作成、管理します。API では読み取りのみ可能です
• コホート ID は数値です。一覧表示の結果にある ID をそのまま使用してください
• 非常に大きなコホートでは、コホート数が概算になることがあります
• コホートは where 式を使用して、他のクエリのフィルターとして利用できます

6. JQL とインサイトのクエリを実行する

使用する場面：カスタム JQL クエリまたはインサイト分析を実行したい場合

ツールの実行順序：

1. MIXPANEL_JQL_QUERY - カスタム JQL（JavaScript Query Language）クエリを実行します［任意］
2. MIXPANEL_QUERY_INSIGHT - 保存済みのインサイトクエリを実行します［任意］

主なパラメーター：

• JQL の場合：JQL の JavaScript コードを含む script
• インサイトの場合：保存済みインサイトの bookmark_id
• project_id：クエリのプロジェクトコンテキスト

注意点：

• JQL では、Mixpanel 固有の JavaScript に似た構文を使用します
• JQL クエリには実行時間の制限があります。効率的に実行できるよう最適化してください
• インサイトの bookmark_id は、既存の保存済みインサイトを参照している必要があります
• JQL はレガシー機能です。現在の利用可否については Mixpanel のドキュメントを確認してください

よく使われるパターン

ID の解決

プロジェクト名 -> プロジェクト ID：

1. Call MIXPANEL_GET_ALL_PROJECTS
2. Find project by name in results
3. Extract project id

ファネル名 -> ファネル ID：

1. Call MIXPANEL_LIST_FUNNELS
2. Find funnel by name
3. Extract funnel_id

Mixpanel の式構文

where および on パラメーターで使用します：

• プロパティ参照：properties["property_name"]
• 等価：properties["country"] == "US"
• 比較：properties["age"] > 25
• ブール値：properties["is_premium"] == true
• 含有：「search_term」が properties["name"] に含まれる
• AND/OR：properties["country"] == "US" and properties["plan"] == "pro"

ページネーション

• イベントクエリ：日付範囲を調整して、日付ベースのページネーションを行います
• プロフィールのクエリ：一貫した結果を得るには、page 番号と session_id を使用します
• ファネルとコホートの一覧：通常、ページネーションなしで完全な結果が返されます

既知の注意点

日付形式：

• 常に「YYYY-MM-DD」形式を使用します
• 日付範囲の両端は含まれます
• データの鮮度は、Mixpanel の取り込み遅延（通常は数分）に左右されます

式の構文：

• プロパティの参照には常に properties["name"] 形式を使用します
• 文字列値は引用符で囲む必要があります：properties["status"] == "active"
• 数値は引用符で囲みません：properties["count"] > 10
• ブール値は true / false（小文字）です

レート制限：

• Mixpanel API にはプロジェクトごとのレート制限があります
• 大規模なセグメンテーションクエリはタイムアウトする場合があります。日付範囲を短くするか、セグメント数を減らしてください
• API 呼び出しを最小限に抑えるため、利用可能な場合はバッチ操作を使用します

レスポンスの解析：

• レスポンスデータは data キーの下にネストされている場合があります
• イベントデータは通常、日付とセグメントごとにグループ化されています
• 数値が文字列として返される場合があります。明示的に解析してください
• 空の日付範囲では、空の配列ではなく空のオブジェクトが返されます

クイックリファレンス

タスク	ツールスラッグ	主なパラメーター
プロジェクトの一覧表示	MIXPANEL_GET_ALL_PROJECTS	(none)
イベントの集計	MIXPANEL_AGGREGATE_EVENT_COUNTS	event, from_date, to_date, unit
セグメンテーション	MIXPANEL_QUERY_SEGMENTATION	event, on, from_date, to_date
ファネルの一覧表示	MIXPANEL_LIST_FUNNELS	(none)
ファネルのクエリ	MIXPANEL_QUERY_FUNNEL	funnel_id, from_date, to_date
プロファイルのクエリ	MIXPANEL_QUERY_PROFILES	where, output_properties, page
プロファイルの一括更新	MIXPANEL_PROFILE_BATCH_UPDATE	(profile update objects)
コホートの一覧表示	MIXPANEL_COHORTS_LIST	(none)
JQL クエリ	MIXPANEL_JQL_QUERY	script
インサイトのクエリ	MIXPANEL_QUERY_INSIGHT	bookmark_id

---

Composio 提供