Skip to main content
Glama

queria

Query Japanese open data on Queria from the terminal, Python, and MCP.

Queria が公開する日本のオープンデータ(e-Stat、国土数値情報、EDINET、気象庁ほか)を、ターミナル・Python・MCP から read-only で探索するクライアントです。データは DuckLake 形式で公開されており、計算はすべて手元の DuckDB で行われます。

インストール

uvx queria list          # インストール不要で実行
pip install queria       # または通常インストール

Python 3.10+ が必要です。

Related MCP server: estat-mcp

使い方

queria list                              # データセット一覧
queria search 人口                        # データセット・テーブル・カラムの横断検索
queria info e_stat                       # メタデータ(ライセンス・出典など)
queria schema e_stat                     # テーブル一覧
queria columns e_stat mart_population    # カラム一覧
queria summarize zipcode.main.zipcodes   # カラム統計(全件スキャン)
queria sql "SELECT * FROM zipcode.main.zipcodes LIMIT 10"
queria sql "SELECT * FROM zipcode.main.zipcodes" --out zipcodes.parquet

テーブルは <dataset>.<schema>.<table> で参照します。参照したデータセットは自動的に ATTACH されます。

API トークン

トークンなしでも使えますが、レートリミットがあります。https://queria.io/profile/api-keys で発行したトークンを登録すると上限が上がります:

queria auth set-token <token>   # ~/.config/queria/config.toml に保存
queria auth status              # 確認

--token オプションや環境変数 QUERIA_TOKEN でも指定できます(この順で優先)。

Python API

import queria

with queria.connect() as conn:
    conn.sql("SELECT * FROM catalog.main.mart_datasets").show()

MCP サーバー

Claude Code / Claude Desktop / Cursor などの MCP クライアントから使えます:

{
  "mcpServers": {
    "queria": {
      "command": "uvx",
      "args": ["--from", "queria[mcp]", "queria", "mcp"]
    }
  }
}

ドキュメント

https://docs.queria.io/

License

MIT

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    D
    maintenance
    Enables natural language search and retrieval of data from Japan's Ministry of Land, Infrastructure, Transport and Tourism (MLIT) Data Platform, including location-based queries, attribute filtering, and data visualization capabilities.
    18
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    MCP server for Japan's e-Stat (Government Statistics Portal). Search statistical datasets, retrieve data tables, and access metadata from official Japanese government statistics.
    9
    Apache 2.0