メインコンテンツへスキップ
Zenovaydocs
47分で読めます

MCPツールリファレンス

このページは、Zenoyayアナリティクスサーバーを通じて利用可能な全77個のMCPツールを文書化しています。各ツールには、そのパラメーター、JSON-RPCリクエスト例、およびレスポンス例が含まれています。

サーバーURL： https://api.zenovay.com/mcp トランスポート： Streamable HTTP（JSON-RPC 2.0） 認証ヘッダー： Authorization: Bearer zv_YOUR_API_KEY

すべてのツールはMCPが有効になった有効なAPIキーが必要です。書き込みツール（read_writeが必須と表記）は読み取り専用モードではエラーを返します。完全なリストは 権限と制限 を参照してください。

AIアシスタント向けクイックリファレンス

このセクションを使用して、Zenovay MCPサーバーをすばやく理解してください。すべてのリクエストは次のJSON-RPCエンベロープを使用します：

リクエストテンプレートJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "TOOL_NAME",
  "arguments": { ... }
}
}

各セッションの最初のステップ： list_websites（引数なし）を呼び出してウェブサイトIDを検出してください。ほぼすべてのツールは website_id パラメーターが必要です。

全77ツール一覧：

#ツールカテゴリーコスト説明
1query_analyticsanalytics3自然言語アナリティクスクエリ
2get_visitorsanalytics1期間比較オプション付きの訪問者統計
3get_top_pagesanalytics1訪問者数でランク付けされた最も訪問されたページ
4get_traffic_sourcesanalytics1トラフィックソース/リファラー内訳
5get_geographic_dataanalytics1国およびオプションの市別内訳
6get_technology_breakdownanalytics1デバイス、ブラウザー、オペレーティングシステム
7get_realtime_visitorsanalytics1現在のアクティブ訪問者（過去5分）
8compare_periodsanalytics12つの期間間のメトリクスの比較
9get_funnel_analysisadvanced1ファネルステップバイステップの変換データ
10get_goalsadvanced1完了率を伴うアクティブゴール
11get_session_replaysadvanced1セッションリプレイ記録リスト（Pro+）
12get_heatmap_dataadvanced1ページあたりのヒートマップインタラクションデータ（Pro+）
13get_errorsadvanced1JavaScriptエラー追跡
14get_b2b_companiesadvanced1リバースIPを介したB2B企業識別
15get_revenueadvanced1売上高の合計と内訳（Pro+）
16get_performance_metricsadvanced1Core Web Vitals（LCP、CLS、INP、FCP、TTFB）
17get_insightsai_insights1AI生成のアクション可能なインサイト
18get_anomaliesai_insights1検出されたメトリクス異常
19get_weekly_digestai_insights1週別パフォーマンスダイジェスト（今週vs先週）
20get_recommendationsai_insights1AI駆動の最適化推奨事項
21list_websitesmanagement1アクセス可能なウェブサイトをリスト（最初に呼び出してください！）
22create_goalmanagement1カスタムゴールを作成（read_writeが必須）
23manage_funnelmanagement1ファネルを作成/更新（read_writeが必須）
24export_datamanagement1アナリティクスをJSON或いはCSVでエクスポート（Scale+）
25get_api_usagemanagement1残りの日次クォータを確認
26get_website_settingsmanagement1ウェブサイトの設定と構成を取得
27update_website_settingsmanagement1ウェブサイト設定を更新（read_writeが必須）
28toggle_public_dashboardmanagement1公開ダッシュボードを有効/無効化（read_writeが必須）
29toggle_cookieless_trackingmanagement1クッキーレストラッキングを有効/無効化（read_writeが必須、Pro+）
30get_tracking_codemanagement1ウェブサイトのトラッキングコードスニペットを取得
31regenerate_tracking_codemanagement1新しいトラッキングコードを生成（read_writeが必須）
32list_goalsmanagement1ウェブサイトのすべてのゴールをリスト
33update_goalmanagement1既存のゴールを更新（read_writeが必須）
34delete_goalmanagement1ゴールを削除（read_writeが必須）
35toggle_goalmanagement1ゴールを有効または無効化（read_writeが必須）
36list_funnelsmanagement1ウェブサイトのすべてのファネルをリスト
37delete_funnelmanagement1ファネルを削除（read_writeが必須）
38delete_websitemanagement1ウェブサイトを完全に削除（read_writeが必須、full_accessが必須）
39add_ip_exclusionsettings1IP除外リストに追加（read_writeが必須）
40remove_ip_exclusionsettings1IP除外リストから削除（read_writeが必須）
41add_path_exclusionsettings1パターンを除外に追加（read_writeが必須）
42remove_path_exclusionsettings1除外からパスを削除（read_writeが必須）
43list_exclusionssettings1すべてのIPおよびパス除外をリスト
44get_notification_settingssettings1通知設定を取得
45update_notification_settingssettings1通知設定を更新（read_writeが必須）
46get_team_membersteam1チームメンバーをリスト（full_accessが必須）
47invite_team_memberteam1新しいチームメンバーを招待（read_writeが必須、full_accessが必須、Pro+）
48remove_team_memberteam1チームメンバーを削除（read_writeが必須、full_accessが必須）
49create_websitemanagement1新しいウェブサイトを作成（read_writeが必須、full_accessが必須）
50list_api_keysapi_keys1チームのすべてのAPIキーをリスト
51create_api_keyapi_keys1新しいAPIキーを作成（read_writeが必須）
52revoke_api_keyapi_keys1APIキーを取り消し（read_writeが必須）
53get_api_key_detailsapi_keys1特定のAPIキーの詳細を取得
54update_api_key_permissionsapi_keys1APIキーの権限を更新（read_writeが必須）
55list_uptime_monitorsuptime1すべての稼働時間モニターをリスト
56get_uptime_statusuptime1モニターの現在のステータスを取得
57create_uptime_monitoruptime1新しい稼働時間モニターを作成（read_writeが必須）
58delete_uptime_monitoruptime1稼働時間モニターを削除（read_writeが必須）
59get_uptime_historyuptime1稼働時間の履歴とインシデントログを取得
60update_website_namemanagement1ウェブサイト表示名を更新（read_writeが必須）
61update_website_timezonemanagement1ウェブサイトのタイムゾーンを更新（read_writeが必須）
62update_website_domainmanagement1ウェブサイトドメインを更新（read_writeが必須）
63pause_trackingmanagement1アナリティクストラッキングを一時停止（read_writeが必須）
64resume_trackingmanagement1アナリティクストラッキングを再開（read_writeが必須）
65schedule_reportmanagement1定期アナリティクスレポートをスケジュール（read_writeが必須）
66get_report_schedulemanagement1スケジュール済みレポート設定を取得
67cancel_reportmanagement1スケジュール済みレポートをキャンセル（read_writeが必須）
68get_export_historymanagement1データエクスポート履歴を取得
69get_data_retentionmanagement1ウェブサイトのデータ保持ポリシーを取得
70set_revenue_currencysettings1売上高通貨を設定（read_writeが必須）
71get_revenue_settingssettings1売上高設定（通貨、フィールドマッピング）を取得
72add_allowed_domainsettings1CORS許可リストにドメインを追加（read_writeが必須）
73remove_allowed_domainsettings1CORS許可リストからドメインを削除（read_writeが必須）
74list_allowed_domainssettings1CORS許可されたドメインをリスト
75request_data_deletionsettings1GDPR用訪問者データを削除（read_writeが必須）
76get_retention_dataadvanced1リテンション群分析（Pro+）
77get_user_profilesanalytics1セッション履歴を含む訪問者プロフィール

一般的な time_range 値： 24h、7d、30d、90d、1y（デフォルト：ほとんどのツールで 7d）

一般的なパターン

個別のツールに進む前に、一般的なマルチツールのワークフローをいくつか紹介します：

ウェブサイト検出とアナリティクス：

  1. list_websites — ウェブサイトIDを検出
  2. get_visitors — トラフィック概要を取得
  3. get_top_pages — パフォーマンスが最高のページを確認
  4. get_traffic_sources — トラフィックの出所を理解

パフォーマンス監査：

  1. list_websites — ウェブサイトIDを取得
  2. get_performance_metrics — Core Web Vitalsを確認
  3. get_errors — JavaScriptエラーを検出
  4. get_insights — AI生成の推奨事項を確認

週別レビュー：

  1. get_weekly_digest — 週次比較の自動化
  2. get_anomalies — 異常なパターンを確認
  3. compare_periods — 特定のメトリクスを詳しく調査

アナリティクスツール

すべてのアナリティクスツールは、プランのデータ保持ウィンドウを適用します。保持制限を超えるデータをリクエストするクエリは自動的に固定され、レスポンスには retention_note フィールドが含まれます。プランごとの保持制限については 計画適用 を参照してください。

1. query_analytics

アナリティクスデータについて自然言語で質問してください。これは最も柔軟なツールです。他の特定のツールが適合しない場合に使用してください。

コスト： 3クエリ

