トラブルシューティング

よくある問題とその対処法。

“Can only send testing emails to your own email address”

原因： Resend 無料枠の制限です。

対処： RECIPIENT_EMAIL を Resend にサインアップしたときに使ったメールアドレスと同じものに設定するか、Resend でカスタムドメインを認証してください（Dashboard → Domains → Add Domain → DNS レコードを追加）。

原因： 新しい Gemini API キーは有効化に数分かかります。請求と API が有効化されていないと、一部のキーはまったく動作しないことがあります。

対処： 以下の手順を順番に試してください：

5〜10 分待つ — 新しいキーは有効化に時間が必要なことがあります
Generative Language API を有効化 — Google Cloud Console に移動 → 「Generative Language API」を検索 → API キーに関連付けられたプロジェクトで Enable をクリック
請求情報を追加 — Google AI Studio に移動 → Settings → Billing で請求情報を追加。無料枠を選択することは引き続き可能です — 請求情報の追加はキーの有効化のためで、無料の制限を超えない限り課金されません

その間、Richfolio は自動的にギャップベースの推奨にフォールバックします — ブリーフは引き続き配信されますが、AI 分析がないだけです。

原因： Yahoo Finance は特定のティッカー（特に BIPC のようにあまり一般的でないもの）で時折問題が起きることがあります。

対処： 対応不要です。そのティッカーはスキップされ、残りは通常通り続行されます。これは Yahoo Finance の断続的な問題です。

原因： Secret が間違ったレベルで追加されました。

対処： Secret がリポジトリレベルで追加されていることを確認してください：Settings → Secrets and variables → Actions → Repository secrets。環境レベルではありません。

原因： NewsAPI 無料枠は直近 24 時間の記事のみを返します。一部のティッカー（特に ETF や小型株）はニュースヘッドラインに登場することが稀です。

対処： これは正常な挙動です。それらのティッカーについてはニュースなしでブリーフは問題なく実行されます。AI 分析は推奨の中で「最近のニュースなし」と記載します。

原因： ボットとの会話をまだ開始していません。

対処： Telegram を開き、ユーザー名でボットを検索し、何かメッセージ（例：「hi」）を送ってください。Telegram Bot API では、ボットがメッセージを送れるようにするにはユーザーが先にコンタクトを開始する必要があります。その後、Richfolio を再実行してください。

原因： プロジェクトルートに config.json が存在しません。

対処：

GitHub Actions： CONFIG_JSON 変数が有効な JSON 内容で存在することを確認してください（Settings → Secrets and variables → Actions → Variables タブ）。
ローカル： cp config.example.json config.json を実行し、ポートフォリオデータで編集してください。

原因： 1 つ以上の API キーが欠けているか無効です。

対処： .env ファイル（ローカル）または GitHub Secret（Actions）を確認してください。ブリーフは利用可能なものに応じて適応します：

すべての組み合わせが有効です — 必須なのは RESEND_API_KEY と RECIPIENT_EMAIL だけです。