`noibu_*` ツール呼び出しの必須リファレンス資料です。フィールド（データの項目）とメジャー（測定値）の意味、クエリ制約（`orderBy`の要件、行数の上限、単一メジャー原則）、`rationale`引数の記述ルール、ドメイン（対象範囲）の解決方法を説明しています。また、`console.noibu.com`から貼り付けたURLの解析も扱います。 このスキルは、関連する特定分野のNoibuスキル（例: `checkout-analysis`、`tech-diagnosis`）と一緒に読み込まれます。それらのスキルの代わりではなく、各自の対象分野のルーティング（情報の振り分け）を担当します。
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は、セッション・ページアクセス・エラーを追跡するECサイト分析プラットフォーム（オンライン小売店の売上・顧客行動を可視化するツール）です。チームがサイトのパフォーマンスとコンバージョン（購入完了）を改善するのに役立ちます。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を確認）
「ページの読み込み速度が遅い / 壊れている / 最もアクセスが多い」「Web バイタル（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の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を使用：
個別ページ・パフォーマンス・UX・グループ単位での「このユーザーは何をしたか」という話題の場合、noibu_get_page_visitsを使用：
Web Vitals（LCP, CLS, INP, FCP, TTFB, FID）とVISUAL_ERROR_COUNTはページアクセス上にあります — これがパフォーマンス / 「遅い」 / 「壊れているように感じる」 / UX品質の質問の主要なレンズです。これらをエラーツールにルーティングしないでください。
全フィールドの詳細はreferences/sessions.mdまたはreferences/page-visits.mdを確認してください。
ほとんどのユーザーはサイトパフォーマンスについてのビジネス質問であり、エラーに関する技術的な質問ではありません。分析で先導してください。
「最大の改善機会は？」 → まずセッションとページアクセスの分析から始める（コンバージョン傾向・カート放棄・流入元パフォーマンス・ページエンゲージメント・デバイス/ブラウザ別分析）。エラーは改善機会の一種ですが、唯一または主要な種類ではありません
「チェックアウトが壊れている？」 → 分析か技術かは不明。まず分析で規模を把握（すべてのユーザーか特定セグメントか、いつから？）。その後、特定エラーを掘り下げるか、データパターン探索を継続するかをユーザーに確認
「サイトのパフォーマンスは？」 → 分析から（セッション、ページアクセス、時系列）
「どんなエラーが起こっている？」 → これは明示的に技術的な質問。references/errors.mdを確認
パターン：分析ツールが問題の規模と形状を示し、エラーツールが根本原因を説明します。ユーザーが明示的にエラー・バグ・特定エラーについて質問した場合を除き、常に分析で始めてください。不確実な場合は、ユーザーがデータ探索か特定エラー調査かどちらを望んでいるか確認してください。
noibu_get_domainとnoibu_list_domainsをスキップnoibu_get_domainを呼び出して解決noibu_get_domainがマッチなし、またはエラーの場合、noibu_list_domainsにフォールバックnoibu_get_domain — ドメイン名で単一ドメインを検索。完全一致のみ。ベアドメイン名またはフルURLを受け入れ、www.・スキーム・パス・クエリ・フラグメント・末尾ドットを許容します。タイポは自動解決されません — マッチしない場合、NotFoundエラーが返り、errors[0].extensions.suggestionsに最大3件の近い許可ドメイン名が表示されます。これらをユーザーに見せ、選択させてください。推奨を無断で置き換えないこと。提案が空の場合はnoibu_list_domainsにフォールバック
noibu_list_domains — ユーザーがアクセスできるドメインのリスト。ドメインUUIDまたは名前がない場合、またはnoibu_get_domainがマッチしない場合のフォールバックとして呼び出し
rationale引数すべてのnoibu_*ツールがrationale引数を受け入れます。常に記入してください。 ユーザーの視点から、ツールを今すぐ呼び出す理由を1文で説明するものです。
rationale: "ユーザーがモバイルでのチェックアウトCTAのコンバージョン効果を知りたいため、/checkoutのクリックマップを取得"rationale: "カート放棄スパイクの詳細追跡 — ユーザーが離脱する箇所を見つけるためページアクセスを取得"rationale: "ツールを呼び出し"（説明になっていない）rationale: "データ取得のため"（説明になっていない）Noibuエンジニアはチャットを見ることができません。ratonaleは、実際にユーザーが何をしようとしているかを理解する唯一の信号です。ユーザーの質問に固有の内容にしてください。呼び出しは記入なしでも成功しますが、毎回記入してください。
noibu_search_sessionsは最大100行、noibu_get_page_visitsは最大1500行を返すorderByは必須。queryInput内にmeasures/groupBy/filters/limitと共に配置。なければ行数上限が任意の行を返し、集計が無言に間違う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_search_sessions grouped by UTM_SOURCE / UTM_MEDIUM. If the channel
the user named has NO utm rows, do NOT report it absent: paid clicks usually
carry gclid / gad_ instead of utm tags. Switch to
noibu_get_page_visits and filter REFERRING_URL CONTAINS "gclid",
counting UNIQ(SESSION_ID) — see Recovering URL parameters.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/ab-tests.md (noibu_list_ab_tests,
noibu_get_ab_test_results).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.
Never tell the user a metric is zero, missing, or "not tracked" until you have checked both of these. Reporting absence prematurely is the most common way these tools give a confidently wrong answer.
URL, LANDING_URL and EXIT_URL
are query-stripped at ingest, but REFERRING_URL is not. Ad clicks (gclid,
gad_), on-site search terms (search?q=) and order IDs survive there.
See Recovering URL parameters.noibu_get_company to list the
company's other domains. Storefront and checkout are frequently separate Noibu
domains, and completed orders often exist only on the checkout domain — a
storefront-only query makes conversion look broken when it is not.Prefer "at least N, and here is why it undercounts" over "no data".
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.
Check sibling domains before reporting missing data. A company often runs its
storefront and checkout as separate Noibu domains (e.g. www.example.com and
checkout.example.com), and the orders may exist only on the sibling. Before telling
the user a metric is zero or "not tracked", call noibu_get_company to enumerate the
company's domains and check the relevant one. Sessions do not stitch across domains,
so acquisition source and completed orders can sit in two disconnected datasets.
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.URL, LANDING_URL and EXIT_URL have their query string and fragment stripped at
ingest. REFERRING_URL does not — it is stored absolute and verbatim, so it is the
only field that still carries URL parameters.
To recover a parameter, filter page visits on REFERRING_URL CONTAINS "<param>":
Always run this on noibu_get_page_visits, never noibu_search_sessions. A
session's REFERRING_URL is only its landing referrer, which browsers strip of query
params cross-origin. The parameters survive on internal referrers — the ad landing
page pointing at the next page — which exist only per page visit. Routing this to the
sessions tool undercounts by roughly 20x (779 vs 15,642 sessions on one real domain).
gclid or gad_. Google Ads auto-tagging adds these even when
UTM tags are absent, so a domain with no utm_source=google can still be measured.search?q= or search?term=.
Discover the pattern first by grouping referrers that contain ?.Caveat: REFERRING_URL is populated on landing visits too, but browsers strip the query
string on cross-origin navigation, so parameters in practice only survive on same-origin
(internal) referrers — a visit that follows an earlier visit on the site. A bounced
single-page session has a referrer but no recoverable parameters. Treat any count derived
from this as a floor and say so. Some values are masked (e.g. email=******). Grouping by
REFERRING_URL returns raw URLs, so normalise case, &page=N and percent-encoding
before ranking.
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 |
| AB tests / experiments (test roster and config, which variation is winning, verdicts, guardrail health checks, comparing arms) | references/ab-tests.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 による自動翻訳です。