apkpure

apkpure — APKPure APK 다운로드 CLI

설치 확인

which apkpure || echo "설치 필요"
apkpure -V 2>/dev/null || echo "버전 확인 불가"

설치가 안 되어 있으면:

# Homebrew
brew install kyungw00k/cli/apkpure

# Shell Script
curl -fsSL https://kyungw00k.dev/apkpure/install.sh | sh

# Go
go install github.com/kyungw00k/apkpure/cmd/apkpure@latest

핵심 명령어

apkpure -a <패키지ID> <출력경로>                        # 최신 APK 다운로드
apkpure -a <패키지ID>@<버전> <출력경로>                 # 특정 버전 APK 다운로드
apkpure -l -a <패키지ID>                               # 사용 가능한 버전 목록 확인
apkpure -c apps.csv <출력경로>                          # CSV 파일에서 일괄 다운로드
apkpure -a <패키지ID> -o arch=arm64-v8a <출력경로>      # 특정 아키텍처 APK 다운로드

옵션 레퍼런스

플래그	기본값	설명
-a, --app		앱 패키지 ID (예: com.instagram.android 또는 com.instagram.android@1.2.3)
-c, --csv		앱 ID 목록이 담긴 CSV 파일 경로
-f, --field	1	CSV에서 앱 ID가 담긴 필드 번호
-v, --version-field		CSV에서 버전이 담긴 필드 번호
-l, --list-versions		사용 가능한 버전 목록 출력
-o, --options		추가 옵션 (예: arch=arm64-v8a,language=ko-KR)
-r, --parallel	4	병렬 다운로드 수
-s, --sleep-duration	0	다운로드 사이 대기 시간 (밀리초)
-V, --version		CLI 버전 출력

-o 옵션 레퍼런스

키	설명	예시
arch	CPU 아키텍처	arm64-v8a, armeabi-v7a, x86, x86_64
language	언어 코드	ko-KR, en-US
os_ver	Android OS 버전	35 (Android 15)
output_format	목록 명령어 출력 형식	plaintext, json

시나리오별 사용법

1. 특정 앱의 최신 APK를 다운로드할 때

# Instagram 최신 APK 다운로드
apkpure -a com.instagram.android ./downloads

# YouTube 최신 APK 다운로드
apkpure -a com.google.android.youtube ./downloads

2. 특정 버전의 APK가 필요할 때

# 먼저 사용 가능한 버전 목록 확인
apkpure -l -a com.instagram.android

# 특정 버전 지정하여 다운로드
apkpure -a com.instagram.android@150.0.0.0 ./downloads

3. 여러 앱을 한꺼번에 다운로드할 때 (CSV 배치)

# apps.csv 파일 준비 (한 줄에 패키지 ID 하나)
# com.instagram.android
# com.google.android.youtube
# com.kakao.talk

# CSV 파일로 일괄 다운로드 (기본 4개 병렬)
apkpure -c apps.csv ./downloads

# 병렬 다운로드 수 조정
apkpure -c apps.csv -r 2 ./downloads

# 다운로드 간격 추가 (서버 부하 방지, 1초 대기)
apkpure -c apps.csv -s 1000 ./downloads

CSV에 버전 정보도 포함된 경우:

# apps_with_version.csv 예시:
# com.instagram.android,150.0.0.0
# com.google.android.youtube,18.32.39

apkpure -c apps_with_version.csv -f 1 -v 2 ./downloads

4. 특정 아키텍처(arm64-v8a)의 APK가 필요할 때

# arm64-v8a 아키텍처 APK 다운로드
apkpure -a com.instagram.android -o arch=arm64-v8a ./downloads

# 여러 옵션 동시 적용 (아키텍처 + 언어)
apkpure -a com.instagram.android -o arch=arm64-v8a,language=ko-KR ./downloads

# x86 에뮬레이터용 APK
apkpure -a com.instagram.android -o arch=x86 ./downloads

5. 사용 가능한 버전 목록을 확인할 때

# 기본 텍스트 형식으로 버전 목록 출력
apkpure -l -a com.instagram.android

# JSON 형식으로 버전 목록 출력
apkpure -l -a com.instagram.android -o output_format=json

# JSON 출력 후 jq로 파싱
apkpure -l -a com.instagram.android -o output_format=json | jq '.'

출력 형식

다운로드 완료 시

다운로드가 완료되면 지정한 출력 경로에 APK 파일이 저장됩니다.

<출력경로>/<패키지ID>-<버전>.apk

예시:

./downloads/com.instagram.android-150.0.0.0.apk

버전 목록 출력 (plaintext)

150.0.0.0
149.0.0.0
148.0.0.0
...

버전 목록 출력 (JSON)

[
  "150.0.0.0",
  "149.0.0.0",
  "148.0.0.0"
]

주의사항

• 인터넷 연결 필요: APKPure 서버에서 직접 다운로드하므로 인터넷 연결이 필요합니다.
• 패키지 ID 확인: 패키지 ID는 Google Play Store URL의 id= 파라미터에서 확인할 수 있습니다. (예: play.google.com/store/apps/details?id=com.instagram.android)
• 아키텍처 미지정 시: -o arch= 옵션 없이 다운로드하면 APKPure가 범용(universal) APK를 제공합니다. 특정 기기 호환성이 필요하면 아키텍처를 명시하세요.
• 버전 표기: @ 뒤에 버전을 붙여 특정 버전을 지정합니다. 정확한 버전 문자열은 -l 옵션으로 먼저 확인하세요.
• 병렬 다운로드: -r 기본값은 4입니다. 네트워크 상황에 따라 조절하세요.
• 이용 약관: APKPure 서비스 이용 약관을 준수하여 사용하세요.