앱스토어 앱 검색과 패키지 다운로드를 터미널에서 처리하는 방법
앱스토어에서 원하는 앱을 찾아 설치 파일을 내려받는 과정을 명령어로 처리할 수 있습니다. 이는 Apple 생태계 앱의 메타데이터 조회와 .ipa 또는 .pkg 파일 다운로드를 자동화하는 도구입니다. 특히 스크립트나 자동화 환경에서 앱 정보를 다루고 싶을 때 유용합니다.
터미널에서 앱스토어와 대화하기
이 도구는 Apple의 앱스토어와 상호작용하기 위해 설계되었습니다. search 명령어로 앱을 찾고, download 명령어로 실제 설치 파일을 가져올 수 있습니다. iOS, iPadOS, tvOS, watchOS, visionOS, macOS 앱 모두를 지원합니다. 기본적으로 대화형 모드로 작동하지만, --non-interactive 플래그를 사용하면 자동화 환경에서도 안정적으로 실행됩니다. 출력 형식은 텍스트나 JSON으로 선택할 수 있어 후속 처리가 쉽습니다.
MCP 서버로 확장된 활용
이 도구는 MCP(Model Context Protocol) 서버로 실행될 수 있습니다. ipatool mcp 명령을 통해 표준 입력/출력 기반 서버를 띄우고, MCP 클라이언트에 연결하면 앱스토어 도구를 다른 AI 에이전트나 자동화 시스템에서 호출할 수 있습니다. 먼저 터미널에서 ipatool auth login으로 인증을 완료한 뒤, 클라이언트 설정에 해당 명령을 등록하면 됩니다. 이를 통해 앱 검색이나 버전 조회 같은 작업을 외부 시스템에서 자연스럽게 수행할 수 있습니다.
설치와 실행 환경
macOS에서는 Homebrew를 통해 brew install ipatool로 설치할 수 있습니다. Linux와 Windows는 GitHub 릴리스에서 최신 버전을 직접 받아야 합니다. 실행을 위해선 macOS, Linux, Windows, iOS 중 하나를 사용해야 하며, 앱스토어에 연결된 Apple 계정이 필요합니다. Go 언어로 작성되어 있어 go build 명령으로 소스에서 직접 컴파일하는 것도 가능합니다. MIT 라이선스로 배포되어 자유롭게 사용할 수 있습니다.
사용 전 확인 사항
auth 명령을 통해 인증 상태를 점검하는 것이 좋습니다. 또한, 다운로드하려는 앱이 해당 계정에 구매 이력이 있는지, 또는 무료 앱인지에 따라 purchase 명령이 필요할 수 있습니다. 자동화 환경에서는 --non-interactive 옵션을 반드시 지정해야 하며, 키체인 접근이 필요한 경우 --keychain-passphrase로 패스프레이스를 제공해야 합니다. 특정 버전의 메타데이터나 버전 목록을 조회할 때는 get-version-metadata와 list-versions 명령을 활용하면 됩니다.
