appstore-rating-pulse

TotalClaw 作者 totalclaw

监控多个国家/地区任何 iOS 应用程序的 App Store 评级。使用 Apple 的免费 iTunes Lookup API 获取实时总体收视率 — 无需 API 密钥。设置每日 cron 报告或获取即时快照。触发“跟踪应用评分”、“检查我的 App Store 评分”、“每日评分报告”或“显示各个国家/地区的评分”。

安装 / 下载方式

TotalClaw CLI推荐

totalclaw install totalclaw:totalclaw~aligurelli-appstore-rating-pulse

cURL直接下载，无需登录

curl -fsSL https://skills.taituai.com/api/skills/totalclaw%3Atotalclaw~aligurelli-appstore-rating-pulse/file -o aligurelli-appstore-rating-pulse.md

## 概述（中文）

监控多个国家/地区任何 iOS 应用程序的 App Store 评级。使用 Apple 的免费 iTunes Lookup API 获取实时总体收视率 — 无需 API 密钥。设置每日 cron 报告或获取即时快照。触发“跟踪应用评分”、“检查我的 App Store 评分”、“每日评分报告”或“显示各个国家/地区的评分”。

## 原文

# AppStore Rating Pulse

Fetches current overall App Store ratings for iOS apps across any country using Apple's free iTunes Lookup API — no API key or paid subscription needed.

## Setup

Edit `scripts/fetch-ratings.sh` with your apps and regions:

```bash
# Apps: "App Name" "AppStoreID" "CC1,CC2,CC3"
APPS=(
  "My App|1234567890|US,GB,DE"
  "Another App|9876543210|US,JP,KR"
)
```

Country codes follow ISO 3166-1 alpha-2 (US, GB, JP, KR, DE, FR, RU, ES, CA, AU, etc.).

## Run Manually

```bash
bash /path/to/skills/public/appstore-rating-pulse/scripts/fetch-ratings.sh
```

## Output Format

```
overall rating for My App(1234567890) 19.02.2026 - 4,72 - USA
overall rating for My App(1234567890) 19.02.2026 - 4,10 - UK
overall rating for My App(1234567890) 19.02.2026 - N/A - GERMANY
```

Ratings use comma as decimal separator. N/A means the app has no ratings in that country yet.

## Daily Cron Setup

Create an isolated cron job (sessionTarget: isolated) that runs the script and delivers the output via announce:

```
Run bash /path/to/scripts/fetch-ratings.sh and send the output to the user as-is. If all lines show N/A or the script errors, warn that something may be wrong.
```

Schedule example: `0 12 * * *` (daily at noon, your timezone).

## Customization

- Add/remove apps by editing the `APPS` array in `fetch-ratings.sh`
- Add/remove countries per app by editing the comma-separated country code list
- Country name display is handled automatically (common countries are mapped; others display as the raw code)