推し窓 (oshi-mado)

推しの YouTube 新着を横断チェックする Chrome 拡張機能です。リストに追加した複数の推しの動向を絞り込み、小窓かタブで開いたページで表示できます。 推し窓は、登録した YouTube チャンネルの新着を1つのポップアップにまとめて表示する拡張機能です。 チャンネルを1つずつ巡回しなくても、ツールバーのアイコンを押すだけで「いま何が来ているか」がわかります。 ////////////////// ■ できること ・新着の横断表示 　登録したチャンネルの直近7日間の投稿を、日付ごとにまとめて表示します。 ・種類別タブ 　配信中 / 全て / 動画 / アーカイブ / 予定 のタブで切り替えられます。 　サムネイルの上には、配信中・開始予定日時・アーカイブ・Shorts のバッジが出ます。 ・視聴できるようになった時刻でソート 　ライブ配信やアーカイブは「配信が始まった時刻」、動画は「公開された時刻」を基準に並びます。 　枠を立てただけの配信が上に居座ることがありません。 ・チャンネルでの絞り込み 　ヘッダーのセレクトで、特定の推しの投稿だけを表示できます。タブの件数も連動します。 ・取得できなかったチャンネルの明示 　新着の取得に失敗したチャンネルは、件数ではなく ID を並べて画面の上部に出します。 　推しが出てこないとき、登録し忘れなのか一時的な取得失敗なのかを区別できます。 ・未保存の設定を守る 　推しの追加・削除や API キーの変更を保存せずに設定画面を閉じようとすると、確認ダイアログが出ます。 ・タブ表示 　ポップアップ内のボタンから通常のタブとして開き直せます。横幅を気にせず一覧できます。 ・ダークテーマ対応 　ブラウザのテーマ設定に合わせて自動で配色が切り替わります。 ■ 「直近7日」の数え方 枠を立てた日ではなく、視聴できるようになった日で数えます。 配信中とアーカイブは配信が始まった時刻、動画と Shorts は公開された時刻が基準です。 ずっと前から告知されていた配信でも、始まった時点で一覧に載ります。 「予定」タブは、先の予定を何日先でも表示します。 ただし、開始予定時刻を24時間過ぎても始まらない枠は出しません。配信トラブルで枠を取り直したときの消し忘れなどが、いつまでも残らないようにするためです。 ■ はじめかた 1. 設定画面を開き、推しの YouTube チャンネルを登録します。 　 チャンネルID（UC…）、チャンネルURL、@ハンドルのいずれでも登録できます。 　 Google Takeout でダウンロードした登録チャンネルの CSV を貼り付けて一括登録することもできます（240チャンネルまで）。 　 手順はガイドにまとめています: https://yoyogipinball.github.io/oshi-mado/ 2. （任意）YouTube Data API キーを登録します。設定画面に取得手順を用意しています。 ■ API キーが必要な理由 新着の発見には、各チャンネルが公開している RSS フィードを使っています。ここは API キー不要です。 一方で「これは配信中なのか、アーカイブなのか、まだ始まっていない予定なのか」という判定と、その開始時刻は、 YouTube Data API v3 からでないと取得できません。チャンネルのアイコンと名前も同様です。 拡張機能から YouTube の内部 API を叩く方法は、リクエストの偽装が必要になり利用規約に触れるおそれがあるため採用していません。 そのため、各ユーザーがご自身の API キーを登録する方式（BYOD）にしています。 キーは Google Cloud Console から無料で取得でき、設定画面に手順を用意しています。 キーを登録しなくても新着一覧は表示されます。その場合、配信は「枠を立てた時刻」に並び、種類の判定は行われません。 ■ クォータについて RSS で新着を見つけ、判定が確定済みのものはキャッシュし、状態が変わりうるものだけを API に問い合わせます。 59チャンネル・新着400件の環境でも、1回の更新で消費するクォータは1ユニットでした。 無料枠は1日1万ユニットなので、個人利用で使い切ることはまずありません。 ■ プライバシー 開発者のサーバーはありません。利用状況の計測も行いません。 登録したチャンネルと API キーは Chrome の同期領域（chrome.storage.sync）に保存され、 通信先は YouTube と Google API のみです。 ■ 既知の制約 ・YouTube に投稿されてから RSS や API に反映されるまで数分かかります。 ・RSS は直近15件までしか返さないため、公開日がかなり先の配信予定枠は載らないことがあります。 ・開始予定時刻が設定されていない配信枠は、代わりに「枠を立てた時刻」を表示します。実際の開始時刻とずれることがあります。 ・コミュニティ投稿は API から取得できないため対象外です。 ・登録できるのは240チャンネルまでです。Chrome の同期領域に、1項目あたりの容量上限があるためです。 ■ 開発者について 不具合の報告・ご要望は GitHub の Issue へお願いします。 https://github.com/YoyogiPinball/oshi-mado/issues メールでのお問い合わせ: yoyogipinball11@gmail.com ほかの制作物はポートフォリオサイトにまとめています。 https://yoyogipinball.github.io