JLyrics

🎼 Java向けの拡張可能な歌詞スクレイピングAPI

使用例

LyricsClient client = new LyricsClient();
Lyrics lyrics = client.getLyrics("smooth criminal").get();
System.out.println(lyrics.getContent()); // As he came into the window ...

特徴

• 非同期/同期の両方に対応（CompletableFuture を使用）
• 同一リクエストの重複スクレイピングを防ぐキャッシュ機能
• 高いカスタマイズ性（reference.conf と lightbend/config）
• 追加サイトへの拡張が容易
• 日本語向け検索正規化（全角/半角・空白の正規化）
• 非ASCII検索語の UTF-8 URLエンコード対応

CI/CD

• 最低サポートJavaバージョン: 11
• GitHub Actions で Java 11 / 17 / 21 / 25 を検証
• v* タグpush時に mvn deploy で GitHub Packages へ公開
• Jenkins は Jenkinsfile で Java 11 ベースのビルド/テスト/成果物保存に対応

対応済み歌詞サイト

• A-Z Lyrics
• Genius
• MusixMatch
• [ここに追加できます]

Maven 設定

<repository>
  <id>jitpack.io</id>
  <url>https://jitpack.io</url>
</repository>

<dependency>
  <groupId>dev.cosgy</groupId>
  <artifactId>jlyrics</artifactId>
  <version>v0.7</version>
</dependency>

Gradle 設定（build.gradle）

repositories {
    mavenCentral()
    maven { url 'https://jitpack.io' }
}

dependencies {
    implementation 'dev.cosgy:jlyrics:v0.7'
}

Gradle Kotlin DSL 設定（build.gradle.kts）

repositories {
    mavenCentral()
    maven(url = "https://jitpack.io")
}

dependencies {
    implementation("dev.cosgy:jlyrics:v0.7")
}