パラメーター型必須説明
website_idstringはいウェブサイトのUUID
questionstringはい自然言語での質問（最大500文字）
リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "query_analytics",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "question": "How many visitors did I have this week?"
  }
}
}
レスポンスJSON
{
"jsonrpc": "2.0",
"id": 1,
"result": {
  "content": [{
    "type": "text",
    "text": {
      "intent": "visitor_count",
      "confidence": 0.95,
      "time_range": "7d",
      "results": { "total_visitors": 1250, "unique_visitors": 980 },
      "summary": "You had 1,250 total visitors (980 unique) in the last 7 days.",
      "suggestions": [
        "How many visitors did I have this week?",
        "What are my top pages?",
        "Where are my visitors from?",
        "What devices do visitors use?"
      ]
    }
  }]
}
}

2. get_visitors

ウェブサイトの訪問者統計をオプション期間比較で取得します。

コスト： 1クエリ

パラメーター型必須デフォルト説明
website_idstringはい—ウェブサイトのUUID
time_rangestringいいえ7d期間：24h、7d、30d、90d、1y
compare_with_previousbooleanいいえfalse前の期間との比較を含む
リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "get_visitors",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "time_range": "7d",
    "compare_with_previous": true
  }
}
}
レスポンスJSON
{
"summary": {
  "total_visitors": 1250,
  "unique_visitors": 980,
  "page_views": 3400,
  "bounce_rate": 42.5,
  "avg_session_duration": 185.3
},
"daily_stats": [
  { "date": "2026-02-27", "visitors": 180, "unique_visitors": 140, "page_views": 490, "bounce_rate": 41.2 },
  { "date": "2026-02-28", "visitors": 195, "unique_visitors": 155, "page_views": 510, "bounce_rate": 43.1 }
],
"comparison": {
  "previous_period": { "start": "2026-02-20", "end": "2026-02-26" },
  "previous_summary": {
    "total_visitors": 1100,
    "unique_visitors": 870,
    "page_views": 3100,
    "bounce_rate": 44.8
  },
  "changes": {
    "visitors_pct": 13.64,
    "unique_visitors_pct": 12.64,
    "page_views_pct": 9.68,
    "bounce_rate_pct": -5.13
  }
}
}

3. get_top_pages

訪問者数でランク付けされた最も訪問されたページを取得します。

コスト： 1クエリ

パラメーター型必須デフォルト説明
website_idstringはい—ウェブサイトのUUID
time_rangestringいいえ7d期間：24h、7d、30d、90d、1y
limitnumberいいえ20返すページの最大数（1～100）
リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "get_top_pages",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "time_range": "30d",
    "limit": 5
  }
}
}
レスポンスJSON
{
"pages": [
  { "url": "/", "visitors": 520, "percentage": 41.6 },
  { "url": "/pricing", "visitors": 180, "percentage": 14.4 },
  { "url": "/features", "visitors": 145, "percentage": 11.6 },
  { "url": "/docs", "visitors": 110, "percentage": 8.8 },
  { "url": "/blog/analytics-guide", "visitors": 95, "percentage": 7.6 }
],
"total_pages": 47
}

4. get_traffic_sources

訪問者がどこから来ているかを示すトラフィックソースを取得します。

コスト： 1クエリ

パラメーター型必須デフォルト説明
website_idstringはい—ウェブサイトのUUID
time_rangestringいいえ7d期間：24h、7d、30d、90d、1y
limitnumberいいえ20返すソースの最大数（1～100）
リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "get_traffic_sources",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "time_range": "30d"
  }
}
}
レスポンスJSON
{
"sources": [
  { "source": "Direct", "visitors": 450, "percentage": 36.0 },
  { "source": "google.com", "visitors": 320, "percentage": 25.6 },
  { "source": "twitter.com", "visitors": 85, "percentage": 6.8 },
  { "source": "github.com", "visitors": 60, "percentage": 4.8 }
],
"total_sources": 23
}

5. get_geographic_data

国別の地理的内訳をオプションの都市レベルの詳細で取得します。

コスト： 1クエリ

パラメーター型必須デフォルト説明
website_idstringはい—ウェブサイトのUUID
time_rangestringいいえ7d期間：24h、7d、30d、90d、1y
limitnumberいいえ20エントリの最大数（1～100）
include_citiesbooleanいいえfalse国ごとの都市レベルの内訳を含む
リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "get_geographic_data",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "include_cities": true,
    "limit": 3
  }
}
}
レスポンスJSON
{
"countries": [
  {
    "country_code": "US",
    "country_name": "United States",
    "visitors": 520,
    "percentage": 41.6,
    "cities": [
      { "city": "San Francisco", "visitors": 85 },
      { "city": "New York", "visitors": 72 }
    ]
  },
  {
    "country_code": "DE",
    "country_name": "Germany",
    "visitors": 180,
    "percentage": 14.4,
    "cities": [
      { "city": "Berlin", "visitors": 45 },
      { "city": "Munich", "visitors": 32 }
    ]
  }
],
"total_countries": 28
}

6. get_technology_breakdown

訪問者技術内訳を取得します：デバイス、ブラウザー、およびオペレーティングシステム。

コスト： 1クエリ

パラメーター型必須デフォルト説明
website_idstringはい—ウェブサイトのUUID
time_rangestringいいえ7d期間：24h、7d、30d、90d、1y
リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "get_technology_breakdown",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  }
}
}
レスポンスJSON
{
"devices": [
  { "name": "desktop", "visitors": 780, "percentage": 62.4 },
  { "name": "mobile", "visitors": 390, "percentage": 31.2 },
  { "name": "tablet", "visitors": 80, "percentage": 6.4 }
],
"browsers": [
  { "name": "Chrome", "visitors": 625, "percentage": 50.0 },
  { "name": "Safari", "visitors": 300, "percentage": 24.0 },
  { "name": "Firefox", "visitors": 150, "percentage": 12.0 }
],
"operating_systems": [
  { "name": "Windows", "visitors": 450, "percentage": 36.0 },
  { "name": "macOS", "visitors": 350, "percentage": 28.0 },
  { "name": "iOS", "visitors": 250, "percentage": 20.0 },
  { "name": "Android", "visitors": 140, "percentage": 11.2 }
],
"total_visitors": 1250
}

7. get_realtime_visitors

現在のアクティブ訪問者（過去5分内に訪問）を取得します。

コスト： 1クエリ

パラメーター型必須説明
website_idstringはいウェブサイトのUUID
リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "get_realtime_visitors",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  }
}
}
レスポンスJSON
{
"active_visitors": 12,
"recent_visitors": [
  {
    "country_name": "United States",
    "page_url": "/pricing",
    "device_type": "desktop",
    "browser": "Chrome"
  },
  {
    "country_name": "Germany",
    "page_url": "/",
    "device_type": "mobile",
    "browser": "Safari"
  }
]
}

8. compare_periods

2つの期間間のアナリティクスメトリクスを比較します。

コスト： 1クエリ

パラメーター型必須デフォルト説明
website_idstringはい—ウェブサイトのUUID
current_periodstringいいえ7d現在の期間：24h、7d、30d、90d
comparison_periodstringいいえprevious比較：previous、same_period_last_month、same_period_last_year
リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "compare_periods",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "current_period": "30d",
    "comparison_period": "same_period_last_month"
  }
}
}
レスポンスJSON
{
"current": {
  "period": { "start": "2026-02-04", "end": "2026-03-06" },
  "visitors": 3800,
  "unique_visitors": 2900,
  "page_views": 10200,
  "bounce_rate": 42.5,
  "avg_session_duration": 185.3,
  "days": 30
},
"comparison": {
  "period": { "start": "2026-01-05", "end": "2026-02-04" },
  "type": "same_period_last_month",
  "visitors": 3200,
  "unique_visitors": 2500,
  "page_views": 8800,
  "bounce_rate": 45.1,
  "avg_session_duration": 170.8,
  "days": 30
},
"changes": {
  "visitors_pct": 18.75,
  "unique_visitors_pct": 16.0,
  "pageviews_pct": 15.91,
  "bounce_rate_pct": -5.76,
  "avg_session_duration_pct": 8.49
}
}

高度なツール

9. get_funnel_analysis

ファネル分析データを取得します。funnel_idがない場合はすべてのファネルをリスト表示します。1つある場合は、ステップバイステップの変換データを返します。

コスト： 1クエリ

パラメーター型必須デフォルト説明
website_idstringはい—ウェブサイトのUUID
funnel_idstringいいえ—詳細なステップ分析用のファネルUUID
time_rangestringいいえ30d期間：24h、7d、30d、90d、1y
リクエスト（ファネルをリスト）JSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "get_funnel_analysis",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  }
}
}
レスポンスJSON
{
"funnels": [
  { "id": "f1a2b3c4-...", "name": "Signup Flow", "created_at": "2026-01-15T10:00:00Z" },
  { "id": "f5d6e7f8-...", "name": "Checkout Flow", "created_at": "2026-02-01T14:30:00Z" }
]
}
リクエスト（詳細分析）JSON
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
  "name": "get_funnel_analysis",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "funnel_id": "f1a2b3c4-..."
  }
}
}
レスポンスJSON
{
"funnel": { "id": "f1a2b3c4-...", "name": "Signup Flow" },
"steps": [
  { "name": "Landing Page", "order": 1, "visitors": 500, "conversion_rate": 100 },
  { "name": "Signup Form", "order": 2, "visitors": 320, "conversion_rate": 64 },
  { "name": "Email Verification", "order": 3, "visitors": 280, "conversion_rate": 56 },
  { "name": "Onboarding Complete", "order": 4, "visitors": 210, "conversion_rate": 42 }
]
}

