⚠️

重要前提

安装AI Skills的关键前提是：必须科学上网，且开启TUN模式，这一点至关重要，直接决定安装能否顺利完成，在此郑重提醒三遍：科学上网，科学上网，科学上网。查看完整安装教程 →

App Store 情报工具：免费获取 iOS 与 Google Play 应用数据、评分、评论及元数据

appstore-intel by dylanfeltus/skills

67 周安装量

173 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/dylanfeltus/skills --skill appstore-intel

数据分析移动应用 API

🇨🇳中文介绍

应用商店情报

使用苹果免费的 iTunes 搜索与查询 API，查找应用详情、评分、评论，并搜索 iOS App Store 和 Mac App Store。无需 API 密钥。

对于 Google Play，请通过 web_search 和 web_fetch 使用网络爬虫。

使用时机

用户询问应用的评分或评论
用户想要比较某个类别中的应用
用户希望通过关键词查找应用
用户询问竞争对手在应用商店的存在情况
用户需要应用元数据（价格、大小、版本、更新说明）

API 概览 — Apple iTunes 搜索 API

免费。无需身份验证。无需 API 密钥。

两个端点：

搜索： https://itunes.apple.com/search
查询： https://itunes.apple.com/lookup

速率限制： 每分钟约 20 次调用。对于大量使用，请缓存结果。

搜索应用

基本搜索

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

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

参数	描述	必需	值
`term`	搜索查询（URL 编码，空格用 `+` 表示）	是	任意文本
`country`	两位国家代码	是	`us`, `gb`, `de` 等
`entity`	应用类型	否	`software` (iPhone), `iPadSoftware`, `macSoftware`
`media`	媒体类型	否	`software` (应用的默认值)
`limit`	最大结果数	否	1–200 (默认 50)
`lang`	语言	否	`en_us`, `ja_jp`

通过应用 ID (Track ID)

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

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"],  // ⚠️ 可能包含 10+ 个 URL — 总结数量，不要全部输出
  "supportedDevices": ["iPhone15,2", "iPad14,1"],  // ⚠️ 可能包含 100+ 个项目 — 为节省上下文，输出时省略
  "languageCodesISO2A": ["EN", "FR", "DE"]
}

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

没有免费的公开 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 中提取（当可用时）：

标题、开发者、评分、评论数、下载量
描述、更新内容、截图

包 ID 在 URL 中：play.google.com/store/apps/details?id=com.example.app

通过关键词搜索应用

对搜索词进行 URL 编码
获取：https://itunes.apple.com/search?term=ENCODED_QUERY&country=us&entity=software&limit=10
解析 JSON 响应
对于每个结果，呈现：名称、开发者、评分、评论数、价格和应用商店链接

获取特定应用的详细信息

找到应用的 Track ID（来自搜索结果，或来自 App Store URL — /id 后面的数字）
获取：https://itunes.apple.com/lookup?id=TRACK_ID&country=us
呈现完整详情：评分、评论、版本、更新说明、价格、大小、描述

查询两个应用：https://itunes.apple.com/lookup?id=ID1,ID2&country=us
呈现关键指标的并排比较

检查应用在不同国家的评分

使用不同的国家代码查询相同的 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
按地区比较评分和评论数

查找 iOS 和 Android 版本

搜索 iOS：使用应用名称调用 iTunes 搜索 API
搜索 Android：web_search "site:play.google.com/store/apps APP_NAME"
使用 web_fetch 获取 Google Play 页面以获取详情
呈现两个平台的数据

从 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 评分) · 免费
开发者：Developer Name · 类别：Health & Fitness
版本 3.2.1 (2024年1月10日)

📝 更新内容：最新版本更新说明摘要...

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

### 针对 "query" 的应用商店结果 (找到 N 个)

1. **App Name** ⭐ 4.5 (125K) · 免费
   开发者：Developer · 类别：Category
   📱 https://apps.apple.com/...

2. **App Name** ⭐ 4.2 (50K) · $4.99
   开发者：Developer · 类别：Category
   📱 https://apps.apple.com/...

### 应用比较

| 指标 | App A | App B |
|--------|-------|-------|
| 评分 | ⭐ 4.5 | ⭐ 4.2 |
| 评论数 | 125K | 50K |
| 价格 | 免费 | $4.99 |
| 大小 | 50 MB | 120 MB |
| 最后更新 | 2024年1月10日 | 2023年12月5日 |

无结果： 搜索词可能过于具体。尝试更宽泛的词语或检查拼写。
API 错误 / 超时： 重试一次。iTunes API 通常很可靠。
达到速率限制： 等待 60 秒。考虑为批量查询缓存结果。
国家未找到： 验证两位 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 商店网页 — 免费，无需身份验证，使用爬虫

🇺🇸English

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`

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=us
- https://itunes.apple.com/lookup?id=APP_ID&country=gb
- https://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_fetch for details
Present both platforms' data

Finding App IDs

From App Store URL: apps.apple.com/us/app/app-name/id553834731 → ID is 553834731
From search results: The trackId field
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...

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

Search Results

### 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/...

Comparison

### 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 |

Error Handling

No results: The search term may be too specific. Try broader terms or check spelling.
API error / timeout: Retry once. The iTunes API is generally reliable.
Rate limited: Wait 60 seconds. Consider caching results for batch lookups.
Country not found: Verify the two-letter ISO country code.
App removed from store: The lookup will return resultCount: 0. Inform the user the app may have been removed.
Google Play scraping fails: The page structure may have changed. Fall back to web_search results.

Examples

Example 1: "How's the Spotify app rated?"

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

Example 2: "Find fitness apps with good ratings"

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

Then filter results where averageUserRating >= 4.5 and sort by userRatingCount.

Example 3: "Compare Notion and Obsidian on the App Store"

Look up both apps and present a comparison table.

Data Sources

iOS / Mac: iTunes Search API — Free, no auth
Android: Google Play Store web pages via web_fetch — Free, no auth, scraping

Weekly Installs

Repository

dylanfeltus/skills

GitHub Stars

173

First Seen

Feb 19, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykWarn

Installed on

codex59

opencode59

gemini-cli58

github-copilot53

cursor51

claude-code51

SoulTrace 人格评估 API - 基于五色心理模型的贝叶斯自适应测试

56,700 周安装