appstore-intel

App Store インテリジェンス

Apple の無料の iTunes Search & Lookup API を使って、アプリの詳細、評価、レビューを確認し、iOS App Store と Mac App Store を検索します。API キーは不要です。

Google Play では、web_search と web_fetch を使ったウェブスクレイピングを利用します。

使用する場面

• アプリの評価やレビューについて尋ねられた場合
• カテゴリ内のアプリを比較したい場合
• キーワードでアプリを探したい場合
• 競合アプリのアプリストアでの展開状況について尋ねられた場合
• アプリのメタデータ（価格、サイズ、バージョン、リリースノート）が必要な場合

API の概要 — Apple iTunes Search API

無料です。認証不要です。API キーも不要です。

エンドポイントは 2 つあります。

• 検索： https://itunes.apple.com/search
• 検索： https://itunes.apple.com/lookup

レート制限： 約 1 分あたり 20 回です。大量に利用する場合は結果をキャッシュしてください。

アプリを検索する

基本的な検索

https://itunes.apple.com/search?term=QUERY&country=COUNTRY&entity=software&limit=N

web_fetch を使ってこの URL を呼び出します。レスポンスは JSON です。

パラメーター

パラメーター	説明	必須	値
term	検索クエリ（URL エンコードし、スペースには + を使用）	はい	任意のテキスト
country	2 文字の国コード	はい	us、gb、de など
entity	アプリの種類	いいえ	software（iPhone）、iPadSoftware、macSoftware
media	メディアの種類	いいえ	software（アプリのデフォルト）
limit	最大結果数	いいえ	1～200（デフォルトは 50）
lang	言語	いいえ	en_us、ja_jp

例

https://itunes.apple.com/search?term=fitness+tracker&country=us&entity=software&limit=10

特定のアプリを検索する

アプリ ID（Track ID）で検索

https://itunes.apple.com/lookup?id=APP_ID&country=us

Bundle ID で検索

https://itunes.apple.com/lookup?bundleId=com.example.app&country=us

複数のアプリを一度に検索

https://itunes.apple.com/lookup?id=ID1,ID2,ID3&country=us

レスポンス形式

各結果には次の情報が含まれます。

{
  "trackId": 553834731,
  "trackName": "App Name",
  "bundleId": "com.example.app",
  "sellerName": "Company Name",
  "artistName": "Developer Name",
  "price": 0.00,
  "formattedPrice": "Free",
  "currency": "USD",
  "averageUserRating": 4.5,
  "userRatingCount": 125000,
  "averageUserRatingForCurrentVersion": 4.3,
  "userRatingCountForCurrentVersion": 5000,
  "contentAdvisoryRating": "4+",
  "trackContentRating": "4+",
  "primaryGenreName": "Health & Fitness",
  "genres": ["Health & Fitness", "Lifestyle"],
  "description": "Full app description...",
  "releaseNotes": "What's new in this version...",
  "version": "3.2.1",
  "currentVersionReleaseDate": "2024-01-10T00:00:00Z",
  "releaseDate": "2020-06-15T00:00:00Z",
  "fileSizeBytes": "52428800",
  "minimumOsVersion": "15.0",
  "trackViewUrl": "https://apps.apple.com/us/app/...",
  "artworkUrl512": "https://is1-ssl.mzstatic.com/...",
  "screenshotUrls": ["url1", "url2"],  // ⚠️ Can be 10+ URLs — summarize count, don't dump all
  "supportedDevices": ["iPhone15,2", "iPad14,1"],  // ⚠️ Can be 100+ items — omit from output to save context
  "languageCodesISO2A": ["EN", "FR", "DE"]
}

レスポンスのラッパー：

{
  "resultCount": 10,
  "results": [...]
}

Google Play の検索

Google Play には無料の公開 API がありません。次の方法を利用します。

ウェブ検索

web_search: "site:play.google.com/store/apps QUERY"

アプリページを直接スクレイピング

web_fetch: https://play.google.com/store/apps/details?id=PACKAGE_ID&hl=en&gl=us

⚠️ Google Play のページは、取得できるコンテンツが限られる場合や、自動リクエストがブロックされる場合があります。 web_fetch で不完全なデータしか取得できない場合は、通常、スニペットに評価、ダウンロード数、デベロッパー情報が含まれる web_search の結果を利用します。

取得した HTML から、次の情報を抽出します（取得可能な場合）。

