Csvglow

csvglow

CSV／Excel ファイルから、美しくインタラクティブな HTML ダッシュボードを生成します。コマンドを 1 つ実行するだけで、設定は不要です。

csvglow sales.csv

自動検出されたグラフ、複数列を対象としたスマートな分析、相関関係、並べ替え可能なデータテーブルを備えた、単一の HTML ダッシュボードをブラウザーで開きます。ダークグラデーションテーマを採用しています。任意のグラフをクリップボードにコピーできます。

インストール

pip install csvglow

または、npx 経由で実行できます（インストール不要）。

npx csvglow data.csv

使い方

csvglow data.csv                    # CSV to dashboard, opens in browser
csvglow report.xlsx                 # Excel works too
csvglow data.csv -o dashboard.html  # Custom output path
csvglow data.csv --no-open          # Don't auto-open browser

生成されるもの

• スマートな分析結果 — 複数列を参照するナラティブ分析により、矛盾、効率の差、上位／下位のパフォーマンスを明らかにします
• すべての数値列に対するヒストグラム（平均、中央値、標準偏差、四分位数、外れ値の件数付き）
• カテゴリ列に対する棒グラフ
• クロス分析 — カテゴリ列と数値列のクロス集計を自動生成し、全体平均の線を表示します
• 日付列に対する、塗りつぶし領域付きの時系列折れ線グラフ
• 数値列間の相関ヒートマップ
• 相関の高いペア（|r| > 0.7）の散布図
• 並べ替え・フィルタリング可能なデータテーブル（先頭 1000 行）
• スライドに貼り付けるための、各グラフのコピーボタン

出力は単一の自己完結型 HTML ファイルです。サーバーも CDN も不要で、オフラインで動作します。

MCP サーバー

csvglow は、MCP に対応した任意のクライアントで MCP ツールとして動作します。一度設定すれば、AI アシスタントにファイルパスを指定してダッシュボードの生成を依頼できます。

使用するクライアントを選び、MCP 設定ファイルに csvglow を追加してください。

クライアント	設定ファイルの場所
Cursor	.cursor/mcp.json（プロジェクトのルート）
Windsurf	~/.windsurf/mcp.json

次の内容を設定に追加してください。

{
  "mcpServers": {
    "csvglow": {
      "command": "npx",
      "args": ["-y", "csvglow", "--mcp"]
    }
  }
}

npx を使用するため、追加のインストールは不要です。

すでに pip 経由で csvglow をインストールしている場合は、代わりに "command": "csvglow" と "args": ["--mcp"] を使用してください。

OpenClaw スキル

csvglow は OpenClaw スキルとして利用できます。OpenClaw に対応したクライアントであれば、手動で設定しなくても自動的に検出して使用できます。

対応形式

• .csv ／ .tsv（区切り文字を自動検出）
• .xls
• .xlsx（最初のシートのみ — 複数シートへの対応は近日公開予定）

変更履歴

0.1.0

• 初回リリース
• 列の種類を自動検出（数値、カテゴリ、日時、識別子）
• スマートな分析結果：複数列にわたる矛盾の検出、効率分析、上位／下位パフォーマンスの特定
• 統計情報サイドバー付きヒストグラム、棒グラフ、クロス分析のクロス集計、時系列グラフ、相関ヒートマップ、散布図
• 並べ替え・フィルタリング可能なデータテーブル
• すべてのグラフをクリップボードにコピー
• MCP サーバーモード（csvglow --mcp）
• OpenClaw スキルに対応
• 大容量ファイル（10 万行以上）向けのスマートなサンプリング

ロードマップ

• Excel の複数シート対応
• 結合キーを使った複数ファイル対応
• ライトテーマ
• カスタムカラーパレット
• PDF エクスポート

ライセンス

MIT