mixpanel-automation

Rube MCP による Mixpanel の自動化

Rube MCP を介して Composio の Mixpanel ツールキットを利用し、Mixpanel のプロダクト分析を自動化します。

前提条件

• Rube MCP に接続されていること（RUBE_SEARCH_TOOLS が利用可能）
• RUBE_MANAGE_CONNECTIONS を通じた Mixpanel への有効な接続があること（ツールキットは mixpanel）
• 現在のツールスキーマを取得するため、必ず最初に 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 であることを確認します

データと変更の範囲

件数を比較する前に、対象のプロジェクト、データリージョン、レポートのタイムゾーン、ID／ユニークユーザーのルール、日付範囲を正確に確認してください。件数の上限、データの鮮度、利用できないディメンションを明示してください。セグメント別のユニーク件数は通常、合算できません。また、ファネルの相関関係は因果関係を証明するものではありません。クエリのリクエストは、プロファイルの更新を許可するものではありません。一括書き込みの前に、正確な一意の ID と操作内容をプレビューし、個人情報（PII）を保護してください。加算・追記更新を再試行する前に、結果を照合してください。検出された最新のスキーマは、この静的なリファレンスに優先します。

主なワークフロー

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	(なし)
イベントの集計	MIXPANEL_AGGREGATE_EVENT_COUNTS	event, from_date, to_date, unit
セグメンテーション	MIXPANEL_QUERY_SEGMENTATION	event, on, from_date, to_date
ファネルの一覧表示	MIXPANEL_LIST_FUNNELS	(なし)
ファネルのクエリ	MIXPANEL_QUERY_FUNNEL	funnel_id, from_date, to_date
プロファイルのクエリ	MIXPANEL_QUERY_PROFILES	where, output_properties, page
プロファイルの一括更新	MIXPANEL_PROFILE_BATCH_UPDATE	(プロファイル更新オブジェクト)
コホートの一覧表示	MIXPANEL_COHORTS_LIST	(なし)
JQL クエリ	MIXPANEL_JQL_QUERY	script
インサイトのクエリ	MIXPANEL_QUERY_INSIGHT	bookmark_id

使用する場合

このスキルは、概要で説明されているワークフローまたはアクションを実行する場合に適用されます。

制限事項

• タスクが上記のスコープに明確に一致する場合にのみ、このスキルを使用してください。
• 出力を環境固有の検証、テスト、専門家によるレビューの代わりとして扱わないでください。
• 必要な入力、権限、安全境界、または成功基準が欠けている場合は、停止して確認を求めてください。