「AsuMe」は、ポップで直感的なUIを持つブラウザ完結型の英単語学習アプリケーションです。
バックエンドのデータベースを一切持たず、すべての学習データと進捗はブラウザの localStorage に安全に保存されます。自分で作った単語帳（CSVファイル）を取り込んだり、APIを活用して英単語から自動で問題を生成して、自分だけの単語帳で効率よく学習することができます。
- ブラウザ完結（DB不要）: サーバーやデータベースの構築は一切不要。すぐに使い始められます。
- スマートな出題アルゴリズム: 単純なランダムではなく、「まだ解いていない単語」「正答率が低い苦手な単語」「最後に学習してから時間が経っている単語」を優先して出題します。
- 殿堂入り（マスター）システム: 同じ単語に3回連続で正解すると「殿堂入り👑」となり、通常の出題から自動的に除外されるため、覚えていない単語に集中できます。
- 単語の自動生成と補完 (API連携): 「英単語」を入力するだけで、以下のデータを自動で取得・生成します。単語帳に不足しているデータの一括補完機能も備えています。
- 英語の定義・品詞・発音記号（WordsAPI / cmu-dict）
- 高精度な日本語訳（DeepL API）
- TOEIC（ビジネス・旅行・フォーマル等）に特化した文脈での短い例文と、自然な穴埋め問題化（WordsAPI / OpenAI gpt-4o-mini）
- プロジェクト管理画面: 各単語の正答率、連続正解数、殿堂入りステータスの確認、個別編集、手動追加が一つのダッシュボードで完結します。不足データの「一括補完（Batch Enrich）」もここから実行可能です。
- データのエクスポート/インポート: 学習進捗を含めたプロジェクト全体のZIPバックアップや、プレーンな単語リストとしてのCSV出力（エクセル対応BOM付き）が可能です。
- 音声読み上げ機能: Web Speech APIを利用し、問題出題時にネイティブな英語音声を自動再生します。
- フレームワーク: Next.js (App Router / クライアントコンポーネント中心)
- スタイリング: Tailwind CSS v4
- 主要ライブラリ:
papaparse(CSV解析)jszip(ZIPファイルの圧縮・展開)cmu-pronouncing-dictionary(発音記号フォールバック)
- 利用API: RapidAPI (WordsAPI), DeepL API, OpenAI API
- インフラ/DB: Upstash Redis (APIレート制限用)
-
パッケージのインストール
npm install
-
環境変数の設定
.env.exampleをコピーして.env.localを作成し、自動生成機能で使用するAPIキーを設定してください。（自動生成機能を使用しない場合は設定不要でアプリ自体は動作します）WORDS_API_KEY="your_wordsapi_key" DEEPL_API_KEY="your_deepl_api_key" OPENAI_API_KEY="your_openai_api_key" # 以下はAPIの使いすぎを防止するためのRate Limit用設定（Vercel等の公開環境で必須） UPSTASH_REDIS_REST_URL="your_upstash_redis_rest_url" UPSTASH_REDIS_REST_TOKEN="your_upstash_redis_rest_token" DAILY_GLOBAL_LIMIT="2450" DAILY_IP_LIMIT="200"
-
開発サーバーの起動
npm run dev
ブラウザで http://localhost:3000 にアクセスするとアプリが起動します。
手動で単語帳を作成してインポートする場合は、以下のヘッダー（1行目）を含むCSVファイルを用意してください。
words,japanese,paragraphs,phonetic,partOfSpeech
apple,りんご,I ate an _.,ˈæpl,noun
attempt,試みる,The police _[活用形] to stop the thief.,əˈtempt,verbwords: 英単語（必須）japanese: 日本語訳（必須）paragraphs: 穴埋め用の例文（空欄箇所は_や_[活用形]にする）phonetic: 発音記号（任意）partOfSpeech: 品詞（任意）