Queria スキル

Claude Code や Codex などのエージェントから Queria のデータを探索するスキル

Queria は、Claude Code や Codex などのエージェントから公開データを探索するための専用スキルを queria-io/skills で配布しています。データセットの発見からスキーマ把握、SQL 取得、横断結合までを行えます。導入後の分析の流れは「AI エージェントで分析する」で体験できます。

スキルは Agent Skills 標準の形式なので、対応する30以上のエージェントで同じものが動きます。Claude Desktop など、エージェントがシェルを使えない MCP クライアントから使う場合は「MCP サーバー」を参照してください。

必要なもの

Queria CLI（PyPI: queria）を使います。uv があれば uvx queria でインストール不要、なければ pip install queria（Python 3.10+）
認証は不要です（data.queria.io の匿名アクセスにはレートリミットがあります）

できること

データセット一覧の取得
データセット・テーブル・カラムの横断検索
メタデータ（ライセンス・出典など）とスキーマの把握
SQL の実行（複数データセットを跨いだ JOIN を含む）
結果の CSV / Parquet への書き出し
データの不足・不備やドキュメントの誤りの報告（送信前に必ず本文を提示して承認を求めます）

郵便番号、法人番号、e-Stat 政府統計、不動産価格、国土数値情報（GIS）、自治体コード、暦などを、別々のデータセットを跨いで探索できます。

配布しているスキル

スキル	用途
`queria`	公開データの探索・検索・SQL 実行（このページの内容）
`queria-publish-dataset`	自分のデータセットを登録・ビルド・公開する
`queria-describe-dataset`	データを公開するときに、説明を何をどこに書くか決める

導入

導入方法は4つあり、入るスキルはどれも同じです。Queria CLI からの導入はエージェントを選びません。

エージェントを問わず、Queria CLI から導入できます:

uvx queria skills install

書き込み先はいまのプロジェクトです。Codex・Cursor・OpenCode などが読む .agents/skills に書き、Claude Code が設定されている環境では .claude/skills にも書きます。このマシンの全プロジェクトで使うなら --global を付けてください。

書き込み先の指定や、手元で書き換えたスキルの扱いは CLI リファレンスにあります。

プラグインとしてインストールします。Claude Code 内から:

/plugin marketplace add queria-io/skills
/plugin install queria@queria-io

CLI からも同じことができます:

claude plugin marketplace add queria-io/skills
claude plugin install queria@queria-io

Codex CLI のプラグインとしてインストールします:

codex plugin marketplace add queria-io/skills
codex plugin add queria@queria-io

Codex CLI・IDE 拡張・ChatGPT デスクトップアプリはプラグイン設定を共有するため、一度の登録でどのクライアントからも使えます。

Cursor、OpenCode など Agent Skills 標準に対応したエージェントには skills CLI でインストールします:

npx skills add queria-io/skills

エージェントごとのスキルディレクトリに手動でコピーする方法は queria-io/skills の README を参照してください。

使い方

スキルを導入したエージェントに、自然言語で頼むだけで起動します。

Queria で東京都の郵便番号を調べて

日本の都道府県別人口を出して

可視化や統計分析、ダッシュボード作成はこのスキルのスコープ外です。取得結果をファイルに書き出し、可視化・分析用の別スキルや BI ツールに渡す使い方を想定しています。

次のステップ

AI エージェントで分析する: 対話で深掘りする分析の流れを体験する
MCP サーバー: シェルの無い MCP クライアントからの利用
接続方法: プログラムや BI ツールからの接続全般