repo-lab

GitHub Trending JP — GitHub注目リポジトリを自動収集・記事化し、AIツールアフィリエイトと組み合わせて収益化する HOOTL（Human Out Of The Loop）自律運営メディア。

---

概要

日本語向けの GitHub トレンド解説メディアを全自動で運営するシステム。

Spinela ワークフローエンジンが 3 時間毎に GitHub Trending を収集 → 記事生成 → CMS 投稿するパイプラインを実行し続ける。記事品質の自己改善・プロンプト自動最適化・SEO リライトまで含め、人間の介入なしで運営を継続することを目標としている。

サイト: repo-lab.com

ビジネスモデル: GitHub 分析コンテンツ（集客）+ AIツールアフィリエイト（収益）

---

システム構成

[GitHub API]
     │ repo-collector（1日2回）
     ▼
[PostgreSQL / VPS]  ←── candidate_queue（記事化候補プール）
     │ candidate-selector（3時間毎・chain起点）
     ▼
[article-writer] ── GitHub README分析・記事生成・サムネイル生成（Flux.2[klein]）
     │ chain（articles_ready==true）
     ▼
[article-poster] ── Strapi v5 投稿 → CF Pages 再ビルドトリガー
                                              │
                                              ▼
                                   [Cloudflare Pages]
                                   repo-lab.com（Astro）

---

技術スタック

---

主要コンポーネント

site/ — Astroフロントエンド

Cloudflare Pages でホストされる静的サイト。Strapi REST API からデータを取得して記事一覧・詳細・ツール解説ページを表示する。

site/
├── src/pages/
│   ├── index.astro          # トップ（リポジトリ記事一覧）
│   ├── articles/[slug].astro # 記事詳細
│   ├── tools/[slug].astro   # AIツール解説（アフィリ導線）
│   ├── categories/[slug].astro
│   └── diagnose.astro       # 診断ページ
├── src/components/          # RelatedArticles など
└── wrangler.toml            # CF Pages 設定（GA4 ID等）

repo-lab/ — Spinelaパイプライン

VPS 上で動作するエージェント群と WF 定義ファイル。rlctl CLI でエージェントを管理する。

repo-lab/
├── workflow.yaml            # メイン 3WF 定義（candidate-selector / article-writer / article-poster）
├── workflows/               # サブシステム WF（品質改善・SEO・X 投稿等）
├── agents/
│   ├── candidate-selector/  # Step1: 記事化候補を candidate_queue から選定
│   ├── article-writer/      # Step2: README 分析 → 記事生成 → 画像生成
│   ├── article-poster/      # Step3: Strapi 投稿 → CF Pages 再ビルド
│   ├── repo-collector/      # GitHub Trending 収集（1日2回）
│   ├── quality-improver/    # 低スコア記事の自動リライト（週次）
│   ├── seo-improver/        # GSC/GA4 データ活用の SEO 改善（週次）
│   ├── prompt-improver/     # 品質傾向分析 → プロンプト自動最適化（週次）
│   ├── x-post-scheduler/    # X（Twitter）自動投稿
│   ├── link-checker/        # 記事内リンク死活確認（週次）
│   └── db-backup/           # PostgreSQL バックアップ → R2（日次）
├── db/                      # DB マイグレーション SQL
└── templates/article.md     # 記事生成テンプレート

VPS（ConoHa / hootl-prod-01）

---

ワークフロー概要

メインパイプライン（3時間毎・自動）

candidate-selector
  └─ candidate_queue から未記事化リポジトリを選定
       ↓ has_candidates == true
  article-writer
  └─ GitHub README 分析 → 記事本文生成 → Flux.2[klein] でサムネイル生成
       ↓ articles_ready == true
  article-poster
  └─ Strapi v5 に投稿 → CF Pages Deploy Hook で再ビルド → DB 記録

自律改善パイプライン（週次・自動）

---

セットアップ（概要）

前提条件

• ConoHa VPS（4GB）上に以下が稼働していること:
• PostgreSQL（strapi_hootl DB）
• Strapi v5（PM2 管理・api.repo-lab.com）
• Spinela（CodeLodis WF エンジン）
• Cloudflare Pages プロジェクト（repo-lab.com）
• Cloudflare R2 バケット（repo-lab-images / repo-lab-backups）

環境変数設定

cd repo-lab/
cp .env.example .env
# .env を編集して各 API キー・接続情報を設定
# 詳細: docs/infra/env-vars.md

主要な設定項目:

WF 登録・起動

# Spinela に WF を登録
lodisctl workflow register repo-lab/workflow.yaml
lodisctl workflow register repo-lab/workflows/quality-improver.yaml
# ... 他の workflows/ も同様

# 手動起動（動作確認）
lodisctl workflow run "github-trending::candidate-selector"

# 実行状態確認
lodisctl workflow status <run_id>

サイト（Astro）ローカル確認

cd site/
npm install
npm run dev   # http://localhost:4321
npm run build # 静的ビルド（CF Pages にデプロイ）

---

現在の稼働状況

---

ドキュメント

---

月次コスト（参考）