asc app create (UI オートメーション)

このスキルを使用して、Web UI を操作することで App Store Connect に新しいアプリを作成します。 これはオプトイン、ローカルのみのオートメーションであり、ユーザーが署名済みの状態を必要とします。

前提条件

• ブラウザオートメーションツールが利用可能 (Playwright、Cursor browser MCP、または同等)。
• ユーザーが App Store Connect にサインイン済み (またはログイン + 2FA を完了可能)。
• バンドル ID は既に Apple Developer ポータルに登録されている必要があります。
• 必須入力が既知:
  • アプリ名 (最大 30 文字)
  • バンドル ID (存在し、他のアプリで未使用)
  • SKU
  • プラットフォーム (iOS、macOS、tvOS、visionOS)
  • 主言語
  • ユーザーアクセス (フルアクセスまたは制限付きアクセス)

セーフティガードレール

• クッキーをエクスポートまたは保存しない。
• 表示されているブラウザセッションのみを使用。
• 「作成」をクリックする前に最終確認を一時停止 (スタンドアロンスクリプト用)。
• 失敗時に「作成」アクションを自動的に再試行しない。

ワークフロー

1. プリフライト: バンドル ID を登録し、既存アプリがないことを確認

# バンドル ID をパブリック API 経由で登録 (未登録の場合)
asc bundle-ids create --identifier "com.example.app" --name "My App" --platform IOS

# アプリレコードが存在しないことを確認
asc apps list --bundle-id "com.example.app" --output json

2. App Store Connect を開く

https://appstoreconnect.apple.com/apps に移動し、ユーザーがサインイン済みであることを確認します。

3. 新規アプリフォームを開く

「新規アプリ」ボタン (青い「+」アイコン) は、ダイアログではなく ドロップダウンメニュー を開きます。

• 「新規アプリ」ボタンをクリックしてドロップダウンを開きます。
• ドロップダウン内の「新規アプリ」メニュー項目 をクリックします。
• 作成ダイアログ/モーダルが表示されます。

4. 必須フィールドを順番に入力

プラットフォーム (チェックボックス)

プラットフォームは チェックボックス (ラジオボタンではありません)。目的のプラットフォームのチェックボックスをクリック:

• iOS、macOS、tvOS、visionOS
• 複数を選択可能。

名前 (テキスト入力)

• ラベル: Name
• 最大 30 文字。

主言語 (選択/コンボボックス)

• ラベル: Primary Language
• 言語ラベル (例: "English (U.S.") で select_option または同等を使用。

バンドル ID (選択/コンボボックス)

• ラベル: Bundle ID
• これは <select> ドロップダウンです。オプションはプラットフォーム選択後に非同期で読み込みます。
• ドロップダウンが読み込み完了するまで待機 (初期状態は「Loading...」を表示)。
• ラベルテキストの一致で選択 (名前と識別子の両方を含む): "My App - com.example.app"

SKU (テキスト入力)

• ラベル: SKU

ユーザーアクセス (ラジオボタン) -- 必須

• このフィールドは必須です。 1 つのオプションが選択されるまで、作成ボタンは無効なままです。
• オプション: Limited Access または Full Access。
• これらは <span> オーバーレイを持つカスタムラジオボタンです。
• 既知の問題: アクセシビリティベースのクリックはオーバーレイ <span> によってインターセプトされる可能性があります。
• 回避策: ラジオ要素で最初に scrollIntoView を使用してから、ラジオ参照を直接クリック。これはオーバーレイインターセプションをバイパスします。

5. 「作成」をクリック

• 「作成」ボタンは、すべての必須フィールドが入力されて かつ ユーザーアクセスが選択されるまで無効です。
• クリック後、ボタンテキストは処理中に「Creating」に変わります。
• 新しいアプリのページへのナビゲーションを待機 (URL パターン: /apps/<APP_ID>/...)。

6. API 経由で作成を検証

asc apps view --id "APP_ID" --output json --pretty
# または
asc apps list --bundle-id "com.example.app" --output json

7. ポスト作成セットアップに引き継ぎ

asc app-setup info set --app "APP_ID" --primary-locale "en-US"
asc app-setup categories set --app "APP_ID" --primary GAMES
asc web apps availability create \
  --app "APP_ID" \
  --territory "USA,GBR" \
  --available-in-new-territories true

上記の実験的な Web フローは最初の利用可能性ブートストラップのみに使用します。アプリの利用可能性が既に存在する場合は、後の地域変更の場合、asc pricing availability edit --app "APP_ID" ... に切り替えます。

既知の UI オートメーション問題

「新規アプリ」は直接アクションではなくドロップダウンメニュー

最初のクリックは「新規アプリ」と「新規アプリバンドル」を持つメニューを開きます。ボタンをクリックするだけでなく、メニュー項目をクリックする必要があります。

ユーザーアクセスラジオボタンに span オーバーレイがある

Apple のカスタムラジオボタンは、<input type="radio"> をスタイル化された <span> 要素にラップします。直接参照ベースのクリックは「クリックターゲットがインターセプトされた」で失敗する可能性があります。修正方法は:

1. ラジオ要素をビューにスクロール (scrollIntoView)。
2. ラジオ参照を直接クリック (オフセットやラベルクリック経由ではない)。

バンドル ID ドロップダウンが非同期で読み込み

プラットフォームを選択した後、バンドル ID ドロップダウンは「Loading...」を表示し、無効になります。選択する前に有効で入力されるまで待機します。

browser_fill はフォーム検証をトリガーしない可能性がある

Apple の Ember.js フォームはカスタム変更ハンドラーを使用します。browser_fill (アトミック設定) は検証をトリガーしない可能性があります。すべてのフィールドを入力した後も「作成」ボタンが無効なままの場合:

• 少なくとも 1 つのテキストフィールドで値をゆっくり (文字ごと) 再入力します。
• またはフィールドをクリック、クリア、ゆっくり入力します。

失敗処理

• フィールドまたはボタンが見つからない場合は停止し、ユーザーサポートを要求します。
• スクリーンショットをキャプチャし、最後に既知のステップを報告します。
• 「作成」クリックを自動的に再試行しないでください。
• 失敗時、ユーザーはブラウザで検証エラー (赤いアウトライン、インラインメッセージ) を確認する必要があります。

注記

• このスキルはパブリック API の欠落に対する回避策です。Apple のドキュメントは明確に述べています: 「このAPI を使用してアプリを作成しないでください。代わりに App Store Connect Web サイトで新しいアプリを作成してください。」
• UI セレクターは予告なく変更される可能性があります。CSS より role/label/text セレクターを優先します。
• 唯一の手動ステップはサインインである必要があります。その他すべてはエージェント駆動可能です。