10. get_goals

完了数と変換率を伴うアクティブゴールを取得します。

コスト： 1クエリ

パラメーター型必須デフォルト説明
website_idstringはい—ウェブサイトのUUID
time_rangestringいいえ30d期間：24h、7d、30d、90d、1y
リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "get_goals",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  }
}
}
レスポンスJSON
{
"goals": [
  { "id": "g1...", "name": "Newsletter Signup", "goal_type": "url_match", "is_active": true, "completions": 145, "conversion_rate": 3.82 },
  { "id": "g2...", "name": "Pricing Click", "goal_type": "element_click", "is_active": true, "completions": 89, "conversion_rate": 2.34 }
]
}

11. get_session_replays

セッションリプレイ記録をリスト表示します。デバイスまたは国でフィルター処理します。

コスト： 1クエリ | 必須： Pro+（sessionReplay 機能フラグ）

パラメーター型必須デフォルト説明
website_idstringはい—ウェブサイトのUUID
limitnumberいいえ20返すセッション数（1～50）
device_typestringいいえ—フィルター：desktop、mobile、tablet
country_codestringいいえ—ISO国コード（例 US、DE）
リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "get_session_replays",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "device_type": "mobile",
    "limit": 5
  }
}
}
レスポンスJSON
{
"sessions": [
  {
    "id": "sr1...",
    "session_id": "sess_abc123",
    "visitor_id": "v1...",
    "duration_ms": 45200,
    "page_count": 4,
    "had_interaction": true,
    "started_at": "2026-03-05T14:22:00Z"
  }
],
"total": 23
}

12. get_heatmap_data

ページごとのヒートマップインタラクションデータを取得します。

コスト： 1クエリ | 必須： Pro+（heatmaps 機能フラグ）

パラメーター型必須デフォルト説明
website_idstringはい—ウェブサイトのUUID
page_urlstringいいえ—特定のページURLにフィルター
limitnumberいいえ20返すページ数（1～50）
リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "get_heatmap_data",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  }
}
}
レスポンスJSON
{
"pages": [
  { "page_url": "/", "total_interactions": 2340, "unique_visitors": 890, "last_updated": "2026-03-05T18:00:00Z" },
  { "page_url": "/pricing", "total_interactions": 1560, "unique_visitors": 620, "last_updated": "2026-03-05T17:45:00Z" }
]
}

13. get_errors

ウェブサイトの追跡されたJavaScriptエラーを取得します。

コスト： 1クエリ

パラメーター型必須デフォルト説明
website_idstringはい—ウェブサイトのUUID
statusstringいいえopenフィルター：open、resolved、ignored
limitnumberいいえ50返すエラー数（1～100）
リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "get_errors",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "status": "open"
  }
}
}
レスポンスJSON
{
"errors": [
  {
    "id": "e1...",
    "message": "TypeError: Cannot read property 'map' of undefined",
    "type": "TypeError",
    "occurrence_count": 45,
    "first_seen": "2026-02-28T10:15:00Z",
    "last_seen": "2026-03-05T22:30:00Z",
    "is_resolved": false
  }
],
"total": 8
}

14. get_b2b_companies

リバースIP検索を介してウェブサイトを訪問するB2B企業を特定します。

コスト： 1クエリ

パラメーター型必須デフォルト説明
website_idstringはい—ウェブサイトのUUID
limitnumberいいえ20返す企業数（1～100）
sort_bystringいいえlast_seenソート：visits、last_seen、confidence
industrystringいいえ—業界でフィルター（例 Technology）
min_visitsnumberいいえ1最小訪問数
リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "get_b2b_companies",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "sort_by": "visits",
    "min_visits": 3
  }
}
}
レスポンスJSON
{
"companies": [
  {
    "name": "Acme Corp",
    "domain": "acme.com",
    "industry": "Technology",
    "employee_count": 500,
    "visit_count": 12,
    "last_visit": "2026-03-05T16:00:00Z",
    "confidence_score": 0.92
  }
]
}

15. get_revenue

売上高分析を合計と内訳で取得します。

コスト： 1クエリ | 必須： Pro+（revenueAttribution 機能フラグ）

パラメーター型必須デフォルト説明
website_idstringはい—ウェブサイトのUUID
time_rangestringいいえ30d期間：24h、7d、30d、90d、1y
group_bystringいいえdayグループ化：day、week、month、source
リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "get_revenue",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "group_by": "source"
  }
}
}
レスポンスJSON
{
"total_revenue": 12450.00,
"transaction_count": 89,
"avg_order_value": 139.89,
"currency": "USD",
"breakdown": [
  { "source": "google.com", "revenue": 5200.00, "transactions": 38 },
  { "source": "Direct", "revenue": 4100.00, "transactions": 30 },
  { "source": "twitter.com", "revenue": 1850.00, "transactions": 12 }
]
}

16. get_performance_metrics

Core Web Vitalsとパーセンタイル内訳を伴うパフォーマンスメトリクスを取得します。

コスト： 1クエリ

パラメーター型必須デフォルト説明
website_idstringはい—ウェブサイトのUUID
time_rangestringいいえ7d期間：24h、7d、30d、90d、1y
page_urlstringいいえ—特定のページにフィルター
リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "get_performance_metrics",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  }
}
}
レスポンスJSON
{
"lcp": { "p50": 1800, "p75": 2200, "p90": 3100, "rating": "good", "sample_count": 450 },
"cls": { "p50": 0.05, "p75": 0.08, "p90": 0.15, "rating": "good", "sample_count": 450 },
"inp": { "p50": 120, "p75": 180, "p90": 280, "rating": "good", "sample_count": 420 },
"fcp": { "p50": 1200, "p75": 1600, "p90": 2400, "rating": "good", "sample_count": 450 },
"ttfb": { "p50": 350, "p75": 600, "p90": 950, "rating": "good", "sample_count": 450 }
}

評価しきい値：

メトリック良い改善が必要不良
LCP≤ 2500ms≤ 4000ms> 4000ms
CLS≤ 0.1≤ 0.25> 0.25
INP≤ 200ms≤ 500ms> 500ms
FCP≤ 1800ms≤ 3000ms> 3000ms
TTFB≤ 800ms≤ 1800ms> 1800ms

AIインサイトツール

17. get_insights

ウェブサイトのパフォーマンスに関するAI生成のアクション可能なインサイトを取得します。

コスト： 1クエリ

パラメーター型必須デフォルト説明
website_idstringはい—ウェブサイトのUUID
severitystringいいえ—フィルター：critical、warning、info
statusstringいいえactiveフィルター：active、acknowledged、resolved
limitnumberいいえ10最大インサイト数（1～50）
リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "get_insights",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "severity": "critical"
  }
}
}
レスポンスJSON
{
"website": { "id": "2ea8af07-...", "domain": "example.com" },
"insights": [
  {
    "id": "i1...",
    "title": "Bounce rate spike on /pricing",
    "description": "Bounce rate on the pricing page increased by 35% compared to last week. Consider reviewing recent changes.",
    "severity": "critical",
    "type": "bounce_rate",
    "created_at": "2026-03-05T08:00:00Z"
  }
],
"summary": { "total": 3, "critical": 1, "warning": 1, "info": 1 }
}

18. get_anomalies

検出された異常（メトリクスの異常な偏差）を取得します。

コスト： 1クエリ

パラメーター型必須デフォルト説明
website_idstringはい—ウェブサイトのUUID
severitystringいいえ—フィルター：critical、warning、info
metricstringいいえ—メトリック別にフィルター（例 visitors、bounce_rate）
limitnumberいいえ10最大異常数（1～50）
リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "get_anomalies",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  }
}
}
レスポンスJSON
{
"website": { "id": "2ea8af07-...", "domain": "example.com" },
"anomalies": [
  {
    "id": "a1...",
    "metric_name": "visitors",
    "expected_value": 180,
    "actual_value": 45,
    "deviation_pct": -75.0,
    "severity": "critical",
    "detected_at": "2026-03-04T00:00:00Z",
    "is_resolved": false
  }
],
"total": 2
}

19. get_weekly_digest

今週を先週と比較する週別パフォーマンスダイジェストを生成します。

コスト： 1クエリ

パラメーター型必須説明
website_idstringはいウェブサイトのUUID
リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "get_weekly_digest",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  }
}
}
レスポンスJSON
{
"website": { "id": "2ea8af07-...", "domain": "example.com" },
"this_week": { "visitors": 1250, "pageviews": 3400, "sessions": 980, "bounce_rate": 42.5, "avg_duration": 185 },
"last_week": { "visitors": 1100, "pageviews": 3100, "sessions": 870, "bounce_rate": 44.8, "avg_duration": 170 },
"changes": {
  "visitors": 13.64,
  "pageviews": 9.68,
  "sessions": 12.64,
  "bounce_rate": -5.13,
  "avg_duration": 8.82
},
"top_pages": [
  { "path": "/", "views": 520 },
  { "path": "/pricing", "views": 180 }
],
"top_countries": [
  { "country": "US", "visitors": 520 },
  { "country": "DE", "visitors": 180 }
]
}

