MCP 対応ツール一覧

Amethyst MCP ツールでできることを確認しましょう。

Amethyst MCP は、AI クライアントが Model Context Protocol 経由で呼び出せるツールを公開しています。これらのツールを使うと、分析データの取得、プロジェクトやワークスペースの管理、Index Worker の設定を、自然言語のプロンプトからすべて行えます。

ツールは連携して動作します。1 つのプロンプトで、ワークスペースの一覧取得 → プロジェクトの選択 → 集計データの取得 → ビューの作成まで進められます。

以下のセクションは機能領域ごとに整理されています。読み取りツール（繰り返し安全に呼び出せるもの）と変更ツール（確認が必要なもの）を、各ドメインでまとめて確認できます。

ワークスペースとプロジェクト

`list_workspaces`

現在のユーザーが利用可能なワークスペースの一覧を取得します。

ワークスペースに紐づくツールを呼び出す前に、利用可能なワークスペースを確認したいときに使います。

パラメータ: なし

プロンプト例:

「アクセスできる Amethyst のワークスペースを一覧表示して」
「自分のワークスペースを教えて」

`list_projects`

ワークスペース内のプロジェクト一覧を取得します。

プロジェクトスコープのツールを呼び出す前に、プロジェクト ID や名前を確認したいときに使います。

パラメータ	型	必須	説明
`workspaceId`	string	はい	対象ワークスペース ID。

プロンプト例:

「このワークスペースのプロジェクトをすべて表示して」
「Search Analytics のプロジェクトはある？」

`list_bigquery`

ワークスペースの BigQuery 設定一覧を取得します。Search Analytics と User Analytics の両方を含みます。

パラメータ	型	必須	説明
`organizationId`	string	はい	対象ワークスペース ID。
`only`	`"sa"` \| `"ua"`	いいえ	SA または UA のみに絞り込み。省略時は両方を返します。

プロンプト例:

「このワークスペースに設定されている BigQuery データセットを表示して」

`create_search_analytics_bigquery`

ワークスペースに Search Analytics 用の BigQuery テーブル設定を登録します。

パラメータ	型	必須	説明
`projectID`	string	条件付き	Google Cloud の BigQuery プロジェクト ID。`manageType` が `SELF` の場合は必須。
`datasetName`	string	条件付き	BigQuery データセット名。`manageType` が `SELF` の場合は必須。
`manageType`	`"SELF"` \| `"JADE"`	いいえ	デフォルト `SELF`。GCP プロジェクト/データセットを指定する場合は `SELF` を使用。
`organizationId`	string	条件付き	ワークスペース ID。`projectId` 未指定時は必須。
`projectId`	string	条件付き	Search Analytics プロジェクト ID（組織を自動解決）。

プロンプト例:

「BigQuery データセットを Search Analytics に接続して」
「GCP プロジェクト my-gcp-project のデータセット search_data を SA に登録して」

`create_user_analytics_bigquery`

ワークスペースに User Analytics 用の BigQuery テーブル設定を登録します。

パラメータ	型	必須	説明
`projectID`	string	はい	Google Cloud の BigQuery プロジェクト ID。
`datasetName`	string	はい	BigQuery データセット名。
`organizationId`	string	条件付き	ワークスペース ID。`projectId` 未指定時は必須。
`projectId`	string	条件付き	User Analytics プロジェクト ID（組織を自動解決）。

プロンプト例:

「BigQuery データセットを User Analytics に接続して」
「GCP プロジェクト my-gcp-project のデータセット ua_events を UA に登録して」

`create_project`

新しいプロジェクト（Index Worker、Search Analytics、User Analytics）を作成します。

パラメータ	型	必須	説明
`organizationId`	string	はい	ワークスペース ID。
`name`	string	はい	プロジェクト名。
`kind`	string	はい	`INDEX_WORKER`、`SEARCH_ANALYTICS`、`USER_ANALYTICS` のいずれか。
`color`	string	いいえ	カラーコード `#RRGGBB`（例: `#4F46E5`）。
`description`	string	いいえ	プロジェクトの説明。
`bigQueryId`	string	条件付き	BigQuery 設定 ID。SA・UA プロジェクトでは必須。
`keyEvents`	string[]	いいえ	UA のみ: トラッキングするキーイベント。デフォルト: `["purchase"]`。

プロンプト例:

「‘Blog’ という名前で新しい Search Analytics プロジェクトを作って」
「サイトマップ監視用の Index Worker プロジェクトを追加して」

`edit_project`

プロジェクトの名前変更、カラー変更、説明の更新を行います。name、color、description のいずれか 1 つ以上が必要です。

パラメータ	型	必須	説明
`projectId`	string	はい	更新対象のプロジェクト ID。
`name`	string	いいえ	新しいプロジェクト名。
`color`	string	いいえ	新しいカラーコード（`#RRGGBB` 形式）。
`description`	string	いいえ	新しい説明。
`organizationId`	string	いいえ	結果パス構築用のワークスペース ID。

プロンプト例:

「このプロジェクトの名前を ‘Main Site’ に変更して」
「プロジェクトの色を青に変えて」

`duplicate_project`

既存のプロジェクトを複製します。

パラメータ	型	必須	説明
`projectId`	string	はい	コピー元のプロジェクト ID。
`organizationId`	string	いいえ	URL パス構築用のワークスペース ID。

プロンプト例:

「このプロジェクトのコピーを作って」

`delete_project`

プロジェクト全体を削除します。ユーザーがプロジェクトの削除を明示的にリクエストした場合のみ使用します。

パラメータ	型	必須	説明
`projectId`	string	はい	削除するプロジェクト ID。

プロンプト例:

「‘Old Site’ プロジェクトを削除して」

ダッシュボード

`list_dashboards`

ワークスペースのダッシュボード一覧を取得します。

ダッシュボードの存在確認や選択に使います。

パラメータ	型	必須	説明
`organizationId`	string	はい	ワークスペース ID。

プロンプト例:

「ダッシュボードを表示して」
「このワークスペースにあるダッシュボードは？」

`create_dashboard`

ワークスペースに新しいダッシュボードを作成します。

パラメータ	型	必須	説明
`organizationId`	string	はい	ワークスペース ID。
`name`	string	はい	ダッシュボード名。

プロンプト例:

「‘Weekly Overview’ というダッシュボードを作って」

`edit_dashboard`

ダッシュボードの名前や説明を更新します。name または description のいずれか 1 つ以上が必要です。

パラメータ	型	必須	説明
`dashboardId`	string	はい	ダッシュボード ID。
`name`	string	いいえ	新しいダッシュボード名。
`description`	string	いいえ	新しい説明。
`organizationId`	string	いいえ	ナビゲーションリンク用のワークスペース ID。

プロンプト例:

「このダッシュボードの名前を ‘Monthly Report’ に変更して」

`delete_dashboard`

ワークスペースのダッシュボードを削除します。この操作は元に戻せません。

パラメータ	型	必須	説明
`dashboardId`	string	はい	削除するダッシュボード ID。

プロンプト例:

「‘Test Dashboard’ を削除して」

