freebie-radar — AI判定と多重フィルタを備えたリソース情報集約ツール
ZiChuanLan/freebie-radar
★ 1,188 ・ TypeScript ・ MIT
概要
freebie-radar(资源雷达 / Resource Radar)は、開発者コミュニティやゲーム配信プラットフォーム、各種フォーラム、RSSなどからお得な情報や技術ニュースを自動で収集・整理するセルフホスト型の情報集約ワークステーションです。
Web上には無料配布、割引セール、オープンソースの更新、業界ニュースといった有用な情報が溢れている一方で、宣伝目的の投稿やノイズ情報も多く混ざり合っています。本ツールは、ルールベースの除外処理とOpenAI互換APIを用いたAIセマンティック判定を組み合わせることで、ノイズを排除しながらコンテンツを精密に分類します。
収集した情報は専用のWebダッシュボードで一覧できるほか、カテゴリや入手形態に応じた条件分岐を設定し、Telegramへ即時または定期的にプッシュ通知することが可能です。無料配布やセール情報、最新の技術動向を効率的にキャッチアップしたいエンジニアやホビーユーザーに適しています。
主な特徴
- 100以上の内蔵データソースに対応 GitHub、Steam、Epic Games、Reddit、Telegramチャンネル、各種フォーラム、技術系RSSなど、111個のデータソースが組み込まれており、必要に応じてカスタムRSSやスクリプト経由のデータ投入も行えます。
- 「形態 × 分野 × 入手方法」による多次元分類 収集した情報を6つのコンテンツ形態(無料特典、セール、オープンソース、ニュース、業界情報、ノイズ)、27の垂直カテゴリ(AI、VPS、クラウド、セキュリティなど)、6段階の入手方法(完全無料、条件付き、抽選、試用、宣伝、有料)に細かく分類して管理します。
- 3層構造によるノイズ除去とAIセマンティック審査 キーワードや正規表現による事前ブロック、AIによる文脈審査(1〜5段階の品質評価や判定理由の出力)、そしてトークンを消費せずに過去データを再分類するルール再適用エンジンを搭載しています。
- 柔軟なTelegramプッシュ通知ルーティング 「無料特典のみを即時通知する」「オープンソースの話題は1日1回まとめて配信する」など、条件・カテゴリ・重要度に応じた複数の配信ルートを個別に定義できます。
- レスポンシブなWebダッシュボード React 19とTailwind CSS v4で構築されたWeb画面を備えており、コンパクトな単行リスト表示、2列カード、3列カードの各レイアウトを切り替えて閲覧可能です。
使い方
Docker Composeを利用すると、Node.jsのローカルセットアップやデータベースの事前構築を行わずに起動できます。
1. Docker Compose による起動
リポジトリをクローンし、ビルドと起動を実行します。
git clone https://github.com/ZiChuanLan/freebie-radar.git
cd freebie-radar
# 必要に応じて環境変数を編集(管理パスワードやTelegram、AI連携の設定など)
cp .env.example .env
# コンテナをビルドしてバックグラウンド起動
docker compose up -d --build
Cloudflareの保護が施されたサイトを収集対象に含める場合は、リポジトリに含まれるFlareSolverr用のプロファイルを利用して起動できます。
# .env に FLARESOLVERR_URL=http://flaresolverr:8191 を設定した上で実行
docker compose --profile cf up -d --build
起動後、ヘルスチェックエンドポイント(http://127.0.0.1:8788/health)にアクセスすることで稼働状況を確認できます。
2. ソースコードから直接実行する場合
Node.js 22.5以上およびpnpm 10が導入された環境では、以下の手順で起動可能です。
git clone https://github.com/ZiChuanLan/freebie-radar.git
cd freebie-radar
pnpm install
cp .env.example .env
pnpm build
pnpm start
3. CLIによる運用管理
付属のCLIツール(src/server/cli.ts)を利用して、データソースの有効化・無効化や即時収集、過去データの再分類などの操作が可能です。
# データソース一覧とステータスの確認
pnpm tsx src/server/cli.ts sources
# 収集処理の即時実行
pnpm tsx src/server/cli.ts collect
# 分類ルールの再適用
pnpm tsx src/server/cli.ts reclassify
技術的なポイント
- 軽量なバックエンド構成
サーバーサイドはTypeScriptで記述され、WebフレームワークにはHonoが採用されています。ランタイムにはNode.js(Dockerイメージは
node:24-alpine)を使用し、データベースにはNode.js標準のnode:sqliteをWAL(Write-Ahead Logging)モードで動作させているため、PostgreSQLやMySQLなどの外部データベースを別途用意する必要がありません。通常稼働時のメモリ消費量は100MB未満に抑えられています。 - APIコストを抑える前処理パイプライン すべての記事を即座にLLMへ送信するのではなく、まずURLやタイトルに基づく正規表現・キーワード遮断ルールで明らかなノイズを除外します。AI審査が必要と判断されたコンテンツのみをOpenAI互換エンドポイントに送る構成をとることで、API利用料を抑える設計になっています。
- 認証とアクセス制御の分離
環境変数
ADMIN_TOKENを設定することで、公開ビュー(収集されたタイムラインやデイリーまとめ)は閲覧可能な状態を維持したまま、各種設定の変更や手動データ投入といった書き込み系APIに対してのみパスワード保護を適用できます。また、OAuthを利用したマルチユーザー運用オプションも用意されています。
注意点
- ライセンス 本プロジェクトはMITライセンスの下で公開されています。
- 外部サービスの利用規約 READMEの免責事項にも記載されている通り、本ツールは公開されているWebページやAPIから情報を収集・集約するものです。対象サイトの利用規約やrobots.txtを遵守し、リクエスト頻度を過剰に上げないよう運用上の配慮が求められます。
- 環境変数の管理
ADMIN_TOKENが未設定の初期状態では管理インターフェースが保護されません。インターネット上に公開する場合は、強力なトークンを設定することが推奨されています。 - ブラウザログインが必要な一部ソース
特定プラットフォームなどCookieやセッションログインが必要なデータソースについては、Playwrightを用いたスクリプト(
scripts/pw-collect.mjs)や専用のUserScriptを用いたローカル連携が前提となっています。
まとめ
freebie-radarは、多数の情報源からお得なキャンペーン情報や技術トピックを自律的に巡回・収集・分類できるセルフホスト型ツールです。SQLiteの内蔵によるシンプルなデプロイ構成と、ルールベースとAIを組み合わせたフィルタリング機構により、運用コストを抑えながらノイズの少ない情報収集環境を構築できます。





