LINE Bot for Developers

概要

このプロジェクトは、開発者向けの技術記事をLINEで自動配信するBotです。RSSフィードから最新記事を収集し、Gemini APIによるAI分析（要約、タグ付け、クイズ生成）を行い、リッチなFlex Messageとしてユーザーに届けます。記事データはPostgreSQLデータベースで管理され、未読記事の段階的配信やキーワード検索が可能です。

主な機能

• RSSフィードからの自動記事収集: config/feeds.php で設定されたRSSフィードから定期的に最新記事を取得します。
• AIによる記事分析: Gemini APIを利用して、記事の要約、関連タグの抽出、内容に関する三択クイズを自動生成します。
• LINE Flex Message: 記事のタイトル、要約、タグ、クイズを、視覚的に分かりやすいリッチなメッセージで配信します。
• データベースによる記事管理: 記事データはPostgreSQLに保存され、効率的に管理されます。
• 未読記事の段階的配信: 「最新情報」というメッセージで、未読の記事を最大10件ずつ配信します。
• キーワード検索: 「最新情報 [キーワード]」という形式で、過去記事の検索が可能です。
• インタラクティブなクイズ機能: 記事内容に関するクイズに、ボタンをタップして直感的に回答できます。
• カスタマイズ可能なリッチメニュー: トーク画面下部のメニューを、専用スクリプトで簡単に設定・更新できます。

技術スタック

• 言語: PHP 8.2
• Webサーバー: Apache
• データベース: PostgreSQL
• LINE API: Messaging API
• AI: Google Gemini API
• ホスティング: Render (Web Service)
• CI/CD & 定期実行: GitHub Actions
• コンテナ技術: Docker

---

セットアップガイド

1. リポジトリのクローン

まず、このリポジトリをローカル環境にクローンします。

git clone https://github.com/your-username/your-repository-name.git
cd your-repository-name

2. Renderでのサービス準備

このBotは、LINEからのWebhookを常時待機する「Web Service」をRender上で実行します。

1. PostgreSQLデータベースの作成

   • Renderのダッシュボードで、新規にPostgreSQLデータベースを作成します（Freeプランで十分です）。
   • 作成後、データベースの詳細画面から「Internal Connection String」をコピーしておきます。これがDATABASE_URLになります。

2. Web Serviceのデプロイ

   • このGitHubリポジトリを元に、Renderで新しい「Web Service」を作成します。
   • ランタイムとして「Docker」を選択します。Renderは自動的にプロジェクトルートのDockerfileを認識し、ビルドします。

3. 環境変数の設定

作成したWeb Serviceの「Environment」タブで、以下の環境変数を設定します。後述するGitHub Actionsでも同様のシークレット設定が必要です。

キー	説明
DATABASE_URL	手順2-1でコピーしたPostgreSQLの内部接続URL。
LINE_CHANNEL_ACCESS_TOKEN	LINE Developersで取得した、Messaging APIのチャネルアクセストークン。
LINE_CHANNEL_SECRET	LINE Developersで取得した、チャネルシークレット。
AI_API_KEY	Google AI Studioで取得した、Gemini APIのAPIキー。
SCRAPING_API_KEY	Browserless.ioのAPIキー（記事の本文取得精度向上、任意）。
LINE_USER_ID	テスト通知を受け取るあなたのLINEユーザーID（任意）。

4. データベースのテーブル作成

run_daily.phpスクリプトは、articlesテーブルが存在しない場合に自動で作成する機能を持っています。後述するGitHub Actionsを一度実行することで、テーブルが初期化されます。

5. リッチメニューの設定

ユーザーが最初に目にするリッチメニューを設定します。

1. 画像ファイルの準備

   • richmenu.png というファイル名で、リッチメニューとして表示したい画像を作成します（推奨サイズ: 2500x1686px、1MB未満）。
   • 作成したファイルをプロジェクトのルートに配置し、コミット・プッシュします。

2. 設定スクリプトの実行

   • GitHubリポジトリの「Actions」タブ -> 「Send LINE Notification」ワークフローを選択します。
   • 「Run workflow」ボタンを押し、表示されるドロップダウンから setup_rich_menu を選択して実行します。
   • これにより、richmenu.pngが読み込まれ、全ユーザーのデフォルトリッチメニューとして設定されます。

