Receipt Extraction

レシートの抽出

オーストラリアの GST／ABN に対応したレシート・請求書の抽出 — 文書化されたオーストラリアの接待費／ITC の税コード規則を明細ごとに適用し、単なる OCR テキストではなく、各明細について tax_code、confidence、1 行の rationale を返します。書類を渡すだけで、ベンダー、明細、税額、合計を含む、検証済みの構造化 JSON を取得できます。オーストラリアの GST 検証と ABN のチェックサム検証は、最初から組み込まれています。API を 1 回呼び出すだけで、手作業で画像認識 LLM のプロンプトを作成したり、ATO の公式ドキュメントから ABN／GST の規則を再導出したりする必要はありません。

機能

• レシート／請求書の画像または PDF（base64）を受け付け、クリーンでバージョン管理された Receipt JSON オブジェクトを返します。
• ベンダーの ABN（11 桁の mod 89 チェックサム）を検証し、明細と合計の GST を照合します。文書化された規則に従い、接待費コードが適用される経費のうち、控除できない GST は除外します。
• 各明細には tax_code に加え、confidence（0～1）と、適用した実際の規則を明記する 1 行の rationale が含まれます（例：「例外に該当する状況がないため接待費の ITC は認められない」、またはレストラン形式の食事を再び控除対象にする旅行付随費用の例外）。そのため、結果をただ信頼するのではなく、判定内容を確認できます。
• MCP サーバー（extract_receipt ツール）または通常の HTTPS API として動作するため、Claude、Cursor、その他の HTTP クライアントから利用できます。

GST の処理は、公開されているオーストラリアの税法の文書に基づいています。出力はソフトウェアによるものであり、税務アドバイスではありません。

例（MCP ツールの呼び出し）

{
  "tool": "extract_receipt",
  "input": { "document_base64": "<base64 image or PDF>", "mime_type": "image/jpeg" }
}

{
  "vendor": { "name": "Acme Pty Ltd", "abn": "51824753556", "abn_valid": true },
  "date": "2026-07-14",
  "line_items": [
    {
      "description": "Widget",
      "qty": 2,
      "unit_price": 12.5,
      "gst": 2.5,
      "tax_code": "taxable",
      "confidence": 0.95,
      "rationale": "Standard-rated retail good; 10% GST applies."
    }
  ],
  "totals": { "subtotal": 25.0, "gst": 2.5, "total": 27.5 },
  "schema_version": "1.0"
}

料金

現在、無料プランはセルフサービスで利用できます。有料プランは近日公開予定です。

• 無料 — 月 20 件まで。カード登録不要。現在セルフサービスで利用できます。
• 従量課金 (近日公開) — 1 件あたり $0.02、最低利用料金なし。
• Pro (近日公開) — 月額 $19 で 1,500 件（実質約 $0.013／件）、優先サポート付き。

今すぐ有料プランをご希望ですか？ 利用希望を登録していただければ、優先してご案内します。

キーの取得

MCP サーバーは https://receipt-extraction.acjlabs.com/mcp で稼働中です（別のアドレス https://acjlabs-receipt-extraction.acjlabs.workers.dev/mcp も同じデプロイ先に接続され、引き続き使用できるため、既存の設定を変更する必要はありません）。無料プランのキーはセルフサービスで取得できます。POST /v1/signup に { "email": "[email protected]" } を送信すると、月 20 件まで、カード登録不要のキーがレスポンスで直接返されます。キーはすぐに保存してください。表示されるのは 1 回だけで、紛失しても復元できません（再登録して新しいキーを取得してください）。Pro／従量課金の請求が開始された後は、有料キーも同じ方法で発行される 1 回限りの取得リンクから取得できます。同じ手順に加えて、料金と他の選択肢との比較については https://acjlabs-receipts.pages.dev をご覧ください。

MCP クライアントへの接続

Claude Code の場合：

claude mcp add --transport http receipt-extraction \
  https://receipt-extraction.acjlabs.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

カスタムヘッダー付きのリモート HTTP サーバーに対応したその他の MCP クライアント（Cursor、Cline、VS Code など）でも同じように動作します。上記の URL を指定し、Authorization: Bearer YOUR_API_KEY ヘッダーを設定してください。生のキー値のみを転送でき（Bearer プレフィックスなし）、ゲートウェイやスキャナーも使用できます。どちらの形式でも認証できます。ツールの検出（initialize／tools/list）にはキーは不要です。キーが必要なのは extract_receipt の呼び出し時だけです。

1 つのガイドに沿って進めたい場合は、docs/quickstart.md に、コピーして実行できる手順（キーの取得、クライアントごとの設定、curl による接続確認）がすべて記載されています。

精度について

ネット価格、GST 込み価格のみの記載、チェックサムが無効な ABN、判読不能な書類を網羅した、自作ながら実際に読み取り可能なテスト書類で 4 件中 4 件の検証に成功しています。より多様な書類形式に対する実運用での精度は、実際のトラフィックが発生し次第、追跡します。

npm クライアント

MCP JSON-RPC 呼び出しを手作業で記述する代わりに、型付き関数を使いたいですか？ npm で公開中の @acjlabs/receipt-extraction-client は、extract_receipt ツールの呼び出しをラップします。

npm install @acjlabs/receipt-extraction-client

import { createReceiptExtractionClient } from "@acjlabs/receipt-extraction-client";

const client = createReceiptExtractionClient({
  baseUrl: "https://receipt-extraction.acjlabs.com",
  apiKey: "...",
});
const receipt = await client.extractReceipt(base64EncodedImageOrPdf, "image/png");

汎用 OCR では不十分な理由

汎用 OCR 抽出 API が返すのは、生のフィールドだけです。オーストラリアの ABN には 11 桁のモジュラス 89 チェックサムがあることや、接待費として分類された経費では GST の按分方法が異なることなど、オーストラリア固有のレイヤーを適用するものはありません。こうした処理は、変更される可能性のある他社のスキーマに合わせて、自分で構築・保守する必要があります。比較の全文をご覧いただくか、オーストラリアの GST ルールによって多くの領収書抽出ツールが機能しなくなる理由をお読みください（ABN のチェックサム、実際に適用される 3 つの GST ケース、およびそれらを基に任意のツールをテストする方法について説明しています）。

ソースの公開状況とサポート

このリポジトリでは、ホステッドサービスのドキュメントを公開しています。サービスの実装はオープンソースではありません。バグ報告や機能リクエストは、このリポジトリの Issues で歓迎しています。[email protected] からお問い合わせいただくこともできます。