Delhaize receipts

delhaize-mcp

AI アシスタントが、専用のヘッドレスブラウザーを使って、ご自身の Delhaize（ベルギー）のレシートと今週のプロモーションを取得できる、非公式の Model Context Protocol サーバーです。普段お使いのブラウザーを操作することも、パスワードを参照することもありません。

非公式であり、Delhaize とは提携しておらず、同社から承認も受けていません。お客様ご自身のアカウントのみを、お客様の依頼に応じて、ご自身で閲覧する場合と同じ方法で読み取ります。ご利用が Delhaize の利用規約に適合することを確認し、リクエストの頻度を低く保ち、他人のデータ収集には使用しないでください。

機能

ツール	機能	書き込み先
delhaize_auth_status	保存済みのログインがまだ有効かどうかを確認します	なし
delhaize_list_receipts	最近のレシートを一覧表示し、まだ記録にないものに印を付けます	なし
delhaize_fetch_new_receipts	新しいレシートの画像をそれぞれ保存します	data/receipts_inbox/
delhaize_backfill_images	すでに記録にあるレシートの不足している写真を保存します	data/receipts_backfill/
delhaize_fetch_promotions	週ごとのプロモーション一覧のページを生データのまま保存します	data/promos_inbox/<date>/

商品を文字起こしすることも、記録を編集することも、パスワードを扱うこともありません。ファイルをディスクに保存するだけです。画像を読み取って記録する作業は、お客様またはアシスタントが行います。レシートの明細の合計が印字された合計額と一致するか確認することをおすすめします。

レシートは**（日付、店舗、合計額）**で識別されるため、同じものが二度取得されることはありません。

必要条件

• Python 3.10+
• ロイヤルティカードにレシートが紐付いた Delhaize アカウント

インストール

pip install delhaize-mcp
python3 -m playwright install chromium

これにより、2 つのコマンドが使えるようになります。delhaize-mcp（MCP サーバー）と、同じ操作をコマンドラインから実行する delhaize-receipts です。

セットアップ

1. 一度ログインします。 ブラウザーウィンドウが開くので、ご自身でサインインしてください。

   delhaize-receipts login
   

   セッションは ~/.delhaize-mcp/profile に保存されます（または DELHAIZE_PROFILE を設定してください）。以降の実行では、ヘッドレスモードでこのセッションを再利用します。セッションが期限切れになった場合は、もう一度 login を実行してください。このフォルダーにはセッション Cookie が保存されます。絶対にコミットしたり、共有したりしないでください。

2. データフォルダーを選択します（任意）。デフォルトでは、すべてのデータが ~/.delhaize-mcp/data に書き込まれます。別のフォルダーを使うには DELHAIZE_DATA_DIR を設定してください。このフォルダー内の receipts_all.json がレシートの記録です。次のような JSON リストです。

   [{"date": "2026-08-11", "store": "Delhaize Centre", "total": 11.11, "image": "photos/2026-08-11.jpeg"}]
   

   image は省略できます。既存の画像がないレシートが、backfill の対象になります。

3. アシスタントに接続します。

   Claude Code：

   claude mcp add delhaize-receipts -- delhaize-mcp
   

   Claude Desktop（claude_desktop_config.json）：

   {
     "mcpServers": {
       "delhaize-receipts": {
         "command": "delhaize-mcp",
         "env": {"DELHAIZE_DATA_DIR": "/path/to/your/data"}
       }
     }
   }
   

   アプリが delhaize-mcp を見つけられない場合は、フルパスを使用してください（which delhaize-mcp で確認できます）。

コマンドライン

アシスタントなしでも、同じ操作を実行できます。

delhaize-receipts status
delhaize-receipts list     --months 1   # this month and last
delhaize-receipts fetch    --months 1
delhaize-receipts backfill --months 3
delhaize-receipts promos

仕組み

Delhaize は各レシートをクライアント側アプリ内の画像として表示するため、サーバーは実際のページをヘッドレス Chromium（Playwright）で表示し、人が閲覧する場合とまったく同じように、表示されたページを読み取ります。フランス語の日付、ユーロ金額、重複排除、ファイル名などの解析ルールはすべて src/delhaize_mcp/core.py にあり、ブラウザーに依存せず、ユニットテストで完全にテストされています。

テスト

ブラウザーもネットワークも必要ありません。

python3 tests/test_core.py
python3 tests/test_server.py

プライバシー

• delhaize.be への通常のページリクエストを除き、マシンの外部にデータが送信されることはありません。
• パスワードが読み取られたり、保存されたりすることはありません。ログインには、ご自身で作成したブラウザープロファイルを使用します。
• ログイン情報とデータはコードの外にある ~/.delhaize-mcp に保存されるため、リポジトリに入ることはありません。

制限事項

• フランス語表示のベルギー向けサイト（delhaize.be/fr）を対象に作られています。Delhaize 側でページが変更されると動作しなくなることがあります。パーサーは意図的に柔軟に作られており、ツールは取得できなかったものを報告するため、問題を黙って見過ごすことはありません。
• プロモーションの取得ではページの生データのみを保存します。その解釈はご自身で行ってください。

ライセンス

MIT。LICENSE を参照してください。