Raindrop要約メール配信サービス（セットアップ手順）

Raindrop.io に保存したリンクを、GitHub Actions の定期実行で要約し、AWS SES 経由でメール配信します。

詳細仕様（エンジニア向け）は docs/spec.md を参照してください。

---

0. 用意するもの（アカウント）

• GitHub（このリポジトリをフォークして利用するのがおすすめ）
• Raindrop.io（ブックマーク保存先）
• OpenAI（要約用API）
• AWS SES（メール送信用）

---

1. リポジトリを準備

1. GitHub 上でこのリポジトリをフォーク（または自分のリポジトリにコピー）

2. ローカルにクローン（GitHub の画面上だけで設定する場合、クローンは必須ではありません）

git clone <あなたのリポジトリURL>

---

2. OpenAI APIキーを取得

1. OpenAI の API Keys ページでキーを作成
   https://platform.openai.com/api-keys

Permissionsの設定方法 Restricted タブで Model capabilities → Responses：許可 他は すべて None（未選択）

2. 作成したキーを控える（あとで GitHub Secrets に登録）

---

3. Raindrop APIトークンを取得

1. Raindrop の Integrations / API token 画面でトークン(Test Token)を発行
   https://app.raindrop.io/settings/integrations

2. トークンを控える（あとで GitHub Secrets に登録）

---

4. AWS SES を設定（メール送信）

4.1 送信元の確認（Sender）

SES で送信元メールアドレスまたはドメインを検証します。

参考: https://docs.aws.amazon.com/ses/latest/dg/verify-addresses-and-domains.html

4.2 認証情報を用意

GitHub Actions から SES を呼び出すために、GitHub Actions OIDC + IAM Role を利用します。

• IAM ユーザーの AWS_ACCESS_KEY_ID / AWS_SECRET_ACCESS_KEY は使いません
• セットアップ手順（Terraform側）は aws-terraform を参照してください
  • https://github.com/takurooper/aws-terraform/tree/main/ses-setup
  • https://github.com/takurooper/aws-terraform/blob/main/ses-setup/GITHUB_ACTIONS_SETUP.md

4.3 迷惑メール対策（重要）

メールが「迷惑メール」に入る場合があります。以下を推奨します。

• 送信元ドメインを検証し、可能なら SPF/DKIM を設定
• 受信側（Gmail など）で FROM_EMAIL を「連絡先に追加」/ フィルタで受信トレイへ振り分け
• 会社/学校メールの場合、ドメイン指定受信（ホワイトリスト）に FROM_EMAIL を追加

---

5. GitHub Actions に設定を登録

GitHub のリポジトリ画面で Settings → Secrets and variables → Actions を開きます。

5.1 Secrets（機密情報）

Secrets タブで以下を追加します。

• RAINDROP_TOKEN（Raindrop API token）
• OPENAI_API_KEY
• AWS_ROLE_ARN（GitHub Actions が引き受けるIAM RoleのARN）
• （任意）SUMMARY_SYSTEM_PROMPT（要約プロンプトをカスタムしたい場合）

※ AWSリージョンはワークフロー側（.github/workflows/schedule_run.yml の aws-region）で設定します。

SUMMARY_SYSTEM_PROMPT は複数行でもOKです。未設定の場合はコード内のデフォルトプロンプトが使われます。

5.2 Variables（機密でない設定）

Variables タブで以下を追加します。

• TO_EMAIL（配信先メールアドレス）
• FROM_EMAIL（送信元メールアドレス）
• FROM_NAME（送信元表示名。例: Raindrop要約メール配信サービス）
• （任意）OPENAI_MODEL（例: gpt-4.1-mini）
• （任意）BATCH_LOOKBACK_DAYS（バッチで対象とする過去日数。未設定なら 1）

---

6. GitHub Actions を実行する

1. リポジトリの Actions タブを開く
2. Digest and Mail Raindrop ワークフローを選ぶ
3. Run workflow で手動実行（最初の動作確認におすすめ）

スケジュール実行（cron）は .github/workflows/schedule_run.yml に定義されています。

---

7. 使い方（運用）

• Raindrop にリンクを保存します（保存先は「未整理」想定）。
• 一定日数分の新着を対象に要約してメールします。
• 次回以降の重複処理を避けるため、処理済みのアイテムにはタグ 配信済み が付きます。
• 確認済み タグが付いているアイテムは要約対象外です。

※ 要約のために、記事本文を OpenAI API に送信します。機密情報を含むページは保存しないでください。本文が1000文字未満のリンクは、情報量不足の可能性がある旨の注意書きがメールに入ります。

---

8. よくあるトラブル

• メールが来ない
  • Actions の実行ログを確認（失敗している場合はログに出ます）
  • 迷惑メールフォルダを確認（上記「迷惑メール対策」を参照）
• どのメールプロバイダーが使われているか確認したい
  • GitHub Actions のログに Using mail provider=ses と出ます
• OpenAI のエラーが多い
  • 一時的な 502/503/504 は 1 回だけリトライします
  • それ以外の失敗は該当リンクのみ失敗扱いになり、メールには「手動確認」として載ります
• 特定サイトの本文取得が 403 Forbidden で失敗する
  • サイト側のbot対策で弾かれている可能性があります。Variables に HTTP_USER_AGENT（Chrome/Firefox等のブラウザUA）を設定してください。