8.9 KiB
English | 中文 | 日本語 | 한국어 | Deutsch
AvDict 🎬
コマンドラインで AV 番号を検索するツール — 出演者、発売日、メーカーなどの情報を取得
番号を入力するだけで、出演者・発売日・メーカー・収録時間・タグなどの詳細情報を取得できます。複数のデータソースを自動的に切り替えて検索します。
特徴
- 🔍 複数データソース自動フォールバック — JAVBUS → NJAV → JavLibrary → JAVDB の順に検索、最初にヒットした結果を返す
- 📋 豊富な情報 — 女優、男優、発売日、収録時間、メーカー、レーベル、監督、シリーズ、タグ、パッケージ画像、評価
- 💾 ローカルキャッシュ — 検索結果を7日間キャッシュし、重複リクエストを削減
- 🖥️ クロスプラットフォーム — Linux、Windows、macOS 対応
- 🎨 カラー出力 — ターミナルで見やすいカラー表示
- ⚡ 高速検索 — 番号から直接 URL を生成、ログイン不要
動作要件
- Node.js >= 18.0.0
- npm >= 6.0.0
- curl（Linux/macOS は標準搭載、Windows は Git Bash 環境で利用可能なこと）
プラットフォームサポート
| プラットフォーム | JAVBUS | NJAV | JavLibrary | JAVDB |
|---|---|---|---|---|
| Linux / macOS | ✅ | ✅ | ✅ | ✅ |
| Windows | ✅ | ✅ | ✅ | ❌ |
JAVDB は Cloudflare の TLS フィンガープリント制限により Windows では利用不可。その他の3つのソースは Windows でも正常に動作します。
インストール
方法1：npm からインストール（推奨）
npm install -g javdict
方法2：GitHub からクローン（開発者向け）
git clone https://github.com/gdjdkid/AvDict.git
cd AvDict
npm install
npm install -g .
インストール確認：
jav -v
アップデート方法
方法1：npm でアップデート（推奨）
sudo npm install -g javdict@latest
方法2：GitHub からアップデート（開発者向け）
cd AvDict
git pull
sudo npm install -g .
使い方
番号を検索：
jav SSIS-001
jav ABF-331
jav JUR-067
言語を指定して出力：
jav --lang jp SSIS-001 # 日本語（デフォルト設定時）
jav --lang zh SSIS-001 # 中文
jav --lang en SSIS-001 # English
jav --lang kr SSIS-001 # 한국어
jav --lang de SSIS-001 # Deutsch
jav -l ja SSIS-001 # 省略形
生の JSON データで出力：
jav -r SSIS-001
キャッシュを削除：
jav --clear-cache
JAVDB Cookie を設定（任意）：
jav --setup
ヘルプを表示：
jav -h
コマンドオプション
Usage: jav [options] [番号]
Arguments:
番号 検索する番号、例: SSIS-001
Options:
-v, --version バージョンを表示
-l, --lang <言語> 出力言語：zh/en/jp/kr/de（デフォルト：zh）
-r, --raw 生の JSON 形式で出力
--setup JAVDB Cookie を設定（任意、カバレッジ向上）
--clear-cache ローカルキャッシュを削除
-h, --help ヘルプを表示
設定
JAVDB Cookie（任意）
設定しなくても通常通り使用できます。設定すると、一部のマイナー作品の検索カバレッジが向上します（Linux/macOS のみ有効）。
取得手順：
- Chrome で https://javdb.com を開いてログイン
- Chrome 拡張機能 Get cookies.txt LOCALLY をインストール
- JAVDB ページで拡張機能アイコンをクリックし、Cookie をエクスポート
_jdb_sessionの行を見つけ、最後の列の値をコピー- 以下のコマンドを実行して貼り付け：
jav --setup
Cookie は ~/.config/javinfo/config.json にローカル保存されます。外部に送信されることはありません。
Cookie の有効期限は約2週間です。マイナー作品が見つからなくなったら jav --setup を再実行して更新してください。
キャッシュについて
検索結果は ~/.config/javinfo/cache.json に自動的にキャッシュされ、有効期限は7日間です。
強制的に最新データを取得するには：
jav --clear-cache
よくある質問
Q: 「番号が見つかりません」と表示される？
A: 考えられる原因：
- すべてのデータソースに収録されていない（非常にマイナーなコンテンツ）
- JAVDB Cookie の有効期限切れ —
jav --setupで更新 - データソースへのネットワークアクセス不可 — プロキシ設定を確認
Q: Windows で一部の番号が見つからない？
A: Windows では Cloudflare の制限により JAVDB が使用できません。JAVDB にのみ収録されている一部の作品は Windows では検索できません。完全な検索結果を得るには Linux 環境（Raspberry Pi など）の使用を推奨します。
Q: Permission denied と表示される？
A: グローバルインストールには管理者権限が必要です：
sudo npm install -g .
Q: Cookie はどのくらいの頻度で更新が必要ですか？
A: 通常は約2週間ごとです。以前は検索できていたマイナー作品が見つからなくなったら、Cookie の有効期限切れの可能性があります — jav --setup を実行して更新してください。
Q: FC2 素人番号は対応していますか？
A: 対応しています。031926-100 のようなハイフン形式で入力してください。ツールが自動的に形式を変換して検索します。
Q: 中国本土でも使えますか？
A: すべてのデータソースは中国本土からアクセスできない海外サイトです。中国本土ではプロキシ（VPN）が必要です。検索が失敗する場合は、以下のコマンドでネットワーク接続を確認してください：
curl -sL --connect-timeout 5 "https://www.javbus.com" -o /dev/null -w "JAVBUS: %{http_code}\n"
curl -sL --connect-timeout 5 "https://www.njav.com" -o /dev/null -w "NJAV: %{http_code}\n"
curl -sL --connect-timeout 5 "https://www.google.com" -o /dev/null -w "Google: %{http_code}\n"
200 が返ってくれば接続可能、000 が返ってくれば接続不可です。プロキシ設定を確認してください。
データソース
| ソース | サイト | 特徴 |
|---|---|---|
| JAVBUS | javbus.com | 高速、豊富なデータ |
| NJAV | njav.com | 高カバレッジ、Cookie 不要 |
| JavLibrary | javlibrary.com | 詳細なメタデータ、評価情報あり |
| JAVDB | javdb.com | 最も包括的、Cookie 必要 |
ライセンス
このプロジェクトは MIT License のもとでオープンソース公開されています。
コントリビュート
PR や Issue を歓迎します！
- このリポジトリを Fork
- ブランチを作成：
git checkout -b feat/your-feature - 変更をコミット：
git commit -m "feat: 変更内容を説明" - ブランチをプッシュ：
git push origin feat/your-feature - Pull Request を作成
コミットメッセージ規則：
feat:— 新機能fix:— バグ修正docs:— ドキュメント更新chore:— メンテナンス
作者にコーヒーを ☕
このツールが役に立った場合は、サポートをご検討ください：
| WeChat Pay | Alipay | PayPal |
|---|---|---|
 |
 |
 |
更新履歴
- v1.2.2 — README 多言語対応、npm 公開
- v1.2.0 — NJAV を第4データソースとして追加、優先順位を調整
- v1.1.x — 3ソースフォールバック、JAVDB Cookie をオプション化、クロスプラットフォーム対応
- v1.0.0 — 初回リリース