app-store-optimization

App Store Optimization（ASO）

Apple App Store と Google Play Store で、キーワードの調査、メタデータの最適化、競合分析、アプリストアでの露出向上を行うための ASO ツールです。このファイルは簡潔な案内図です。タスクを実行する際は、以下から該当するリファレンスを読み込んでください。

主な機能

• キーワード調査 — 関連性、検索ボリューム、競争率、コンバージョン意図に基づいて、キーワードの選定・拡張・スコアリングを行い、メタデータ内の配置先を割り当てます
• メタデータ最適化 — プラットフォームの文字数制限と密度目標に照らして、タイトル、サブタイトル／短い説明、iOS のキーワード欄、全体の説明文を最適化します
• 競合分析 — 上位 10 件の競合を対象に、キーワードマトリックス、ギャップ分析、ビジュアルおよび評価のベンチマークを行います
• ローンチと A/B テスト — 構造化されたローンチチェックリスト、実施時期、サンプルサイズと有意性の計算を含むコンバージョン実験を提供します
• レビューとローカライズ — 感情・テーマ・問題点を抽出し、複数市場向けにメタデータを調整します
• 8 つの Python ツール — keyword_analyzer、metadata_optimizer、competitor_analyzer、aso_scorer、ab_test_planner、review_analyzer、launch_checklist、localization_helper（標準ライブラリのみ。提供されたデータを分析します）

使用するタイミング

• アプリストア掲載用のキーワードを調査またはスコアリングするとき
• ランキングやコンバージョン向上のために、タイトル／サブタイトル／説明文／キーワード欄を最適化するとき
• キーワードのギャップやポジショニングの機会を把握するために、競合を監査するとき
• アプリのローンチを計画するとき、またはストア掲載情報の A/B テストを実施するとき
• レビューを分析するとき、または複数市場向けのローカライズを計画するとき

最初に確認すること

生成する前に、以下の入力を確認してください。不明確または曖昧な項目があれば、推測せずに質問してください。

• プラットフォーム — Apple App Store と Google Play では、文字数制限、キーワード欄と説明文のインデックス登録、ランキング要因が異なります
• アプリのカテゴリとシードキーワード — アプリの分野と、調査を始めるキーワード（キーワード調査とスコアリングに影響します）
• 主な目標 — ランキングでの露出向上か、コンバージョン率の向上か（メタデータ、タイトル／サブタイトル、スクリーンショットの優先順位を決めます）
• 対象市場／ロケール — 対象のストアフロント（ローカライズとキーワード検索ボリュームの推定に影響します）

停止ルール：出力に最も大きく影響する項目を 2～3 個だけ質問してください。ユーザーが「とにかく下書きを作って」と言った場合は、そのまま進め、成果物の冒頭に前提を記載してください。

クイックスタート

python scripts/keyword_analyzer.py --keywords "todo,task,planner"
python scripts/metadata_optimizer.py --platform ios --title "App Title"
python scripts/aso_scorer.py --app-id com.example.app

注：スクリプトはインポート可能な Python ライブラリです。クラス、メソッド、便利な関数については「ツールリファレンス」を参照してください。

リファレンス

タスクに合ったリファレンスを読み込んでください。このファイルは簡潔に保ち、必要に応じて詳細を参照します。

• references/aso-workflows.md — 5 つのワークフローすべてについて、手順、スコアリング基準、配置表、構造図、テンプレート、変更前後の例を掲載しています。キーワード調査、メタデータ最適化、競合分析、ローンチ、A/B テストの実行時に読んでください。
• references/tool-reference.md — 8 つの Python スクリプトの完全な使用方法（クラス、メソッド、パラメーター、戻り値、便利な関数、およびスクリプトとアセットの表）を掲載しています。ツールを実行する前に読んでください。
• references/operations-and-benchmarks.md — トラブルシューティング表、成功基準／目標、プラットフォームの制限、先回りして対処するためのトリガー、出力成果物、コミュニケーション基準、関連スキル、完全な統合マトリックスを掲載しています。問題の診断、目標の設定、他のツールとの連携時に読んでください。
• references/keyword-research-guide.md — 調査手法、評価フレームワーク、トラッキングについて説明しています。キーワードの詳細な発見と選定の際に読んでください。
• references/platform-requirements.md — iOS および Android のメタデータ仕様とビジュアルアセットの要件を掲載しています。プラットフォームのルールに照らして各フィールドを検証するときに読んでください。
• references/aso-best-practices.md — 最適化戦略、評価管理、ローンチの戦術を掲載しています。実証済みの戦術やプレイブックを確認するときに読んでください。

対応範囲と制約

対応範囲： Apple App Store と Google Play Store を対象とした、キーワード調査、メタデータの最適化と文字数制限の検証、競合 ASO 分析（公開データ）、有意差の計算を含む A/B テストの計画、リリース・季節性・ローカライズの計画、レビューの感情分析。

対応範囲外： ストアデータのリアルタイム取得（スクリプトは提供された静的データを分析します）、Apple Ads（旧 Apple Search Ads）／Google Ads のキャンペーン管理、クリエイティブ素材のデザイン、デバイス間のアトリビューション（MMP をご利用ください）、アプリ内分析／継続率の分析、収益／サブスクリプション価格の設定。

データ上の制約： どちらのストアにも公式の検索ボリューム API はありません（推定にはサードパーティ製ツールやヒューリスティックを使用します）。競合データとレビューのデータは公開情報に限られます。過去のランキングデータには外部ツール（AppTweak、Sensor Tower、data.ai）が必要です。Apple の 2025 年 6 月のアップデートではスクリーンショット内のテキストがインデックス対象になりましたが、これらのスクリプトではまだ分析できません。詳細は references/operations-and-benchmarks.md をご覧ください。

統合ポイント

Apple App Store Connect および Google Play Console（メタデータの提出、Product Page Optimization／Store Listing Experiments）、Apple Ads（旧 Apple Search Ads。キーワードの発見）、ASO ツール（ボリューム／ランキングデータ用の AppTweak、Sensor Tower、data.ai）、分析ツール（エンゲージメントのシグナル用の Firebase／Mixpanel／Amplitude）、さらに campaign-analytics および content-creator スキルと連携します。接続方法とデータフローの詳細は references/operations-and-benchmarks.md をご覧ください。