`create_dashboard_item`

既存のダッシュボードにメトリクスカードを追加します。

パラメータ	型	必須	説明
`dashboardId`	string	はい	ダッシュボード ID。
`type`	string	はい	アイテムの種類: `IW_CRAWL`, `IW_INDEX`, `IW_NOT_INDEX`, `SA_CLICK`, `SA_IMP`, `SA_CTR`, `SA_RANK`, `SA_UNIQ_QUERY`, `SA_UNIQ_URL`, `UA_SESSION_COUNT`, `UA_UNIQUE_USER_COUNT`, `UA_CONVERSION_RATE`, `UA_SURF_RATE`, `UA_ENGAGEMENT_RATE`, `UA_CONVERSION_COUNT`, `UA_PAGE_VIEW_EVENT_COUNT`。
`featureId`	string	はい	フィーチャー ID（base64 エンコード）。IndexWorker、SearchAnalytics、UserAnalytics、またはビュー ID を受け付けます。

プロンプト例:

「このダッシュボードにクリック数のカードを追加して」
「Index Worker のクロール数メトリクスをダッシュボードに追加して」

`edit_dashboard_item`

ダッシュボードアイテムのタイトル、説明、リンク先の変更を行います。name、description、featureId のいずれか 1 つ以上が必要です。

パラメータ	型	必須	説明
`id`	string	はい	ダッシュボードアイテム ID。
`name`	string	いいえ	新しいアイテム名。
`description`	string	いいえ	新しい説明。
`featureId`	string	いいえ	新しいフィーチャー / ビュー / ジョブ ID。

プロンプト例:

「このカードの名前を ‘Weekly Clicks’ に変更して」

`delete_dashboard_item`

ダッシュボードからカードやウィジェットを削除します。

パラメータ	型	必須	説明
`dashboardId`	string	はい	アイテムが含まれるダッシュボード ID。
`dashboardItemId`	string	はい	削除するダッシュボードアイテム ID。

プロンプト例:

「このメトリクスをダッシュボードから削除して」

Index Worker

`list_index_workers`

特定の Index Worker プロジェクトに属するすべての Index Worker を取得します。

パラメータ	型	必須	説明
`projectId`	string	はい	Index Worker プロジェクト ID。

プロンプト例:

「プロジェクト X の Index Worker をすべて表示して」
「このプロジェクトの IW ジョブを一覧表示して」

`get_indexing_job_details`

特定の Index Worker の最近のジョブを取得します。タスクごとのクロール/インデックスステータスと Google カバレッジ結果を含みます。

パラメータ	型	必須	説明
`indexWorkerId`	string	はい	Index Worker ID。
`jobId`	string	いいえ	特定のジョブ ID。指定時はそのジョブのみ返します。
`jobsLimit`	number	いいえ	取得するジョブの最大数（1–50）。デフォルト: 5。
`tasksLimit`	number	いいえ	ジョブごとの最大タスク数（1–2000）。デフォルト: 50。
`crawledOnly`	boolean	いいえ	クロール済みタスクのみに絞り込み。
`indexedOnly`	boolean	いいえ	インデックス済みタスクのみに絞り込み。
`notIndexedOnly`	boolean	いいえ	未インデックスタスクのみに絞り込み。

プロンプト例:

「この Index Worker の最新のジョブ結果を見せて」
「最後のクロールでインデックスエラーはあった？」

`get_index_worker_export_data`

Index Worker のエクスポートパラメータを準備し、トレンドデータまたは URL データを CSV、Excel、JSON としてダウンロードできるようにします。

パラメータ	型	必須	説明
`indexWorkerId`	string	はい	Index Worker ID（GraphQL グローバル ID）。
`exportTarget`	string	はい	`trends`（チャートデータ）または `urls`（URL テーブル）。
`format`	string	はい	`csv`、`excel`、`json`。`exportTarget` が `trends` の場合は `csv` のみ。
`dateRange`	object	いいえ	`{ start?, end }` ISO-8601 UTC 形式。`start` のデフォルトは 2000-01-01。
`isComparing`	boolean	いいえ	比較エクスポートの場合は `true`。
`comparingDateRange`	object	いいえ	比較範囲。比較モードを有効にします。

プロンプト例:

「この Index Worker のトレンド CSV をエクスポートして」
「URL テーブルを Excel でダウンロードして」

`create_index_worker`

GUI フォームに対応するフィールドを持つ Index Worker を作成します。URL ソース、スケジュール、フィルターなどを設定できます。

パラメータ	型	必須	説明
`organizationId`	string	はい	ワークスペース ID。
`name`	string	はい	Index Worker 名。
`urlType`	string	はい	`SITEMAP`、`RSS`、`MANUAL` のいずれか。
`projectId`	string	いいえ	Index Worker プロジェクト ID（判明している場合に推奨）。
`projectName`	string	いいえ	プロジェクト名（ワークスペース内で解決されます）。
`note`	string	いいえ	メモ / 説明。
`propertyId`	string	いいえ	Search Console プロパティ ID。実行に必要です。
`samplingCount`	number	いいえ	サンプルサイズ（1–2000）。デフォルト: 500。
`schedule`	object	いいえ	スケジュール: `{ type }` で type は `run-once`、`not-set`、`daily`、`weekly`、`custom`。デフォルト: `not-set`。
`sitemap`	string	条件付き	サイトマップ URL。`urlType` が `SITEMAP` のとき必須。
`rssFeed`	string	条件付き	RSS フィード URL。`urlType` が `RSS` のとき必須。
`rssFeedSamplingPeriod`	number	条件付き	RSS サンプリング期間: `0`（全件）、`1`、`3`、`7`、`28`、`365`。`urlType` が `RSS` のとき必須。
`urls`	string \| string[]	条件付き	手動 URL。`urlType` が `MANUAL` のとき必須。
`urlGroup`	object	いいえ	`{ op, patterns[] }` — `AND`/`OR` 演算子による URL グループフィルター。
`ignoreURLParameters`	string \| string[]	いいえ	無視する URL パラメータ。

プロンプト例:

「example.com のサイトマップを使った新しい Index Worker を作って」
「RSS フィード用のデイリー Index Worker を設定して」

`edit_index_worker`

Index Worker の名前、メモ、サンプルサイズ、スケジュールなどの設定を更新します。

パラメータ	型	必須	説明
`organizationId`	string	はい	ワークスペース ID。
`indexWorkerId`	string	いいえ	対象の Index Worker ID（推奨）。
`indexWorkerName`	string	いいえ	対象の Index Worker 名。
`projectId`	string	いいえ	Index Worker プロジェクト ID。
`projectName`	string	いいえ	プロジェクト名。
`name`	string	いいえ	新しい Index Worker 名。
`note`	string	いいえ	新しいメモ。
`propertyId`	string	いいえ	Search Console プロパティ ID。
`urlType`	string	いいえ	`SITEMAP`、`RSS`、`MANUAL`。
`samplingCount`	number	いいえ	新しいサンプルサイズ（1–2000）。
`schedule`	object	いいえ	スケジュール更新。一時停止には `not-set` を使用。
`sitemap`	string	条件付き	サイトマップ URL（`urlType` が `SITEMAP` のとき必須）。
`rssFeed`	string	条件付き	RSS フィード URL（`urlType` が `RSS` のとき必須）。
`rssFeedSamplingPeriod`	number	条件付き	RSS サンプリング期間（`urlType` が `RSS` のとき必須）。
`urls`	string \| string[]	条件付き	手動 URL（`urlType` が `MANUAL` のとき必須）。
`urlGroup`	object \| null	いいえ	URL グループフィルター。`null` でクリア。
`ignoreURLParameters`	string \| string[]	いいえ	無視する URL パラメータ。

