--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 の形で出力します。
書式とフラグの一覧
探す・読む
データ
チャートとアナリティクス
接続と管理
コマンドを調べる
サーバーが提供しているコマンドと、そのフラグを調べます。一覧を表示する
1 つのコマンドを調べる
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> 全コマンドの書式とフラグは、書式とフラグの一覧を参照してください。expl server search
閲覧できるコンテンツを、タイトル、説明、タグで探します。検索語がなければ、新しい順に一覧します。書式
引数とフラグ
例
言葉で探す
ターミナル自分のコンテンツを一覧する
ターミナル出力と上限
結果には、コンテンツの 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 件読みます。書式
引数とフラグ
例
ノートを読む
ターミナル見出しを 1 つだけ読む
ターミナル--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
データの列の名前と型、公開した人が書いた説明、行数を調べます。書式
引数とフラグ
例
列の名前と型だけを調べる
ターミナル詳しく調べる
ターミナル出力と上限
列の名前、型、行数が入ります。full では、公開した人が書いた説明、欠損値と固有値の数、最小値と最大値、よく出る値、更新状況(最後に更新された時刻と、新しいかどうか)も入ります。所有者が承認していれば、セマンティクス(1 行の意味、列の役割、既定の集計方法、集計のルール)も入ります。セマンティクスは公式の定義なので、集計の前に読んでください。 ページ送りはありません。トラブルシューティング
関連: expl server dataframe preview、expl server dataset query
expl server dataframe preview
データの行を、offset と limit でページに分けて取得します。書式
引数とフラグ
例
先頭の 3 行を表示する
ターミナル101〜200行目を取得する
ターミナル出力と上限
公開した人がすべてのデータを含めて公開したときは、すべての行を読めます。そうでないときは、公開したときに保存したサンプルの行です。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結合するデータ: datasets
JSON結合条件: joins
JSON例
地域ごとの行数を数える
ターミナル--limit 5)で切ったので、result.has_more が true になり、RESULT_TRUNCATED の警告が付いています。残りの地域も見るときは、--limit を増やすか、条件で絞り込みます。
全体の行数を数える
ターミナル出力と上限
結果は正確で、データのバージョン(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 の説明を参照してください。例
行をファイルにする
ターミナル出力と上限
15 分で切れるダウンロードリンクが返ります。リンクを使えるのは、サインインしている本人だけです。ファイルの保存先は--output で指定できます。
ページ送りはありません。結果が大きすぎて dataset query で読めないときに、このコマンドを使います。
トラブルシューティング
関連: expl server dataset query、expl server dataframe preview
expl server dataframe get-wrangling
公開されたデータがどのように作られたかを調べます。データ加工のステップを順番に、読み込んだデータと結合したデータ、列ごとにどのステップが作ったか、変えたかを返します。書式
引数とフラグ
例
概要を見る
ターミナル1 つの列を作ったステップを見る
ターミナル出力と上限
--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 行を取得する
ターミナル出力と上限
チャートの行に加えて、数値の意味が付きます。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)を取得します。形、傾向、配置を確認するための機能です。書式
引数とフラグ
例
チャートの画像を取得する
ターミナル出力と上限
画像は、公開したときに保存されたもので、描き直されません。そのため、データより古いことがあります。結果の result.image.may_be_stale で確かめます。画像は、expl を動かしているコンピューターに保存され、結果の image_path がその場所を示します。保存先は--output で指定できます。正確な数値は、画像ではなく chart get-data で読みます。
ページ送りはありません。
トラブルシューティング
関連: expl server chart get-data
expl server analytics get-result
アナリティクス(回帰、相関、カイ二乗検定など)の結果を、プログラムで扱える形式のデータで取得します。書式
引数とフラグ
例
アナリティクスの結果を取得する
ターミナル--analytics は指定していません。長い出力は省略しています。この例では、説明文は空にしています。
実行結果
出力と上限
モデルの定義(目的変数、説明変数、N)、安定した列 id を持つ結果の表、学習用とテスト用に分けた主要な統計量、実行したときの設定、説明の文が入ります。説明の文には、数値から作ったものか、AI が作ったものかの印が付きます。数値は表示されたとおりの桁で、係数は標準化されていません。 表ごとの行数を--limit で絞れます。ページ送りはありません。
トラブルシューティング
関連: expl server fetch
expl server chart query
ノート、ダッシュボード、スライドに含まれるチャートのデータを、サーバーで絞り込み、集計して、結果だけを返します。書式
引数とフラグ
JSON の引数
filters、metrics、sort の JSON の形は、dataset query の説明を参照してください。チャートの問い合わせでは結合の指定は使いません。例
チャートのデータを集計する
ターミナル出力と上限
対象は、公開されたとおりのチャートの表です。チャートがすでに集計した値が入っています。総計や小計の行は表に入らず、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 ツールをつなぐための、手順とリンクを返します。書式
引数とフラグ
例
手順を取得する
ターミナル出力と上限
手順とリンクを返すだけです。インストールも実行もしません。Desktop も操作しません。 ページ送りはありません。トラブルシューティング
関連: サインイン
