メインコンテンツへスキップ
目的からコマンドを選びます。名前を選ぶと、引数と例を確認できます。 書式の読み方: <値> は自分の値に置き換えます。[ ] で囲んだ項目は省略できます。真偽値は --flag または --no-flag で指定します。値の配列は、--tables summary --tables table のように、フラグを繰り返して渡します。JSON の例は bash 向けの書き方です。Windows では、JSON ファイルを --input で渡すこともできます。 サインインや接続に関するコマンドは、それぞれのページにあります。サインイン(login、logout、status)、API キー(token)、このページのコマンドを調べる(tools list、tools describe)です。expl server skill は、AI エージェント向けの説明を SKILL.md の形で出力します。

書式とフラグの一覧

探す・読む

データ

チャートとアナリティクス

接続と管理

コマンドを調べる

サーバーが提供しているコマンドと、そのフラグを調べます。

一覧を表示する

コマンドの一覧は、そのつどサーバーから取得します。サーバーに新しい操作が増えても、expl の新しいバージョンは要りません。サーバーに接続できないときや、サインインしていないときは、前回保存した一覧を表示します。保存がないときは、空の一覧になります。 tools list が終了コード 0 で終わっても、接続できているとは限りません。接続は、expl server status で確認します。

1 つのコマンドを調べる

<command> は、一覧に出たコマンドの名前に置き換えます。2 語のコマンドは、expl server tools describe "chart get-data" のように引用符で囲みます。chart_get_data のような道具名でも指定できます。 コマンドの説明と、使えるフラグが表示されます。コマンド名を推測せず、ここで確認してください。

コマンドの形

search と fetch には、動詞を付けません。expl server search <query>、expl server fetch <id> の形で使用します。ほかのコマンドは、expl server dataset query のように、名詞と動詞を続けます。 それぞれのコマンドには、その裏にある道具の名前があります。MCP クライアントから見える名前です。expl server call <tool_name> は、その名前でコマンドを実行します。例: expl server call dataframe_preview <id> 全コマンドの書式とフラグは、書式とフラグの一覧を参照してください。 閲覧できるコンテンツを、タイトル、説明、タグで探します。検索語がなければ、新しい順に一覧します。

書式

[ ] は省略できる指定、< > は自分の値に置き換える部分です。フラグは — で始まる追加の指定です。

引数とフラグ

例

言葉で探す

ターミナル
結果の先頭の数行です。説明は省略しています。 実行結果

自分のコンテンツを一覧する

ターミナル
自分のコンテンツを、新しい順に最大 50 件出します。 結果は先頭の 2 件に省略しています。 実行結果

出力と上限

結果には、コンテンツの id と URL が入ります。id は、fetch などほかのコマンドに渡します。データのコンテンツには、列の名前と型、行数も入ります。既定では人が読みやすい形で、--json を付けると JSON になります。 結果の has_more が true のときは、next_offset の値を --offset に渡すと、次のページを取得できます。

トラブルシューティング

関連: expl server fetch、expl server dataframe get-schema

expl server fetch

id を指定して、ノート、ダッシュボード、スライド、データを 1 件読みます。

書式

[ ] は省略できる指定、< > は自分の値に置き換える部分です。フラグは — で始まる追加の指定です。

引数とフラグ

例

ノートを読む

ターミナル
<id> は、検索結果に表示された id に置き換えます。 実行結果は、id が wX2yZ3aB4c のノート(Sales Orders Overview)で実行したものです。長い出力は省略しています。 実行結果

見出しを 1 つだけ読む

ターミナル
s2 は、metadata.toc にある見出しの id に置き換えます。 同じノートの見出し s2(Sales by region)だけを返した結果です。このノートは短いため metadata.toc が返らず、見出し id の s2 は、下の --query の結果から取りました。 実行結果

話題を探す

ターミナル
どれかの語を含む段落を返します。 同じノートに --query "region" を付けて実行した結果です。条件に合う段落が、角かっこの中の見出しの id と見出しの経路とともに返ります。 実行結果

出力と上限

ノート、ダッシュボード、スライドは、本文、埋め込まれた各チャートの先頭の行、各アナリティクスの説明を Markdown で返します。metadata.charts と metadata.blocks に、チャートやアナリティクスの名前が入ります。データは、列、行数、サンプルの行、更新状況が入ります。 長いノートは、--query で話題を探すか、--section で見出しを 1 つ指定して読みます。続きがあるときは、metadata.range.next_cursor の値を --cursor に渡します。metadata.truncated は、続きがあるときだけ含まれます。