プロンプト例:

「この Index Worker のスケジュールを一時停止して」
「サンプルサイズを 1000 に変更して」

`duplicate_index_worker`

既存の Index Worker を複製します。

パラメータ	型	必須	説明
`indexWorkerId`	string	はい	コピー元の Index Worker ID。
`currentProjectId`	string	条件付き	現在のプロジェクト ID（`currentProjectId` / `targetProjectId` のいずれか必須）。
`targetProjectId`	string	条件付き	コピー先プロジェクト ID。
`organizationId`	string	いいえ	ワークスペース ID ヒント。

プロンプト例:

「この Index Worker を別のプロジェクトに複製して」

`delete_index_worker`

Index Worker ジョブを削除します。「IW を削除」などの曖昧な表現のデフォルトアクションです。

パラメータ	型	必須	説明
`indexWorkerId`	string	はい	削除する Index Worker ID。

プロンプト例:

「この Index Worker を削除して」

`move_index_worker_project`

Index Worker ジョブを別のプロジェクトに移動します。

パラメータ	型	必須	説明
`indexWorkerId`	string	はい	Index Worker ID。
`targetProjectId`	string	はい	移動先プロジェクト ID。

プロンプト例:

「この Index Worker を ‘Main Site’ プロジェクトに移動して」

`rerun_index_worker_job`

Index Worker の 1 回限りの再実行をトリガーします。

パラメータ	型	必須	説明
`indexWorkerId`	string	はい	Index Worker ID。
`projectId`	string	いいえ	キャッシュ再検証用のプロジェクト ID。

プロンプト例:

「この Index Worker を今すぐ再実行して」

Search Console とサービスアカウント

`list_service_accounts`

ワークスペースに登録されたすべてのサービスアカウントを一覧表示します。

パラメータ	型	必須	説明
`organizationId`	string	はい	対象ワークスペース ID。

プロンプト例:

「登録されているサービスアカウントは？」

`add_search_console_property`

Google Search Console プロパティをワークスペースに登録し、Index Worker で使用できるようにします。

パラメータ	型	必須	説明
`workspaceId`	string	いいえ	ワークスペース ID。
`property`	string	いいえ	Search Console プロパティ文字列（例: `https://example.com/` や `sc-domain:example.com`）。
`type`	string	いいえ	`USER` または `SERVICE_ACCOUNT`。
`serviceAccountId`	string	条件付き	`SERVICE_ACCOUNT` 登録時に必須。

プロンプト例:

「Search Console プロパティを追加して」
「sc-domain:example.com を登録して」

`delete_search_console_property`

登録済みの Search Console プロパティをワークスペースから削除します。

パラメータ	型	必須	説明
`workspaceId`	string	いいえ	ワークスペース ID。
`propertyId`	string	いいえ	登録解除するプロパティ ID。

プロンプト例:

「example.com の Search Console プロパティを削除して」

`delete_service_account`

ワークスペースからサービスアカウントの登録を解除します。serviceAccountId または organizationId と serviceAccountEmail の両方を指定します。

パラメータ	型	必須	説明
`serviceAccountId`	string	条件付き	サービスアカウント ID。
`serviceAccountEmail`	string	条件付き	サービスアカウントのメールアドレス。
`organizationId`	string	条件付き	ワークスペース ID。`serviceAccountEmail` 使用時に必須。

プロンプト例:

「Index Worker のサービスアカウントを削除して」

Search Analytics

`list_search_analytics_views`

プロジェクトの保存済み Search Analytics ビュー一覧を取得します。各ビューのフィルター条件やデフォルト期間も含みます。

パラメータ	型	必須	説明
`projectId`	string	はい	Search Analytics プロジェクト ID。

プロンプト例:

「この Search Analytics プロジェクトのビューを見せて」

`list_query_groups`

Search Analytics プロジェクトの Query Group を一覧表示します。

パラメータ	型	必須	説明
`projectId`	string	はい	対象プロジェクト ID。

プロンプト例:

「このプロジェクトの Query Group をすべて表示して」

`get_search_analytics_aggregated_data`

プロジェクトまたは保存済みビューの日次集計 Search Analytics データを取得します。

メトリクスにはクリック数、インプレッション数、CTR、平均掲載順位、ユニーククエリ数、ユニーク URL 数が含まれます。

パラメータ	型	必須	説明
`projectId`	string	`projectId` / `viewId` のいずれか	SA プロジェクト ID。
`viewId`	string	`projectId` / `viewId` のいずれか	SA ビュー ID。
`movingAverage`	string	はい	移動平均の窓: `none`、`7d`、`28d`、`both`。
`dateRange`	object	いいえ	`{ start, end }` ISO-8601 形式。
`comparingDateRange`	object	いいえ	比較期間（ISO-8601）。比較モードを有効にします。
`isComparing`	boolean	いいえ	比較データを取得する場合は `true`。デフォルト: `false`。
`limit`	number	いいえ	行数の上限（1–1000）。
`groupBy`	string	いいえ	`QUERY_GROUP` または `URL_GROUP`。
`timeGroupBy`	string	いいえ	`DATE`、`WEEK`、`MONTH`、`AUTO`。
`metrics`	string[]	いいえ	取得するメトリクス: `CLICKS`、`IMPRESSIONS`、`CTR`、`AVERAGE_OF_RANK`、`DISTINCT_QUERIES`、`DISTINCT_URLS`。

フィルターパラメータ

パラメータ	型	必須	説明
`query`	string	いいえ	クエリフィルター値。
`queryFilterType`	FilterEnum	いいえ	クエリフィルター演算子。
`queryGroupIDs`	string[]	いいえ	Query Group ID の配列。
`url`	string	いいえ	URL フィルター値。
`urlFilterType`	FilterEnum	いいえ	URL フィルター演算子。
`urlGroupIDs`	string[]	いいえ	URL Group ID の配列。
`devices`	string[]	いいえ	デバイスフィルター。
`countries`	string[]	いいえ	国フィルター。
`searchTypes`	string[]	いいえ	`WEB`、`IMAGE`、`VIDEO`、`NEWS`、`DISCOVER`、`GOOGLE_NEWS`。デフォルト: `["WEB"]`。
`rawKinds`	string[]	いいえ	検索結果の表示形式。
`isAnonymousQuery`	boolean	いいえ	匿名クエリのフィルター。

