mcpField
I
integration-setup

integration-setup

github.com/lyticsデータ・データベース450 回インストール3 週間前に更新
リポジトリ

integration-setup について

integration-setupは、Lyticsへのデータ取り込みや外部へのエクスポートを設定するスキルです。プロバイダーと認証情報の確認から接続・ジョブ設定までを案内し、承認後にリソースを順に作成します。

主な機能

  1. 01プラットフォーム、データ方向、種類の特定
  2. 02プロバイダーと既存認証情報の確認
  3. 03接続の選択・作成とジョブ設定
  4. 04リソース設定の提示と承認取得
  5. 05承認後の連携リソースの順次作成

活用シーン

  1. 01外部プラットフォームからLyticsへオーディエンスを取り込む
  2. 02Lyticsのセグメントを外部プラットフォームへエクスポートする
  3. 03広告プラットフォーム向けコンバージョンイベントのエクスポート設定

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/lytics/agent-skills --skill integration-setup

インストール後、Claude Code で/integration-setupを入力して読み込まれたか確認します。

詳細

インテグレーションのセットアップ

目的

認証情報の作成から、接続の設定、ジョブの作成まで、データインテグレーションを一通りセットアップできるようユーザーを支援します。インポート（Lyticsへのデータ流入）とエクスポート（外部プラットフォームへのデータ流出）の両方に対応します。

環境

認証済みのAPIアクセスが必要です。認証情報の解決については、../references/auth.mdを参照してください。

入力

  • 希望するインテグレーションの説明（プラットフォーム、方向、データ型）
  • 任意：認証情報、エクスポートするセグメント、スケジュールの希望

セットアップの流れ

ステップ 0：Integration Advisor の利用を検討する

ユーザーのリクエストにワークフローの選択、フィールドのマッピング、または新しいインテグレーションの一からのセットアップが含まれる場合は、integration-advisor skillから始めることを提案します。

"新しいインテグレーションでは、適切なワークフローの選択、フィールドのマッピング、最適な設定をお手伝いできます。まずは戦略的なガイダンスをご希望ですか？"

ユーザーから具体的で明確なセットアップの依頼（例：「ワークフロー X と認証 Y を使ってジョブを作成して」）がある場合は、そのまま進めます。

ステップ 1：インテグレーションの種類を特定する

ユーザーの説明を解析して、次の項目を特定します。

  • プラットフォーム：Facebook、Google、Salesforce、Klaviyo など
  • 方向：インポート（Lyticsへ）またはエクスポート（Lyticsから）
  • データ型：オーディエンス、イベント、プロファイル、コンバージョン
ステップ 2：利用可能なプロバイダーを確認する
curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/provider" \
  -H "Authorization: ${LYTICS_API_TOKEN}"

対象プラットフォームに一致するプロバイダーを見つけます。

ステップ 3：既存の認証を確認する
curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/auth" \
  -H "Authorization: ${LYTICS_API_TOKEN}"

対象プラットフォームの有効な認証がすでに存在するか確認します。

ステップ 4：認証を作成する（必要な場合）

connection-manager skillを使って認証情報を作成します。対象プラットフォームで必要な認証情報について、ユーザーに案内します。

ステップ 5：接続を作成または選択する
# Check existing connections
curl -s "${LYTICS_API_URL:-https://api.lytics.io}/v2/connection" \
  -H "Authorization: ${LYTICS_API_TOKEN}"

利用可能な既存の接続を使用するか、新しい接続を作成します。

ステップ 6：ジョブを設定する

job-manager skillを使って、次の内容を含むジョブを作成します。

  • インテグレーションの種類に合ったワークフロー
  • プラットフォーム固有の設定
  • 認証情報に紐づける認証 ID
  • セグメント ID（エクスポートの場合）
ステップ 7：確認ゲート

インテグレーションのセットアップ全体を提示します。

  • 認証プロバイダーの詳細（認証情報ではなく種類）
  • 接続設定
  • ジョブ設定（ワークフロー、スケジュール、セグメント）
  • 作成する各リソースの生のAPIペイロード
ステップ 8：承認後に実行する

次の順序でリソースを作成します。

  1. 認証（新規の場合）
  2. 接続（新規の場合）
  3. ジョブ

作成した各リソースへのリンクを添えて、成功を報告します。

よくあるインテグレーションのパターン

オーディエンスのエクスポート
  1. ユーザーがセグメントを選択または作成する
  2. segment_idを指定してエクスポートジョブを設定する
  3. スケジュール（継続、毎日など）を設定する
データのインポート
  1. データソースへの接続を設定する
  2. 接続をスキャンして、利用可能なデータを検出する
  3. フィールドマッピングを指定してインポートジョブを作成する
コンバージョン API（CAPI）
  1. 広告プラットフォームの認証を設定する
  2. コンバージョンのエクスポートジョブを作成する
  3. Lyticsのイベントをプラットフォームのコンバージョンイベントにマッピングする

エラー処理

  • 認証情報がない：対象プラットフォームで認証情報を確認できる場所をユーザーに案内します
  • 認証が無効：認証情報を作り直すよう提案します
  • ワークフローが見つからない：そのプラットフォームで利用可能なワークフローを一覧表示します
  • セグメントが見つからない：まずaudience-builderを使ってセグメントを作成できるよう支援します

依存関係

  • 組み合わせるもの：connection-manager skill、job-manager skill、../references/confirmation-gate.md
  • 参照先：../references/auth.md
  • 関連：audience-builder skill（エクスポートするセグメントの作成用）

コメント

Markdown 対応