appstore-intel
Look up app details, ratings, reviews, and search the iOS App Store, Mac App Store, and Google Play. Use when the user asks about app ratings, wants to compare apps, or research a competitor's app store presence. No API key required.
dylanfeltus · 已有静态检查记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add dylanfeltus/skills --skill appstore-intel技能说明
name: appstore-intel description: Look up app details, ratings, reviews, and search the iOS App Store, Mac App Store, and Google Play. Use when the user asks about app ratings, wants to compare apps, or research a competitor's app store presence. No API key required.
App Store Intelligence
Look up app details, ratings, reviews, and search the iOS App Store and Mac App Store using Apple's free iTunes Search & Lookup APIs. No API key required.
For Google Play, use web scraping via web_search and web_fetch.
When to Use
- User asks about an app's ratings or reviews
- User wants to compare apps in a category
- User wants to find apps by keyword
- User asks about a competitor's app store presence
- User wants app metadata (price, size, version, release notes)
API Overview — Apple iTunes Search API
Free. No authentication. No API key.
Two endpoints:
- Search:
https://itunes.apple.com/search - Lookup:
https://itunes.apple.com/lookup
Rate Limit: ~20 calls per minute. Cache results for heavy usage.
Searching for Apps
Basic Search
https://itunes.apple.com/search?term=QUERY&country=COUNTRY&entity=software&limit=N
Use web_fetch to call this URL. Response is JSON.
Parameters
| Parameter | Description | Required | Values |
|---|---|---|---|
term | Search query (URL-encoded, + for spaces) | Yes | Any text |
country | Two-letter country code | Yes | us, gb, de, etc. |
entity | App type | No | software (iPhone), iPadSoftware, macSoftware |
media | Media type | No | software (default for apps) |
limit | Max results | No | 1–200 (default 50) |
lang | Language | No | en_us, ja_jp |
Example
https://itunes.apple.com/search?term=fitness+tracker&country=us&entity=software&limit=10
Looking Up Specific Apps
By App ID (Track ID)
https://itunes.apple.com/lookup?id=APP_ID&country=us
By Bundle ID
https://itunes.apple.com/lookup?bundleId=com.example.app&country=us
Multiple Apps at Once
https://itunes.apple.com/lookup?id=ID1,ID2,ID3&country=us
Response Format
Each result contains:
{
"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"]
}
The response wrapper:
{
"resultCount": 10,
"results": [...]
}
Google Play Lookup
There's no free public Google Play API. Use these approaches:
Web Search
web_search: "site:play.google.com/store/apps QUERY"
Direct App Page Scraping
web_fetch: https://play.google.com/store/apps/details?id=PACKAGE_ID&hl=en&gl=us
⚠️ Google Play pages may return limited content or block automated requests. If web_fetch returns incomplete data, fall back to web_search results which typically include rating, download count, and developer info in the snippet.
Extract from the fetched HTML (when available):
- Title, developer, rating, review count, downloads
- Description, what's new, screenshots
Google Play Package ID
The package ID is in the URL: play.google.com/store/apps/details?id=com.example.app
Step-by-Step Instructions
Search for Apps by Keyword
- URL-encode the search term
- Fetch:
https://itunes.apple.com/search?term=ENCODED_QUERY&country=us&entity=software&limit=10 - Parse JSON response
- For each result, present: name, developer, rating, review count, price, and App Store link
Get Detailed Info for a Specific App
- Find the app's Track ID (from a search, or from the App Store URL — the number after
/id) - Fetch:
https://itunes.apple.com/lookup?id=TRACK_ID&country=us - Present full details: rating, reviews, version, release notes, price, size, description
Compare Two Apps
- Look up both apps:
https://itunes.apple.com/lookup?id=ID1,ID2&country=us - Present side-by-side comparison of key metrics
Check an App's Rating Across Countries
- Look up the same ID with different country codes:
https://itunes.apple.com/lookup?id=APP_ID&country=ushttps://itunes.apple.com/lookup?id=APP_ID&country=gbhttps://itunes.apple.com/lookup?id=APP_ID&country=de
- Compare ratings and review counts by region
Find Both iOS and Android Versions
- Search iOS: iTunes Search API with the app name
- Search Android:
web_search "site:play.google.com/store/apps APP_NAME" - Fetch the Google Play page with
web_fetchfor details - Present both platforms' data
Finding App IDs
- From App Store URL:
apps.apple.com/us/app/app-name/id553834731→ ID is553834731 - From search results: The
trackIdfield - From bundle ID lookup: If you know the bundle ID (e.g.,
com.spotify.client)
Output Format
Single App
### 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...
📱 iO
阅读完整来源 ↗