parserbee-mcp

ParserBee MCP サーバー

ParserBee 用の Model Context Protocol サーバーです。Parser テンプレートを使って、請求書、領収書、注文書、銀行取引明細書などの書類から、AI アシスタントが構造化データを抽出できます。

アシスタントには、次のように依頼できます。

• 「~/Downloads/inv-2041.pdf の請求書を、自分の Invoice テンプレートで抽出して。」
• 「このフォルダーにあるすべての領収書を読み取って、店舗名、日付、合計金額の表にして。」
• 「ParserBee のページクレジットはあといくつありますか？」

ツール

ツール	機能
extract_document	Parser テンプレートを使って、ローカルファイル（file_path）または公開リンク（file_url）からデータを抽出します。1ページにつき1ページクレジットを消費します。
list_templates	アカウントにある Parser テンプレートとそのフィールドを一覧表示します
get_template	すべてのフィールドを含む Parser テンプレートを1つ取得します
get_credits	ページクレジットの残高、プラン、サブスクリプションのステータスを取得します
list_recent_extractions	直近10件の抽出リクエストを一覧表示します
get_extraction	抽出データを含む抽出リクエストを1件取得します

始める前に

1. app.parserbee.com で無料アカウントを作成します。新規アカウントには、クレジットカード不要で25ページ分が無料で付与されます。
2. Parser テンプレートを作成します。サンプル書類を1つアップロードすると、AI がフィールドを作成します。または、テンプレートライブラリから用意されたテンプレートを選びます。
3. ダッシュボードの Settings から API キーをコピーします。キーは pk_ で始まります。

Node.js 18 以降が必要です。

セットアップ

Claude Desktop

Settings > Developer > Edit Config を開き、次を追加します。

{
  "mcpServers": {
    "parserbee": {
      "command": "npx",
      "args": ["-y", "parserbee-mcp"],
      "env": { "PARSERBEE_API_KEY": "pk_your_api_key" }
    }
  }
}

Claude Desktop を再起動します。

Claude Code

claude mcp add parserbee --scope user -e PARSERBEE_API_KEY=pk_your_api_key -- npx -y parserbee-mcp

--scope user を指定すると、すべてのフォルダーで ParserBee を利用できます。指定しない場合、Claude Code はコマンドを実行したフォルダーにのみサーバーを追加します。その後、新しい Claude Code セッションを開始し、claude mcp list で確認します。

Cursor

同じ mcpServers ブロックを ~/.cursor/mcp.json（すべてのプロジェクト用）または .cursor/mcp.json（1つのプロジェクト用）に追加します。

VS Code

.vscode/mcp.json に追加します。

{
  "servers": {
    "parserbee": {
      "command": "npx",
      "args": ["-y", "parserbee-mcp"],
      "env": { "PARSERBEE_API_KEY": "pk_your_api_key" }
    }
  }
}

ローカルコピーから

git clone https://github.com/ParserBee/parserbee-mcp.git
cd parserbee-mcp
npm install
PARSERBEE_API_KEY=pk_your_api_key node dist/index.js

クライアントの接続先を node /path/to/parserbee-mcp/dist/index.js に設定します。

設定

環境変数	必須	用途
PARSERBEE_API_KEY	はい	Settings で取得した API キー
PARSERBEE_BASE_URL	いいえ	デフォルトは https://app.parserbee.com です

返されるデータ

extract_document は API レスポンスを返します。抽出されたフィールドは data に含まれ、Parser テンプレートに沿った形式になります。

{
  "success": true,
  "request_id": "req_abc123",
  "data": {
    "invoice_number": "INV-2026-001",
    "vendor_name": "Acme Corp",
    "total_amount": 1500
  },
  "credits_remaining": 449,
  "usage": { "pages_processed": 1, "credits_charged": 1 }
}

ファイル形式は PDF、PNG、JPG、WebP、HEIC に対応し、最大サイズは50 MBです。スキャン画像やスマートフォンで撮影した写真も使用できます。無効なキー、ページクレジットの不足、不明なテンプレートなどの API エラーは、ParserBee のエラーコードを含むツールエラーとして返されるため、アシスタントが修正方法を案内できます。

お試しください

sample-invoices リポジトリには、すべてのフィールドの正しい値がわかる無料のテスト用請求書が18件あります。結果の確認にご利用ください。

関連リンク

• parserbee-python と parserbee-node：クライアントライブラリ
• parserbee-n8n：n8n ワークフロー
• parserbee-postman：Postman コレクションと OpenAPI ファイル
• 無料のブラウザーツール：請求書パーサー、銀行取引明細書コンバーター、領収書スキャナー
• ツールを比較していますか？請求書 OCR ソフトウェアのテストをご覧ください。

開発

npm install
npm test
npm run build

ライセンス

MIT