6. 定期実行の設定 (GitHub Actions)

記事の自動収集は、.github/workflows/notify.yml に定義されたGitHub Actionsによって行われます。

1. シークレットの登録

   • GitHubリポジトリの「Settings」->「Secrets and variables」->「Actions」を開きます。
   • 「New repository secret」ボタンを押し、手順3でリストアップした環境変数をすべて登録します。

2. 動作確認

   • Actionsタブから「Send LINE Notification」ワークフローを手動実行（daily_notifyを選択）し、ログにエラーが出ないことを確認します。
   • 成功すれば、スケジュールに従って毎日自動で記事が収集・分析され、データベースに保存されます。

---

使い方

LINE Botに以下のメッセージを送信することで、機能を呼び出せます。

• 最新情報 未読の最新記事を最大10件、カルーセル形式で表示します。続けて送信すると、次の未読記事が表示されます。

• 最新情報 [キーワード] （例: 最新情報 PHP） タイトルや要約にキーワードを含む記事を検索し、新しいものから最大10件表示します。

• クイズの回答 記事と共に配信されるクイズには、選択肢のボタンをタップして回答できます。正解・不正解がその場で分かります。

カスタマイズ

RSSフィードの追加・変更

config/feeds.php ファイルを編集することで、収集対象のRSSフィードを自由に追加・変更できます。

<?php
// config/feeds.php

return [
    'publickey' => [
        'name' => 'publickey', // 内部識別名 (ユニークに)
        'label' => 'Publickey', // LINEで表示されるソース名
        'url' => 'https://www.publickey1.jp/atom.xml',
        'default_image_url' => 'https://www.publickey1.jp/about/images/publickey_logo_200.png', // サムネイルがない場合の代替画像
    ],
    // 他のフィードもこの形式で追加
];

---

システム構成図

graph TD
    subgraph "User Interaction (LINE)"
        A["LINE User"]
        A -- "1. `最新情報`と送信" --> B("LINE Platform");
        B -- "2. Webhook" --> C{"Render Web Service<br>(webhook.php)"};
        C -- "3. 記事データを要求" --> D[("PostgreSQL DB")];
        D -- "4. 記事データを返却" --> C;
        C -- "5. Flex Messageを返信" --> B;
        B -- "6. メッセージ表示" --> A;
    end

    subgraph "Periodic Job (Article Collection)"
        E["GitHub Actions<br>(Scheduled Cron)"] -- "7. `run_daily.php`実行" --> F{"PHP Script"};
        F -- "8. RSS取得" --> G["External RSS Feeds"];
        G -- "9. 記事URL" --> F;
        F -- "10. AI要約・クイズ生成を依頼" --> H["Google Gemini API"];
        H -- "11. 分析結果" --> F;
        F -- "12. 新しい記事をDBに保存" --> D;
    end

    style A fill:#fff,stroke:#333,stroke-width:2px
    style B fill:#00B900,stroke:#fff,stroke-width:2px,color:#fff
    style C fill:#4A90E2,stroke:#fff,stroke-width:2px,color:#fff
    style D fill:#D1E6FA,stroke:#333,stroke-width:2px
    style E fill:#24292E,stroke:#fff,stroke-width:2px,color:#fff
    style F fill:#7A869A,stroke:#fff,stroke-width:2px,color:#fff
    style G fill:#FBBC05,stroke:#333,stroke-width:2px
    style H fill:#F2F2F2,stroke:#333,stroke-width:2px

Loading

---

運用・メンテナンス

【重要】無料データベースの90日更新手順

このプロジェクトで利用しているRenderの無料PostgreSQLデータベースは、作成から90日で自動的に削除されるという重要な制限があります。

データベースが削除されると、Botは記事を保存・取得できなくなり、エラーが発生します。サービスを継続するには、90日ごとに以下の手作業によるデータベースの更新（入れ替え）が必要です。

作業のタイミング: データベース作成から85〜89日後を推奨します。カレンダーにリマインダーを設定しておきましょう。

---

手順1: 新しいデータベースをRenderで作成

