Clawhub-skills airpay-agent
Airレジ/Airペイ管理エージェント — リクルートのPOSレジ・キャッシュレス決済プラットフォームをClaude Codeから完全操作。売上管理、決済処理、在庫管理、顧客分析、スタッフシフト管理をターミナルからリアルタイムに実行する店舗運営特化スキル。
git clone https://github.com/traygerbig/clawhub-skills
T=$(mktemp -d) && git clone --depth=1 https://github.com/traygerbig/clawhub-skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/finance-accounting-pack/airpay-agent" ~/.claude/skills/traygerbig-clawhub-skills-airpay-agent && rm -rf "$T"
finance-accounting-pack/airpay-agent/SKILL.md┌──────────────────────────────────────────────────────────┐ │ ╔═╗╦╦═╗╔═╗╔═╗╦ ╦ │ │ ╠═╣║╠╦╝╠═╝╠═╣╚╦╝ Agent │ │ ╩ ╩╩╩╚═╩ ╩ ╩ ╩ │ │ │ │ ┌─────┐ ┌─────┐ ┌─────┐ ┌─────┐ ┌─────┐ │ │ │ POS │──│ PAY │──│ INV │──│ CRM │──│STAFF│ │ │ │売上 │ │決済 │ │在庫 │ │顧客 │ │管理 │ │ │ └──┬──┘ └──┬──┘ └──┬──┘ └──┬──┘ └──┬──┘ │ │ └────────┴────────┴────────┴────────┘ │ │ リクルート Airレジ / Airペイ API │ │ Claude Code × 店舗運営オペレーション │ └──────────────────────────────────────────────────────────┘
claude-code airpay pos payment japan
Airレジ/Airペイ管理エージェント — リクルートが提供するPOSレジ「Airレジ」とキャッシュレス決済「Airペイ」をClaude Codeから統合管理。売上分析、決済状況、在庫管理、顧客データ、スタッフシフトまで、店舗運営のすべてをコマンドラインから操作する実店舗DXスキル。
Overview
Airpay Agentは、リクルートが提供する店舗向けサービス「Airレジ」(POSレジ)と「Airペイ」(キャッシュレス決済)のAPIをClaude Codeから直接操作するためのスキルです。飲食店、小売店、サービス業など、実店舗を運営する事業者がターミナルから売上確認、在庫管理、顧客分析、スタッフ管理を一元的に行えます。Airペイは業界最安水準の決済手数料(3.24%〜)で、クレジットカード、電子マネー、QRコード決済に対応しており、本スキルでこれらの決済状況をリアルタイムに監視・分析できます。
アーキテクチャ概要
┌───────────────────────────────────────────────────────────────────┐ │ Claude Code Terminal │ │ ┌──────────────────────────────────────────────────────────────┐ │ │ │ airpay sales / payment / inventory / customer / report │ │ │ └──────────────────────────┬───────────────────────────────────┘ │ │ │ │ │ ┌──────────────────────────▼───────────────────────────────────┐ │ │ │ Airpay Agent Core │ │ │ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │ │ │ │Sales │ │Payment │ │Inventory │ │Analytics │ │ │ │ │ │Manager │ │Processor │ │Controller│ │Engine │ │ │ │ │ │(売上管理)│ │(決済処理)│ │(在庫管理)│ │(分析) │ │ │ │ │ └────┬─────┘ └────┬─────┘ └────┬─────┘ └────┬─────┘ │ │ │ │ │ │ │ │ │ │ │ │ ┌────┴─────┐ ┌────┴─────┐ ┌────┴─────┐ │ │ │ │ │Customer │ │Staff │ │Menu │ │ │ │ │ │Manager │ │Scheduler │ │Editor │ │ │ │ │ │(顧客管理)│ │(シフト) │ │(商品管理)│ │ │ │ │ └────┬─────┘ └────┬─────┘ └────┬─────┘ │ │ │ │ └────────────┴────────────┘ │ │ │ └──────────────────────────┬───────────────────────────────────┘ │ │ │ HTTPS / REST API │ │ ┌──────────────────────────▼───────────────────────────────────┐ │ │ │ Airレジ API / Airペイ API │ │ │ │ sales / transactions / products / customers / staff │ │ │ └──────────────────────────┬───────────────────────────────────┘ │ │ │ リクルートID連携 │ │ ┌──────────────────────────▼───────────────────────────────────┐ │ │ │ Airペイ決済端末 ← → 各カードブランド / QRコード決済 │ │ │ │ VISA / Mastercard / JCB / AMEX / Suica / PayPay 他 │ │ │ └──────────────────────────────────────────────────────────────┘ │ └───────────────────────────────────────────────────────────────────┘
処理フロー
商品登録 ──→ 注文受付 ──→ 決済処理 ──→ レシート発行 ──→ 売上計上 │ │ │ │ │ ▼ ▼ ▼ ▼ ▼ 在庫連動 テーブル Airペイ端末 電子レシート 日次集計 価格設定 管理(飲食) カード/QR 印刷/メール 月次レポート
System Prompt(行動指針)
Airpay Agentとして動作する際、以下のガイドラインに厳密に従うこと。
- すべての金額は日本円(JPY)で処理する。 消費税は内税・外税の設定に従い、端数は店舗設定(切り捨て/切り上げ/四捨五入)に準拠する。
- 軽減税率8%と標準税率10%を商品カテゴリに基づいて自動判定する。 飲食料品(テイクアウト含む)は8%、イートインは10%を適用する。
- 決済手段ごとの手数料率を正確に把握する。 クレジットカード3.24%、電子マネー3.24%、QRコード決済は各ブランドの料率に従う。入金サイクルも決済手段ごとに管理する。
- 在庫数がアラート閾値を下回った場合、自動通知を行う。 デフォルト閾値は在庫数5個とし、商品ごとにカスタム設定可能とする。
- 売上データはリアルタイムで集計し、日次・週次・月次のトレンドを追跡する。 前年同月比、前週比の自動算出を行う。
- 顧客データは個人情報保護法に準拠して管理する。 顧客の同意なく個人情報を第三者に提供しない。データの暗号化保存を必須とする。
- スタッフのシフト管理は労働基準法に準拠する。 6時間超勤務で45分、8時間超勤務で60分の休憩を自動チェックする。
- レジ締め処理は日次で実施し、現金過不足を記録する。 過不足が発生した場合はアラートを発行する。
- 決済端末との通信エラーが発生した場合、オフラインモードで取引を記録する。 ネットワーク復旧後に自動同期を行う。
- 商品マスタの変更は営業時間外に反映することを推奨する。 営業中の価格変更は確認プロンプトを表示する。
- 複数店舗の管理に対応する。 店舗間の売上比較、在庫移動、統合レポートを提供する。
- インボイス制度に対応したレシート・領収書を発行する。 登録番号、税率ごとの区分、適格請求書の要件を満たす。
- Airペイの入金スケジュールを自動追跡する。 みずほ銀行・三菱UFJ銀行・三井住友銀行は月6回、ゆうちょ銀行は月3回の入金サイクルに対応する。
- 売上分析には時間帯別、曜日別、天候との相関分析を含める。 ピークタイム予測によるシフト最適化を提案する。
- 不正決済の検知パターンを監視する。 同一カードの短時間連続利用、高額決済の急増など、異常パターンを検出してアラートする。
- 日次バックアップを自動実行する。 売上データ、商品マスタ、顧客データを暗号化してローカルに保存する。
- レポート出力はCSV、Excel、PDF形式に対応する。 税理士向けの仕訳データ出力にも対応し、freee・弥生会計・マネーフォワードのインポート形式をサポートする。
Environment Variables
| 変数名 | 必須 | 説明 | 例 |
|---|---|---|---|
| Yes | Airレジ/AirペイAPIキー | |
| Yes | 店舗ID | |
| Yes | 決済端末ID | |
| No | リクルートIDアカウント | |
| No | 決済完了通知のWebhook先 | |
| No | デフォルト税率(内税/外税) | |
| No | 通貨コード | |
| No | レシートロゴのパス | |
| No | 在庫アラート閾値 | |
| No | 入金先銀行コード | |
| No | ローカルデータ保存先 | |
| No | 複数店舗モード有効化 | |
Commands
1. airpay sales
— 売上管理
airpay sales日次・月次の売上データを照会・分析します。
airpay sales today --store str_tokyo_shibuya_001
出力例:
╔═══════════════════════════════════════════════════════════════╗ ║ 本日の売上サマリー(2026-03-01) ║ ║ 店舗: 渋谷本店 ║ ╠═══════════════════════════════════════════════════════════════╣ ║ ║ ║ 売上総額: ¥287,450 ║ ║ 取引件数: 48件 ║ ║ 客単価: ¥5,988 ║ ║ 前日比: +12.3%(¥255,800) ║ ║ 前年同日比: +8.7%(¥264,350) ║ ║ ║ ║ 時間帯別売上: ║ ║ ┌─────┬──────────┬──────┬───────────────────────────┐ ║ ║ │時間 │ 売上 │ 件数 │ グラフ │ ║ ║ ├─────┼──────────┼──────┼───────────────────────────┤ ║ ║ │10-11│ 12,300│ 3│ ██ │ ║ ║ │11-12│ 35,600│ 8│ ██████ │ ║ ║ │12-13│ 68,900│ 14│ ████████████ │ ║ ║ │13-14│ 42,100│ 9│ ███████ │ ║ ║ │14-15│ 18,500│ 4│ ███ │ ║ ║ │15-16│ 22,300│ 5│ ████ │ ║ ║ │17-18│ 45,200│ 7│ ████████ │ ║ ║ │18-19│ 42,550│ 6│ ███████ │ ║ ║ ├─────┼──────────┼──────┼───────────────────────────┤ ║ ║ │合計 │ 287,450│ 48│ │ ║ ║ └─────┴──────────┴──────┴───────────────────────────┘ ║ ║ ║ ║ 決済手段別: ║ ║ 現金: ¥98,200(34.2%) ║ ║ クレジットカード: ¥112,350(39.1%) ║ ║ 電子マネー: ¥45,600(15.9%) ║ ║ QRコード決済: ¥31,300(10.9%) ║ ╚═══════════════════════════════════════════════════════════════╝
2. airpay payment
— 決済処理・照会
airpay paymentAirペイ経由の決済状況を確認します。
airpay payment list --date 2026-03-01 --status settled
出力例:
決済一覧(2026-03-01 / 確定済み) ┌──────┬────────┬────────────┬──────────┬───────────┬──────────┐ │ 時刻 │ 決済ID │ 決済手段 │ 金額 │ 手数料 │ 入金予定 │ ├──────┼────────┼────────────┼──────────┼───────────┼──────────┤ │10:23 │ PY-001 │ VISA │ 8,800 │ 285 │ 03-05 │ │11:05 │ PY-002 │ Suica │ 1,200 │ 38 │ 03-05 │ │11:42 │ PY-003 │ PayPay │ 3,500 │ 115 │ 03-10 │ │12:15 │ PY-004 │ Mastercard │ 12,600 │ 408 │ 03-05 │ │12:33 │ PY-005 │ iD │ 2,800 │ 90 │ 03-05 │ │13:01 │ PY-006 │ JCB │ 6,400 │ 214 │ 03-10 │ │13:28 │ PY-007 │ LINE Pay │ 4,200 │ 138 │ 03-10 │ │14:55 │ PY-008 │ AMEX │ 15,800 │ 512 │ 03-15 │ ├──────┼────────┼────────────┼──────────┼───────────┼──────────┤ │ │ │ 合計 │ 55,300 │ 1,800 │ │ └──────┴────────┴────────────┴──────────┴───────────┴──────────┘ 手数料率平均: 3.26% 入金予定総額: ¥53,500
3. airpay inventory
— 在庫管理
airpay inventory商品の在庫状況を確認・更新します。
airpay inventory status --category "ドリンク" --alert-only
出力例:
在庫アラート(カテゴリ: ドリンク) ┌──────┬────────────────┬──────┬──────┬────────┬──────────┐ │ SKU │ 商品名 │ 在庫 │ 閾値 │ 状態 │ 発注推奨 │ ├──────┼────────────────┼──────┼──────┼────────┼──────────┤ │ D-12 │ オレンジジュース│ 3 │ 5 │ 要発注 │ 24本 │ │ D-18 │ ジンジャーエール│ 2 │ 5 │ 要発注 │ 24本 │ │ D-25 │ トニックウォーター│ 1 │ 5 │ 緊急 │ 48本 │ └──────┴────────────────┴──────┴──────┴────────┴──────────┘ 発注推奨量は過去30日間の平均販売数 x 7日分で算出 最終在庫更新: 2026-03-01 09:00
4. airpay customer
— 顧客管理
airpay customer顧客データの照会・分析を行います。
airpay customer top --period 2026-02 --limit 5
出力例:
優良顧客ランキング(2026年2月) ┌────┬──────────┬────────┬──────┬────────────┬──────────┐ │順位│ 顧客名 │ 来店数 │ 購入額│ 客単価 │ 会員区分 │ ├────┼──────────┼────────┼──────┼────────────┼──────────┤ │ 1 │ 佐藤 M. │ 12│ 89,400│ 7,450 │ ゴールド │ │ 2 │ 田中 K. │ 8│ 72,300│ 9,037 │ ゴールド │ │ 3 │ 鈴木 Y. │ 15│ 61,500│ 4,100 │ シルバー │ │ 4 │ 高橋 A. │ 6│ 54,200│ 9,033 │ シルバー │ │ 5 │ 渡辺 T. │ 9│ 48,600│ 5,400 │ レギュラー│ └────┴──────────┴────────┼──────┼────────────┼──────────┘ │合計 │ 平均 │ │326,000│ 7,004 │ リピート率: 68.3%(前月比 +2.1%) 新規顧客: 23名 / リピーター: 49名
5. airpay report
— 売上レポート
airpay report詳細な売上レポートを生成します。
airpay report monthly --month 2026-02 --format detailed
出力例:
月次売上レポート(2026年2月) ═══════════════════════════════════════════════════════════ 売上総額: ¥4,523,800 営業日数: 28日 日平均売上: ¥161,564 前月比: +5.2%(¥4,298,600) 前年同月比: +18.9%(¥3,804,200) カテゴリ別売上: フード: ¥2,890,400(63.9%) ドリンク: ¥1,205,200(26.6%) 物販: ¥428,200(9.5%) 曜日別平均売上: 月: ¥128,300 火: ¥132,500 水: ¥141,200 木: ¥148,600 金: ¥198,400 土: ¥215,800 日: ¥165,700 決済手数料合計: ¥98,420(売上比 2.18%) 純売上: ¥4,425,380 入金実績: 3月5日入金予定: ¥1,820,300 3月10日入金予定: ¥1,205,400 3月15日入金予定: ¥680,200 3月20日入金予定: ¥719,480
6. airpay staff
— スタッフ管理
airpay staffスタッフのシフト管理と売上実績を確認します。
airpay staff performance --period 2026-02
出力例:
スタッフ実績(2026年2月) ┌────────┬──────────┬──────┬──────────┬────────┬──────────┐ │ ID │ 名前 │勤務日│ 担当売上 │ 時給 │ 評価 │ ├────────┼──────────┼──────┼──────────┼────────┼──────────┤ │ STF-01 │ 山田花子 │ 22│ 1,280,000│ 1,200│ ★★★★★ │ │ STF-02 │ 佐藤太郎 │ 20│ 1,050,000│ 1,150│ ★★★★ │ │ STF-03 │ 鈴木美咲 │ 18│ 890,000│ 1,100│ ★★★★ │ │ STF-04 │ 高橋翔 │ 15│ 620,000│ 1,050│ ★★★ │ │ STF-05 │ 田中優 │ 12│ 480,000│ 1,050│ ★★★ │ └────────┴──────────┴──────┴──────────┴────────┴──────────┘ 総人件費: ¥1,245,600 人件費率: 27.5%(目標30%以下: 達成)
7. airpay settlement
— 入金管理
airpay settlementAirペイからの入金スケジュールと実績を確認します。
airpay settlement upcoming --month 2026-03
出力例:
入金スケジュール(2026年3月) ┌──────────┬──────────────┬──────────┬───────────┬────────┐ │ 入金日 │ 対象期間 │ 売上額 │ 手数料 │ 入金額 │ ├──────────┼──────────────┼──────────┼───────────┼────────┤ │ 03-05 │ 02/16-02/20 │ 458,200│ 14,863 │443,337│ │ 03-10 │ 02/21-02/25 │ 512,300│ 16,619 │495,681│ │ 03-15 │ 02/26-02/28 │ 345,600│ 11,209 │334,391│ │ 03-20 │ 03/01-03/05 │ 398,400│ 12,924 │385,476│ │ 03-25 │ 03/06-03/10 │ 467,500│ 15,167 │452,333│ │ 03-31 │ 03/11-03/15 │ 489,200│ 15,871 │473,329│ ├──────────┼──────────────┼──────────┼───────────┼────────┤ │ 合計 │ │2,671,200│ 86,653 │2,584,547│ └──────────┴──────────────┴──────────┴───────────┴────────┘ 入金先: 三菱UFJ銀行 渋谷支店 普通 1234567 平均手数料率: 3.24%
8. airpay menu
— 商品・メニュー管理
airpay menu商品マスタの登録・編集・一括管理を行います。
airpay menu add --name "季節のフルーツパフェ" \ --category "デザート" --price 1280 \ --tax-rate 10 --cost 420
出力例:
商品登録完了 商品ID: PRD-0156 商品名: 季節のフルーツパフェ カテゴリ: デザート 販売価格: ¥1,280(税込¥1,408) 原価: ¥420 原価率: 32.8%(目標35%以下: 達成) 税率: 10%(標準税率) バーコード: 自動生成済み 表示順: デザートカテゴリ末尾 テイクアウト対応: 未設定 → テイクアウト販売する場合は --takeout オプションを追加 (軽減税率8%が自動適用されます)
Workflow Diagram
┌──────────────────────────────────────────────────────────────────┐ │ Airpay Agent 店舗運営ワークフロー │ │ │ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │ │ 開店準備 │───▶│ 営業中 │───▶│ レジ締め │───▶│ 日次集計 │ │ │ │ │ │ │ │ │ │ │ │ │ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │ │ │ │ │ │ │ │ ▼ ▼ ▼ ▼ │ │ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │ │ │在庫確認 │ │注文入力 │ │現金突合 │ │売上分析 │ │ │ │スタッフ │ │決済処理 │ │過不足 │ │レポート │ │ │ │確認 │ │レシート │ │記録 │ │出力 │ │ │ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │ │ │ │ │ │ ▼ ▼ │ │ ┌──────────┐ ┌──────────┐ │ │ │在庫自動 │ │月次決算 │ │ │ │減算 │ │会計連携 │ │ │ │発注提案 │ │税務出力 │ │ │ └──────────┘ └──────────┘ │ │ │ │ ──── 定期処理 ───────────────────────────────────── │ │ │ 入金確認 │ 在庫棚卸 │ シフト作成 │ 売上予測 │ │ │ └──────────────────────────────────────────────┘ │ └──────────────────────────────────────────────────────────────────┘
Error Handling
Error 1: 決済端末通信エラー
[AIRPAY-E001] 決済端末との通信に失敗しました 端末ID: trm_ap2_00123456 エラー: Bluetooth接続がタイムアウトしました 対処: 1. 端末の電源を確認してください 2. iPadのBluetooth設定を確認してください 3. 端末を再起動して再接続してください フォールバック: 現金決済モードで取引を記録しますか? [Y/n]
Error 2: 在庫数不整合
[AIRPAY-E002] 在庫数の不整合を検出しました 商品: PRD-0089 オレンジジュース システム在庫: 15本 実棚卸数: 12本 差異: -3本 対処: 差異の原因を選択してください 1. 廃棄(消費期限切れ等) 2. 破損 3. 原因不明(ロス計上) 選択: [1/2/3]
Error 3: カード決済拒否
[AIRPAY-E003] カード決済が拒否されました 決済ID: PY-TMP-00456 カード: VISA ****-****-****-7890 金額: ¥15,800 理由: 与信枠超過(カード発行会社による拒否) 対処: お客様に別の決済手段をご案内ください。 記録: 拒否ログに記録済み(監査用)
Error 4: レジ締め不一致
[AIRPAY-E004] レジ締め時の現金過不足 レジ内現金: ¥152,300 システム計上: ¥153,800 差異: -¥1,500(不足) 対処: 過不足として記録しました。 仕訳: 現金過不足 1,500 / 現金 1,500 アラート: 管理者(山田花子)に通知済み
Error 5: API認証エラー
[AIRPAY-E005] API認証に失敗しました エラーコード: 401 Unauthorized 原因: AIRPAY_API_KEY が無効または期限切れです 対処: 1. Airレジ管理画面からAPIキーを再発行してください 2. AIRPAY_API_KEY 環境変数を更新してください 3. airpay auth verify で認証状態を確認してください
Error 6: 複数店舗データ同期エラー
[AIRPAY-E006] 店舗間データ同期に失敗しました 対象店舗: str_tokyo_shinjuku_002 エラー: ネットワーク接続が不安定です 影響: 商品マスタの更新が反映されていません 対処: 次回のネットワーク接続時に自動同期を実行します。 手動同期: airpay sync --store str_tokyo_shinjuku_002 --force
FAQ
Q1: Airレジの初期費用はかかりますか?
Airレジアプリ自体は無料です。iPadとAirペイカードリーダー(実質無料キャンペーンあり)があれば導入できます。Airpay Agentも無料で利用可能です。
Q2: Airペイの決済手数料はいくらですか?
業界最安水準の3.24%です。VISA、Mastercard、JCB、AMEX、Diners Club、Discover、交通系ICカード(Suica等)、iD、QUICPayがすべて3.24%です。PayPay、d払い、au PAYなどのQRコード決済も対応しています。
Q3: 入金サイクルはどうなっていますか?
みずほ銀行・三菱UFJ銀行・三井住友銀行は月6回(5日ごと)の入金です。ゆうちょ銀行は月3回です。その他の銀行は月3回〜6回で、振込手数料は無料です。
Q4: 軽減税率にどのように対応していますか?
商品登録時にカテゴリと税率を設定することで自動判定します。飲食料品のテイクアウト(8%)とイートイン(10%)の切り替えは、注文時にオプションで指定できます。
Q5: 複数店舗を一括管理できますか?
AIRPAY_MULTI_STORE=true を設定することで、複数店舗のデータを統合管理できます。店舗間の売上比較、在庫移動指示、統合レポートの作成が可能です。
Q6: オフライン時でも使えますか?
Airレジはオフライン時でも注文入力とレシート発行が可能です。Airpay Agentはオフライン時のデータをローカルにキャッシュし、オンライン復帰後に自動同期します。ただし、カード決済はオンライン接続が必要です。
Q7: 既存のPOSシステムからデータ移行できますか?
CSVインポート機能により、他のPOSシステムからの商品マスタ、顧客データの移行に対応しています。
airpay import csv --file products.csv --type menu で一括インポートできます。
Q8: 会計ソフトとの連携はできますか?
freee、弥生会計、マネーフォワードクラウドへの仕訳データ出力に対応しています。
airpay export --format freee で各ソフトのインポート形式でエクスポートできます。
Q9: インボイス制度に対応したレシートは発行できますか?
対応しています。適格請求書発行事業者の登録番号を設定すれば、インボイス制度の要件を満たすレシート(簡易適格請求書)が自動発行されます。税率ごとの区分記載も自動で行われます。
Q10: セキュリティ対策はどうなっていますか?
Airペイは PCI DSS(Payment Card Industry Data Security Standard)に準拠しています。Airpay Agentではカード番号を一切保持せず、トークン化された決済IDのみを管理します。ローカルデータは AES-256 で暗号化保存されます。
Q11: スタッフごとの売上を追跡できますか?
各スタッフにログインIDを発行し、担当した取引を紐づけることで、スタッフ別の売上実績、客単価、取引件数を追跡できます。評価指標として活用可能です。
Q12: 在庫の自動発注はできますか?
在庫が閾値を下回った際に自動で発注推奨リストを生成します。過去の販売データから適正在庫数を算出し、発注数量を提案します。発注そのものは手動確認が必要です。
Data Storage
Airpay Agentのローカルデータは以下のディレクトリ構造で保存されます。
~/.airpay-agent/ ├── config/ │ ├── settings.json # エージェント設定 │ ├── stores/ # 店舗設定 │ │ ├── str_tokyo_shibuya_001.json │ │ └── str_tokyo_shinjuku_002.json │ ├── tax-rates.json # 税率マスタ │ └── receipt-templates/ # レシートテンプレート │ ├── default.json │ └── invoice-compliant.json ├── data/ │ ├── sales/ # 売上データ(日次) │ │ └── 2026/ │ │ └── 03/ │ │ ├── 01.json │ │ └── ... │ ├── transactions/ # 決済トランザクション │ │ └── 2026/ │ │ └── 03/ │ │ ├── PY-001.json │ │ └── ... │ ├── inventory/ # 在庫データ │ │ ├── current.json # 現在在庫 │ │ ├── history/ # 在庫変動履歴 │ │ └── alerts/ # 在庫アラート │ ├── customers/ # 顧客データ(暗号化) │ │ ├── CLT-0001.enc │ │ └── ... │ ├── staff/ # スタッフデータ │ │ ├── STF-01.json │ │ └── shifts/ │ │ └── 2026-03.json │ ├── menu/ # 商品マスタ │ │ ├── products.json │ │ └── categories.json │ ├── settlements/ # 入金データ │ │ └── 2026/ │ │ └── 03/ │ └── reports/ # 生成レポート │ ├── monthly_2026_02.pdf │ └── monthly_2026_02.csv ├── logs/ │ ├── api.log # APIリクエストログ │ ├── transactions.log # 決済ログ │ ├── audit.log # 監査ログ │ └── error.log # エラーログ ├── cache/ │ ├── tokens.enc # 認証トークン(暗号化) │ ├── offline-queue.json # オフライン時の未同期データ │ └── product-cache.json # 商品マスタキャッシュ ├── assets/ │ └── logo.png # レシートロゴ └── backup/ └── 2026/ ├── 02/ └── 03/
Comparison Table
| 機能 | Airpay Agent | Square | stera terminal | PayPay Biz |
|---|---|---|---|---|
| CLI操作 | 対応 | 非対応 | 非対応 | 非対応 |
| Claude Code統合 | 対応 | 非対応 | 非対応 | 非対応 |
| POSレジ機能 | Airレジ(無料) | Square POS(無料) | 有料 | 非対応 |
| 初期費用 | 実質無料 | 無料〜 | 端末有料 | 無料 |
| 決済手数料 | 3.24%均一 | 3.25%〜 | 3.24%〜 | 1.60%〜 |
| クレジットカード | 6ブランド | 6ブランド | 6ブランド | 非対応 |
| 電子マネー | 対応 | 一部対応 | 対応 | 非対応 |
| QRコード決済 | 対応 | 非対応 | 対応 | PayPayのみ |
| 入金サイクル | 月3〜6回 | 翌営業日 | 月2回 | 翌日 |
| 振込手数料 | 無料 | 無料 | 銀行による | 無料 |
| 在庫管理 | 対応 | 対応 | 基本のみ | 非対応 |
| 顧客管理 | 対応 | 対応 | 非対応 | 限定的 |
| スタッフ管理 | 対応 | 対応 | 非対応 | 非対応 |
| インボイス対応 | 対応 | 対応 | 対応 | 対応 |
| 複数店舗管理 | 対応 | 対応 | 限定的 | 非対応 |
| 売上分析・AI予測 | 対応 | 基本分析 | 基本分析 | 基本分析 |
| 会計ソフト連携 | freee/弥生/MF | freee | 非対応 | 非対応 |
| オフライン対応 | キャッシュ | 対応 | 非対応 | 非対応 |
| バッチ処理 | 対応 | 非対応 | 非対応 | 非対応 |
| レポート出力 | CSV/Excel/PDF | CSV/PDF | CSV | |
| API公開 | 対応 | 対応 | 限定的 | 非対応 |
Airpay Agentの最大の優位性は、リクルートの「Air」エコシステム(Airレジ、Airペイ、Airシフト、Airリザーブ等)との統合的な連携と、Claude Codeからのコマンドライン操作が可能な点です。POSレジアプリが無料であること、決済手数料が業界最安水準の3.24%均一であること、そして振込手数料が無料であることは、特に中小規模の店舗にとって大きなメリットです。本スキルを導入することで、店舗オーナーはターミナルから売上分析・在庫管理・スタッフ管理をリアルタイムに実行でき、店舗運営のDXを加速させることができます。
License
MIT License - hanabi-jpn