gallery-dl Pixiv 가이드

공식 Pixiv 추출기는 개별 작품뿐 아니라 사용자 프로필, 이미지, 북마크, 팔로우, 랭킹, 검색, 시리즈, Sketch, pixivision, 배경과 아바타도 다룹니다. URL마다 범위가 다르므로 처음에는 많은 항목이 나오는 프로필보다 작품 하나를 선택하는 편이 안전합니다. 이 gallery-dl Pixiv 안내를 로컬에서 확인할 수 있는 체크리스트로 사용하세요. 실제로 열람하고 사용할 권한이 있는 URL인지 먼저 확인하고, 계정 권한과 공개 범위를 작업 기록에 함께 적어 두면 결과를 해석하기 쉽습니다. 실행 전에는 저장 폴더의 여유 공간과 파일명 규칙도 확인하세요. 작업 범위도 기록하세요.

접근 권한이 있는 페이지에서 www.pixiv.net의 정식 URL을 복사해 따옴표로 감싸고 파일을 쓰기 전에 시뮬레이션하세요. 설치된 버전이 URL을 인식하는지, 인증이 필요한지, 어떤 미디어가 선택되는지 확인할 수 있습니다. 큰 컬렉션의 상태가 계속 같다는 보장은 없습니다.

gallery-dl --simulate "https://www.pixiv.net/en/artworks/ARTWORK_ID"

gallery-dl --simulate "https://www.pixiv.net/en/users/USER_ID"

gallery-dl -K "https://www.pixiv.net/en/artworks/ARTWORK_ID"

Pixiv는 익명 요청을 거부하는 페이지에서 로그인 세션을 요구할 수 있습니다. 자신이 관리하는 브라우저 프로필로 정상 로그인하고 대상 페이지가 열리는지 확인한 다음 gallery-dl이 로컬 쿠키 저장소를 읽게 하세요. 쿠키 선택은 계정이 이미 가진 권한만 재현하며 비공개 작품에 권한을 추가하지 않습니다. 이 gallery-dl Pixiv 안내를 로컬에서 확인할 수 있는 체크리스트로 사용하세요.

쿠키 데이터베이스가 잠겼다면 브라우저를 완전히 닫고 활성 Pixiv 세션이 있는 프로필을 선택하세요. 어제 되던 명령이 실패하면 세션, 프로필, URL 범위, 설치 버전을 각각 확인합니다. 쿠키 값, 브라우저 DB, 토큰과 비밀번호를 공개 설정이나 로그에 넣지 마세요.

• 같은 프로필로 정상 Pixiv 접속을 확인하세요.
• DB가 잠기면 브라우저를 닫으세요.
• 쿠키와 계정 식별자는 기기에 보관하세요.
• 비공개·삭제·제한 콘텐츠는 접근할 수 없으면 받지 마세요.

gallery-dl --cookies-from-browser firefox --simulate "https://www.pixiv.net/en/users/USER_ID"

gallery-dl --cookies-from-browser chrome --simulate "https://www.pixiv.net/en/users/USER_ID"

gallery-dl --cookies-from-browser edge --simulate "https://www.pixiv.net/en/users/USER_ID"

추출기가 응답했다고 작업이 끝난 것은 아닙니다. 작품 하나인지, 공개 작품인지, 북마크인지, 랭킹인지, 검색인지 정하고 처음에는 작은 범위와 명시적인 저장 위치를 사용하세요. 파일명 규칙을 만들기 전 -K로 메타데이터를 확인해 사용자명, ID, 페이지, 날짜와 확장자처럼 실제 반환되는 항목을 사용합니다. 이 gallery-dl Pixiv 안내를 로컬에서 확인할 수 있는 체크리스트로 사용하세요.

저장 위치를 브라우저 임시 프로필 안에 두지 말고 계정을 같은 폴더에 섞지 마세요. 아카이브를 공유하면 다른 사람의 테스트가 비어 보일 수 있습니다. 진단용과 반복 작업을 분리하고 URL과 버전을 명령 옆에 기록하세요.

gallery-dl --cookies-from-browser firefox --range "1-10" --destination "D:/Media/Pixiv" "https://www.pixiv.net/en/users/USER_ID"