トラブルシューティング

関連: expl server search、expl server chart get-data、expl server analytics get-result

expl server dataframe get-schema

データの列の名前と型、公開した人が書いた説明、行数を調べます。

書式

[ ] は省略できる指定、< > は自分の値に置き換える部分です。フラグは — で始まる追加の指定です。

引数とフラグ

例

列の名前と型だけを調べる

ターミナル
<id> は、データの id に置き換えます。 実行結果は、データ Sales Orders(id が hI6jK7lM8n)で実行したものです。長い出力は省略しています。 実行結果

詳しく調べる

ターミナル
同じデータで実行した結果です。統計量、セマンティクス、クエリで使える演算子の一覧は省略しています。 実行結果

出力と上限

列の名前、型、行数が入ります。full では、公開した人が書いた説明、欠損値と固有値の数、最小値と最大値、よく出る値、更新状況(最後に更新された時刻と、新しいかどうか)も入ります。所有者が承認していれば、セマンティクス(1 行の意味、列の役割、既定の集計方法、集計のルール)も入ります。セマンティクスは公式の定義なので、集計の前に読んでください。 ページ送りはありません。

トラブルシューティング

関連: expl server dataframe preview、expl server dataset query

expl server dataframe preview

データの行を、offset と limit でページに分けて取得します。

書式

[ ] は省略できる指定、< > は自分の値に置き換える部分です。フラグは — で始まる追加の指定です。

引数とフラグ

例

先頭の 3 行を表示する

ターミナル
<id> は、データの id に置き換えます。 実行結果は、データ Sales Orders(id が hI6jK7lM8n)で実行したものです。長い出力は省略しています。 実行結果

101〜200行目を取得する

ターミナル
結果は、100 行のうち先頭の 2 行に省略しています。 実行結果

出力と上限

公開した人がすべてのデータを含めて公開したときは、すべての行を読めます。そうでないときは、公開したときに保存したサンプルの行です。is_sample と row_count で確かめます。合計や絞り込みが目的なら、すべてのページを読まずに dataset query を使います。 offset に、すでに読んだ行数を渡すと、続きを読めます。1 回に取得できるのは 100 行までです。

トラブルシューティング

関連: expl server dataframe get-schema、expl server dataset query

expl server dataset query

データをサーバーで絞り込み、集計して、結果だけを返します。列の名前は、search か dataframe get-schema で確認します。

書式

[ ] は省略できる指定、< > は自分の値に置き換える部分です。フラグは — で始まる追加の指定です。

引数とフラグ

JSON の引数の書き方

以下は JSON の入力書式です。< > の部分をデータの id、列名、値に置き換えます。実行結果ではありません。コマンドの単引用符を使う例は bash 形式です。PowerShell や cmd では、引用符の書き方が bash と異なり、単引用符を使う例はそのまま動かないことがあります。その場合は、JSON をファイルに保存して、--input で渡してください。

条件を指定する: filters

JSON
column は列名、operator は比較方法、value は比較する値です。結合後の列は column に alias と column を持つオブジェクトで指定します。

結合するデータ: datasets

JSON

結合条件: joins

JSON
結合では dataset_id の代わりに datasets を渡します。左右の alias は datasets の指定と合わせ、on には対応する列名を指定します。キーが両側で重複すると行が増えるため、集計前にキーを確認してください。

例

地域ごとの行数を数える

ターミナル
<dataset_id> は対象のデータの id、region は実際の列の名前に置き換えます。JSON は、全体を単引用符(‘)で囲みます。 実行結果 Sales Orders のデータ(id: hI6jK7lM8n)で実行した結果です。長い項目は省略して、見やすく整えています。
件数の多い順に 5 地域が返りました。上限(--limit 5)で切ったので、result.has_more が true になり、RESULT_TRUNCATED の警告が付いています。残りの地域も見るときは、--limit を増やすか、条件で絞り込みます。

全体の行数を数える

ターミナル
dimensions を省くと、全体の 1 行が返ります。 実行結果 Sales Orders のデータ(id: hI6jK7lM8n)で実行した結果です。長い項目は省略して、見やすく整えています。
全体の行数は 23,131 行でした。

出力と上限

