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 许可证 下发布。