Daily TED PWA
scioltoharumi/daily-ted
PWA de aprendizado de inglês com análise automática de vocabulário via Cloud Tasks
Ver no GitHubAplicativo PWA de aprendizado de inglês que executa diariamente via Claude Code Scheduled Agent. Extrai transcrições de vídeos TED-Ed/TED Talks, gera análise completa de vocabulário com múltiplas camadas (basic/normal/key/frequent) e entrega dados pré-processados em JSON para interface Svelte interativa.
Instalação
npx convez-ai scioltoharumi/daily-ted1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Aprendizado diário de inglês com transcrições de vídeos TED
- Análise automática e classificação de vocabulário por importância
- Geração programada de conteúdo educativo via Cloud Tasks do Claude
Veredito

Projeto robusto de automação educativa que combina web scraping, processamento com Claude e entrega de PWA. Bem documentado com guias de handover e fase de PoC clara, mas exige coordenação complexa entre backend scheduled e frontend interativo.
README
A tradução para o português deste README ainda está na fila.
引き継ぎ資料一覧 - Daily TED PWA
このフォルダはClaude Codeへの引き継ぎ用ドキュメント一式です。 作業を開始する人(Claude含む)は、このREADMEから読んでください。
引き継ぎ資料の使い方
1. まずこれを読む(順番に)
README.md(このファイル) - 全体マップdocs/project_guide.md- プロジェクト固有のガイド、必読docs/requirements_v3.md- 正式な要件定義書(SSoT)
2. 設計判断を確認する
steering/design_decisions.md- 主要な意思決定とその背景steering/lessons.md- 失敗・教訓ログ(運用しながら追記)
3. データ仕様を確認する
docs/data_schema.md- JSON構造の正式定義docs/mockup_v5.html- UI/UXモックアップ(ブラウザで開く)
4. Cloud Task登録時に使う
prompts/daily_batch.md- メインプロンプト(Cloud Taskにそのまま登録)prompts/word_classification.md- 単語階層判定基準
5. Phase 1 PoCを始めるとき
docs/poc_phase1.md- PoC手順書、各ステップの確認項目scripts/fetch_rss.py- YouTube RSS取得テスト用scripts/slug_estimator.py- slug推定テスト用scripts/scrape_transcript.py- スクレイピングテスト用
ディレクトリ構成
ted-pwa-handover/
├── README.md # ←今ここ(引き継ぎ入口)
├── docs/
│ ├── project_guide.md # プロジェクト固有のガイド
│ ├── requirements_v3.md # 要件定義書 v3.0(SSoT)
│ ├── data_schema.md # JSON構造の正式定義
│ ├── poc_phase1.md # Phase 1 PoC手順書
│ └── mockup_v5.html # UI/UXモックアップ
├── prompts/
│ ├── daily_batch.md # Cloud Task用プロンプト
│ └── word_classification.md # 単語階層判定基準
├── scripts/
│ ├── fetch_rss.py # YouTube RSS取得
│ ├── slug_estimator.py # slug推定 + URL存在確認
│ └── scrape_transcript.py # ted.com スクレイピング
└── steering/
├── design_decisions.md # 主要設計判断ログ(D-001〜D-015)
└── lessons.md # 失敗・教訓ログ(運用追記)
このプロジェクトの本質を5分で理解するための要約
やりたいこと
個人用の英語学習PWA。毎日のTED-Ed/TED Talkを動画で見ながら、 トランスクリプトの全単語にタップで意味・例文・背景・コロケーションが出る。
どう作るか
- バックエンド:Claude Code Cloud Taskが毎朝6時に実行(MAXプラン)
- 処理:RSS取得 → ted.com スクレイピング → Claudeが全要素解説生成 → JSON commit
- フロント:Svelte PWAがJSONを読んで表示するだけ
- 動画:TED公式embedで埋め込み
キーポイント
- 配信ロジック:平日 TED-Ed / 休日 TED Talks / 新作なしならスキップ
- 事前生成徹底:全単語×完全データを事前にJSON化、AI即時生成は使わない
- 4階層強調:basic/normal/key/frequentで重要度を視覚化(★frequentは黄色マーカー)
- 冪等性:同日のJSONがあれば即終了
- コスト・著作権度外視:MAXプラン+私的利用前提
何が決まっていて、何が未確定か
確定:
- アーキテクチャ全体
- 配信ロジック・スキップポリシー
- データスキーマ
- UI/UX(モックアップで具体化済)
- 単語階層の判定基準
未確定(Phase 1 PoCで詰める):
- slug推定の的中率(実測必要)
- TEDサイトHTML構造の現状
- Cloud Taskの実環境動作
- 解説生成プロンプトのチューニング
始め方(推奨順)
Step 0: 環境準備
- GitHubでprivateリポジトリを作成
- このフォルダの中身をリポジトリにコピー
- Claude Codeで対象リポジトリを開く
Step 1: PoC着手(docs/poc_phase1.md の手順)
- Step 1:
python scripts/fetch_rss.py ted-edでRSS取得テスト - Step 2: 直近20本のTED-Edで
python scripts/slug_estimator.py実行、的中率測定 - Step 3:
python scripts/scrape_transcript.py <slug>で1本だけスクレイピング動作確認 - Step 4: Cloud Taskに
prompts/daily_batch.mdを登録、手動実行で1日分試走 - Step 5: 出力JSONの品質を確認、プロンプトをチューニング
Step 2: PWA実装(Phase 2)
- Svelte + Vite で初期化
- モックアップ(
docs/mockup_v5.html)を見ながらコンポーネント分解 - 4階層スタイル、モーダル、お気に入り、エクスポート実装
- PWA化(manifest, Service Worker)
- GitHub Pagesデプロイ確認
Step 3: 本運用開始
- Cloud Taskのcronを
0 6 * * *JSTで有効化 - 数日運用してCloud Task成功率を観察
- 問題があれば
steering/lessons.mdに記録、改善
困ったときの参照先
| 状況 | 見るべきドキュメント |
|---|---|
| 仕様の判断に迷った | docs/requirements_v3.md |
| 「なんでこう決めたんだっけ」 | steering/design_decisions.md |
| データ構造を確認したい | docs/data_schema.md |
| Cloud Taskプロンプトを編集したい | prompts/daily_batch.md |
| 単語階層判定の基準が知りたい | prompts/word_classification.md |
| UIの見た目を確認したい | docs/mockup_v5.html |
| PoCのチェックリスト | docs/poc_phase1.md |
| 過去の失敗・教訓 | steering/lessons.md |
連絡事項
- 開始日:2026-05-07
- 想定期間:Stage 1(数日)+ Stage 2(6-10週間)+ 運用継続(v3.2 Stage 制)
- 著作権・コスト:私的利用 + MAXプランのため度外視
PWA / 公開ホスティング
リポジトリ root の index.html が PWA 本体です。docs/mockup_v6_app_overview.html を実データ fetch 化したもので、./data/index.json と ./data/talks/{date}.json を読み込んで表示します。データが取れない場合は内蔵のサンプルデータにフォールバックし、上部に「サンプルデータ表示中」バナーを表示します。
公開手順(GitHub Pages)
- public 化: GitHub の Settings → General → Danger Zone → "Change visibility" → public
- 著作権: 私的利用前提なので一旦は許容、将来必要なら Cloudflare Pages に切替
- Pages 有効化: Settings → Pages → Source: "Deploy from a branch" → Branch:
main/(root)→ Save - 数分待つと
https://<user>.github.io/daily-ted/でアクセス可能(初回はビルドに 1-3 分かかる) - スマホでも上記 URL を開けば動く。「ホーム画面に追加」で PWA としてインストールできる
ローカル開発
index.html は単一HTMLなのでビルド不要。ただし fetch() を使うので file:// 直接開きでは data/* が読めない(サンプルフォールバックは表示される)。実データを試すには簡易サーバを使う:
python -m http.server 8000
# → http://localhost:8000/
構成ファイル
| ファイル | 役割 |
|---|---|
index.html | PWA 本体(全 5 ビュー + 詳細 + モーダル + 検索 + お気に入り) |
public/manifest.json | Web App Manifest(ホーム画面追加用) |
public/icon-192.svg, icon-512.svg | PWA アイコン |
service-worker.js | オフラインキャッシュ(app shell + data network-first) |
docs/mockup_v6_app_overview.html | 設計参考プレビュー(ダミーデータ固定) |
改訂履歴
- 2026-05-07: 初版作成、要件定義 v3.0 ベース
- 2026-05-10: Stage 1 着手、case H ピボット (v3.1)、Phase 撤廃 + スキーマ拡張 (v3.2)、PWA 本体 (
index.html) 投入