20. get_recommendations

AI駆動の最適化推奨事項を取得します。

コスト： 1クエリ

パラメーター型必須デフォルト説明
website_idstringはい—ウェブサイトのUUID
categorystringいいえ—フィルター：performance、engagement、conversion、seo
limitnumberいいえ5最大推奨事項数（1～20）
リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "get_recommendations",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "category": "performance"
  }
}
}
レスポンスJSON
{
"website": { "id": "2ea8af07-...", "domain": "example.com" },
"recommendations": [
  {
    "id": "r1...",
    "title": "Optimize Largest Contentful Paint",
    "description": "Your LCP p75 is 3200ms (needs improvement). Consider lazy-loading below-fold images and preloading critical assets.",
    "category": "performance",
    "priority": "high",
    "impact": "Improving LCP to under 2500ms could reduce bounce rate by ~10%"
  }
],
"total": 3
}

管理ツール

21. list_websites

現在のAPIキーでアクセス可能なすべてのウェブサイトをリストします。

コスト: 1 クエリ

このツールはパラメーターを受け取りません。フルアクセスキーはすべてのチームウェブサイトを表示します。サイトスコープキーは割り当てられたウェブサイトのみを表示します。

リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "list_websites",
  "arguments": {}
}
}
レスポンスJSON
{
"websites": [
  {
    "id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "domain": "example.com",
    "name": "My Website",
    "tracking_code": "zv_abc123",
    "is_active": true,
    "created_at": "2025-06-15T10:00:00Z"
  }
],
"total": 1
}

22. create_goal

カスタムコンバージョンゴールを作成します。read_write モードが必須です。

コスト: 1 クエリ

パラメータータイプ必須説明
website_idstringはいウェブサイトのUUID
namestringはいゴール名（最大100文字）
goal_typestringはいurl_match、element_click、またはcustom_event
url_patternstringurl_match の場合マッチするURL パターン
url_match_typestringいいえexact、contains、starts_with、ends_with、regex（デフォルト：contains）
css_selectorstringelement_click の場合要素のCSSセレクタ
event_namestringcustom_event の場合トラッキングするカスタムイベント名
リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "create_goal",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "name": "Newsletter Signup",
    "goal_type": "url_match",
    "url_pattern": "/thank-you",
    "url_match_type": "contains"
  }
}
}
レスポンスJSON
{
"goal": {
  "id": "g1a2b3c4-...",
  "name": "Newsletter Signup",
  "goal_type": "url_match",
  "is_active": true,
  "created_at": "2026-03-06T12:00:00Z"
}
}

23. manage_funnel

コンバージョンファネルを作成または更新します。read_write モードが必須です。

コスト: 1 クエリ

パラメータータイプ必須説明
website_idstringはいウェブサイトのUUID
namestringはいファネル名
stepsarrayはい2～10の順序付きステップ（下記参照）
funnel_idstringいいえ更新対象の既存ファネルUUID

ステップオブジェクト：

フィールドタイプ必須説明
step_namestringはい表示名
step_typestringはいurl_match、element_click、custom_event
url_patternstringいいえURL パターン（url_match の場合）
url_match_typestringいいえexact、contains、starts_with、ends_with、regex
リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "manage_funnel",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "name": "Checkout Flow",
    "steps": [
      { "step_name": "Product Page", "step_type": "url_match", "url_pattern": "/products" },
      { "step_name": "Add to Cart", "step_type": "custom_event", "url_pattern": "add_to_cart" },
      { "step_name": "Checkout", "step_type": "url_match", "url_pattern": "/checkout" },
      { "step_name": "Purchase Complete", "step_type": "url_match", "url_pattern": "/order-confirmation" }
    ]
  }
}
}
レスポンスJSON
{
"funnel": {
  "id": "f1a2b3c4-...",
  "name": "Checkout Flow",
  "steps_count": 4,
  "created_at": "2026-03-06T12:00:00Z"
}
}

24. export_data

JSONまたはCSV形式でアナリティクスデータをエクスポートします。

コスト: 1 クエリ | 必須: Scale+（dataExport機能フラグ）

パラメータータイプ必須デフォルト説明
website_idstringはい—ウェブサイトのUUID
formatstringいいえjson出力形式：csv、json
metricsarrayいいえ["visitors","pageviews","unique_visitors"]含めるメトリクス
time_rangestringいいえ30d期間：7d、30d、90d、1y

利用可能なメトリクス： visitors、pageviews、unique_visitors、bounce_rate、avg_session_duration

リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "export_data",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "format": "csv",
    "metrics": ["visitors", "pageviews", "bounce_rate"],
    "time_range": "30d"
  }
}
}
レスポンスJSON
{
"format": "csv",
"time_range": "30d",
"data": "date,visitors,page_views,bounce_rate\n2026-02-04,120,340,42.5\n2026-02-05,135,380,41.2\n...",
"total_rows": 30
}

25. get_api_usage

現在のAPIキーの使用状況と残りのクォータを確認します。

コスト: 1 クエリ

このツールはパラメーターを受け取りません。

リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "get_api_usage",
  "arguments": {}
}
}
レスポンスJSON
{
"api_key": {
  "id": "key_abc123",
  "name": "Production Key",
  "permission": "full_access"
},
"usage": {
  "monthly_requests": 1250,
  "total_requests": 8400
},
"mcp": {
  "queries_today": 15,
  "queries_limit": 500,
  "reset_at": "2026-03-07T00:00:00Z"
},
"subscription": {
  "tier": "Scale"
}
}

26. get_website_settings

ウェブサイトの設定と構成を取得します。

コスト: 1 クエリ

パラメータータイプ必須説明
website_idstringはいウェブサイトのUUID
リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "get_website_settings",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  }
}
}
レスポンスJSON
{
"website": {
  "id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "domain": "example.com",
  "name": "My Website",
  "is_active": true,
  "created_at": "2025-06-15T10:00:00Z"
},
"settings": {
  "public_dashboard_enabled": false,
  "public_dashboard_url": null,
  "cookieless_tracking": false,
  "tracking_code": "zv_abc123",
  "timezone": "America/New_York",
  "data_retention_days": 730,
  "allowed_domains": ["example.com", "www.example.com"]
}
}

27. update_website_settings

ウェブサイト設定を更新します。read_write モードが必須です。

コスト: 1 クエリ

パラメータータイプ必須説明
website_idstringはいウェブサイトのUUID
namestringいいえウェブサイト表示名
timezonestringいいえIANA タイムゾーン（例：America/New_York）
allowed_domainsarrayいいえトラッキングスクリプト用の許可ドメインのリスト
リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "update_website_settings",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "name": "My Updated Website",
    "timezone": "Europe/Berlin",
    "allowed_domains": ["example.com", "www.example.com", "staging.example.com"]
  }
}
}
レスポンスJSON
{
"website": {
  "id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "name": "My Updated Website",
  "timezone": "Europe/Berlin",
  "allowed_domains": ["example.com", "www.example.com", "staging.example.com"],
  "updated_at": "2026-03-15T10:00:00Z"
}
}

28. toggle_public_dashboard

ウェブサイトのパブリックダッシュボード共有を有効または無効にします。read_write モードが必須です。

コスト: 1 クエリ

パラメータータイプ必須説明
website_idstringはいウェブサイトのUUID
enabledbooleanはい有効にする場合はtrue、無効にする場合はfalse
リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "toggle_public_dashboard",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "enabled": true
  }
}
}
レスポンスJSON
{
"public_dashboard": {
  "enabled": true,
  "url": "https://app.zenovay.com/public/2ea8af07-xxxx",
  "globe_url": "https://app.zenovay.com/globe/2ea8af07-xxxx"
}
}

29. toggle_cookieless_tracking

クッキーレストラッキングモードを有効または無効にします。read_write モード。Pro プラン以上が必須です。

有効にすると、トラッカーはクッキーまたはlocalStorageではなく、訪問者識別にSHA-256(IP_subnet + UA + daily_salt)を使用します。

コスト: 1 クエリ

パラメータータイプ必須説明
website_idstringはいウェブサイトのUUID
enabledbooleanはい有効にする場合はtrue、無効にする場合はfalse
リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "toggle_cookieless_tracking",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "enabled": true
  }
}
}
レスポンスJSON
{
"cookieless_tracking": {
  "enabled": true,
  "method": "server_side_hashing",
  "updated_at": "2026-03-15T10:00:00Z"
}
}

クッキーレストラッキングは完全にGDPR準拠です。クッキーやlocalStorageは使用されません。訪問者識別はサーバー側で日次ローテーションソルトを使用して計算されます。

30. get_tracking_code

ウェブサイトのトラッキングコードスニペットを取得します。サイトにインストールするスクリプトタグを取得する場合に使用します。

コスト: 1 クエリ

パラメータータイプ必須説明
website_idstringはいウェブサイトのUUID
リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "get_tracking_code",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  }
}
}
レスポンスJSON
{
"tracking_code": "zv_abc123",
"script_tag": "<script defer data-website-id=\"zv_abc123\" src=\"https://api.zenovay.com/tracker.js\"></script>",
"cookieless_script_tag": "<script defer data-website-id=\"zv_abc123\" data-cookieless=\"true\" src=\"https://api.zenovay.com/tracker.js\"></script>"
}

