--- name: appstore-rating-pulse description: Monitor App Store ratings for any iOS app across multiple countries. Fetches live overall ratings using Apple's free iTunes Lookup API — no API key needed. Set up a daily cron report or get an instant snapshot. Triggers on "track app ratings", "check my App Store rating", "daily rating report", or "show ratings across countries". ---

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:

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