1. Renderのダッシュボードにログインします。
2. [New +] ボタンを押し、[PostgreSQL] を選択します。
3. Name に、日付を入れるなどユニークで分かりやすい名前を付けます（例: line-bot-db-2025-12-20）。
4. Region や PostgreSQL Version は既存のものと同じで構いません。
5. [Create Database] をクリックし、作成が完了するまで待ちます。

手順2: 新しいデータベースの接続情報をコピー

1. 新しく作成したデータベースのダッシュボードを開きます。
2. 「Info」セクションにある「Internal Connection String」を探し、その値をコピーします。これが新しいDATABASE_URLになります。

手順2.5: (推奨) データの移行

古いデータベースから新しいデータベースへ、これまでに蓄積した記事データを移行します。これにより、過去の記事も引き続き検索できるようになります。

前提条件: この手順には、ご自身のPCにPostgreSQLクライアントツール (pg_dump, psql) がインストールされている必要があります。インストールされていない場合は、PostgreSQLの公式サイトからダウンロードしてください。

手順:

1. 接続情報を取得する

   • Renderのダッシュボードで、古いデータベースと新しいデータベースの両方の「Info」ページを開きます。
   • それぞれの「External Connection String」という項目を探し、URLをコピーしておきます。

2. 移行コマンドを実行する

   • PCのターミナル（コマンドプロンプトやPowerShellなど）を開きます。
   • 以下のコマンドを一行で実行します。"古いDBのURL" と "新しいDBのURL" の部分は、先ほどコピーしたそれぞれのExternal Connection Stringに置き換えてください。URLは必ずダブルクォーテーション(")で囲ってください。

   pg_dump "古いDBのURL" | psql "新しいDBのURL"

   • このコマンドは、古いデータベースの内容をダンプ（エクスポート）し、その結果をパイプ(|)経由で新しいデータベースに直接リストア（インポート）します。データ量に応じて少し時間がかかる場合があります。

3. （任意）データ移行の確認

   • コマンドがエラーなく完了したら、psql "新しいDBのURL" コマンドで新しいデータベースに接続し、SELECT COUNT(*) FROM articles; などを実行して、データが移行されていることを確認できます。

---

手順3: RenderのWeb Serviceを更新

1. LINE BotのWeb Service（webhook.phpが動いているサービス）のダッシュボードに移動します。
2. 左側のメニューから [Environment] を選択します。
3. 環境変数の一覧からDATABASE_URLを見つけ、値を手順2でコピーした新しい接続情報に書き換えます。
4. [Save Changes] をクリックします。サービスが新しい環境変数で自動的に再起動します。

手順4: GitHub ActionsのSecretを更新

1. このプロジェクトのGitHubリポジトリページに移動します。
2. [Settings] -> [Secrets and variables] -> [Actions] を開きます。
3. Secretsの一覧からDATABASE_URLを見つけ、[Update] をクリックします。
4. Valueの欄に、手順2でコピーした新しい接続情報を貼り付けて保存します。

手順5: 新しいデータベースを初期化

新しいデータベースは空っぽなので、テーブルを作成し、記事データを投入し始める必要があります。

1. GitHubリポジトリの [Actions] タブを開きます。
2. 左側のメニューから [Send LINE Notification] ワークフローを選択します。
3. [Run workflow] ボタンを押し、表示されるドロップダウンから daily_notify を選択して実行します。
4. このアクションが実行されると、run_daily.phpスクリプトが走り、新しいデータベース内に自動でarticlesテーブルが作成され、記事の収集が再開されます。

手順6: (任意) 古いデータベースの削除

ダッシュボードを整理するため、Render上で古い（有効期限切れが近い）データベースを選択し、「Settings」ページの下部にある削除ボタンから削除します。

サービス上限とリスク管理

無料プランで運用する際の、各サービスにおける制限やサービス停止のリスクは以下の通りです。

サービス	リスク内容	深刻度	対策
Render	DBが90日で消滅する	高	本README記載の手動更新 or 有料化
Render	Web Serviceがスリープし、応答がタイムアウトする	中	有料化
GitHub Actions	無料実行時間の上限（月2,000分）	中	本README記載のスケジュール最適化 or 有料化
LINE API	Pushメッセージの上限（月500通）	低	機能追加時に注意 or 有料化