mcpField
A
appstore-intel

appstore-intel

github.com/dylanfeltus营销与增长18092 次安装6 周前更新
代码仓库

关于 appstore-intel

appstore-intel 是用于查询 iOS 和 Mac App Store 应用信息的技能，适合应用研究和竞品分析。它通过 Apple 的免费 iTunes Search 与 Lookup API 查询，也可用网页搜索和抓取查看 Google Play 信息。

主要功能

  1. 01按关键词搜索 iOS 和 Mac 应用
  2. 02按 ID 或 bundle ID 查询应用
  3. 03获取评分、评论和应用元数据
  4. 04搜索并查看 Google Play 页面
  5. 05比较不同地区的应用列表

适用场景

  1. 01比较某一类别中的应用
  2. 02查询应用评分和评论
  3. 03查找竞品的商店页面
  4. 04查看应用版本、价格或发行说明

安装

复制下面的命令，在终端中运行。

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

安装后在 Claude Code 中输入/appstore-intel确认已加载。

附带文件README.md

详细介绍

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 密钥。

两个端点：

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

速率限制： 每分钟约 20 次调用。高频使用时请缓存结果。

搜索应用

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

使用 web_fetch 调用此 URL。响应为 JSON。

参数
参数描述必填值
term搜索查询（URL 编码，空格用 + 表示）是任意文本
country两个字母的国家/地区代码是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. 列出完整详情：评分、评论、版本、发行说明、价格、大小、描述
比较两个应用
  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 错误 / 超时： 重试一次。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 商店网页 — 免费，无需身份验证，采用抓取方式

评论

支持 Markdown