FilterEnum の値: CONTAINS、NOT_CONTAINS、EQUALS、STARTS_WITH、ENDS_WITH、REGEX、NOT_REGEX、INCLUDE

プロンプト例:

「過去 28 日間の検索パフォーマンスを見せて」
「今月と先月のクリック数を比較して」
「URL Group ごとの Search Analytics トレンドを表示して」

`get_search_analytics_raw_data`

クエリごと / URL ごとのブレイクダウンを含む Search Analytics の生データ行を取得します。

正確な数値や変化の詳細な理由が必要なときに使います。集計データからの推測は行わないでください。

パラメータ	型	必須	説明
`projectId`	string	はい	Search Analytics プロジェクト ID。
`dateRange`	object	いいえ	`{ start, end }` ISO-8601 UTC 形式。
`comparingDateRange`	object	いいえ	比較期間。比較モードを有効にします。
`isComparing`	boolean	いいえ	比較行を取得する場合は `true`。
`limit`	number	いいえ	ページサイズ（1–500）。デフォルト: 100。
`after`	string	いいえ	ページネーションカーソル。
`orderBy`	object	いいえ	`{ field, direction }`。フィールド: `CLICKS`、`IMPRESSIONS`、`CTR`、`AVERAGE_OF_RANK`、`DISTINCT_URLS`、`DISTINCT_QUERIES`、`DATE`、`WEEK`、`MONTH`。
`comparingOrderBy`	object	いいえ	比較行のソート。`*_DIFFERENCE` フィールドを含みます。
`groupBy`	string[]	いいえ	`QUERY`、`QUERY_GROUP`、`URL`、`URL_GROUP`、`DATE`、`WEEK`、`MONTH`、`SEARCH_TYPE`、`DEVICE`、`COUNTRY`、`IS_ANONYMIZED_QUERY`、`IS_ANONYMIZED_DISCOVER`。
`metrics`	string[]	いいえ	出力行に含めるメトリクス。
`includeEdges`	boolean	いいえ	生の GraphQL connection edges を含める。

フィルター・範囲パラメータ

パラメータ	型	必須	説明
`query`	string	いいえ	クエリフィルター値。
`queryFilterType`	FilterEnum	いいえ	クエリフィルター演算子。
`queryGroupIDs`	string[]	いいえ	Query Group ID の配列。
`url`	string	いいえ	URL フィルター値。
`urlFilterType`	FilterEnum	いいえ	URL フィルター演算子。
`urlGroupIDs`	string[]	いいえ	URL Group ID の配列。
`devices`	string[]	いいえ	デバイスフィルター。
`countries`	string[]	いいえ	国フィルター。
`searchTypes`	string[]	いいえ	デフォルト: `["WEB"]`。
`rawKinds`	string[]	いいえ	検索結果の表示形式。
`isAnonymousQuery`	boolean	いいえ	匿名クエリフィルター。
`clicksRange`	IntRange	いいえ	`{ min?, max? }` クリック数フィルター。
`impressionsRange`	IntRange	いいえ	`{ min?, max? }` インプレッション数フィルター。
`ctrRange`	FloatRange	いいえ	`{ min?, max? }` CTR フィルター。
`avgOfRankRange`	FloatRange	いいえ	`{ min?, max? }` 平均掲載順位フィルター。
`distinctQueriesRange`	IntRange	いいえ	`{ min?, max? }` ユニーククエリ数フィルター。
`distinctURLsRange`	IntRange	いいえ	`{ min?, max? }` ユニーク URL 数フィルター。

プロンプト例:

「先週最もインプレッションが多かったクエリは？」
「このプロジェクトのクリック数トップ 20 の URL を見せて」

`create_search_analytics_view`

指定したフィルターと条件で保存済み Search Analytics ビューを作成します。

パラメータ	型	必須	説明
`projectId`	string	条件付き	SA プロジェクト ID（`projectId` / `searchAnalyticsId` のいずれか必須）。
`searchAnalyticsId`	string	条件付き	Search Analytics ID。
`name`	string	はい	ビュー名。
`description`	string	いいえ	ビューの説明。
`dataDate`	object	いいえ	`{ type, dateRange? }`。タイプ: `LATEST`、`DAYS_7`、`DAYS_28`、`DAYS_90`、`DAYS_180`、`DAYS_365`、`DAYS_480`、`CUSTOM`。
`rawDataGroupBy`	string[]	いいえ	RawData のグルーピング。デフォルト: `["QUERY", "QUERY_GROUP", "URL", "URL_GROUP"]`。

フィルターパラメータ

パラメータ	型	必須	説明
`query`	string	いいえ	クエリフィルター。
`queryFilterType`	FilterEnum	いいえ	クエリフィルター演算子。
`queryGroupIDs`	string[]	いいえ	Query Group ID の配列。
`url`	string	いいえ	URL フィルター。
`urlFilterType`	FilterEnum	いいえ	URL フィルター演算子。
`urlGroupIDs`	string[]	いいえ	URL Group ID の配列。
`devices`	string[]	いいえ	`DESKTOP`、`MOBILE`、`TABLET`。
`countries`	string[]	いいえ	国フィルター。
`searchTypes`	string[]	いいえ	デフォルト: `["WEB"]`。
`rawKinds`	string[]	いいえ	検索結果の表示形式。
`isAnonymousQuery`	boolean	いいえ	匿名クエリフィルター。

プロンプト例:

「現在のフィルターを ‘Mobile Only’ という Search Analytics ビューとして保存して」

`update_search_analytics_view`

保存済み Search Analytics ビューの名前、フィルター、日付範囲を編集します。

パラメータ	型	必須	説明
`id`	string	はい	Search Analytics ビュー ID。
`name`	string	いいえ	新しい名前。
`description`	string	いいえ	新しい説明。
`dataDate`	object	いいえ	`{ type, dateRange? }`。
`rawDataOrderBy`	object	いいえ	`{ field, direction }`。
`rawDataGroupBy`	string[]	いいえ	RawData のグルーピング。

フィルターパラメータ（null でクリア可能）

パラメータ	型	必須	説明
`query`	string \| null	いいえ	クエリフィルター。`null` でクリア。
`queryFilterType`	FilterEnum \| null	いいえ	クエリフィルター演算子。
`queryGroupIDs`	string[] \| null	いいえ	Query Group ID の配列。
`url`	string \| null	いいえ	URL フィルター。
`urlFilterType`	FilterEnum \| null	いいえ	URL フィルター演算子。
`urlGroupIDs`	string[] \| null	いいえ	URL Group ID の配列。
`devices`	string[] \| null	いいえ	デバイスフィルター。
`countries`	string[] \| null	いいえ	国フィルター。
`searchTypes`	string[] \| null	いいえ	検索タイプ。
`rawKinds`	string[] \| null	いいえ	検索結果の表示形式。
`isAnonymousQuery`	boolean \| null	いいえ	匿名クエリフィルター。

プロンプト例:

「このビューの名前を ‘Desktop Traffic’ に変更して」
「このビューの日付範囲を更新して」

`delete_search_analytics_view`

保存済み Search Analytics ビューを削除します。

