AsoBeast

AsoBeastとは？

AsoBeastは、Apple App StoreとGoogle Play向けのアプリストア最適化（ASO）ツール兼キーワード順位トラッカーです。アプリの掲載情報を取り込み、キーワード順位を深さ200まで毎日追跡し、競合、レビュー、メタデータを監視して、その履歴を優先順位付けされたASO作業リストにまとめます。このリポジトリは、自分のサーバーで実行する無料のオープンソース版です。ホスト型サービスのasobeast.comも同じコードで動作します。

ストアへのリクエストはすべて、AsoBeastをホストしているマシン上で、通常の公開検索またはページリクエストとして実行されます。そのため、AppleとGoogleには、追跡対象の各フレーズが通常の検索と同じように見えます。ASOベンダーに登録する必要も、APIキーを購入する必要も、キーワードリストを誰かと共有する必要もありません。ストアへのリクエスト以外では、Webhookアラート、メール、OpenAIによる支援、Apple Adsの検索人気度、ストアのステータス更新などの外部連携を明示的に有効にしない限り、データはデプロイ環境内にとどまります。

AsoBeastはどのような人向けですか？

AsoBeastは、アプリを公開し、ASOデータを自分で管理したい人のために作られています。個人開発者、小規模なスタジオ、複数のストアフロントで少数のアプリを追跡する代理店などが対象です。キーワードごとのサブスクリプションなしでASOを追跡したい場合、自分のインフラストラクチャにデータを置く必要がある場合、またはダッシュボードではなくエージェントやスクリプトからASOの履歴を照会したい場合に適しています。公開ストアのエンドポイントから意図的に控えめな頻度でデータを収集するため、数百ではなく、アプリ数で測れる規模のポートフォリオに適しています。AsoBeastの対象ユーザーをご覧ください。

AsoBeast を選ぶ理由

• アカウントもベンダー API キーも不要です。 AsoBeast は、公開ストアのエンドポイントから意図的に控えめな頻度でデータを収集します。必要なのは Docker だけです。
• キーワードリストは自分の手元に置けます。 キーワードリストはデータベースに保存され、ASO ベンダーに送信されることはありません。そのため、検索内容から競合分析製品にキーワードリストを組み立てられる心配はありません。ストアに送られるのは、一度に 1 件の検索だけです。
• 両方のストアを 1 つの追跡単位で管理できます。 1 つのアプリ行で複数のストアフロントにまたがるキーワードを追跡できるため、us と de は 2 つのサブスクリプションではなく、同じ掲載情報のマーケットです。
• すべてのスコアに根拠が示されます。 人気度と難易度には、情報源、計算バージョン、取得日、信頼度が付いているため、数値をうのみにせず、その根拠を検討できます。
• 決定論的な推奨を提供します。 17 個のルールが保存された履歴を、説明可能な作業キューに変換します。AI は任意の補助機能としてアクションを要約できますが、アクションを捏造したり、順序を変更したりすることはありません。
• AGPL-3.0、オープンコアではありません。 ホステッドサービスで実行されるすべての機能が、このリポジトリに含まれています。

機能