• タイトル、デベロッパー、評価、レビュー数、ダウンロード数
• 説明、新機能、スクリーンショット

Google Play のパッケージ ID

パッケージ ID は URL に含まれています：play.google.com/store/apps/details?id=com.example.app

手順

キーワードでアプリを検索する

1. 検索語を URL エンコードします
2. 次を取得します：https://itunes.apple.com/search?term=ENCODED_QUERY&country=us&entity=software&limit=10
3. JSON レスポンスを解析します
4. 各結果について、名前、デベロッパー、評価、レビュー数、価格、App Store のリンクを提示します

特定のアプリの詳細情報を取得する

1. アプリの Track ID を見つけます（検索結果、または App Store の URL にある /id の後の数字から取得できます）
2. 次を取得します：https://itunes.apple.com/lookup?id=TRACK_ID&country=us
3. 評価、レビュー、バージョン、リリースノート、価格、サイズ、説明などの詳細を提示します

2 つのアプリを比較する

1. 両方のアプリを検索します：https://itunes.apple.com/lookup?id=ID1,ID2&country=us
2. 主要な指標を並べて比較します

国ごとのアプリの評価を確認する

1. 同じ ID を異なる国コードで検索します。
   • https://itunes.apple.com/lookup?id=APP_ID&country=us
   • https://itunes.apple.com/lookup?id=APP_ID&country=gb
   • https://itunes.apple.com/lookup?id=APP_ID&country=de
2. 地域ごとに評価とレビュー数を比較します

iOS 版と Android 版の両方を探す

1. iOS を検索します：iTunes Search API でアプリ名を検索します
2. Android を検索します：web_search "site:play.google.com/store/apps APP_NAME"
3. 詳細を確認するため、web_fetch で Google Play のページを取得します
4. 両プラットフォームのデータを提示します

アプリ ID を見つける

• App Store の URL から： apps.apple.com/us/app/app-name/id553834731 → ID は 553834731 です
• 検索結果から： trackId フィールド
• Bundle ID による検索から： Bundle ID が分かっている場合（例：com.spotify.client）

出力形式

単一のアプリ

### App Name
⭐ 4.5/5 (125K ratings) · Free
By Developer Name · Health & Fitness
Version 3.2.1 (Jan 10, 2024)

📝 What's New: Latest release notes summary...

📱 iOS: https://apps.apple.com/...
🤖 Android: https://play.google.com/...

検索結果

### App Store Results for "query" (N found)

1. **App Name** ⭐ 4.5 (125K) · Free
   By Developer · Category
   📱 https://apps.apple.com/...

2. **App Name** ⭐ 4.2 (50K) · $4.99
   By Developer · Category
   📱 https://apps.apple.com/...

比較

### App Comparison

| Metric | App A | App B |
|--------|-------|-------|
| Rating | ⭐ 4.5 | ⭐ 4.2 |
| Reviews | 125K | 50K |
| Price | Free | $4.99 |
| Size | 50 MB | 120 MB |
| Last Updated | Jan 10, 2024 | Dec 5, 2023 |

エラー処理

• 結果が見つからない場合： 検索語が具体的すぎる可能性があります。より広い語句を試すか、スペルを確認してください。
• API エラー／タイムアウト： 1 回再試行してください。iTunes API は通常、安定して動作します。
• レート制限： 60 秒待ってください。まとめて検索する場合は、結果をキャッシュすることを検討してください。
• 国が見つからない場合： 2 文字の ISO 国コードを確認してください。
• アプリがストアから削除されている場合： 検索結果は resultCount: 0 を返します。アプリが削除された可能性があることをユーザーに伝えてください。
• Google Play のスクレイピングに失敗した場合： ページ構造が変更された可能性があります。web_search の結果を代わりに使用してください。

例

例 1：「Spotify アプリの評価は？」

Fetch: https://itunes.apple.com/lookup?bundleId=com.spotify.client&country=us

例 2：「評価の高いフィットネスアプリを探して」

Fetch: https://itunes.apple.com/search?term=fitness&country=us&entity=software&limit=20

次に、averageUserRating >= 4.5 の結果に絞り込み、userRatingCount で並べ替えてください。

例 3：「App Store で Notion と Obsidian を比較して」

両方のアプリを検索し、比較表を提示してください。

データソース

• iOS／Mac： iTunes Search API — 無料、認証不要
• Android： web_fetch を介した Google Play ストアのウェブページ — 無料、認証不要、スクレイピング