パラメータ	型	必須	説明
`id`	string	はい	削除するビュー ID。

プロンプト例:

「このビューを削除して」

`create_search_analytics_query_group`

Search Analytics プロジェクト配下に Query Group を作成します。

パラメータ	型	必須	説明
`projectId`	string	条件付き	SA プロジェクト ID（`projectId` / `searchAnalyticsId` のいずれか必須）。
`searchAnalyticsId`	string	条件付き	Search Analytics ID。
`name`	string	はい	グループ名。
`op`	string	はい	`AND` または `OR`。
`patterns`	object[]	はい	`[{ type, pattern }]`。タイプ: `INCLUDES`、`NOT_INCLUDES`、`CONTAINS`、`NOT_CONTAINS`、`STARTS_WITH`、`ENDS_WITH`、`EQUALS`、`REGEX`、`NOT_REGEX`。
`description`	string	いいえ	グループの説明。
`prepend`	boolean	いいえ	リストの先頭に挿入。

プロンプト例:

「ブランドキーワード用の Query Group を作って」

`update_query_group`

既存の Query Group の名前、説明、演算子、パターンを更新します。少なくとも 1 つのフィールドが必要です。

パラメータ	型	必須	説明
`id`	string	はい	Query Group ID。
`name`	string	いいえ	新しい名前。
`description`	string \| null	いいえ	新しい説明。
`op`	string	いいえ	`AND` または `OR`。
`patterns`	object[]	いいえ	`[{ type, pattern }]`。

プロンプト例:

「‘Brand’ Query Group に新しいパターンを追加して」

`update_query_group_order`

Search Analytics の Query Group の表示順を更新します。

パラメータ	型	必須	説明
`projectId`	string	はい	SearchAnalyticsProject ID。
`ids`	string[]	はい	Query Group ID の順序付きリスト。

`create_search_analytics_url_group`

Search Analytics プロジェクト配下に URL Group を作成します。

パラメータ	型	必須	説明
`projectId`	string	条件付き	SA プロジェクト ID（`projectId` / `searchAnalyticsId` のいずれか必須）。
`searchAnalyticsId`	string	条件付き	Search Analytics ID。
`name`	string	はい	グループ名。
`op`	string	はい	`AND` または `OR`。
`patterns`	object[]	はい	`[{ type, pattern }]`。タイプ: `CONTAINS`、`NOT_CONTAINS`、`STARTS_WITH`、`ENDS_WITH`、`EQUALS`、`REGEX`、`NOT_REGEX`、`SUB_DOMAIN`、`DEPTH1`、`DEPTH2`、`DEPTH3`、`INCLUDES`、`NOT_INCLUDES`。
`description`	string	いいえ	グループの説明。
`prepend`	boolean	いいえ	リストの先頭に挿入。

プロンプト例:

「/blog/ 配下の全ページ用に URL Group を作って」

`update_search_analytics_url_group`

既存の Search Analytics URL Group の名前、説明、演算子、パターンを更新します。少なくとも 1 つのフィールドが必要です。

パラメータ	型	必須	説明
`id`	string	はい	URL Group ID。
`name`	string	いいえ	新しい名前。
`description`	string \| null	いいえ	新しい説明。
`op`	string	いいえ	`AND` または `OR`。
`patterns`	object[]	いいえ	`[{ type, pattern }]`。

プロンプト例:

「‘News’ URL Group に新しいパターンを追加して」

`delete_search_analytics_query_group`

Search Analytics の Query Group を削除します。

パラメータ	型	必須	説明
`queryGroupId`	string	はい	削除する Query Group ID。
`searchAnalyticsId`	string	いいえ	親の Search Analytics ID。
`projectId`	string	いいえ	プロジェクト ID。
`name`	string	いいえ	確認用の表示名。

プロンプト例:

「‘Temp’ Query Group を削除して」

`delete_search_analytics_url_group`

Search Analytics の URL Group を削除します。

パラメータ	型	必須	説明
`urlGroupId`	string	はい	削除する URL Group ID。
`searchAnalyticsId`	string	いいえ	親の Search Analytics ID。
`projectId`	string	いいえ	プロジェクト ID。
`name`	string	いいえ	確認用の表示名。

プロンプト例:

「‘Old Blog’ URL Group を削除して」

`update_search_analytics_daily_export_setting`

Search Analytics の日次エクスポートに使用する Google スプレッドシートを更新します。

パラメータ	型	必須	説明
`spreadsheetId`	string	はい	Google Sheets URL のスプレッドシート ID。
`viewId`	string	条件付き	SA ビュー ID。`viewId`、`searchAnalyticsId`、`projectId` のいずれかを指定。
`searchAnalyticsId`	string	条件付き	Search Analytics ID（デフォルトビュー）。
`projectId`	string	条件付き	SA プロジェクト ID（SA ID に解決されます）。

プロンプト例:

「このビューの日次エクスポート先スプレッドシートを設定して」

User Analytics

`list_user_analytics_views`

プロジェクトの保存済み User Analytics ビュー一覧を取得します。各ビューのフィルター条件も含みます。

パラメータ	型	必須	説明
`projectId`	string	はい	User Analytics プロジェクト ID。

プロンプト例:

「この User Analytics プロジェクトのビューを見せて」

`list_sessions`

User Analytics プロジェクトの GA4 セッションをフィルター付きで一覧表示します。

集計メトリクスではなく、具体的なセッション行が必要なときに使います。

パラメータ	型	必須	説明
`projectId`	string	はい	User Analytics プロジェクト ID。
`dateRange`	object	いいえ	`{ start, end }` ISO-8601 形式。
`limit`	number	いいえ	取得するセッション数（1–50）。デフォルト: 10。
`offset`	number	いいえ	ページネーションオフセット。デフォルト: 0。

フィルターパラメータ