機能	内容
2つのライブストア	Apple App Store または Google Play の URL をインポートし、メタデータをスナップショットとして保存して、必要に応じて更新し、すべての項目の差分を確認できます
キーワードの追跡	検証済みのストアフロントを任意に追跡し、日ごとの順位と履歴を確認できます。一括編集や、iOS の非公開の 100 文字キーワード欄の手動管理にも対応しています
市場の提案	リスティングが対応している言語を読み取り、その言語が通じるストアフロントを、1 日あたりのリクエスト費用とともに提案します。さらに、選んだ市場に、その市場のリスティングで使われているキーワードを登録します
深度 200 までの順位チェック	キーワードと市場ごとに検索を 1 回行うだけで、自社アプリとすべての競合を確認できます。そのため、競合の追跡に追加のリクエストは必要ありません
透明性の高いスコアリング	人気度と難易度を根拠と信頼度とともに提示し、読み取り時に機会を算出します
SERP とカテゴリのインテリジェンス	SERP スナップショットを保持し、変動性、新規参入アプリ、順位変動を確認できます。また、国やカテゴリ別のトップチャート、順位変動、トレンドアプリ、チャートの追跡にも対応しています
競合の発見	ライブ検索結果から競合を見つけ、リスティングを比較し、キーワードのギャップを特定できます
レビューと変更の検出	レビューと評価履歴を同期し、AI で返信を作成してストアに投稿できます。レビューの文面からキーワード候補を抽出し、自社および競合のメタデータ変更を検出します
ストアファネル	App Store Connect キーまたは Google Play サービスアカウントを任意で接続すると、順位やすべてのリスティング変更と並べて、市場別の各ストア独自のファネルを確認できます。インプレッション、プロダクトページの閲覧数、入手タップ数、コンバージョン（App Store では 2024 年までさかのぼる履歴）、Google Play ではストアのリスティング訪問者数、獲得数、検索語句ごとのインストール数を確認できます
ASO 監査とメタデータのワークベンチ	履歴を備えた決定論的な監査基準、ストアメタデータの検証、戦略的なキーワード分類を提供します
ASO アクションセンター	17 個の決定論的なルールに基づき、優先度、推定インパクト、根拠、詳細リンク、完全なライフサイクル、検証済みの結果を備えた推奨事項を提示します
ポートフォリオ分析	ストアや国をまたいで関連するリスティングをグループ化し、グループの可視性を比較して、週次ダイジェストを作成できます
アラート	順位、SERP、メタデータ、レビュー、新しいアクションのイベントについて、署名付き Webhook または SMTP メールで通知します。中断後に再開できるバッチ配信にも対応しています
MCP サーバー	読み取りツール 37 個に加え、キーワード、競合、アクション、注釈を変更するオプトインのツール 7 個を、stdio またはリモートエンドポイント経由で提供します。これにより、Claude Code、Claude Desktop、Cursor、VS Code などの MCP クライアントからインスタンスを利用できます
これらの各項目のガイドは、ドキュメントをご覧ください。

クイックスタート

ワンクリックデプロイ

公開済みのイメージを PostgreSQL および Redis とともに Railway で実行し、すべてのシークレットを自動生成します。Railway へのデプロイをご覧ください。

Docker Compose

Compose を含む Docker、約 2 GB のメモリ、5 GB のディスク容量が必要です。

git clone https://github.com/AsoBeast/asobeast.git
cd asobeast
printf 'POSTGRES_PASSWORD=%s\nAUTH_SECRET=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
chmod 600 .env
docker compose up --build -d --wait

http://localhost:3001 を開き、オーナーアカウントを作成します。アカウントが作成されると、登録は自動的に終了します。Safari は通常の HTTP 接続ではセッション Cookie を保持しないため、ローカルで評価する場合は Chrome または Firefox を使用するか、サインインするとサインインフォームに戻るをご覧ください。ストアの URL をインポートすると、すぐにキーワードの追跡が始まります。

ビルドせずに公開済みのイメージを使いたい場合は、docker-compose.pull.yml を使うと、クローンせずに GHCR から同じスタックを実行できます。

curl -fsSLO https://raw.githubusercontent.com/AsoBeast/asobeast/main/docker-compose.pull.yml
printf 'POSTGRES_PASSWORD=%s\nAUTH_SECRET=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
chmod 600 .env
docker compose -f docker-compose.pull.yml up -d --wait

詳しい手順はクイックスタートをご覧ください。イメージのタグ付け、固定、アップグレードについては、公開済みリリースの実行をご覧ください。

AI エージェントを接続する

すべてのインスタンスで Model Context Protocol エンドポイントが提供されます。Integrations ページで個人用 API トークンを作成し、Claude Code の接続先に設定します。

claude mcp add --transport http asobeast https://your-host/api/backend/mcp --header "Authorization: Bearer asob_…"