gallery-dl -K "https://www.pixiv.net/en/artworks/ARTWORK_ID"

gallery-dl --simulate --config-ignore "https://www.pixiv.net/en/artworks/ARTWORK_ID"

작은 실행이 맞다면 고정된 로컬 파일을 --download-archive로 지정하세요. 성공한 추출기 ID를 기록해 다음 실행에서 건너뜁니다. 미디어 백업이 아니므로 URL이 비었다고 삭제하지 마세요. 범위나 필터가 바뀌었거나 콘텐츠가 없어졌거나 이미 ID가 기록됐을 수 있습니다. 이 gallery-dl Pixiv 안내를 로컬에서 확인할 수 있는 체크리스트로 사용하세요.

범위를 조금씩 늘리고 변경할 때마다 파일을 확인하세요. Pixiv 프로필, 랭킹, 검색과 시리즈는 작업 중에도 바뀔 수 있습니다. 여러 기기에서 사용한다면 아카이브를 의도적으로 백업하고 브라우저 인증정보를 함께 복사하지 마세요.

• 반복 작업마다 아카이브를 하나씩 사용하세요.
• 아카이브는 미디어가 아닌 기록으로 백업하세요.
• 결과를 확인한 뒤 범위를 늘리세요.
• 빈 결과를 항상 추출기 오류로 판단하지 마세요.

gallery-dl --cookies-from-browser firefox --range "1-25" --download-archive "pixiv.sqlite3" "https://www.pixiv.net/en/users/USER_ID"

gallery-dl --write-metadata --download-archive "pixiv.sqlite3" "https://www.pixiv.net/en/artworks/ARTWORK_ID"

gallery-dl --download-archive "pixiv-diagnostic.sqlite3" --simulate "URL"

명령줄 버전이 성공한 뒤 안정적인 값만 설정 파일로 옮기세요. gallery-dl은 기본·카테고리·하위 카테고리 단계로 옵션을 적용하므로 Pixiv 값은 전역 값보다 좁게 둘 수 있습니다. 먼저 저장 위치, 아카이브와 확인한 파일명 규칙만 유지하면 검토하기 쉽습니다. 이 gallery-dl Pixiv 안내를 로컬에서 확인할 수 있는 체크리스트로 사용하세요.

Pixiv를 탓하기 전에 JSON과 활성 파일을 확인하세요. --config-status로 읽힌 경로를 보고, 지원되면 --config-open을 사용하며, --config-ignore로 깨끗한 실행을 비교합니다. JSON에는 주석이나 끝 쉼표를 넣지 말고 Windows 경로를 이스케이프하며 비밀값을 예시에 넣지 마세요.

{
  "extractor": {
    "base-directory": "D:/Media/Pixiv",
    "archive": "D:/Media/Pixiv/pixiv.sqlite3"
  }
}

gallery-dl --config-status

gallery-dl --config-ignore --simulate "https://www.pixiv.net/en/artworks/ARTWORK_ID"

인증, 제한, URL 인식, 필터와 아카이브 스킵은 별개의 문제로 다루세요. 인증 메시지는 잘못된 프로필이나 만료·잠금 상태를 뜻할 수 있고, 429는 병렬 재시도가 아니라 대기와 범위 축소가 필요합니다. 파일이 없으면 URL 형태, 삭제·제한 콘텐츠, 필터, 범위와 아카이브를 확인합니다. 이 gallery-dl Pixiv 안내를 로컬에서 확인할 수 있는 체크리스트로 사용하세요.

같은 URL을 --config-ignore와 --simulate로 비교한 뒤 옵션을 하나씩 되돌리세요. 버전, 정식 URL, 활성 설정, 브라우저 접근을 확인한 뒤 수정합니다. 상위 추출기가 바뀌면 공식 목록과 문서를 확인하고 요청 반복으로 플랫폼 규칙을 우회하지 마세요.

• 권한이 있는 콘텐츠와 계정만 사용하세요.
• 쿠키, 토큰, 비공개 URL과 원본 로그를 공유하지 마세요.
• 첫 테스트는 작게 simulate하세요.
• Pixiv 규칙, 저작권과 제한을 지키세요.