結果は正確で、データのバージョン(dataset.version)と更新時刻(dataset.updated_at)が付きます。どのバージョンのデータで計算したかを、数値といっしょに伝えてください。結合したときは、元のデータ、出力の列の出どころ、結合の前後の行数も付きます。 ページ送りはありません。結果の has_more が true のときは、絞り込むか、集計します。多くの行がほしいときは、dataframe export でファイルにします。

トラブルシューティング

関連: expl server dataframe get-schema、expl server dataframe export

expl server dataframe export

データへの問い合わせの結果を、CSV か Parquet のファイルにして、ダウンロードリンクを返します。

書式

[ ] は省略できる指定、< > は自分の値に置き換える部分です。フラグは — で始まる追加の指定です。

引数とフラグ

JSON の引数

filters、metrics、sort の JSON の形は、dataset query の説明を参照してください。

例

行をファイルにする

ターミナル
<dataset_id> は、データの id に置き換えます。公開した人がファイルとしての取得を許していないデータでは、DATA_EGRESS_LIMIT で失敗します。 実行結果は、データ Sales Orders(id が hI6jK7lM8n)で実行したものです。download_url はファイルへのリンクです(ここでは省略しています)。expires_at の時刻に無効になります。 実行結果

出力と上限

15 分で切れるダウンロードリンクが返ります。リンクを使えるのは、サインインしている本人だけです。ファイルの保存先は --output で指定できます。 ページ送りはありません。結果が大きすぎて dataset query で読めないときに、このコマンドを使います。

トラブルシューティング

関連: expl server dataset query、expl server dataframe preview

expl server dataframe get-wrangling

公開されたデータがどのように作られたかを調べます。データ加工のステップを順番に、読み込んだデータと結合したデータ、列ごとにどのステップが作ったか、変えたかを返します。

書式

[ ] は省略できる指定、< > は自分の値に置き換える部分です。フラグは — で始まる追加の指定です。

引数とフラグ

例

概要を見る

ターミナル
<id> は、データの id に置き換えます。

1 つの列を作ったステップを見る

ターミナル
order_date は、最終的なデータの列の名前に置き換えます。

出力と上限

--steps も --column も付けないと、結果は概要です。概要には、全体の説明、すべてのステップを順に 1 行ずつ(種類、ラベル、何をするか)、読み込んだデータと結合したデータ、列ごとにどのステップが作ったか、変えたかの索引が入ります。ステップを詳しく見るには(完全な説明、式、フィルターの条件や結合のキーなどの設定)、--steps(概要に出る ref)か --column を付けて、もう一度実行します。ref は、データの今のバージョンでだけ有効です。 全体の説明は AI が書いたもので、人は確認していません。引用するときは、そのことを伝えてください。所有者が承認した加工の説明は、dataframe get-schema のセマンティクスで読みます。 1 回の結果に収まらない概要は、--cursor で続きを取得します。ステップを読めないときは、結果にその理由が入ります。データを公開したときに記録されていなかった、所有者が共有していない、公開した人がデータの行を共有していない、のいずれかです。

トラブルシューティング

関連: expl server dataframe get-schema、expl server dataset query

expl server chart get-data

チャートのデータを、数値の意味とあわせて取得します。

書式

[ ] は省略できる指定、< > は自分の値に置き換える部分です。フラグは — で始まる追加の指定です。

引数とフラグ

例

チャートの先頭の 5 行を取得する

ターミナル
<id> はノートなどの id、<chart> は fetch の結果にあるチャートの名前に置き換えます。 実行結果は、ダッシュボード Sales Orders Dashboard(id が pQ9rS0tU1v)のチャート kL8mN9oP(Sales by Region)で実行したものです。長い出力は省略しています。 実行結果

出力と上限

チャートの行に加えて、数値の意味が付きます。chart.encoding(棚ごとの列、集計方法、数値の形式)、chart.filters、chart.data_granularity(集計済みか、行ごとか)、chart.unsupported(返せないもの)、context(公開時点、データの時点、パラメーターの値)です。数値は公開されたときの値で、ブラウザでパラメーターを変えた結果は取れません。チャート単体で公開したものは、集計値でもチャート全体の値でもなく、描画に使ったデータの先頭 100 行なので、足し合わせて合計にしないでください。 offset に、すでに読んだ行数を渡すと、続きを読めます。1 回に取得できるのは 100 行までです。

トラブルシューティング

関連: expl server chart query、expl server chart get-image

expl server chart get-image

チャートの画像(PNG)を取得します。形、傾向、配置を確認するための機能です。

書式

[ ] は省略できる指定、< > は自分の値に置き換える部分です。フラグは — で始まる追加の指定です。