パラメータ	型	必須	説明
`firstPageLocation`	string	いいえ	最初のページ URL フィルター値。
`firstPageLocationFilterType`	FilterEnum	いいえ	最初のページ URL のフィルター演算子。
`firstPageLocationUrlGroupIds`	string[]	いいえ	最初のページの URL Group ID。
`firstPageTitle`	string	いいえ	最初のページタイトルフィルター値。
`firstPageTitleFilterType`	FilterEnum	いいえ	最初のページタイトルのフィルター演算子。
`secondPageLocation`	string	いいえ	2 ページ目の URL フィルター値。
`secondPageLocationFilterType`	FilterEnum	いいえ	2 ページ目の URL のフィルター演算子。
`secondPageLocationUrlGroupIds`	string[]	いいえ	2 ページ目の URL Group ID。
`secondPageTitle`	string	いいえ	2 ページ目のタイトルフィルター値。
`secondPageTitleFilterType`	FilterEnum	いいえ	2 ページ目のタイトルのフィルター演算子。
`visitedPage`	string	いいえ	訪問ページフィルター値。
`visitedPageFilterType`	FilterEnum	いいえ	訪問ページのフィルター演算子。
`os`	string[]	いいえ	OS フィルター: `ANDROID`、`IOS`、`WINDOWS`、`MACOS`、`LINUX`、`CHROME_OS`、`OTHER`。
`devices`	string[]	いいえ	デバイスフィルター: `MOBILE`、`TABLET`、`DESKTOP`、`SMART_TV`、`OTHER`。
`browsers`	string[]	いいえ	ブラウザフィルター: `CHROME`、`FIREFOX`、`SAFARI`、`EDGE` など。
`sources`	string[]	いいえ	流入元フィルター。
`mediums`	string[]	いいえ	メディアフィルター。
`campaigns`	string[]	いいえ	キャンペーンフィルター。
`campaignsFilterType`	FilterEnum[]	いいえ	キャンペーンごとのフィルター演算子（`campaigns` と同じ長さ）。
`events`	string[]	いいえ	含めるイベント。
`eventsNotIn`	string[]	いいえ	除外するイベント。
`expVariantString`	string[]	いいえ	実験バリアント文字列。
`defaultChannelGroup`	string[]	いいえ	デフォルトチャネルグループ。
`isSessionWithNavigation`	boolean	いいえ	ナビゲーションセッションでフィルター。
`pageLocationCount`	IntRange	いいえ	`{ min?, max? }` ページ閲覧数の範囲。
`gaSessionNumber`	IntRange	いいえ	`{ min?, max? }` GA セッション番号の範囲。

FilterEnum の値: CONTAINS、NOT_CONTAINS、STARTS_WITH、ENDS_WITH、EQUALS、REGEX、NOT_REGEX

プロンプト例:

「モバイルデバイスでフィルターした最近のセッションを見せて」
「過去 7 日間の purchase イベントを含むセッションを表示して」

`get_user_analytics_aggregated_data`

プロジェクトまたは保存済みビューの日次集計 User Analytics データ（セッション数、コンバージョン、エンゲージメント、回遊率など）を返します。

パラメータ	型	必須	説明
`projectId`	string	はい	User Analytics プロジェクト ID。
`dateRange`	object	はい	`{ start, end }` ISO-8601 形式。
`movingAverage`	string	はい	移動平均の窓: `none`、`7d`、`28d`、`both`。
`viewId`	string	いいえ	保存済みフィルターを再利用する UA ビュー ID。
`comparingDateRange`	object	いいえ	比較期間。比較モードを有効にします。
`isComparing`	boolean	いいえ	比較データを取得する場合は `true`。デフォルト: `false`。
`groupBy`	string	いいえ	`FIRST_PAGE_LOCATION_URL_GROUP`、`SECOND_PAGE_LOCATION_URL_GROUP`、`FIRST_PAGE_TITLE`、`SECOND_PAGE_TITLE`、`SOURCE_MEDIUM`、`CAMPAIGN`、`DEFAULT_CHANNEL_GROUP`、`EXP_VARIANT_STRING`。
`timeGroupBy`	string	いいえ	`DATE`、`WEEK`、`MONTH`、`AUTO`。
`metrics`	string[]	いいえ	`SESSION_COUNT`、`UNIQUE_USER_COUNT`、`CONVERSION_RATE`、`CONVERSION_COUNT`、`SURF_RATE`、`SURF_COUNT`、`ENGAGEMENT_RATE`、`ENGAGEMENT_COUNT`、`PAGE_VIEW_EVENT_COUNT`。

フィルターパラメータ

パラメータ	型	必須	説明
`firstPageLocation`	string	いいえ	最初のページ URL フィルター。
`firstPageLocationFilterType`	FilterEnum	いいえ	最初のページ URL のフィルター演算子。
`firstPageLocationURLGroupIDs`	string[]	いいえ	最初のページの URL Group ID。
`secondPageLocation`	string	いいえ	2 ページ目の URL フィルター。
`secondPageLocationFilterType`	FilterEnum	いいえ	2 ページ目の URL のフィルター演算子。
`secondPageLocationURLGroupIDs`	string[]	いいえ	2 ページ目の URL Group ID。
`firstPageTitle`	string	いいえ	最初のページタイトルフィルター。
`firstPageTitleFilterType`	FilterEnum	いいえ	最初のページタイトルのフィルター演算子。
`secondPageTitle`	string	いいえ	2 ページ目のタイトルフィルター。
`secondPageTitleFilterType`	FilterEnum	いいえ	2 ページ目のタイトルのフィルター演算子。
`os`	string[]	いいえ	OS フィルター。
`devices`	string[]	いいえ	デバイスフィルター。
`browsers`	string[]	いいえ	ブラウザフィルター。
`sources`	string[]	いいえ	流入元フィルター。
`mediums`	string[]	いいえ	メディアフィルター。
`campaigns`	string[]	いいえ	キャンペーンフィルター。
`campaignsFilterType`	FilterEnum[]	いいえ	キャンペーンごとのフィルター演算子。
`events`	string[]	いいえ	含めるイベント。
`eventsNotIn`	string[]	いいえ	除外するイベント。
`expVariantString`	string[]	いいえ	実験バリアント文字列。
`defaultChannelGroup`	string[]	いいえ	デフォルトチャネルグループ。
`isSessionWithNavigation`	boolean	いいえ	ナビゲーションセッションでフィルター。
`pageLocationCount`	IntRange	いいえ	`{ min?, max? }` 範囲。
`gaSessionNumber`	IntRange	いいえ	`{ min?, max? }` 範囲。
`visitedPage`	string	いいえ	訪問ページフィルター。
`visitedPageFilterType`	FilterEnum	いいえ	訪問ページのフィルター演算子。

プロンプト例:

「過去 28 日間の UA セッショントレンドを見せて」
「今月と先月のコンバージョン率を比較して」

`get_user_analytics_raw_data`

User Analytics のセッションパフォーマンス生データ行を取得します。

正確なコンバージョン/購入数やその増減理由を知りたいときに使います。

パラメータ	型	必須	説明
`projectId`	string	はい	User Analytics プロジェクト ID。
`dateRange`	object	いいえ	`{ start, end }` ISO-8601 UTC 形式。
`comparingDateRange`	object	いいえ	比較期間。比較モードを有効にします。
`isComparing`	boolean	いいえ	比較行を取得する場合は `true`。
`groupBy`	string[]	いいえ	グルーピング次元: `DATE`、`WEEK`、`MONTH`、`DEFAULT_CHANNEL_GROUP`、`SOURCE_MEDIUM`、`CAMPAIGN`、`FIRST_PAGE_LOCATION`、`FIRST_PAGE_LOCATION_URL_GROUP`、`FIRST_PAGE_TITLE`、`SECOND_PAGE_LOCATION`、`SECOND_PAGE_LOCATION_URL_GROUP`、`SECOND_PAGE_TITLE`、`DEVICE`、`OS`、`BROWSER`、`EXP_VARIANT_STRING`。
`orderBy`	object	いいえ	`{ field, direction }`。フィールド: `DATE`、`WEEK`、`MONTH`、`SESSION_COUNT`、`UNIQUE_USER_COUNT`、`FIRST_SESSION_RATE`、`CONVERSION_RATE`、`CONVERSION_COUNT`、`SURF_RATE`、`AVG_SESSION_DURATION`、`ENGAGEMENT_RATE`、`ENGAGEMENT_COUNT`、`AVG_PAGE_LOCATION_COUNT`、`PAGE_VIEW_EVENT_COUNT`。
`limit`	number	いいえ	行数の上限（1–500）。デフォルト: 100。
`offset`	number	いいえ	ページネーションオフセット。デフォルト: 0。
`metrics`	string[]	いいえ	出力行に含めるメトリクス。