31. regenerate_tracking_code

ウェブサイトの新しいトラッキングコードを生成します。read_write モードが必須です。

これにより前のトラッキングコードが無効になります。再生成後、ウェブサイトのスクリプトタグを更新する必要があります。

コスト: 1 クエリ

パラメータータイプ必須説明
website_idstringはいウェブサイトのUUID
リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "regenerate_tracking_code",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  }
}
}
レスポンスJSON
{
"tracking_code": "zv_def456",
"previous_code": "zv_abc123",
"script_tag": "<script defer data-website-id=\"zv_def456\" src=\"https://api.zenovay.com/tracker.js\"></script>",
"regenerated_at": "2026-03-15T10:00:00Z"
}

32. list_goals

ウェブサイトのすべてのゴールを現在のステータスとコンバージョン率とともにリストします。

コスト: 1 クエリ

パラメータータイプ必須デフォルト説明
website_idstringはい—ウェブサイトのUUID
include_inactivebooleanいいえfalse無効なゴールを含める
time_rangestringいいえ30dコンバージョン統計の期間：7d、30d、90d、1y
リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "list_goals",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "include_inactive": true
  }
}
}
レスポンスJSON
{
"goals": [
  {
    "id": "g1a2b3c4-...",
    "name": "Newsletter Signup",
    "goal_type": "url_match",
    "url_pattern": "/thank-you",
    "is_active": true,
    "completions": 145,
    "conversion_rate": 3.82,
    "created_at": "2026-01-15T10:00:00Z"
  },
  {
    "id": "g5d6e7f8-...",
    "name": "Old Promo Banner",
    "goal_type": "element_click",
    "css_selector": "#promo-cta",
    "is_active": false,
    "completions": 0,
    "conversion_rate": 0,
    "created_at": "2025-11-01T08:00:00Z"
  }
],
"total": 2
}

33. update_goal

既存のゴール設定を更新します。read_write モードが必須です。

コスト: 1 クエリ

パラメータータイプ必須説明
website_idstringはいウェブサイトのUUID
goal_idstringはいゴールのUUID
namestringいいえ更新されたゴール名
url_patternstringいいえ更新されたURL パターン
url_match_typestringいいえexact、contains、starts_with、ends_with、regex
css_selectorstringいいえ更新されたCSSセレクタ
event_namestringいいえ更新されたイベント名
リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "update_goal",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "goal_id": "g1a2b3c4-...",
    "name": "Newsletter Signup v2",
    "url_pattern": "/signup-complete"
  }
}
}
レスポンスJSON
{
"goal": {
  "id": "g1a2b3c4-...",
  "name": "Newsletter Signup v2",
  "goal_type": "url_match",
  "url_pattern": "/signup-complete",
  "is_active": true,
  "updated_at": "2026-03-15T10:00:00Z"
}
}

34. delete_goal

ゴールを完全に削除します。read_write モードが必須です。

コスト: 1 クエリ

パラメータータイプ必須説明
website_idstringはいウェブサイトのUUID
goal_idstringはい削除するゴールのUUID
リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "delete_goal",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "goal_id": "g5d6e7f8-..."
  }
}
}
レスポンスJSON
{
"deleted": true,
"goal_id": "g5d6e7f8-..."
}

35. toggle_goal

ゴールを削除せずに有効または無効にします。read_write モードが必須です。

コスト: 1 クエリ

パラメータータイプ必須説明
website_idstringはいウェブサイトのUUID
goal_idstringはいゴールのUUID
is_activebooleanはい有効にする場合はtrue、無効にする場合はfalse
リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "toggle_goal",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "goal_id": "g1a2b3c4-...",
    "is_active": false
  }
}
}
レスポンスJSON
{
"goal": {
  "id": "g1a2b3c4-...",
  "name": "Newsletter Signup v2",
  "is_active": false,
  "updated_at": "2026-03-15T10:00:00Z"
}
}

36. list_funnels

ウェブサイトのすべてのファネルをリストします。

コスト: 1 クエリ

パラメータータイプ必須説明
website_idstringはいウェブサイトのUUID
リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "list_funnels",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  }
}
}
レスポンスJSON
{
"funnels": [
  {
    "id": "f1a2b3c4-...",
    "name": "Signup Flow",
    "steps_count": 4,
    "created_at": "2026-01-15T10:00:00Z"
  },
  {
    "id": "f5d6e7f8-...",
    "name": "Checkout Flow",
    "steps_count": 5,
    "created_at": "2026-02-01T14:30:00Z"
  }
],
"total": 2
}

37. delete_funnel

ファネルを完全に削除します。read_write モードが必須です。

コスト: 1 クエリ

パラメータータイプ必須説明
website_idstringはいウェブサイトのUUID
funnel_idstringはい削除するファネルのUUID
リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "delete_funnel",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "funnel_id": "f5d6e7f8-..."
  }
}
}
レスポンスJSON
{
"deleted": true,
"funnel_id": "f5d6e7f8-..."
}

38. delete_website

ウェブサイトとそのすべてのアナリティクスデータを完全に削除します。read_write モードとfull_access キーが必須です。

このアクションは元に戻すことができません。このウェブサイトのすべてのアナリティクスデータ、ゴール、ファネル、設定が完全に削除されます。

コスト: 1 クエリ

パラメータータイプ必須説明
website_idstringはい削除するウェブサイトのUUID
confirmbooleanはい削除を確認するにはtrueである必要があります
リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "delete_website",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "confirm": true
  }
}
}
レスポンスJSON
{
"deleted": true,
"website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"domain": "example.com"
}

49. create_website

トラッキング対象の新しいウェブサイトを作成します。read_write モードとfull_access キーが必須です。

コスト: 1 クエリ

パラメータータイプ必須説明
domainstringはいウェブサイトドメイン（例：docs.example.com）
namestringいいえ表示名（デフォルト：ドメイン）
timezonestringいいえIANA タイムゾーン（デフォルト：UTC）
リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "create_website",
  "arguments": {
    "domain": "docs.example.com",
    "name": "Documentation Site",
    "timezone": "America/New_York"
  }
}
}
レスポンスJSON
{
"website": {
  "id": "3fb9bg08-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "domain": "docs.example.com",
  "name": "Documentation Site",
  "tracking_code": "zv_ghi789",
  "is_active": true,
  "created_at": "2026-03-15T10:00:00Z"
},
"script_tag": "<script defer data-website-id=\"zv_ghi789\" src=\"https://api.zenovay.com/tracker.js\"></script>"
}

設定ツール

39. add_ip_exclusion

IPアドレスまたはCIDR範囲を除外リストに追加します。除外されたIPからの訪問者はトラッキングされません。read_write モードが必須です。

コスト: 1 クエリ

パラメータータイプ必須説明
website_idstringはいウェブサイトのUUID
ip_addressstringはいIPアドレスまたはCIDR範囲（例：192.168.1.0/24）
labelstringいいえ説明用ラベル（例：「オフィスネットワーク」）
リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "add_ip_exclusion",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "ip_address": "203.0.113.0/24",
    "label": "Office network"
  }
}
}
レスポンスJSON
{
"exclusion": {
  "id": "exc_ip_1...",
  "type": "ip",
  "ip_address": "203.0.113.0/24",
  "label": "Office network",
  "created_at": "2026-03-15T10:00:00Z"
}
}

40. remove_ip_exclusion

IPアドレスを除外リストから削除します。read_write モードが必須です。

コスト: 1 クエリ

パラメータータイプ必須説明
website_idstringはいウェブサイトのUUID
exclusion_idstringはい削除する除外設定のUUID
リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "remove_ip_exclusion",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "exclusion_id": "exc_ip_1..."
  }
}
}
レスポンスJSON
{
"deleted": true,
"exclusion_id": "exc_ip_1..."
}

41. add_path_exclusion

トラッキングから除外するURLパターンを追加します。パターンに一致するページはアナリティクスイベントを生成しません。read_write モードが必須です。

コスト: 1 クエリ

