ipatool

ipatool은 App Store에서 iOS, iPadOS, tvOS, watchOS, visionOS 및 macOS 앱을 검색하고 .ipa 또는 macOS .pkg 앱 패키지를 다운로드할 수 있게 해주는 명령줄 도구입니다.

요구 사항

• 지원되는 운영 체제(macOS, Linux, Windows 또는 iOS).
• App Store를 사용하도록 이미 구성된 Apple 계정.

설치

Linux 및 Windows

GitHub releases에서 최신 버전의 ipatool을 받을 수 있습니다.

macOS

Homebrew를 사용하여 ipatool을 설치할 수 있습니다.

$ brew install ipatool

사용법

시작하려면 다음 명령을 실행하세요.

$ ipatool --help
A cli tool for interacting with Apple's ipa files

Usage:
  ipatool [command]

Available Commands:
  auth                 Authenticate with the App Store
  completion           Generate the autocompletion script for the specified shell
  download             Download iOS, iPadOS, tvOS, watchOS, visionOS, and macOS app packages from the App Store
  get-version-metadata Retrieves the metadata for a specific version of an app
  help                 Help about any command
  list-purchases       List apps owned by the authenticated App Store account
  list-versions        List the available versions of an App Store app
  mcp                  Serve App Store tools over MCP using stdio
  purchase             Obtain a license for the app from the App Store
  search               Search for iOS, iPadOS, tvOS, watchOS, visionOS, and macOS apps available on the App Store

Flags:
      --format format                sets output format for command; can be 'text', 'json' (default text)
  -h, --help                         help for ipatool
      --keychain-passphrase string   passphrase for unlocking keychain
      --non-interactive              run in non-interactive session
      --verbose                      enables verbose logs
  -v, --version                      version for ipatool

Use "ipatool [command] --help" for more information about a command.

참고: 이 도구는 기본적으로 대화형 모드로 실행됩니다. 자동화된 환경에서 실행하는 경우 --non-interactive 플래그를 사용하세요.

MCP 도구

터미널에서 ipatool auth login을 실행한 다음, MCP 클라이언트가 stdio 서버를 실행하도록 구성하세요:

{
  "mcpServers": {
    "ipatool": {
      "command": "ipatool",
      "args": ["mcp"]
    }
  }
}

컴파일

이 도구는 Go 툴체인을 사용하여 컴파일할 수 있습니다.

$ go build -o ipatool

단위 테스트는 다음 명령으로 실행할 수 있습니다.

$ go generate ./...
$ go test -v ./...

라이선스

ipatool은 MIT 라이선스에 따라 배포됩니다.