今週順位が下がったキーワード、トップ 10 に入った競合、Action Center が最初に対応するよう求めている内容などを尋ねてみましょう。Claude Desktop、Cursor、VS Code、Gemini CLI、Windsurf、ローカルの stdio サーバーの設定は、MCP サーバーのセットアップをご覧ください。また、MCP レシピには、すぐに使えるプロンプトが用意されています。

AsoBeast の比較

	AsoBeast（セルフホスト）	サブスクリプション型 ASO プラットフォーム
ストアへのリクエストの実行場所	お使いのマシン	ベンダーのインフラストラクチャ
キーワードリストを見る人	お客様	ベンダー
料金体系	ホスティング料金	ユーザー単位、アプリ単位、またはキーワード単位
キーワード履歴	お客様のもので、保持期間も自由に設定可能	サブスクリプション終了時に消去される
スコアの算出方法	公開済み、バージョン管理済み、検証可能	通常は非公開
拡張方法	フォークできます。AGPL-3.0 です	機能リクエストを送信

ホスト型 AsoBeast は、同じリポジトリを基に構築された別製品です。セルフホスト環境では、すべての機能を利用できます。

技術スタック

pnpm と Turborepo、全体で厳格な TypeScript、NestJS、Prisma、PostgreSQL 18、BullMQ、Redis 8、Tailwind を使用した Next.js、Docker Compose。

コントリビューター向けのセットアップ、アーキテクチャ、モジュール一覧については、ローカル開発とAsoBeast の仕組みをご覧ください。

設定

すべての環境変数とそのデフォルト値、それぞれの変更内容は、設定リファレンスに記載されています。リポジトリ内の apps/api/.env.example と apps/web/.env.example が正式な一覧です。

デフォルトのインストールで必要な変数は、POSTGRES_PASSWORD と AUTH_SECRET の 2 つです。それ以外はすべて、動作するデフォルト値が設定されています。

よくある質問

App Store Optimization とは何ですか？

App Store Optimization とは、App Store と Google Play の検索におけるアプリのランキングとコンバージョン率を改善する取り組みです。インデックス対象のメタデータフィールドでのキーワード選定、競合他社との位置づけ、評価とレビュー、カテゴリ内でのパフォーマンスを対象とします。

AsoBeast に App Store Connect または Google Play Console のアカウントは必要ですか？

いいえ。AsoBeast は公開ストアデータを読み取るため、競合を含むあらゆるアプリを追跡でき、ASO ベンダーの API キーも必要ありません。App Store Connect のキーまたは Google Play のサービスアカウントを接続するかどうかは任意です。接続すると、自分のアプリについて各ストア独自の訪問数、ダウンロード数、コンバージョンが追加され、キーは保存時に暗号化されます。ストアファネルをご覧ください。

AsoBeast はどのアプリストアに対応していますか？

Apple App Store と Google Play の両方に対応しています。Apple では、タイトル、サブタイトル、非公開の 100 文字のキーワード欄がインデックスされます。Google Play では、タイトル、80 文字の短い説明、長い説明がインデックスされるため、サブタイトルとキーワード欄は Apple のみの概念です。ストアをご覧ください。

ランキングはどのくらいの頻度で確認しますか？

デフォルトでは 1 日 1 回で、UTC cron のスケジュールは自由に設定できます。順位チェックでは 200 位まで取得します。null の順位は、確認したものの、その範囲内で見つからなかったことを意味し、ゼロを意味するわけではありません。順位をご覧ください。

複数の国を追跡できますか？

はい。アプリは一度だけインポートし、キーワードの追跡にはそれぞれ独自のストアフロントが設定されるため、1 つのリスティングで複数の市場のキーワードを同時に追跡できます。市場を追加するたびに 1 日あたりのストアリクエスト数が増え、設定ページにはその増加分を見積もる予算カードが表示されます。国と市場をご覧ください。

データはどこかに送信されますか？

送信されるのはストアへのリクエストのみです。追跡対象の各フレーズが通常の検索語として App Store または Google Play に送信されます。送信元はご自身のアドレス、または設定している場合はプロキシプロバイダーです。それ以外の外部連携は、Webhook アラート、SMTP メール、OpenAI による支援、Apple Ads の検索人気度、ストアのステータス確認のみで、いずれも設定するまで無効です。テレメトリーはありません。デプロイ環境から送信されるデータをご覧ください。

