mcpField
A
app-review-mining

app-review-mining

github.com/crawlora-orgマーケティング・グロース141 回インストール2 日前に更新
リポジトリ

app-review-mining について

app-review-mining は Crawlora API を通じて、App Store と Google Play のアプリ情報、レビュー、評価、ランキング、類似アプリを取得するスキルです。レビュー分析やアプリストア最適化の調査向けに、両ストアのデータを正規化された JSON で返します。

主な機能

  1. 01アプリ情報と評価サマリー
  2. 02本文、スコア、日付付きのページ分割レビュー
  3. 03カテゴリ別およびストアランキング
  4. 04類似アプリ一覧
  5. 05アプリ識別子の検索

活用シーン

  1. 01レビューの感情や繰り返し出るテーマの分析
  2. 02両ストアにおける同一アプリの比較
  3. 03アプリのカテゴリランキングの追跡
  4. 04競合アプリや類似アプリの調査

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/crawlora-org/crawlora-skills --skill app-review-mining

インストール後、Claude Code で/app-review-miningを入力して読み込まれたか確認します。

同梱ファイルreference/endpoints.mdscripts/crawlora.sh

詳細

アプリレビューのマイニングとASO

Crawlora APIから、App Store（iOS）およびGoogle Play（Android）のアプリ詳細、レビュー、評価、ランキング、類似アプリ一覧を正規化されたJSONとして取得します。

このスキルを使用する場面

  • 「<アプリ>のレビュー／評価はどうですか？」
  • 「<アプリ>のランキングはどうですか？」／「<カテゴリ>のトップアプリを教えてください。」
  • 「<アプリ>に似たアプリを探して」／競合ASOの調査。
  • 「このアプリの詳細／プライバシー情報／バージョン履歴を取得して。」
  • アプリレビューのセンチメント分析や競合追跡のパイプラインを構築する場合。

セットアップ（一度のみ）

  • Crawlora APIキーを無料で取得します（月2,000クレジット、カード不要）。https://crawlora.netをご覧ください。
  • ヘルパーを実行する前に、環境変数にCRAWLORA_API_KEYを設定します。
  • ヘルパーは環境変数からCRAWLORA_API_KEYを読み取り、https://api.crawlora.net/api/v1にリクエストを送信します。キーがない、または無効な場合は401が返されます。

仕組み

ストアを選択します（どちらのストアにも対応するエンドポイントがあります）。次に、目的に応じて操作します。

  1. アプリを検索する — /appstore/search?term=...または/googleplay/search?q=...で、アプリID／バンドルIDを特定します。
  2. 詳細 — /appstore/app、/googleplay/appで、メタデータ、評価の概要、説明、デベロッパー情報を取得します。
  3. レビュー — /appstore/reviews、/googleplay/reviewsでページネーションを行い、センチメントやテーマの分析に使うレビュー本文、スコア、日付を取得します。
  4. ランキング — /appstore/list、/googleplay/listで、カテゴリ別のストアランキングを取得します。
  5. 競合アプリ — /appstore/similar、/googleplay/similarで類似アプリを取得します。

エンドポイント、メソッド、パラメーターの一覧は、reference/endpoints.mdをご覧ください。

APIの呼び出し

# Find an app, then pull its reviews (GET, key=value params):
scripts/crawlora.sh /appstore/search term="notion" | jq '.'
scripts/crawlora.sh /appstore/reviews id=1232780281 country=us | jq '.data'

scripts/crawlora.sh /googleplay/search term="notion" | jq '.'
scripts/crawlora.sh /googleplay/reviews app_id="notion.id" | jq '.'

すべてのリクエストにはscripts/crawlora.shを使用してください。APIキーがコマンドライン引数に含まれないようにできます。

エンドポイントのリファレンス

このスキルで使用するApp StoreおよびGoogle Playの全エンドポイント（メソッド、パス、パラメーター、説明）については、reference/endpoints.mdをご覧ください。

例

  • レビューのセンチメント分析： 検索でアプリIDを特定し、/appstore/reviewsでページネーションを行って、各レビューのセンチメントを分類し、主な不満や評価されている点を要約します。
  • ストア間の比較： 同じ製品について/appstore/appと/googleplay/appを取得し、プラットフォーム間の評価とレビュー件数を比較します。
  • カテゴリ別ランキングの追跡： カテゴリの/googleplay/listを取得し、ランキングの推移を追跡します。

注意事項と制限

  • クレジット／成功時のみ課金： 2xxの場合にのみ課金されます。無料プランは月2,000クレジットです。キーはhttps://crawlora.netで取得できます。
  • 公開データのみ — ストアの公開ページが対象です。AppleとGoogleの規約を遵守してください。
  • セキュリティ： キーはCRAWLORA_API_KEYのみに保存してください。コードへのハードコード、クエリパラメーターへの指定、コミットは絶対にしないでください。
  • レビューはページネーションされ、ロケールごとに異なります。対象範囲を広げるにはcountry／pageを指定してください。

コメント

Markdown 対応