Noibu ツール（エラー分析サービスの機能）の `noibu_*` 系を呼び出すときに必須となる参考情報です。フィールド（データ項目）とメジャー（数値指標）の意味、クエリ（データ検索）の制約条件（`orderBy` の必須指定、行数の上限、単一メジャー原則など）、`rationale`（判断根拠）引数の使用方法、およびドメイン（領域）の解決方法をカバーしています。また、`console.noibu.com` から貼り付けられた URL の解析にも対応しています。 このスキルは、`checkout-analysis`（チェックアウト分析）や `tech-diagnosis`（技術診断）といった個別テーマのNoibuスキルと並行して読み込まれます。それらを置き換えるのではなく、各々が自分の領域のルーティング（問い合わせの振り分け）を担当する形で運用されます。
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. 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が必須です。詳しくは「クエリの制約」を参照。
トップレベルのルーティング：
「コンバージョン率」「〇〇別の売上」「セッションの何%が〇〇した」「平均注文額」
→ 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
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はページ訪問に存在 — これらがパフォーマンス/「遅い」/「反応が悪い」/ユーザー体験品質の質問での主な視点です。これらをエラーツールにルーティングしないでください。
全項目のリファレンスは、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 — ドメイン名で単一ドメインを検索。完全一致のみ。ベア名またはフル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: "ツールを呼び出し中"（何も伝え
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.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 |
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 による自動翻訳です。