AsoBeast を Claude やほかの AI エージェントに接続できますか？

はい。AsoBeast には、37 個の読み取りツールを備えた Model Context Protocol サーバーが付属しています。ローカルの stdio プロセス、またはご自身のインスタンス上のリモートエンドポイントとして利用できます。すべての接続に個人用 API トークンが必要で、デフォルトでは読み取り専用です。キーワード、競合、アクション、注釈を変更する追加の 7 個のツールは、書き込みスコープを付与したトークンでのみ一覧表示されます。MCPをご覧ください。

AsoBeast は本当に無料ですか？

ソフトウェアは完全に無料です。オープンコアではない AGPL-3.0 ライセンスを採用しており、商用エディション向けに制限された機能はありません。そのため、セルフホスト環境ではすべての機能を利用できます。同じリポジトリから構築されたホステッドサービスでは、機能ではなく、使用するホスティングに対して料金が発生します。変更したバージョンをネットワークサービスとして実行する場合、AGPL により、その変更済みソースを利用者に提供することが求められます。

ドキュメント

トピック	リンク
クイックスタートと最初のインポート	docs.asobeast.com/quickstart
Docker Compose を使ったセルフホスティング	install/docker-compose
設定リファレンス	configuration/reference
概念：スコア、掲載順位、国	concepts
ガイド：キーワード、競合他社、アラート	guides
運用：バックアップ、復元、アップグレード	operations
トラブルシューティングとサポート	support
API リファレンスと OpenAPI	api-reference
MCP ツール	mcp/tools
LLM 向けサイト全体	llms.txt および llms-full.txt

制限事項

利用する前に知っておくとよい点：

• スコアはストアごとの推定値です。 人気度と難易度は、各ストアで異なる公開情報に基づいているため、ストア間で数値を比較できず、ファーストパーティの獲得データの代わりにはなりません。
• スクレイパーは動作しなくなることがあります。 AsoBeast は公開エンドポイントを読み取ります。ストアがエンドポイントを変更すると、パーサーが失敗する場合があります。失敗するとジョブは失敗し、BullMQ がバックオフを挟んで再試行しますが、リクエスト処理が停止することはありません。
• ハードウェアより先にストアのレート制限が容量の上限になります。 公開エンドポイントが許容するアドレスごとのリクエスト頻度は控えめであり、これが単一のインスタンスで追跡できるキーワード市場の数を制限します。容量と制限をご覧ください。
• 運用はご自身の責任です。 バックアップ、TLS、シークレットのローテーション、監視、アップグレードは運用者の責任です。バックアップを頼りにする前に、復元できることを確認してください。

ロードマップ

現在は 1.x 系が最新で、最新リリースは変更履歴に記載されています。今後の課題は次のとおりです。

• オーナーとメンバーよりも細かなユーザー別の権限モデル、および1つのアカウントで複数のワークスペースを利用できる機能。
• ライセンス取得済みデータまたはファーストパーティの獲得データを使った、人気度のより適切な調整。
• 市場ごとのレビュー、カテゴリー順位、評価履歴。掲載情報とスクリーンショットのキャプションはすでに取得され、市場ごとに切り替えられます。
• 同じオプトイン方式で、取り消し可能な変更を一度に1つずつ行う、書き込み用 MCP ツールの追加。

リリースポリシーと 1.x の互換性に関する約束については、アップグレードとロールバックをご覧ください。

コントリビューション

プルリクエストを歓迎します。まず CONTRIBUTING.md を読み、コミット規約、互換性に関する約束、テストスイートの実行方法をご確認ください。バグ、質問、機能リクエストはGitHub の Issueにお寄せください。セキュリティに関する報告は、公開 Issue ではなく SECURITY.md に記載された方法でお送りください。

ライセンス

このリポジトリのソースコードは、AGPL-3.0 ライセンスの下で公開されています。