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はAPIが返すアフィリエイトURLへ反映するために使用します。入力値は永続保存しません。ただしブラウザからAPIへ直接送信する構成のため、公開端末では入力しないでください。本番運用でAccess Keyを秘匿する場合は、許可Origin・レート制限を備えたバックエンドプロキシが必要です。 コマンド UGCバックエンド supabase/schema.sql を実行し、次をビルド環境に設定します。匿名投稿は必ず pending となり、RLSで published だけを公開取得します。 大量アクセスに備えるには、CAPTCHA、IP/ユーザー単位のレート制限、管理者モデレーション画面、通報・削除窓口、CDNキャッシュが追加で必要です。現時点ではこれらを実装済みとは扱いません。 public/robots.txt 、 public/sitemap.xml 、 index.ht

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

02 / 使用技術

使用技術と役割

03 / 設計

構成から読み解く設計

主な項目は README.md です。

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

04 / 変更履歴

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

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

1. 2026/08/04
   プロジェクトの初期構成を作成7431548をGitHubで確認 ↗

05 / 学び

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

• 変更を小さく記録する

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

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

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

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

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

06 / よくある質問

よくある質問