7.6 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
사용 방법
번호 검색：
jav SSIS-001
jav ABF-331
jav JUR-067
원시 JSON 출력：
jav -r SSIS-001
로컬 캐시 삭제：
jav --clear-cache
JAVDB Cookie 설정（선택）：
jav --setup
도움말 표시：
jav -h
명령어 옵션
Usage: jav [options] [번호]
Arguments:
번호 검색할 번호, 예: SSIS-001
Options:
-v, --version 버전 출력
-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 — 최초 릴리스