フィルターパラメータ

パラメータ	型	必須	説明
`firstPageLocation`	string	いいえ	最初のページ URL フィルター。
`firstPageLocationFilterType`	FilterEnum	いいえ	フィルター演算子。
`firstPageLocationUrlGroupIds`	string[]	いいえ	最初のページの URL Group ID。
`firstPageTitle`	string	いいえ	最初のページタイトルフィルター。
`firstPageTitleFilterType`	FilterEnum	いいえ	フィルター演算子。
`secondPageLocation`	string	いいえ	2 ページ目の URL フィルター。
`secondPageLocationFilterType`	FilterEnum	いいえ	フィルター演算子。
`secondPageLocationUrlGroupIds`	string[]	いいえ	2 ページ目の URL Group ID。
`secondPageTitle`	string	いいえ	2 ページ目のタイトルフィルター。
`secondPageTitleFilterType`	FilterEnum	いいえ	フィルター演算子。
`visitedPage`	string	いいえ	訪問ページフィルター。
`visitedPageFilterType`	FilterEnum	いいえ	フィルター演算子。
`os`	string[]	いいえ	OS フィルター。
`devices`	string[]	いいえ	デバイスフィルター。
`browsers`	string[]	いいえ	ブラウザフィルター。
`sources`	string[]	いいえ	流入元フィルター。
`mediums`	string[]	いいえ	メディアフィルター。
`campaigns`	string[]	いいえ	キャンペーンフィルター。
`campaignsFilterType`	FilterEnum[]	いいえ	キャンペーンごとのフィルター演算子。
`events`	string[]	いいえ	含めるイベント。
`eventsNotIn`	string[]	いいえ	除外するイベント。
`expVariantString`	string[]	いいえ	実験バリアント文字列。
`defaultChannelGroup`	string[]	いいえ	デフォルトチャネルグループ。
`isSessionWithNavigation`	boolean	いいえ	ナビゲーションセッションでフィルター。
`pageLocationCount`	IntRange	いいえ	`{ min?, max? }` 範囲。
`gaSessionNumber`	IntRange	いいえ	`{ min?, max? }` 範囲。

プロンプト例:

「過去 7 日間のチャネル別セッションを見せて」
「先月と比べて購入数が変わった理由は？」

`get_user_analytics_key_events`

User Analytics プロジェクトに設定されているキーイベント（コンバージョン）を取得します。

パラメータ	型	必須	説明
`projectId`	string	はい	User Analytics プロジェクト ID。

プロンプト例:

「この UA プロジェクトに設定されているキーイベントは？」

`get_session_detail`

User Analytics の特定ユーザーとセッションの GA4 セッション詳細を取得します。

パラメータ	型	必須	説明
`projectId`	string	はい	プロジェクト ID。
`gaSessionId`	number	はい	GA4 セッション ID。
`userPseudoId`	string	はい	ユーザー擬似 ID（ユーザー ID）。

プロンプト例:

「このセッションの詳細を見せて」

`create_user_analytics_view`

指定したフィルターと条件で保存済み User Analytics ビューを作成します。

パラメータ	型	必須	説明
`projectId`	string	条件付き	UA プロジェクト ID（`projectId` / `userAnalyticsId` のいずれか必須）。
`userAnalyticsId`	string	条件付き	User Analytics ID。
`name`	string	はい	ビュー名。
`detailGroupBy`	string[]	はい	詳細テーブルのグルーピング次元。
`detailOrderBy`	object	はい	`{ field, direction }`。
`description`	string	いいえ	ビューの説明。
`defaultDateRange`	object	いいえ	`{ type, dateRange? }`。タイプ: `LATEST`、`DAYS_7`、`DAYS_28`、`DAYS_90`、`DAYS_180`、`DAYS_365`、`DAYS_480`、`CUSTOM`、`MONTHS_3`、`MONTHS_6`、`MONTHS_12`、`MONTHS_16`。

フィルターパラメータ

パラメータ	型	必須	説明
`visitedPage`	string	いいえ	訪問ページフィルター。
`visitedPageFilterType`	FilterEnum	いいえ	フィルター演算子。
`firstPageLocationURLGroupIDs`	string[]	いいえ	最初のページの URL Group ID。
`firstPageLocationURL`	string	いいえ	最初のページ URL フィルター。
`firstPageLocationFilterType`	FilterEnum	いいえ	フィルター演算子。
`firstPageTitle`	string	いいえ	最初のページタイトルフィルター。
`firstPageTitleFilterType`	FilterEnum	いいえ	フィルター演算子。
`secondPageLocationURLGroupIDs`	string[]	いいえ	2 ページ目の URL Group ID。
`secondPageLocationURL`	string	いいえ	2 ページ目の URL フィルター。
`secondPageLocationFilterType`	FilterEnum	いいえ	フィルター演算子。
`secondPageTitle`	string	いいえ	2 ページ目のタイトルフィルター。
`secondPageTitleFilterType`	FilterEnum	いいえ	フィルター演算子。
`devices`	string[]	いいえ	`MOBILE`、`TABLET`、`DESKTOP`、`SMART_TV`、`OTHER`。
`os`	string[]	いいえ	`ANDROID`、`IOS`、`WINDOWS`、`MACOS`、`LINUX`、`CHROME_OS`、`OTHER`。
`browsers`	string[]	いいえ	`CHROME`、`FIREFOX`、`SAFARI`、`EDGE` など。
`sources`	string[]	いいえ	流入元フィルター。
`mediums`	string[]	いいえ	メディアフィルター。
`countries`	string[]	いいえ	国フィルター。
`regions`	string[]	いいえ	地域フィルター。
`cities`	string[]	いいえ	都市フィルター。
`campaigns`	string[]	いいえ	キャンペーンフィルター。
`campaignsFilterType`	FilterEnum[]	いいえ	キャンペーンごとのフィルター演算子。
`defaultChannelGroup`	string[]	いいえ	デフォルトチャネルグループ。
`events`	string[]	いいえ	含めるイベント。
`eventsNotIn`	string[]	いいえ	除外するイベント。
`expVariantString`	string[]	いいえ	実験バリアント文字列。
`isSessionWithNavigation`	boolean	いいえ	ナビゲーションセッションでフィルター。
`pageLocationCount`	IntRange	いいえ	`{ min?, max? }` 範囲。
`gaSessionNumber`	IntRange	いいえ	`{ min?, max? }` 範囲。

プロンプト例:

「これらのフィルターを ‘Organic Sessions’ という UA ビューとして保存して」

`update_user_analytics_view`