引数とフラグ

例

チャートの画像を取得する

ターミナル
<id> はノートなどの id、<chart> は fetch の結果にあるチャートの名前に置き換えます。 出力の形を示す例で、値は説明用です。ダッシュボード pQ9rS0tU1v のチャート qR0sT1uV(Monthly Sales Trend)の例です。画像の保存先を示す image_path の行は省略しています。公開時に画像が保存されていないチャートは、NOT_FOUND(“This chart has no stored image”)になります。その場合は chart get-data を使います。 実行結果

出力と上限

画像は、公開したときに保存されたもので、描き直されません。そのため、データより古いことがあります。結果の result.image.may_be_stale で確かめます。画像は、expl を動かしているコンピューターに保存され、結果の image_path がその場所を示します。保存先は --output で指定できます。正確な数値は、画像ではなく chart get-data で読みます。 ページ送りはありません。

トラブルシューティング

関連: expl server chart get-data

expl server analytics get-result

アナリティクス(回帰、相関、カイ二乗検定など)の結果を、プログラムで扱える形式のデータで取得します。

書式

[ ] は省略できる指定、< > は自分の値に置き換える部分です。フラグは — で始まる追加の指定です。

引数とフラグ

例

アナリティクスの結果を取得する

ターミナル
<id> はノートなどの id、<analytics> は fetch の結果にあるアナリティクスの名前に置き換えます。 実行結果は、単独で公開されているアナリティクス Analytics 1 - Correlations(id が Analytics-1-Correlations-aB1cD2eF)で実行したものです。単独で公開されているため、--analytics は指定していません。長い出力は省略しています。この例では、説明文は空にしています。 実行結果

出力と上限

モデルの定義(目的変数、説明変数、N)、安定した列 id を持つ結果の表、学習用とテスト用に分けた主要な統計量、実行したときの設定、説明の文が入ります。説明の文には、数値から作ったものか、AI が作ったものかの印が付きます。数値は表示されたとおりの桁で、係数は標準化されていません。 表ごとの行数を --limit で絞れます。ページ送りはありません。

トラブルシューティング

関連: expl server fetch

expl server chart query

ノート、ダッシュボード、スライドに含まれるチャートのデータを、サーバーで絞り込み、集計して、結果だけを返します。

書式

[ ] は省略できる指定、< > は自分の値に置き換える部分です。フラグは — で始まる追加の指定です。

引数とフラグ

JSON の引数

filters、metrics、sort の JSON の形は、dataset query の説明を参照してください。チャートの問い合わせでは結合の指定は使いません。

例

チャートのデータを集計する

ターミナル
<id> はノートなどの id、<chart> はチャートの名前、<column> は chart get-data の結果の query.columns にある列の名前に置き換えます。書式は dataset query と同じです。 実行結果は、ダッシュボード Sales Orders Dashboard(id が pQ9rS0tU1v)のチャート kL8mN9oP(Sales by Region)で実行したものです。このチャートは地域が 8 つあるため、どの地域も 1 行と数えられます。長い出力は省略しています。 実行結果

出力と上限

対象は、公開されたとおりのチャートの表です。チャートがすでに集計した値が入っています。総計や小計の行は表に入らず、result.excluded_totals に入ります。全体の値がほしいときは、行を足し合わせず、excluded_totals を使います。すでに平均、重複を除いた件数、比率にした列を足し合わせたり平均したりすると、警告 CHART_REAGGREGATION が付きます。そのときは、警告を伝えるか、excluded_totals を使います。数値を伝えるときは、チャートの集計方法、chart.filters、context.parameters、context.data_as_of もいっしょに伝えます。 ページ送りはありません。結果の has_more が true のときは、絞り込むか、集計します。

トラブルシューティング

関連: expl server chart get-data、expl server chart get-image

expl server desktop mcp-setup-guide

Exploratory Desktop に AI ツールをつなぐための、手順とリンクを返します。

書式

[ ] は省略できる指定、< > は自分の値に置き換える部分です。フラグは — で始まる追加の指定です。

引数とフラグ

例

手順を取得する

ターミナル
長い出力は省略しています。結果には、使うための条件、クライアントごとのインストールのコマンド、Grok Bot の手順が含まれます。ここでは先頭のクライアントだけを載せています。 実行結果

出力と上限

手順とリンクを返すだけです。インストールも実行もしません。Desktop も操作しません。 ページ送りはありません。

トラブルシューティング

関連: サインイン