ipatool

ipatool は、App Store で iOS、iPadOS、tvOS、watchOS、visionOS、macOS アプリを検索し、.ipa または macOS .pkg アプリパッケージをダウンロードできるコマンドラインツールです。

要件

• サポートされているオペレーティングシステム（macOS、Linux、Windows、または iOS）。
• App Store を使用するように設定済みの Apple Account。

インストール

Linux および Windows

最新バージョンの ipatool は GitHub releases から入手できます。

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 ライセンス の下でリリースされています。