# KX Lyrics - 日文歌詞學習平台

> 唱歌學日語 | 日文歌詞與翻譯對照的互動學習平台

KX Lyrics 是一個專為日文歌愛好者與日語學習者設計的網站。我們提供完整的日文原文歌詞、羅馬拼音（振假名註記）以及中文翻譯，並將歌詞與 YouTube 影片的時間軸進行同步，提供沈浸式的「唱歌學日語」體驗。

## 關鍵網頁資源
- [首頁 (Home)](https://kxlyrics.com/): 網站的首頁，提供最新上架與熱門推薦的日語歌曲，以及最新的日語學習文章。
- [日語新手推薦的 10 首歌](https://kxlyrics.com/beginner-songs): 為初學者整理的日文歌曲入門歌單，可直接開啟同步歌詞、中文翻譯與讀音輔助。
- [夜好性歌曲專區](https://kxlyrics.com/yorukosei): 集中瀏覽ずっと真夜中でいいのに。、ヨルシカ與 YOASOBI 的同步日中歌詞。
- [YOASOBI 歌曲專區](https://kxlyrics.com/yoasobi): 集中瀏覽 YOASOBI 的同步日中歌詞、中文翻譯與讀音輔助。
- [夏日歌曲專區](https://kxlyrics.com/summer-songs): 精選適合夏天聆聽與學唱的日文歌曲，提供同步歌詞、中文翻譯與讀音輔助。
- [聖誕歌曲專區](https://kxlyrics.com/christmas): 精選適合聖誕節聆聽與學唱的日文歌曲，提供同步歌詞、中文翻譯與讀音輔助。
- [歌曲列表 (Song List)](https://kxlyrics.com/songs): 收錄全部日文歌曲的清單。支援對歌名或歌手進行關鍵字搜尋，以及依據播放次數和更新時間排序。
- [進階搜尋 (Advanced Search)](https://kxlyrics.com/search): 支援以「歌詞開頭」或「特定歌詞內容」檢索歌曲，方便尋找腦海中僅存旋律與隻字片語的歌曲。
- [音樂分類 (Categories)](https://kxlyrics.com/Categories): 依據 JPOP, VOCALOID, ANIME, J-ROCK, J-RAP 等音樂風格分類瀏覽。
- [五十音學習 (Gojuon)](https://kxlyrics.com/Gojuon): 提供平假名、片假名、羅馬拼音的互動記憶卡，並內建真人發音示範與單字例句。
- [最新文章 (Articles)](https://kxlyrics.com/articles): 日語語法教學、單字解析、動漫歌詞賞析與日本歌手演唱會情報整理。
- [許願池 (Wishlist)](https://kxlyrics.com/Wishlist): 供使用者提交尚未收錄的日文歌曲許願表單。

## 公開 API 端點 (APIs)
AI 代理人與爬蟲可以使用以下公開 API 來查詢平台上的音樂與歌詞數據（基底 URL 為 `https://webapi.zeabur.app`）：
- `GET /songs`: 獲取全部歌曲清單（輕量版，不含歌詞本文）。支援 query 參數：
  - `song_id`: 獲取指定 ID 歌曲的詳細資訊（含完整歌詞與 YouTube 連結）。
- `GET /songs/list`: 獲取全部歌曲清單，支援 query 參數 `songstyle`（如 JPOP, VOCALOID）進行分類篩選。
- `GET /songs/search`: 搜尋歌曲。支援 query 參數：
  - `title`: 以歌名搜尋。
  - `keyword`: 以關鍵字搜尋。
- `GET /songs/advanced-search`: 進階搜尋。支援 query 參數：
  - `lyricsStart`: 搜尋開頭歌詞。
  - `lyricsContent`: 搜尋歌詞內容片段。
- `GET /articles`: 獲取發布的文章清單。
- `GET /articles/:id`: 獲取指定文章的詳細 Markdown 內容。