保存済み User Analytics ビューの名前、フィルター、日付範囲を編集します。

パラメータ	型	必須	説明
`id`	string	はい	User Analytics ビュー ID。
`name`	string	いいえ	新しい名前。
`description`	string	いいえ	新しい説明。
`defaultDateRange`	object	いいえ	`{ type, dateRange? }`。
`detailGroupBy`	string[]	いいえ	グルーピング次元。
`detailOrderBy`	object	いいえ	`{ field, direction }`。

フィルターパラメータ（null でクリア可能）

パラメータ	型	必須	説明
`visitedPage`	string \| null	いいえ	訪問ページフィルター。
`visitedPageFilterType`	FilterEnum \| null	いいえ	フィルター演算子。
`firstPageLocationURLGroupIDs`	string[] \| null	いいえ	最初のページの URL Group ID。
`firstPageLocationURL`	string \| null	いいえ	最初のページ URL フィルター。
`firstPageLocationFilterType`	FilterEnum \| null	いいえ	フィルター演算子。
`firstPageTitle`	string \| null	いいえ	最初のページタイトルフィルター。
`firstPageTitleFilterType`	FilterEnum \| null	いいえ	フィルター演算子。
`secondPageLocationURLGroupIDs`	string[] \| null	いいえ	2 ページ目の URL Group ID。
`secondPageLocationURL`	string \| null	いいえ	2 ページ目の URL フィルター。
`secondPageLocationFilterType`	FilterEnum \| null	いいえ	フィルター演算子。
`secondPageTitle`	string \| null	いいえ	2 ページ目のタイトルフィルター。
`secondPageTitleFilterType`	FilterEnum \| null	いいえ	フィルター演算子。
`devices`	string[] \| null	いいえ	デバイスフィルター。
`os`	string[] \| null	いいえ	OS フィルター。
`browsers`	string[] \| null	いいえ	ブラウザフィルター。
`sources`	string[] \| null	いいえ	流入元フィルター。
`mediums`	string[] \| null	いいえ	メディアフィルター。
`countries`	string[] \| null	いいえ	国フィルター。
`regions`	string[] \| null	いいえ	地域フィルター。
`cities`	string[] \| null	いいえ	都市フィルター。
`campaigns`	string[] \| null	いいえ	キャンペーンフィルター。
`campaignsFilterType`	FilterEnum[] \| null	いいえ	キャンペーンごとのフィルター演算子。
`defaultChannelGroup`	string[] \| null	いいえ	デフォルトチャネルグループ。
`events`	string[] \| null	いいえ	含めるイベント。
`eventsNotIn`	string[] \| null	いいえ	除外するイベント。
`expVariantString`	string[] \| null	いいえ	実験バリアント文字列。
`isSessionWithNavigation`	boolean \| null	いいえ	ナビゲーションセッションでフィルター。
`pageLocationCount`	IntRange \| null	いいえ	ページ閲覧数の範囲。
`gaSessionNumber`	IntRange \| null	いいえ	GA セッション番号の範囲。

プロンプト例:

「このビューにデバイスフィルターを追加して」

`delete_user_analytics_view`

保存済み User Analytics ビューを削除します。

パラメータ	型	必須	説明
`id`	string	はい	削除するビュー ID。

プロンプト例:

「この UA ビューを削除して」

`create_user_analytics_url_group`

User Analytics プロジェクト配下に URL Group を作成します。

パラメータ	型	必須	説明
`projectId`	string	条件付き	UA プロジェクト ID（`projectId` / `userAnalyticsId` のいずれか必須）。
`userAnalyticsId`	string	条件付き	User Analytics ID。
`name`	string	はい	グループ名。
`op`	string	はい	`AND` または `OR`。
`patterns`	object[]	はい	`[{ type, pattern }]`。
`description`	string	いいえ	グループの説明。
`prepend`	boolean	いいえ	リストの先頭に挿入。

プロンプト例:

「/products/ ページ用に URL Group を作って」

`update_user_analytics_url_group`

既存の User Analytics URL Group の名前、説明、演算子、パターンを更新します。少なくとも 1 つのフィールドが必要です。

パラメータ	型	必須	説明
`id`	string	はい	URL Group ID。
`name`	string	いいえ	新しい名前。
`description`	string \| null	いいえ	新しい説明。
`op`	string	いいえ	`AND` または `OR`。
`patterns`	object[]	いいえ	`[{ type, pattern }]`。

プロンプト例:

「この URL Group のパターンを更新して」

`delete_user_analytics_url_group`

User Analytics の URL Group を削除します。

パラメータ	型	必須	説明
`urlGroupId`	string	はい	削除する URL Group ID。
`userAnalyticsId`	string	いいえ	親の User Analytics ID。
`projectId`	string	いいえ	プロジェクト ID。
`name`	string	いいえ	確認用の表示名。

プロンプト例:

「この URL Group を削除して」

`update_user_analytics_key_events`

User Analytics プロジェクトのキーイベント（コンバージョン）を設定します。キーイベントリスト全体を置き換えます。

パラメータ	型	必須	説明
`keyEvents`	string[]	はい	イベント名（例: `["purchase", "sign_up"]`）。リスト全体を置き換えます。
`userAnalyticsId`	string	条件付き	User Analytics ノード ID。`projectId` 未指定時は必須。
`projectId`	string	条件付き	User Analytics プロジェクト ID。`userAnalyticsId` 未指定時は必須。

プロンプト例:

「purchase と sign_up をキーイベントに設定して」
「キーイベントを purchase だけに変更して」

URL Group（共通）

これらのツールは Search Analytics と User Analytics の両方のプロジェクトで動作します。

`list_url_groups`

プロジェクトの URL Group を一覧表示します（Search Analytics、User Analytics 両対応）。

パラメータ	型	必須	説明
`projectId`	string	はい	対象プロジェクト ID。

プロンプト例:

「このプロジェクトの URL Group を表示して」

`update_url_group_order`

URL Group の表示順を更新します（Search Analytics、User Analytics 両対応）。

パラメータ	型	必須	説明
`projectId`	string	はい	SA または UA プロジェクト ID。
`ids`	string[]	はい	URL Group ID の順序付きリスト。
`target`	string	いいえ	`sa` または `ua`。

通知

`list_notifications`

認証済みユーザーの受信トレイ通知を一覧表示します。

パラメータ	型	必須	説明
`workspaceId`	string	はい	通知のスコープとなるワークスペース ID。
`limit`	number	いいえ	取得する通知数（1–50）。デフォルト: 10。
`after`	string	いいえ	ページネーションカーソル。
`unread`	boolean	いいえ	`true` の場合、未読通知のみ取得。
`archived`	boolean	いいえ	アーカイブ状態でフィルター。
`type`	string	いいえ	種類でフィルター: `ANNOUNCEMENT`、`REPORT`、`ERROR`、`ANOMALY_DETECTED`、`NEW_DATA`。
`severity`	string	いいえ	重要度でフィルター: `HIGH`、`MIDDLE`、`LOW`。

プロンプト例:

「最新の通知を表示して」
「未読の通知はある？」