いいかんじ™家計簿

iPhone ショートカットで AI 証憑仕訳

iPhone の ショートカット アプリで、レシートを撮影するだけで AI が仕訳候補を自動作成するショートカットを作ります。

完成イメージ:

完成イメージ

ショートカットを起動 → カメラで撮影 → API に送信 → 写真をアルバムに保存。あとはアプリの AI 証憑仕訳画面で確認して仕訳を確定するだけです。

事前準備

ショートカットを使う前に、いいかんじ™家計簿の設定を2つ済ませておきます。

1. 外部 AI の設定

設定 > 外部AI から AI プロバイダーを設定します。

項目 例
プロバイダー OpenAI / Gemini / Claude / Ollama
API キー プロバイダーの API キー
モデル gpt-4o / gemini-2.0-flash 等

2. API キーの発行

設定 > APIキー管理 から新しい API キーを発行します。

重要: API キーは発行時の1回しか表示されません。必ずその場でコピーしてください。

ショートカットの作成

Step 1: 新規ショートカットを作成

  1. ショートカット アプリを開く
  2. 右上の + ボタンをタップ
  3. 上部のショートカット名をタップして名前を付ける（例: 「レシート AI 仕訳」）

Step 2: 「写真を撮る」アクションを追加

  1. 下部の検索バーで 「写真」 と検索
  2. 「写真を撮る」 をタップして追加
  3. 「カメラプレビューを表示」 をオンにしておく

これでショートカット実行時にカメラが起動し、レシートを撮影できます。

Step 3: 「URL の内容を取得」アクション（API 呼び出し）

レシート画像を API に送信します。

  1. 「URL の内容を取得」 アクションを追加
  2. 以下の通り設定:
設定項目 値
URL https://your-server.example.com/api/v1/ai/analyze
方法 POST
  1. 「ヘッダ」 をタップして1行追加:
キー 値
Authorization Bearer ik_ここにAPIキーを貼る
  1. 「本文を要求」 を 「フォーム」 に変更し、フィールドを追加:
キー 型 値
image ファイル （自動で「写真を撮る」の出力が入る）
notify テキスト 1（Discord 通知が不要なら省略可）

ポイント: image フィールドの型は必ず 「ファイル」 を選んでください。「テキスト」のままだと画像データが正しく送信されません。

Step 4: 「写真をアルバムに保存」アクション（任意）

撮影したレシート画像を写真アプリに残しておきたい場合:

  1. 「写真アルバムに保存」 アクションを追加
  2. 保存先アルバムをタップして、任意のアルバム名を指定（例: 「レシート」）

保存する写真は 「写真を撮る」の出力（カメラで撮った写真）を指定します。

ホーム画面に追加

作成したショートカットをホーム画面に配置すると、ワンタップで起動できます。

  1. ショートカット一覧で 「レシート AI 仕訳」 を長押し
  2. 「ホーム画面に追加」 をタップ
  3. アイコンと名前を設定して 「追加」

使い方

  1. ホーム画面の 「レシート AI 仕訳」 をタップ
  2. カメラが起動 → レシートを撮影
  3. API に自動送信され、Discord にも通知が届く
  4. いいかんじ™家計簿の AI 証憑仕訳 画面を開く
  5. 候補を確認して 「この仕訳を登録」 で確定

Tips