Benepass 費用払い戻しスキル

Benepass 費用払い戻しスキル は何をしますか？

ブラウザ自動操作、Gmail 統合による認証コード取得、領収書ファイルのアップロードを使用して、Benepass での費用払い戻しフロー（ログインから提出まで）を完全に自動化します。

---

前提条件

• ブラウザアクセス（コンピューターツール）を有効にして Benepass を操作できるようにする
• コード実行 & ファイル作成を有効にする — 領収書ファイルの保存とアップロードに必要
• Gmail MCP を設定し、メール認証コードを取得できるようにする
• Gmail MCP を使用してメールアドレスを特定する。Gmail アクセスが利用できない場合はユーザーに問い合わせる
• 領収書画像（スクリーンショット、写真、または PDF）を入手する

---

ステップ 1: 領収書の詳細を抽出する

Benepass にアクセスする前に、領収書画像またはメッセージから以下の主要情報を抽出します：

• 金額（例: $84.99）
• 事業者名（例: Verizon、DoorDash、Lyft）
• メモ/備考 — 指示されたメモを適用する。それがない場合は短い説明をデフォルトにする（例：「自宅Wi-Fi」、「昼食」、「オフィスまでの移動」）
• 給付金カテゴリ — 指定されたカテゴリを選択する。確信がある場合は文脈から推測し、それ以外の場合は確認を求める（ステップ 4 を参照）

---

ステップ 2: Benepass にログインする

2a. サイトに移動し、メールアドレスを入力する

Navigate to: https://app.getbenepass.com

• メール入力フィールドをクリックし、メールアドレスを入力する
• 2 つのログインオプションが表示されます：「Log in with G-Suite」と「Log in with Email Code」
• 「Log in with Email Code」をクリックする

2b. Gmail から認証コードを取得する

「Enter verification code」プロンプト（6 桁入力ボックス）が表示されるのを待ちます。

Gmail MCP を使用してコードを取得します：

Gmail search query: "from:benepass verification code"
maxResults: 1

• メールのスニペットから 6 桁のコードを抽出します（「Your verification code is: XXXXXX」を探す）
• 6 桁のコードを認証入力欄に入力します — 6 桁すべてが入力されるとページが自動送信されます
• ダッシュボードが読み込まれるまで 3〜5 秒待ちます

2c. ログイン成功を確認する

ダッシュボードに挨拶、アカウント残高、インサイトカードが表示されることを確認し、ログイン成功を確認します。

重要: 期限切れの認証コードには以下のように対処します：

• 認証ページの「Didn't receive it? Resend」をクリックする
• 5 秒待ってから、新しいコードを Gmail で再度検索する

---

ステップ 3: 払い戻しを開始する

• 左サイドバーの「Get reimbursed」ボタンをクリックする
• 払い戻しフォームが読み込まれて 2 つのセクションが表示されるのを待つ:
  1. 給付金を選択（ドロップダウン）
  2. 詳細を入力（金額、事業者名、メモ、領収書）

---

ステップ 4: 給付金を選択する

• 「Select benefit」ドロップダウンをクリックする
• 指定されたカテゴリを選択する。確信がある場合は文脈から推測し、それ以外の場合は確認を求める
• 利用可能な給付金オプションはドロップダウンから直接読み取る — カテゴリは雇用主によって異なります
• 選択した給付金の表示残高が払い戻し金額をカバーしていることを確認する

---

ステップ 5: 詳細を入力する

金額フィールド

重要: 正しい金額を入力する前に、金額フィールドから事前に入力された値を必ずクリアしてください。

• 金額フィールドをトリプルクリックして既存の値を選択する
• 正しい金額を入力する（例: 84.99）
• $ 記号は含めず、数字のみを入力する

事業者名フィールド

• 事業者名入力フィールドをクリックする
• 事業者名を入力する（例: Verizon、DoorDash、Lyft）

メモフィールド（任意だが推奨）

• メモ入力フィールドをクリックする
• メモを入力する（例: 自宅Wi-Fi、昼食、オフィスまでの移動）

---

ステップ 6: 領収書をアップロードする

重要: ファイル入力は id="fileInput" を持つ隠し要素です。表示されているドロップゾーンはクリックできません — 代わりに隠し入力を使います。id="fileInput" の要素が見つからない場合は、ページ上の <input type="file"> を検索します。

1. filter: interactive を指定して read_page を使用し、ファイル入力要素を見つける
2. 以下を探す: <input id="fileInput" class="hidden" type="file">
3. 以下のように、その隠し入力の ref を指定して upload_file ツールを使用する：

upload_file:
  file_path: <領収書ファイルへのパス>
  ref: <fileInput の ref>

4. アップロード後、以下を確認する：
   • Receipt ラベルが赤色ではなくなっている（アップロード前は赤色）
   • ファイル名とサイズを示す「Files uploaded」セクションが表示されている
   • 領収書のサムネイルプレビューが表示されている

---

ステップ 7: 提出する

• 下にスクロールして「Submit reimbursement」ボタンを表示する
• 送信をクリックする前に、確認用のサマリを提示する：
  • 給付金カテゴリ
  • 金額
  • 事業者名
  • メモ/備考
  • 領収書ファイル名
  • この提出後の残り給付金残高
• 明示的な承認があるまで待つ
• 「Submit reimbursement」をクリックする
• 処理に 3 秒待つ

提出成功を確認する

送信後、ページは経費詳細ビューにリダイレクトされ、以下が表示されます：

• 状態: 保留中
• 支払い方法: 払い戻し
• 給付金: 選択した給付金名
• 支払い進捗: 未払い額 = 提出金額

確認を報告します。

---

トラブルシューティング

セッションの期限切れ

エラーが発生したり、ページがログインページにリダイレクトされた場合は、ステップ 2（ログイン）から再開してセッション期限切れに対処します。

認証コードが機能しない

期限切れの認証コードに対処します：「Didn't receive it? Resend」をクリックし、数秒待ってから Gmail で新しいコードを再検索します。最新のメールが取得されるようにします（デフォルトのソートで maxResults: 1 を使用）。

金額フィールドの癖

新しい金額を入力する前に、常に金額フィールドをトリプルクリックして既存のテキストをすべて選択します — これにより連結（例: 32184.99）を防ぎます。

アップロードが認識されない

領収書のアップロードが機能していないように見える場合：

1. read_page でページを再読み込みし、fileInput の ref を見つける
2. fileInput が見つからない場合は、<input type="file"> 要素を検索する
3. 正しい ref を指定して upload_file でアップロードを再試行する
4. アップロード後に「Files uploaded」セクションが表示されることを確認する

給付金残高が不足している

選択した給付金に十分な残高がない場合は、問題を報告し、別の給付金カテゴリを使用するかどうかを確認します。