存在しないJavDB API

JavDB APIは存在しません。JavDBは一度も出荷したことがありません。「javdb api」を検索すると、その名を借りたコミュニティ製スクレイパーの山が出てきます。そのどれもが、明日には壊れかねないHTMLをパースしているのです。

一文で言えば、それが問題のすべてです。とはいえ、実際に何が出回っているのか順に見ていく価値はあります。あなたはそれらすべてにぶつかることになるからです。

「javdb api」が実際に指しているもの

ひと握りのリポジトリ、どれも非公式で、すべて脆いものです。

javdb-python は javdb.com ですらなく javdatabase.com をラップしています。作者ははっきりこう言っています。関数とHTML構造は安定したAPIではない、と。使い捨てのスクリプトには十分ですが、出荷するものには向きません。
npm の javdb-api は事実上死んでいます。1年以上リリースがなく、週に数件のダウンロードしかありません。この上に作るのはやめましょう。
ovnrain/javbus-api のようなセルフホスト型スクレイパーは、あなたの代わりにスクレイプするDockerコンテナを渡してきます。運用しやすくはなりますが、土台は同じで、ソースサイトがマークアップを変えればやはり壊れます。
メディアサーバー向けツール(Javinizer、Emby/Jellyfin の JavScraper プラグイン)は、ローカルのライブラリを整理するには優れていますが、自分のアプリから呼び出すデータAPIとして作られたものではありません。

なぜそれらはいずれ壊れるのか

これらのツールは生きたウェブサイトをスクレイプするので、そのウェブサイトが持つあらゆる防御をそのまま受け継ぎます。JavDBは Cloudflare の裏にあり、これらのプロジェクトの半分は、ページをひとつ取り返すためだけに FlareSolverr を並行して動かす必要があります。一部のコンテンツ(fc2)では、手で貼り付けて期限切れのたびに更新するセッションクッキーが必要です。サイト上のクラス名のリネームがあなたのパーサーを静かに壊し、変更履歴も警告もなく、ある日メタデータが空っぽになります。そしてJavDBのメタデータは英語と中国語のみなので、それを土台に作られたものは日本語のフィールドを取りこぼします。

つまり、あなたが保守するのはひとつの統合ではありません。スクレイパーと、ヘッドレスブラウザのバイパスと、クッキーと、深夜2時にすべてが崩れたときのためのポケベルを保守することになるのです。

ホスト型の代替

javinfo は、JavDBが決してくれなかったAPIです。実際の javdb プロバイダーを備えています。コードを送れば、構造化されたメタデータが返ってきます。スクレイパーが追い求めているダウンロードリンクとマグネットリンクも含めて。毎回同じ形、子守りする必要は何もありません。

curl -X POST 'https://javinfo-search.p.rapidapi.com/search' \
  -H 'Content-Type: application/json' \
  -H 'X-RapidAPI-Key: YOUR_RAPIDAPI_KEY' \
  -H 'X-RapidAPI-Host: javinfo-search.p.rapidapi.com' \
  -d '{ "q": "CAWD-001", "providers": "javdb" }'

{
  "result": {
    "q": "CAWD-001",
    "source": "javdb",
    "video": { "dvdId": "CAWD-001", "runtimeMins": 120, "series": "Series Name" },
    "extra": {
      "downloadLinks": [
        { "name": "CAWD-001 1080p", "size": 5905580032, "hd": true, "magnet": "magnet:?xt=urn:btih:..." }
      ],
      "score": 4.3,
      "voteCount": 512
    }
  },
  "latencyMs": 980,
  "cached": false,
  "gated": false
}

すべてのプロバイダーは同じベースの video 形にマッピングされるので、どのソースが応答しても result.video.* を同じように読めます。スクレイピングも Cloudflare との戦いも私たちが引き受けるので、あなたはやらずに済みます。これは、あらゆるソースをカバーする単一のJAVメタデータAPI の一部であり、設計からしてプロバイダー非依存です。壊れやすいスクレイプの山ではなく、メンテナンスされた統合がひとつあるだけ。JavDBがこうしたソースの唯一の例というわけではありません。DMMはもっとひどい。

認証、レート制限、プランは RapidAPI にあります。javdb プロバイダーとそのダウンロードリンクは、missav プロバイダーと並んで Pro ティア(1日1,000リクエスト)で利用できます。1分で動かせます。Dockerも、FlareSolverr も、クッキーも不要です。