Raku Toolv2の設計・技術選定・コミット履歴を解説

01 / 概要

プロジェクトの概要と目的

えらびより / Raku Atlas / raku toolv2 楽天Web Serviceの公式APIを横断して、紹介候補を検索・保存するアフィリエイト検証ツールです。 対応範囲 API検索: 楽天市場、楽天トラベル、楽天ブックス、楽天Kobo、楽天GORA コンテンツ企画支援: 楽天レシピ（API自体はアフィリエイト非対応） サービスカタログ: 楽天公式のアフィリエイト対象サービスをカテゴリ別に表示 編集支援: 候補保存、広告表記・確認事項付き投稿メモ UGC: Supabase接続時のレビュー投稿、審査待ち保存、公開済みレビュー一覧 SEO/AIO/LLMO: JSON LD、canonical、OG、robots、sitemap、llms.txt、一次情報へのcitation 「楽天アフィリエイト対象」と「楽天Web Serviceでアフィリエイト対応APIが提供されている」は同じではありません。公開APIがないサービスを取得済みとは表現せず、公式リンク作成画面へ案内します。 認証情報 楽天Web Serviceで発行されたApplication ID、Access Key、Affiliate IDをXサーバーの公開ディレクトリ外に保存します。ブラウザは同一ドメインの /api/rakuten.php だけを呼び、Access Keyを受け取りません。配置方法は server/README.md を参照してください。 コマンド UGCバックエンド supabase/schema.sql を実行し、次をビルド環境に設定します。匿名投稿は必ず pending となり、RLSで published だけを公開取得します。 大量アクセスに備えるには、CAPTCHA、IP/ユーザー単位のレート制限、管理者モデレーション画面、通報・削除窓口、CDNキャッシュが追加で必要です。現時点ではこれらを実装済みとは扱いません。 本番ドメインは https://erabiyori.jp/ です。GitHub Pagesでは public/CNAME を利用します。 公式資料 API一覧

本記事は公開されている構成と main ブランチのコミットを一次情報として整理しています。

02 / 使用技術

使用技術と役割

03 / 設計

構成から読み解く設計

主な項目は です。

• 単一アプリケーション構成
• 機能単位の責務分割

04 / 変更履歴

コミットから見る実装の変遷

以下は既定ブランチの直近の変更です。リンク先で原文と一次情報を確認できます。

1. 2026/08/15
   支援・購入への導線を追加する61a1a85をGitHubで確認 ↗
2. 2026/08/11
   feat: GitHub Actionsデプロイワークフロー追加（rsync+SSH+PHPプロキシ）a75ccb1をGitHubで確認 ↗
3. 2026/08/04
   説明資料を更新805ed98をGitHubで確認 ↗
4. 2026/08/04
   機能・コンテンツを追加56118d7をGitHubで確認 ↗
5. 2026/08/04
   機能・コンテンツを追加cfc72bdをGitHubで確認 ↗
6. 2026/08/04
   テストを追加・更新69f91ecをGitHubで確認 ↗
7. 2026/08/04
   機能・コンテンツを追加7670033をGitHubで確認 ↗
8. 2026/08/04
   機能・コンテンツを追加3972e7fをGitHubで確認 ↗
9. 2026/08/04
   説明資料を更新0b24b7aをGitHubで確認 ↗
10. 2026/08/04
    機能・コンテンツを追加2eb7e03をGitHubで確認 ↗
11. 2026/08/04
    実装内容を更新5b0cbebをGitHubで確認 ↗
12. 2026/08/04
    実装内容を更新5388619をGitHubで確認 ↗

05 / 学び

このプロジェクトから得られる学び

• 変更を小さく記録する

  コミット単位で目的を分けると、実装の意図を追跡しやすくなります。

• 構成と技術選定を結び付ける

  JavaScriptの採用理由と各ディレクトリの責務を説明できることが保守性につながります。

• READMEと実装を同時に育てる

  説明とコードを近い状態に保つことが、再利用と振り返りを助けます。

06 / よくある質問

よくある質問