windsor-ai-business-data

Windsor.ai ビジネスデータスキル

ユーザーがビジネスデータを必要とする場合は、マーケティング分析、営業指標、CRM データ、E コマースの取引、財務データなど、Windsor.ai の 325 以上のコネクターから利用できるあらゆるデータに、このスキルを使用してください。

使用する場面

• ビジネスデータをあらゆるソースから取得する必要があるダッシュボード、レポート、データビジュアライゼーションを作成する場合
• 広告費、キャンペーンのパフォーマンス、ROAS、CTR、CPC、コンバージョン指標について質問された場合
• コードベースで CRM、営業、E コマース、財務データが必要な場合
• 利用可能なデータソースやフィールドを確認したい場合
• テスト、プロトタイピング、フィクスチャの生成などのために、実データを使ってプロジェクトの初期データを用意したい場合
• Windsor.ai がサポートするプラットフォームとのインテグレーションを構築する場合

利用可能なツール

Windsor.ai は 4 つの MCP ツールを提供します。

get_connectors

接続済みのプラットフォームとアカウント ID を一覧表示します。利用可能なアカウントがわからない場合は、必ず最初に呼び出してください。

get_options

特定のコネクターで利用できるフィールド、日付フィルター、オプションを返します。get_data を呼び出す前に、クエリ可能なデータを確認するために使用してください。

パラメーター：

• connector（必須）："google_ads"、"facebook"、"tiktok"、"linkedin"、"googleanalytics4"、"hubspot"、"salesforce"、"searchconsole"、"instagram"、"youtube"、"google_my_business"、"shopify"、"stripe"、"quickbooks"など、300 以上のプラットフォーム ID
• accounts（必須）：get_connectors で取得したアカウント ID のリスト

get_fields

特定のフィールドに関する詳細なメタデータ（データ型、説明、利用可能な値）を返します。データを処理するコードを書く前にスキーマを把握する必要がある場合に使用してください。

パラメーター：

• connector（必須）：プラットフォーム ID
• fields（必須）：["campaign", "spend", "clicks"]のようなフィールド ID のリスト

get_data

実際のデータを取得します。主なクエリツールです。

パラメーター：

• connector（必須）：プラットフォーム ID
• accounts（必須）：アカウント ID のリスト
• fields（必須）：取得するフィールド。例：["campaign", "date", "spend", "clicks", "impressions"]
• date_from / date_to："YYYY-MM-DD"形式の日付範囲
• date_preset："last_7d"、"last_30d"、"this_month"、"last_3m"のような簡易指定
• filters：[["spend", "gt", 100], "and", ["campaign", "contains", "Sale"]]のような条件
• options：{"attribution_window": "7d_view,1d_click"}のようなコネクター固有のオプション

ワークフローのパターン

1. 確認 → get_connectorsを呼び出し、何が接続されているか確認します
2. 調査 → get_optionsを呼び出し、コネクターで利用可能なフィールドを確認します
3. 把握 → 型付きインターフェースを構築する場合は、get_fieldsを呼び出してフィールドのメタデータを取得します
4. クエリ → get_dataを呼び出し、実際のデータを取得します

よく使われるフィールドのパターン

フィールドはコネクターの種類によって異なります。よくある例を以下に示します。

マーケティング／広告コネクター： campaign、adgroup、ad、date、device、country、spend、clicks、impressions、conversions、revenue、ctr、cpc、cpm、roas

CRM コネクター： deal、contact、company、stage、owner、amount、close_date

E コマースコネクター： order_id、product、quantity、price、customer、status

利用可能なフィールドはコネクターによって異なるため、必ず最初にget_optionsを確認してください。

ヒント

• ダッシュボードやチャートを作成する場合は、get_dataでデータを取得し、アプリから読み込めるローカルの JSON／CSV ファイルに書き込みます
• TypeScript プロジェクトでは、get_fieldsを使って正確な型定義を生成します
• 手早くクエリを実行するには、date_presetを使用します："last_7d"、"last_30d"、"this_month"
• フィルターを組み合わせて対象を絞ったクエリを実行します：[["spend", "gt", 0], "and", ["campaign", "ncontains", "test"]]
• 各コネクターからデータを取得してコード内で統合すれば、異なるコネクターのデータ（例：広告費と CRM の売上）を結合できます