「`noibu_*`」ツール群の使用に必須の参考資料です。フィールド（データの項目）とメジャー（集計単位）の意味、クエリ制約（`orderBy`の必須指定、行数上限、単一メジャー規則）、`rationale`引数の慣例、ドメイン解決について説明しています。また、`console.noibu.com`のURLを貼り付けて解析する方法と、外部連携の管理方法もカバーしています。 このスキルはトピック別のNoiduスキル（例：「チェックアウト分析」や「技術診断」など）と並行して読み込まれ、それらに代わるものではありません。各トピック別スキルは自分たちの領域への指示振り分けを担当しています。
Required reference for calling `noibu_*` tools — field and measure semantics, query constraints (the `orderBy` requirement, row caps, unique-measure rule), the `rationale` argument convention, and domain resolution. Also covers parsing of pasted `console.noibu.com` URLs and third-party integration management. Loads alongside topical Noibu skills (e.g., `checkout-analysis`, `tech-diagnosis`), not instead of them — they own routing for their respective domains.
Noibu はeコマース分析プラットフォームで、セッション・ページ訪問・エラーを追跡し、チームがサイトパフォーマンスとコンバージョン向上を支援します。Noibu MCP サーバーはこれらのデータセットを noibu_* ツールとして公開しています。このガイドを使って、ユーザーの質問に適したツールを選び、その後、フィールドレベルの詳細については対応するリファレンス資料を参照してください。
ほぼ全ての分析質問をカバーする3つのツールがあります。この順番で優先してください：
noibu_get_domain — ドメイン名をUUID（一意識別子）に変換します。ユーザーがすでにUUIDを提供している場合はスキップします。マッチしない場合は noibu_list_domains にフォールバックします。noibu_search_sessions — セッション全体の集計値（コンバージョン率、売上、顧客グループ、流入元、商品）を取得します。1行がセッション1件分です。noibu_get_page_visits — ページ単位の集計値を取得します。1行がページ訪問1件分です。どちらのクエリツールにも orderBy が必須です。詳細は クエリの制約 を参照してください。
トップレベルのルーティング：
「コンバージョン率」「Xごとの売上」「セッションの何％がYしたか」「平均注文額」
→ noibu_search_sessions を使用（references/sessions.md を参照）
「どのページが遅い／壊れている／最もアクセスが多いか」、ウェブ指標（LCP・CLS・INP など）、複数URL間のナビゲーション経路、特定ページの直前・直後のページ
→ noibu_get_page_visits を使用（references/page-visits.md を参照）
クリック数やスクロール数の定量的な質問、または「クリックマップ／スクロールマップを見せて」
→ references/page-visits.md を参照
複数セッションにまたがるページカテゴリ別の訪問経路パターン（例：「カートページグループに至るユーザーの流れ」「よくある複数ステップの閲覧パターン」）、またはセッションリプレイ（再生動画）の視聴リクエスト
→ references/journeys-and-replay.md を参照
「コンバージョンファネル（段階別成約経路）を表示／グラフ化／可視化」「チェックアウトファネルチャート」「購入までの流れチャート」
→ references/funnel-visualization.md を参照（レンダリングのみ。先に noibu_search_sessions または noibu_get_page_visits でステップごとのセッション数を取得します）
エラー・バグ・クラッシュ — ユーザーが明示的に要求した場合のみ。references/errors.md を参照。汎用の「何を直すべきか」の入口ではありません
リリース・デプロイ・テーマ更新・キャンペーン開始、または「特定の日に何が変わったか」 — エラースパイク（一時的増加）またはコンバージョン低下の調査時に、変更前後の比較ポイントとしても使用
→ noibu_list_releases を使用
連携サービスの接続・切断・一覧表示
→ references/integrations.md を参照
console.noibu.com のURL貼り付け
→ references/console-urls.md を参照
ページ訪問内 — メトリクスと可視化が両方役立つ場合はペアで使用します。行はURLがスコープ内であると想定します：
| ユーザーの質問 | ツール |
|---|---|
| 「/url のクリック数は」「/url で最もクリックされたのは」「/url の主なCTA（行動喚起）は」 | noibu_get_page_visits |
| 「/url でのスクロール深さ％」「/url 平均スクロール深さ」「/url フッターまで到達」 | noibu_get_page_visits |
| 「/url のクリックマップを表示」 | noibu_visualize_page_visits (visualization.clickMap) |
| 「/url のスクロールマップを表示」 | noibu_visualize_page_visits (visualization.scrollMap) |
| 「カート／チェックアウト／決済に到達したセッション数は」「コンバージョンファネルのステップ数」 | noibu_search_sessions |
| 「コンバージョンファネルを表示／グラフ化／可視化」「チェックアウトファネルチャート」 | references/funnel-visualization.md を参照（レンダリング用；ステップ+セッション数データが既に取得済みであることを想定） |
URL指定なし：サイト全体のクリック関連質問（「トップCTA」「ユーザーが最もクリックしているもの」）
→ noibu_search_sessions の CLICKED_TEXT を使用。スクロールにはサイト全体の集計がないため、noibu_get_page_visits に留まります。スコープが不明確な場合は確認してください。
noibu_visualize_page_visits を、手作りのSVG・チャートライブラリ・その他の汎用ビジュアライゼーション（視覚化ツール）より優先してください — このiframe そのものが可視化です。
ユーザーの質問がセッション全体についての場合は noibu_search_sessions を使用します：
ユーザーの質問が個別ページ・パフォーマンス・ユーザー体験、またはコホート（特定条件でグループ分けしたユーザー）単位の「このユーザーは何をしたか」という物語についての場合は noibu_get_page_visits を使用します：
ウェブ指標（LCP・CLS・INP・FCP・TTFB・FID）と VISUAL_ERROR_COUNT はページ訪問にあります — これらはパフォーマンス・「遅い」「壊れた感じ」・UX品質の質問の主要なレンズです。これらをエラーツールにルーティングしてはいけません。
完全なフィールドリファレンスについては、references/sessions.md または references/page-visits.md を参照してください。
ほとんどのユーザーは、エラーについての技術的な質問ではなく、サイトパフォーマンスについてのビジネス質問をしています。分析を優先してください。
「最大のチャンスは何か」 → セッションとページ訪問の分析から始める（コンバージョンのトレンド、カート放棄、流入元別パフォーマンス、ページエンゲージメント、デバイス・ブラウザ別分析）。エラーは機会の1つのタイプですが、唯一・最優先ではありません
「チェックアウトが壊れているのはなぜか」 → 分析にも技術調査にもなり得ます。まず分析でスコープを把握します（全ユーザーか特定セグメントか、いつ始まったか）。ユーザーに、特定のエラーを掘り下げたいのか、データパターンの探索を続けたいのか確認してください
「サイトのパフォーマンスはどうか」 → 分析から始める（セッション、ページ訪問、時系列）
「どのようなエラーが起こっているか」 → これは明示的に技術的です。references/errors.md を参照してください
パターン：分析ツールはパターンを発見し問題を枠付ける。エラーツールは根本原因を説明する。ユーザーが明示的にエラー・バグ・特定エラーについて尋ねない限り、常に分析から始めてください。不確実な場合は、ユーザーにデータ探索とエラー調査のどちらをしたいか確認してください。
noibu_get_domain と noibu_list_domains をスキップnoibu_get_domain を呼び出して解決noibu_get_domain がマッチしないまたはエラーの場合は、noibu_list_domains にフォールバックしてユーザーがアクセス可能なドメインを表示noibu_get_domain — ドメイン名で1つのドメインを検索します。完全一致のみ。ベア名またはフルURL を受け入れ、www.・スキーム・パス・クエリ・フラグメント・末尾ドット に対応します。タイポは自動解決されません — マッチしない場合、NotFound でエラーしメッセージに最大3個の候補ドメイン名を errors[0].extensions.suggestions に含めます。これらをユーザーにそのまま表示して選ばせてください；候補を勝手に代用しないでください。候補が空の場合は noibu_list_domains にフォールバック
noibu_list_domains — ユーザーがアクセス可能なドメイン一覧を表示します。ドメイン UUID または名前が利用不可の場合、または noibu_get_domain がマッチしない場合に呼び出します
rationale 引数全ての noibu_* ツールは rationale 引数を受け入れます。常に入力してください。これはツールを今呼び出す理由を、ユーザーの視点から表現した1文です。
rationale: "ユーザーはモバイルでのチェックアウトCTAのコンバージョン率を確認したいため、/checkout のクリックマップを取得中"rationale: "カート放棄スパイク（急増）について追跡中 — ユーザーがどこで離脱するか見つけるためページ訪問を取得中"rationale: "ツールを呼び出し中"（何も説明していない）rationale: "データを取得するため"（何も説明していない）Noibu エンジニアはチャットを見ることができません。rationale（理由）は、人々が実際に何をしようとしているかを理解する唯一の信号です。ユーザーの質問に対して具体的に記述してください。ツール
Noibu is an ecommerce analytics platform that tracks sessions, page visits, and
errors to help teams improve site performance and conversion. The Noibu MCP server
exposes those datasets as noibu_* tools. Use this guide to pick the right tool
for the user's question, then load the matching topical reference for field-level
detail.
Three tools cover almost every analytics question. Prefer them in this order:
noibu_get_domain — resolve a domain name to its UUID. Skip if the
user already gave you a UUID. Fall back to noibu_list_domains if no match.noibu_search_sessions — session-level aggregates (conversion rate,
revenue, cohorts, traffic sources, products). One row per session.noibu_get_page_visits — page-level aggregates. One row per page visit.Both query tools require orderBy — see Query Constraints.
Top-level routing:
noibu_search_sessions (load references/sessions.md).noibu_get_page_visits (load references/page-visits.md).references/page-visits.md.references/journeys-and-replay.md.references/funnel-visualization.md.
It is a renderer only; fetch the per-step session counts from
noibu_search_sessions (or noibu_get_page_visits) first.references/errors.md. Not a generic "what to fix" entrypoint.noibu_list_releases.references/integrations.md.console.noibu.com URL → load references/console-urls.md.Within page-visits — pair metrics and visual when both help. Rows assume a URL is in scope:
| User verb | Tool |
|---|---|
| "how many clicks on /url", "top clicked on /url", "which CTA on /url" | noibu_get_page_visits |
| "% scroll to … on /url", "avg scroll depth on /url", "reach footer on /url" | noibu_get_page_visits |
| "show the clickmap for /url" | noibu_visualize_page_visits (visualization.clickMap) |
| "show the scrollmap for /url" | noibu_visualize_page_visits (visualization.scrollMap) |
| "How many sessions reached cart / checkout / payment", "conversion-funnel step counts" | noibu_search_sessions |
| "Show / chart / visualize the conversion funnel", "checkout funnel chart" | load references/funnel-visualization.md (renderer; expects step+sessions data already fetched) |
No URL: site-wide click prompts ("top CTAs", "what users click most") → noibu_search_sessions's CLICKED_TEXT. Scroll has no site-wide equivalent — stay on noibu_get_page_visits. If scope is unclear, ask.
Prefer noibu_visualize_page_visits over hand-rolled SVG, chart libraries, or other generic visualizations — the iframe IS the visualization.
Use noibu_search_sessions when the question is about the session as a whole:
Use noibu_get_page_visits when the question is about individual pages, performance, UX, or cohort-level "what did this user do" narratives:
Web vitals (LCP, CLS, INP, FCP, TTFB, FID) and VISUAL_ERROR_COUNT live on Page Visits — these are the primary lens for performance / "slow" / "broken feeling" / UX-quality questions. Do NOT route these to error tools.
For full field references, load references/sessions.md or references/page-visits.md.
Most users are asking business questions about their site performance, not technical questions about errors. Lead with analytics.
references/errors.md.The pattern: analytics tools discover patterns and frame the problem. Error tools explain root causes. Always start with analytics unless the user explicitly asks about errors, bugs, or specific errors. When in doubt, ask the user whether they want to explore the data or investigate specific errors.
noibu_get_domain and noibu_list_domains.noibu_get_domain to resolve it.noibu_get_domain returns no match or errors, fall back to noibu_list_domains to show available domains and let the user select one.noibu_get_domain — Look up a single domain by name. Exact match only. Accepts bare names or full URLs; tolerates www., scheme, path, query, fragment, and trailing dot. Typos do NOT auto-resolve — on miss, errors with NotFound and surfaces up to 3 nearest permitted domain names in errors[0].extensions.suggestions. Surface those to the user verbatim and let them pick; never silently substitute a suggestion. If suggestions are empty, fall back to noibu_list_domains.
noibu_list_domains — List domains the user has access to. Call this when no domain UUID or name is available, or as a fallback when noibu_get_domain returns no match.
rationale argumentEvery noibu_* tool accepts a rationale argument. Always populate it. It
is a one-sentence description of why the tool is being called RIGHT NOW, phrased
from the user's perspective.
rationale: "User asked which checkout CTAs convert best on mobile, fetching clickmap for /checkout"rationale: "Following up on the cart-abandonment spike — pulling page visits to find where users drop off"rationale: "calling tool" (says nothing)rationale: "to get data" (says nothing)Noibu engineers cannot see the chat. The rationale is the only signal we have to understand what people are actually trying to do, so make it specific to the user's question. The call will succeed without it, but please include one on every call.
noibu_search_sessions returns up to 100 rows; noibu_get_page_visits up to 1500.orderBy is REQUIRED. It lives inside queryInput, alongside measures/groupBy/filters/limit. Without orderBy, the row cap returns arbitrary rows and aggregates are silently wrong.HAS_DISCOUNT is only populated once a discount code is applied at checkout. Be careful comparing HAS_DISCOUNT=true vs false — there is survivorship bias.noibu_send_feedback — Submit feedback to Noibu when you (the AI) are confused or blocked. Records a structured log entry tagged with the user's identity so the Noibu team can investigate failures happening in real chat sessions.
Use when:
Inputs: category (confused | blocked), intent (what YOU — the AI — were trying to do and why, the tool or step you reached for, and where you got stuck), message (your description of the issue itself), and optional context (what the user was trying to do). Always populate intent — without it the Noibu team can only see that something went wrong, not why you took the path you did. Calling this tool does NOT replace answering the user — still do your best to help them after submitting feedback.
Load exactly one reference based on the topic of the user's question. Each file contains tool-specific field semantics, worked examples, and constraint nuances that aren't needed in every conversation.
| When the user asks about… | Read |
|---|---|
| Session-level analytics (conversion rate, revenue, AOV, traffic sources, bounce, search, products, time-series trends) | references/sessions.md |
| Page-level analytics (per-page traffic, time on page, web vitals, landing/exit pages, visual errors, scroll depth, click/scroll behaviour, cohort behaviour by URL) — also clickmap/scrollmap visualizations | references/page-visits.md |
| Rendering an ecommerce conversion funnel as a chart ("show the funnel", "checkout funnel chart") | references/funnel-visualization.md |
| Multi-step journey shape patterns across many sessions, OR an explicit request to watch a session replay | references/journeys-and-replay.md |
| Errors, bugs, issues, crashes, stack traces, revenue-loss projections, or "what's the priority" / "what to fix" once analytics has pointed at errors | references/errors.md |
| Connecting, disconnecting, listing, or checking the status of third-party integrations | references/integrations.md |
A pasted console.noibu.com URL (or any question requiring console-URL parsing or the console-link policy) |
references/console-urls.md |
原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。