Scanner Excel Extraction Skill

概要

scannerエージェントがExcelファイルからデータを抽出し、構造化されたフォーマット（Markdown、JSON、CSV）に変換する際に使用します。

ツール優先順位

1. MarkItDown MCP（最優先） - mcp-markitdown@ai-plugins プラグイン
2. Python スクリプト（フォールバック） - MarkItDown MCPが利用できない場合

クイックリファレンス

方法1: MarkItDown MCP（推奨）

# ローカルファイルをMarkdownに変換
mcp__plugin_mcp-markitdown_markitdown__convert_to_markdown uri="file:///path/to/data.xlsx"

# URLからExcelファイルを変換
mcp__plugin_mcp-markitdown_markitdown__convert_to_markdown uri="https://example.com/data.xlsx"

MarkItDown MCPはExcelの全シートをMarkdownテーブルに変換します。追加ライブラリのインストールは不要です。

方法2: Python スクリプト（フォールバック）

MarkItDown MCPが利用できない場合や、数式評価・特定シート抽出など高度な処理が必要な場合に使用します。

# 全シートをJSONに変換
python scripts/extract-excel.py data.xlsx --output=json

# 特定シートのみCSVに変換
python scripts/extract-excel.py data.xlsx --sheet="Sheet1" --output=csv

# 数式を評価して出力
python scripts/extract-excel.py data.xlsx --evaluate-formulas

必要なライブラリ:

pip install pandas openpyxl xlrd

出力形式

Markdown形式（MarkItDown MCP）: テーブル形式でシートごとに出力

JSON形式（Python）:

{
  "Sheet1": [
    {"id": 1, "name": "Product A", "price": 1000}
  ]
}

CSV形式（Python）: 各シートごとに data_Sheet1.csv, data_Sheet2.csv を生成

ベストプラクティス

DO	DON'T
ヘッダー行を明確に（1行目）	複雑な書式に依存
データ型を統一	結合セルを使用
大容量ファイルはチャンク処理	全データをメモリに展開
空白セルの扱いを定義	マクロに依存

詳細ガイド

ファイル	内容
01-usage-guide.md	詳細な使用方法、スクリプト実装、データ型の扱い
02-examples.md	実装例（売上データ、在庫データ、大容量ファイル）

関連Skill

• scanner-pdf-analysis: PDF解析
• data-analyst-export: データエクスポート