パラメータータイプ必須説明
website_idstringはいウェブサイトのUUID
path_patternstringはい除外するURLパターン（例：/admin/*、/internal/health）
match_typestringいいえexact、starts_with、contains、regex（デフォルト：starts_with）
labelstringいいえ説明用ラベル
リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "add_path_exclusion",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "path_pattern": "/admin",
    "match_type": "starts_with",
    "label": "Admin panel"
  }
}
}
レスポンスJSON
{
"exclusion": {
  "id": "exc_path_1...",
  "type": "path",
  "path_pattern": "/admin",
  "match_type": "starts_with",
  "label": "Admin panel",
  "created_at": "2026-03-15T10:00:00Z"
}
}

42. remove_path_exclusion

パス除外設定を削除します。read_write モードが必須です。

コスト: 1 クエリ

パラメータータイプ必須説明
website_idstringはいウェブサイトのUUID
exclusion_idstringはい削除する除外設定のUUID
リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "remove_path_exclusion",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "exclusion_id": "exc_path_1..."
  }
}
}
レスポンスJSON
{
"deleted": true,
"exclusion_id": "exc_path_1..."
}

43. list_exclusions

ウェブサイトのすべてのIPおよびパス除外設定をリストします。

コスト: 1 クエリ

パラメータータイプ必須説明
website_idstringはいウェブサイトのUUID
リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "list_exclusions",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  }
}
}
レスポンスJSON
{
"ip_exclusions": [
  {
    "id": "exc_ip_1...",
    "ip_address": "203.0.113.0/24",
    "label": "Office network",
    "created_at": "2026-03-15T10:00:00Z"
  }
],
"path_exclusions": [
  {
    "id": "exc_path_1...",
    "path_pattern": "/admin",
    "match_type": "starts_with",
    "label": "Admin panel",
    "created_at": "2026-03-15T10:00:00Z"
  }
],
"total_ip": 1,
"total_path": 1
}

44. get_notification_settings

現在のチームの通知設定を取得します。

コスト: 1 クエリ

パラメータータイプ必須説明
website_idstringはいウェブサイトのUUID
リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "get_notification_settings",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  }
}
}
レスポンスJSON
{
"notifications": {
  "weekly_digest_email": true,
  "anomaly_alerts": true,
  "anomaly_threshold": "warning",
  "goal_completion_alerts": false,
  "uptime_alerts": true,
  "email_recipients": ["[email protected]"]
}
}

45. update_notification_settings

通知設定を更新します。read_write モードが必須です。

コスト: 1 クエリ

パラメータータイプ必須説明
website_idstringはいウェブサイトのUUID
weekly_digest_emailbooleanいいえ週次ダイジェストを有効/無効
anomaly_alertsbooleanいいえ異常アラートを有効/無効
anomaly_thresholdstringいいえ最小重大度：info、warning、critical
goal_completion_alertsbooleanいいえゴール達成通知を有効/無効
uptime_alertsbooleanいいえアップタイム監視アラートを有効/無効
email_recipientsarrayいいえ通知するメールアドレスのリスト
リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "update_notification_settings",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "anomaly_alerts": true,
    "anomaly_threshold": "critical",
    "goal_completion_alerts": true,
    "email_recipients": ["[email protected]", "[email protected]"]
  }
}
}
レスポンスJSON
{
"notifications": {
  "weekly_digest_email": true,
  "anomaly_alerts": true,
  "anomaly_threshold": "critical",
  "goal_completion_alerts": true,
  "uptime_alerts": true,
  "email_recipients": ["[email protected]", "[email protected]"],
  "updated_at": "2026-03-15T10:00:00Z"
}
}

チームツール

46. get_team_members

チームのすべてのメンバーをリストします。full_access キーが必須です。

コスト: 1 クエリ

このツールはパラメーターを受け取りません。

リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "get_team_members",
  "arguments": {}
}
}
レスポンスJSON
{
"team": {
  "id": "team_abc123",
  "name": "Acme Corp"
},
"members": [
  {
    "id": "usr_1...",
    "email": "[email protected]",
    "name": "Jane Admin",
    "role": "owner",
    "joined_at": "2025-06-01T10:00:00Z"
  },
  {
    "id": "usr_2...",
    "email": "[email protected]",
    "name": "John Dev",
    "role": "member",
    "joined_at": "2025-08-15T14:00:00Z"
  }
],
"total": 2
}

47. invite_team_member

メールアドレスでチームに新しいメンバーを招待します。read_write モード、full_access キー、Pro プラン以上が必須です。

コスト: 1 クエリ

パラメータータイプ必須説明
emailstringはい招待するメールアドレス
rolestringいいえロール：member（デフォルト）またはadmin
リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "invite_team_member",
  "arguments": {
    "email": "[email protected]",
    "role": "member"
  }
}
}
レスポンスJSON
{
"invitation": {
  "id": "inv_1...",
  "email": "[email protected]",
  "role": "member",
  "status": "pending",
  "invited_at": "2026-03-15T10:00:00Z",
  "expires_at": "2026-03-22T10:00:00Z"
}
}

48. remove_team_member

チームからメンバーを削除します。read_write モードとfull_access キーが必須です。

チームオーナーは削除できません。メンバーはすべてのチームウェブサイトへのアクセスをすぐに失います。

コスト: 1 クエリ

パラメータータイプ必須説明
member_idstringはい削除するメンバーのユーザーID
リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "remove_team_member",
  "arguments": {
    "member_id": "usr_2..."
  }
}
}
レスポンスJSON
{
"removed": true,
"member_id": "usr_2...",
"email": "[email protected]"
}

APIキーツール

50. list_api_keys

現在のチームのすべてのAPIキーをリストします。キーメタデータを返します（キー値自体は返しません）。

コスト: 1 クエリ

このツールはパラメーターを受け取りません。

リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "list_api_keys",
  "arguments": {}
}
}
レスポンスJSON
{
"api_keys": [
  {
    "id": "key_1...",
    "name": "Production Key",
    "prefix": "zv_prod_",
    "type": "full_access",
    "mcp_enabled": true,
    "mcp_mode": "read_write",
    "created_at": "2026-01-15T10:00:00Z",
    "last_used_at": "2026-03-15T09:30:00Z"
  }
],
"total": 1
}

51. create_api_key

新しいAPIキーを作成します。read_write モードが必須です。

コスト: 1 クエリ

パラメータータイプ必須説明
namestringはいキーの表示名
typestringはいfull_accessまたはsite_access
website_idstringいいえsite_accessキーの場合は必須
リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "create_api_key",
  "arguments": {
    "name": "Staging Key",
    "type": "site_access",
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  }
}
}
レスポンスJSON
{
"api_key": {
  "id": "key_2...",
  "name": "Staging Key",
  "key": "zv_stg_xxxxxxxxxxxxxxxx",
  "type": "site_access",
  "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "created_at": "2026-03-15T10:00:00Z"
},
"message": "Save this key — it will not be shown again."
}

完全なAPIキー値は作成時のみ返されます。安全に保管してください。

52. revoke_api_key

APIキーを取り消し（削除）します。read_write モードが必須です。

コスト: 1 クエリ

パラメータータイプ必須説明
key_idstringはい取り消すAPIキーID
リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "revoke_api_key",
  "arguments": {
    "key_id": "key_2..."
  }
}
}
レスポンスJSON
{
"revoked": true,
"key_id": "key_2...",
"name": "Staging Key"
}

53. get_api_key_details

特定のAPIキーの詳細情報を取得します。

コスト: 1 クエリ

パラメータータイプ必須説明
key_idstringはいAPIキーID
リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "get_api_key_details",
  "arguments": {
    "key_id": "key_1..."
  }
}
}
レスポンスJSON
{
"api_key": {
  "id": "key_1...",
  "name": "Production Key",
  "prefix": "zv_prod_",
  "type": "full_access",
  "mcp_enabled": true,
  "mcp_mode": "read_write",
  "mcp_permissions": {
    "analytics": true,
    "advanced": true,
    "ai_insights": true,
    "management": true,
    "settings": true,
    "api_keys": false,
    "uptime": true
  },
  "created_at": "2026-01-15T10:00:00Z",
  "last_used_at": "2026-03-15T09:30:00Z",
  "total_requests": 1247
}
}

54. update_api_key_permissions

APIキーのMCPパーミッションを更新します。read_write モードが必須です。

コスト: 1 クエリ

パラメータータイプ必須説明
key_idstringはいAPIキーID
mcp_enabledbooleanいいえMCPアクセスを有効または無効
mcp_modestringいいえread_onlyまたはread_write
permissionsobjectいいえ機能グループの切り替え（例：{"analytics": true, "management": false}）
リクエストJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "update_api_key_permissions",
  "arguments": {
    "key_id": "key_1...",
    "mcp_mode": "read_write",
    "permissions": {
      "analytics": true,
      "advanced": true,
      "ai_insights": true,
      "management": true,
      "settings": false
    }
  }
}
}
レスポンスJSON
{
"updated": true,
"key_id": "key_1...",
"mcp_mode": "read_write",
"mcp_permissions": {
  "analytics": true,
  "advanced": true,
  "ai_insights": true,
  "management": true,
  "settings": false
}
}

Uptimeツール

55. list_uptime_monitors

現在のチームのすべてのuptimeモニターをリストアップします。

コスト: 1クエリ

このツールはパラメーターを必要としません。

RequestJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "list_uptime_monitors",
  "arguments": {}
}
}
ResponseJSON
{
"monitors": [
  {
    "id": "mon_1...",
    "url": "https://example.com",
    "name": "Production Site",
    "interval": 300,
    "status": "up",
    "uptime_30d": 99.98,
    "last_checked_at": "2026-03-15T09:55:00Z"
  }
],
"total": 1
}

56. get_uptime_status

特定のモニターの現在のステータスと応答時間を取得します。

コスト: 1クエリ

パラメーター型必須説明
monitor_idstringYesモニターのUUID
RequestJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "get_uptime_status",
  "arguments": {
    "monitor_id": "mon_1..."
  }
}
}
ResponseJSON
{
"monitor": {
  "id": "mon_1...",
  "url": "https://example.com",
  "status": "up",
  "response_time_ms": 142,
  "status_code": 200,
  "uptime_24h": 100.0,
  "uptime_7d": 99.99,
  "uptime_30d": 99.98,
  "last_checked_at": "2026-03-15T09:55:00Z",
  "last_incident_at": "2026-03-10T03:22:00Z"
}
}

57. create_uptime_monitor

新しいuptimeモニターを作成します。read_writeモードが必須です。

コスト: 1クエリ

パラメーター型必須説明
urlstringYesモニター対象のURL
namestringNo表示名（デフォルト：URLのホスト名）
intervalnumberNoチェック間隔（秒単位、デフォルト：300）
RequestJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "create_uptime_monitor",
  "arguments": {
    "url": "https://api.example.com/health",
    "name": "API Health",
    "interval": 60
  }
}
}
ResponseJSON
{
"monitor": {
  "id": "mon_2...",
  "url": "https://api.example.com/health",
  "name": "API Health",
  "interval": 60,
  "status": "pending",
  "created_at": "2026-03-15T10:00:00Z"
}
}

58. delete_uptime_monitor

uptimeモニターを削除します。read_writeモードが必須です。

コスト: 1クエリ

パラメーター型必須説明
monitor_idstringYes削除するモニターのUUID
RequestJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "delete_uptime_monitor",
  "arguments": {
    "monitor_id": "mon_2..."
  }
}
}
ResponseJSON
{
"deleted": true,
"monitor_id": "mon_2..."
}

59. get_uptime_history

モニターのuptime履歴とインシデントログを取得します。

コスト: 1クエリ

パラメーター型必須説明
monitor_idstringYesモニターのUUID
time_rangestringNo時間範囲：24h、7d、30d、90d（デフォルト：30d）
RequestJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "get_uptime_history",
  "arguments": {
    "monitor_id": "mon_1...",
    "time_range": "7d"
  }
}
}
ResponseJSON
{
"monitor_id": "mon_1...",
"uptime_percentage": 99.99,
"total_checks": 2016,
"failed_checks": 1,
"incidents": [
  {
    "id": "inc_1...",
    "started_at": "2026-03-10T03:22:00Z",
    "resolved_at": "2026-03-10T03:27:00Z",
    "duration_seconds": 300,
    "status_code": 503,
    "reason": "Service Unavailable"
  }
],
"avg_response_time_ms": 156
}

Webサイト管理ツール（60-64）

60. update_website_name

Webサイトの表示名を更新します。read_writeモードが必須です。

コスト: 1クエリ

パラメーター型必須説明
website_idstringYesWebサイトのUUID
namestringYes新しい表示名
RequestJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "update_website_name",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "name": "Production Website"
  }
}
}
ResponseJSON
{
"website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"name": "Production Website",
"updated_at": "2026-03-15T10:00:00Z"
}

61. update_website_timezone

Webサイトのタイムゾーンを更新します。日次分析の集計方法に影響します。read_writeモードが必須です。

コスト: 1クエリ

パラメーター型必須説明
website_idstringYesWebサイトのUUID
timezonestringYesIANAタイムゾーン（例：America/New_York、Europe/London）
RequestJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "update_website_timezone",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "timezone": "Europe/London"
  }
}
}
ResponseJSON
{
"website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"timezone": "Europe/London",
"updated_at": "2026-03-15T10:00:00Z"
}

62. update_website_domain

Webサイトのドメインを更新します。read_writeモードが必須です。

コスト: 1クエリ

パラメーター型必須説明
website_idstringYesWebサイトのUUID
domainstringYes新しいドメイン（例：example.com）
RequestJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "update_website_domain",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "domain": "new.example.com"
  }
}
}
ResponseJSON
{
"website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"domain": "new.example.com",
"updated_at": "2026-03-15T10:00:00Z"
}

63. pause_tracking

Webサイトの分析トラッキングを一時停止します。新しいイベントは記録されません。read_writeモードが必須です。

コスト: 1クエリ

パラメーター型必須説明
website_idstringYesWebサイトのUUID
RequestJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "pause_tracking",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  }
}
}
ResponseJSON
{
"website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"tracking_active": false,
"paused_at": "2026-03-15T10:00:00Z"
}

64. resume_tracking

一時停止中のWebサイトの分析トラッキングを再開します。read_writeモードが必須です。

コスト: 1クエリ

パラメーター型必須説明
website_idstringYesWebサイトのUUID
RequestJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "resume_tracking",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  }
}
}
ResponseJSON
{
"website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"tracking_active": true,
"resumed_at": "2026-03-15T10:00:00Z"
}

レポートツール（65-69）

65. schedule_report

定期的な分析レポートをメール経由で送信するようにスケジュール設定します。read_writeモードが必須です。

コスト: 1クエリ

パラメーター型必須説明
website_idstringYesWebサイトのUUID
frequencystringYesdaily、weekly、またはmonthly
recipientsarrayYesメールアドレスのリスト
metricsarrayNo含める特定のメトリクス（デフォルト：すべて）
RequestJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "schedule_report",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "frequency": "weekly",
    "recipients": ["[email protected]", "[email protected]"]
  }
}
}
ResponseJSON
{
"report": {
  "id": "rpt_1...",
  "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "frequency": "weekly",
  "recipients": ["[email protected]", "[email protected]"],
  "next_send_at": "2026-03-22T08:00:00Z",
  "created_at": "2026-03-15T10:00:00Z"
}
}

66. get_report_schedule

Webサイトのスケジュール設定されたレポート設定を取得します。

コスト: 1クエリ

パラメーター型必須説明
website_idstringYesWebサイトのUUID
RequestJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "get_report_schedule",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  }
}
}
ResponseJSON
{
"reports": [
  {
    "id": "rpt_1...",
    "frequency": "weekly",
    "recipients": ["[email protected]", "[email protected]"],
    "next_send_at": "2026-03-22T08:00:00Z",
    "last_sent_at": "2026-03-15T08:00:00Z"
  }
],
"total": 1
}

67. cancel_report

スケジュール設定されたレポートをキャンセルします。read_writeモードが必須です。

コスト: 1クエリ

パラメーター型必須説明
report_idstringYesキャンセルするレポートスケジュールID
RequestJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "cancel_report",
  "arguments": {
    "report_id": "rpt_1..."
  }
}
}
ResponseJSON
{
"cancelled": true,
"report_id": "rpt_1..."
}

68. get_export_history

Webサイトのデータエクスポート履歴を取得します。

コスト: 1クエリ

パラメーター型必須説明
website_idstringYesWebサイトのUUID
limitnumberNo最大結果数（デフォルト：20）
RequestJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "get_export_history",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "limit": 5
  }
}
}
ResponseJSON
{
"exports": [
  {
    "id": "exp_1...",
    "format": "csv",
    "time_range": "30d",
    "status": "completed",
    "file_size_bytes": 245760,
    "created_at": "2026-03-14T15:00:00Z"
  }
],
"total": 1
}

69. get_data_retention

現在のプランに基づいて、Webサイトのデータ保持ポリシーを取得します。

コスト: 1クエリ

パラメーター型必須説明
website_idstringYesWebサイトのUUID
RequestJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "get_data_retention",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  }
}
}
ResponseJSON
{
"website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"plan": "pro",
"analytics_retention_days": 730,
"heatmap_retention_days": 60,
"session_replay_retention_days": 60,
"oldest_data_at": "2024-03-15T00:00:00Z"
}

収益・データツール（70-75）

70. set_revenue_currency

Webサイトのデフォルト収益表示通貨を設定します。ISO 4217通貨コードを使用します。read_writeモードが必須です。

コスト: 1クエリ

パラメーター型必須説明
website_idstringYesWebサイトのUUID
currencystringYesISO 4217通貨コード（例：USD、EUR、GBP、CHF、JPY）
RequestJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "set_revenue_currency",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "currency": "EUR"
  }
}
}
ResponseJSON
{
"website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"currency": "EUR",
"message": "Revenue currency set to EUR"
}

71. get_revenue_settings

設定された通貨とフィールドマッピングを含む、Webサイトの収益関連設定を取得します。

コスト: 1クエリ

パラメーター型必須説明
website_idstringYesWebサイトのUUID
RequestJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "get_revenue_settings",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  }
}
}
ResponseJSON
{
"website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"currency": "EUR",
"revenue_field_mappings": null
}

72. add_allowed_domain

ドメインをCORSホワイトリストに追加します。ホワイトリストに登録されたドメインのみがこのWebサイトにトラッキングデータを送信できます。read_writeモードが必須です。

コスト: 1クエリ

パラメーター型必須説明
website_idstringYesWebサイトのUUID
domainstringYesホワイトリストに登録するドメイン（例：example.com、staging.example.com）
RequestJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "add_allowed_domain",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "domain": "staging.example.com"
  }
}
}
ResponseJSON
{
"website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"domain": "staging.example.com",
"allowed_domains": ["example.com", "staging.example.com"],
"total": 2
}

73. remove_allowed_domain

ドメインをCORSホワイトリストから削除します。read_writeモードが必須です。

コスト: 1クエリ

パラメーター型必須説明
website_idstringYesWebサイトのUUID
domainstringYesホワイトリストから削除するドメイン
RequestJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "remove_allowed_domain",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "domain": "staging.example.com"
  }
}
}
ResponseJSON
{
"website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"removed": "staging.example.com",
"allowed_domains": ["example.com"],
"total": 1
}

74. list_allowed_domains

Webサイトのホワイトリストに登録されているすべてのドメインをリストアップします。

コスト: 1クエリ

パラメーター型必須説明
website_idstringYesWebサイトのUUID
RequestJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "list_allowed_domains",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
  }
}
}
ResponseJSON
{
"website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"allowed_domains": ["example.com", "staging.example.com"],
"total": 2
}

75. request_data_deletion

Webサイトから特定の訪問者のすべてのデータを削除します。GDPR準拠（削除権）に使用されます。このアクションは取り消せません。read_writeモードが必須です。

コスト: 1クエリ

パラメーター型必須説明
website_idstringYesWebサイトのUUID
visitor_idstringYes削除対象の訪問者のUUID
RequestJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "request_data_deletion",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "visitor_id": "vis_abc123..."
  }
}
}
ResponseJSON
{
"message": "Visitor data deleted successfully",
"website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"visitor_id": "vis_abc123...",
"records_deleted": 47,
"deleted_at": "2026-03-15T10:00:00Z"
}

これにより、ページビュー、セッション、イベントを含むすべての訪問者データが永続的に削除されます。この操作は取り消せません。

複数ステップのワークフロー例

これらの例では、一般的なタスクのための完全なリクエスト/レスポンスチェーンを示します。各ステップは上記のJSON-RPC形式を使用しています。

週次トラフィックレポート

典型的なレポートワークフロー：Webサイトを検出してから、訪問者統計、トップページ、トラフィックソースを取得します。

ステップ1 — Webサイトを検出：

RequestJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "list_websites",
  "arguments": {}
}
}
Response (extract website_id)JSON
{
"jsonrpc": "2.0",
"id": 1,
"result": {
  "content": [{
    "type": "text",
    "text": "[{"id": "ws_abc123", "domain": "zenovay.com", "name": "Zenovay"}]"
  }]
}
}

ステップ2 — 訪問者概要を取得：

RequestJSON
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
  "name": "get_visitors",
  "arguments": {
    "website_id": "ws_abc123",
    "time_range": "7d"
  }
}
}

ステップ3 — トップページを取得：

RequestJSON
{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/call",
"params": {
  "name": "get_top_pages",
  "arguments": {
    "website_id": "ws_abc123",
    "time_range": "7d",
    "limit": 10
  }
}
}

ステップ4 — トラフィックソースを取得：

RequestJSON
{
"jsonrpc": "2.0",
"id": 4,
"method": "tools/call",
"params": {
  "name": "get_traffic_sources",
  "arguments": {
    "website_id": "ws_abc123",
    "time_range": "7d"
  }
}
}

合計コスト：4クエリ（1 + 1 + 1 + 1）

パフォーマンス監査

パフォーマンスの問題、エラー、AIの推奨事項を特定します。

ステップ1 — Webサイトをリストアップ（上記と同じ、website_idを取得）

ステップ2 — Core Web Vitalsをチェック：

RequestJSON
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
  "name": "get_performance_metrics",
  "arguments": {
    "website_id": "ws_abc123",
    "time_range": "7d"
  }
}
}

ステップ3 — エラーをチェック：

RequestJSON
{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/call",
"params": {
  "name": "get_errors",
  "arguments": {
    "website_id": "ws_abc123",
    "time_range": "7d",
    "limit": 20
  }
}
}

ステップ4 — AI推奨事項を取得：

RequestJSON
{
"jsonrpc": "2.0",
"id": 4,
"method": "tools/call",
"params": {
  "name": "get_recommendations",
  "arguments": {
    "website_id": "ws_abc123"
  }
}
}

合計コスト：4クエリ（1 + 1 + 1 + 1）

クイックヘルスチェック

残りのクォータと現在のライブ訪問者をすばやくチェック — セッション開始時に最適です。

ステップ1 — 残りのクォータをチェック：

RequestJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "get_api_usage",
  "arguments": {}
}
}

ステップ2 — リアルタイム訪問者をチェック：

RequestJSON
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
  "name": "get_realtime_visitors",
  "arguments": {
    "website_id": "ws_abc123"
  }
}
}

合計コスト：2クエリ（1 + 1）

週単位の比較

今週のメトリクスと先週を比較して、トレンドを特定します。

ステップ1 — Webサイトをリストアップ（website_idを取得）

ステップ2 — 期間を比較：

RequestJSON
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
  "name": "compare_periods",
  "arguments": {
    "website_id": "ws_abc123",
    "current_period": "7d",
    "previous_period": "7d"
  }
}
}

ステップ3 — 異常を検出：

RequestJSON
{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/call",
"params": {
  "name": "get_anomalies",
  "arguments": {
    "website_id": "ws_abc123",
    "time_range": "7d"
  }
}
}

合計コスト：3クエリ（1 + 1 + 1）

Webサイトのセットアップと設定

除外設定とクッキーレストラッキングを使用して新しいWebサイトをセットアップします。

ステップ1 — Webサイトを作成：

RequestJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "create_website",
  "arguments": {
    "domain": "docs.example.com",
    "name": "Documentation"
  }
}
}

ステップ2 — クッキーレストラッキングを有効化：

RequestJSON
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
  "name": "toggle_cookieless_tracking",
  "arguments": {
    "website_id": "NEW_WEBSITE_ID",
    "enabled": true
  }
}
}

ステップ3 — オフィスIPを除外：

RequestJSON
{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/call",
"params": {
  "name": "add_ip_exclusion",
  "arguments": {
    "website_id": "NEW_WEBSITE_ID",
    "ip_address": "203.0.113.0/24",
    "label": "Office network"
  }
}
}

ステップ4 — インストール用のトラッキングコードを取得：

RequestJSON
{
"jsonrpc": "2.0",
"id": 4,
"method": "tools/call",
"params": {
  "name": "get_tracking_code",
  "arguments": {
    "website_id": "NEW_WEBSITE_ID"
  }
}
}

合計コスト：4クエリ（1 + 1 + 1 + 1）

新しいツール

76. get_retention_data

Webサイトが時間経過に伴って訪問者をどの程度保持しているかを示すリテンション コーホート分析を取得します。最初の訪問期間でグループ化されたコーホートデータを返します。

コスト： 1クエリ | 必須： Pro+（retentionAnalysis機能フラグ）

パラメーター型必須デフォルト説明
website_idstringYes—WebサイトのUUID
time_rangestringNo30d時間範囲：7d、30d、90d、1y
cohort_sizestringNoweekコーホートグループ化：day、week、month
RequestJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "get_retention_data",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "time_range": "30d",
    "cohort_size": "week"
  }
}
}
ResponseJSON
{
"cohorts": [
  {
    "period": "2026-02-17",
    "visitors": 320,
    "retention": [100, 42.5, 28.1, 18.4]
  },
  {
    "period": "2026-02-24",
    "visitors": 285,
    "retention": [100, 38.9, 25.3]
  },
  {
    "period": "2026-03-03",
    "visitors": 310,
    "retention": [100, 41.0]
  },
  {
    "period": "2026-03-10",
    "visitors": 295,
    "retention": [100]
  }
],
"cohort_size": "week",
"time_range": "30d",
"summary": {
  "avg_week1_retention": 40.8,
  "avg_week2_retention": 26.7,
  "total_cohort_visitors": 1210
}
}

77. get_user_profiles

訪問者プロファイルをセッション履歴と行動データ付きで取得します。訪問履歴、表示ページ、エンゲージメント メトリクスを含む個別の訪問者レコードを返します。

コスト: 1クエリ

パラメーター型必須デフォルト説明
website_idstringYes—WebサイトのUUID
limitnumberNo20返すプロファイル数（1-50）
country_codestringNo—ISO国コードでフィルタリング（例：US、DE）
min_sessionsnumberNo—セッションの最小数
time_rangestringNo30d時間範囲：7d、30d、90d、1y
RequestJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "get_user_profiles",
  "arguments": {
    "website_id": "2ea8af07-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "min_sessions": 3,
    "limit": 10
  }
}
}
ResponseJSON
{
"profiles": [
  {
    "visitor_id": "v_abc123",
    "first_seen": "2026-02-15T09:30:00Z",
    "last_seen": "2026-03-14T16:45:00Z",
    "total_sessions": 8,
    "total_pageviews": 34,
    "avg_session_duration_ms": 185000,
    "country": "US",
    "city": "San Francisco",
    "device_type": "desktop",
    "browser": "Chrome",
    "os": "macOS",
    "top_pages": ["/", "/pricing", "/docs"],
    "referrer": "google.com"
  }
],
"total": 156
}

JSON-RPCプロトコルリファレンス

すべてのMCPリクエストはJSON-RPC 2.0形式を使用します：

Request envelopeJSON
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "tool_name",
  "arguments": { ... }
}
}

利用可能なメソッド：

メソッド説明
initializeハンドシェイク — サーバー情報と機能を返す
tools/listスキーマ付きのすべてのツールをリストアップ
tools/callツールを実行
pingヘルスチェック

エラーレスポンス形式：

Error responseJSON
{
"jsonrpc": "2.0",
"id": 1,
"error": {
  "code": -32003,
  "message": "Daily query limit exceeded. Upgrade at https://app.zenovay.com/settings"
}
}

完全なエラーコード リファレンスについては、「権限と制限」を参照してください。

このページは役に立ちましたか？