Agent skill

App Store Intelligence

by dylanfeltus in dylanfeltus/skills

Looks up app details, ratings and reviews and searches the iOS and Mac App Stores through Apple's free iTunes APIs, with a web-search fallback for Google Play.

MITAuto-check passedMobile

Install App Store Intelligence

skills CLI
$ npx skills add dylanfeltus/skills --skill appstore-intel -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install dylanfeltus/skills appstore-intel --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/dylanfeltus/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/appstore-intel .claude/skills/appstore-intel && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
appstore-intel
GitHub stars
179
Token cost
~2k tokens
SKILL.md length
623 words
Files
2
Skills in repo
10
Repo updated
First seen
Licence
MIT

At a glance

Looks up app details, ratings and reviews and searches the iOS and Mac App Stores through Apple's free iTunes APIs, with a web-search fallback for Google Play.

  • Works in 4 steps: URL-encode the search term → Fetch:… → Parse JSON response → …
  • Checking an app's rating and review count
  • SKILL.md covers When to Use, API Overview — Apple iTunes…, Searching for Apps and Looking Up Specific Apps, plus 7 more sections
  • Reaches itunes.apple.com and apps.apple.com

What it does

For Apple platforms the agent calls two iTunes endpoints with no API key: search by term, country and entity (iPhone software, iPad software or Mac software, with a result limit from 1 to 200 and a language option), and lookup by app id, bundle id or several ids at once. Results come back as JSON with metadata such as price, size, version and release notes. The rate limit is about 20 calls per minute, so heavy use should cache results.

Google Play has no free public API, so the skill falls back to web search restricted to play.google.com and to fetching an app's detail page by package id. Typical uses are checking an app's ratings or reviews, comparing apps in a category, finding apps by keyword and researching a competitor's store presence. The excerpt is truncated before the end of the Google Play section.

When your agent uses it

  • Checking an app's rating and review count
  • Comparing apps in a category
  • Researching a competitor's store listing
  • Finding apps by keyword in a given country

Example prompts

  • “Compare the top fitness tracker apps in the US App Store by rating.”
  • “Look up the bundle id com.example.app and give me its version and release notes.”
  • “What do the ratings look like for this competitor's app on Google Play?”

Requirements

  • Network access to the iTunes Search and Lookup APIs
  • Web search and fetch tools for Google Play lookups

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. URL-encode the search term
  2. Fetch: https://itunes.apple.com/search?term=ENCODED_QUERY&country=us&entity=software&limit=10
  3. Parse JSON response
  4. For each result, present: name, developer, rating, review count, price, and App Store link

What it can do on your machine

Read from SKILL.md and the folder at commit b97a48f. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are json).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • itunes.apple.com
    • apps.apple.com
    • play.google.com
    • is1-ssl.mzstatic.com

    Also links to:

    • developer.apple.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

App Store Intelligence loads about 2k tokens when it runs. Until then it costs about 62 tokens; SKILL.md has 623 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~62
When it runs · the whole SKILL.md, loaded when a task matches
~2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from dylanfeltus/skills at commit b97a48f, republished under its MIT licence (© dylanfeltus). 623 words, ~1,975 tokens.

Download SKILL.mdSave it as .claude/skills/appstore-intel/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
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

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

Use web_fetch to call this URL. Response is JSON.

Parameters
ParameterDescriptionRequiredValues
termSearch query (URL-encoded, + for spaces)YesAny text
countryTwo-letter country codeYesus, gb, de, etc.
entityApp typeNosoftware (iPhone), iPadSoftware, macSoftware
mediaMedia typeNosoftware (default for apps)
limitMax resultsNo1–200 (default 50)
langLanguageNoen_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:

json
{
  "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:

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

Google Play Lookup

There's no free public Google Play API. Use these approaches:

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
  1. URL-encode the search term
  2. Fetch: https://itunes.apple.com/search?term=ENCODED_QUERY&country=us&entity=software&limit=10
  3. Parse JSON response
  4. For each result, present: name, developer, rating, review count, price, and App Store link
Get Detailed Info for a Specific App
  1. Find the app's Track ID (from a search, or from the App Store URL — the number after /id)
  2. Fetch: https://itunes.apple.com/lookup?id=TRACK_ID&country=us
  3. Present full details: rating, reviews, version, release notes, price, size, description
Compare Two Apps
  1. Look up both apps: https://itunes.apple.com/lookup?id=ID1,ID2&country=us
  2. Present side-by-side comparison of key metrics
Show full SKILL.md (249 more words)Show less
Check an App's Rating Across Countries
  1. 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
  2. Compare ratings and review counts by region
Find Both iOS and Android Versions
  1. Search iOS: iTunes Search API with the app name
  2. Search Android: web_search "site:play.google.com/store/apps APP_NAME"
  3. Fetch the Google Play page with web_fetch for details
  4. 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

© dylanfeltus, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in appstore-intel of dylanfeltus/skills.

  • SKILL.md
  • README.md

Open the folder on GitHubat commit b97a48f

Compare with similar skills

App Store Intelligence next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

App Store Intelligence compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
App Store Intelligence this skilldylanfeltus/skills179—~2kAutomated safety check: PassMIT
Product Developmentgustavscirulis/snapgrid1171 repos~1.1kAutomated safety check: PassCustom licence
Product Agentgustavscirulis/snapgrid1171 repos~2.6kAutomated safety check: PassCustom licence
Amazon Best Sellers Finderbrowser-act/skills6.1k2 repos~1.5kAutomated safety check: PassMIT
Consulting Analysisbytedance/deer-flow83k5 repos~8.4kAutomated safety check: PassMIT
Competitor Comparison Matrixfirecrawl/web-agent1.2k—~1.1kAutomated safety check: PassMIT

Similar skills

  • Product Development

    gustavscirulis/snapgrid

    End-to-end product development for iOS/macOS apps. An agent skill from gustavscirulis/snapgrid.

    117 GitHub starsUsed in 1 repo~1.1k tokens
    Product & Project ManagementAuto-check passed
  • Product Agent

    gustavscirulis/snapgrid

    Discover and validate product ideas, analyze markets, scope MVPs, and optimize app store presence for iOS/macOS apps.

    117 GitHub starsUsed in 1 repo~2.6k tokens
    Marketing & SEOAuto-check passed
  • Amazon Best Sellers Finder

    browser-act/skills

    Extracts structured Amazon product data for a keyword and marketplace through the BrowserAct API, including titles, prices, ratings, reviews, sales volume and promotions.

    6.1k GitHub starsUsed in 2 repos~1.5k tokens
    Data & AnalyticsAuto-check passed
  • Consulting Analysis

    bytedance/deer-flow

    A skill your agent uses when the user requests to generate, create, or write professional research reports including but not limited to market analysis, consumer insights, brand analysis, financial…

    83k GitHub starsUsed in 5 repos~8.4k tokens
    Marketing & SEOAuto-check passed
  • Competitor Comparison Matrix

    firecrawl/web-agent

    Compares two or more products or companies on pricing, features and positioning by scraping their sites, and returns a normalized JSON matrix.

    1.2k GitHub stars~1.1k tokensUpdated 5 mo ago
    Marketing & SEOAuto-check passed
  • Market Research Reports

    foryourhealth111-pixel/Vibe-Skills

    Produces long consulting-style market research and industry reports covering market sizing, competitive landscape, market entry and investment theses.

    3.6k GitHub stars~2.5k tokensUpdated 1 mo ago
    Business, Finance & HRAuto-check: notes

More from dylanfeltus/skills

All 10 skills in this repo
  • AI Image Creative Direction

    dylanfeltus/skills

    Gives prompt templates, a model-selection guide and anti-generic rules for AI-generated visuals: hero images, feature illustrations, OG cards, icons and backgrounds.

    179 GitHub stars~2.6k tokensUpdated 20 days ago
    Auto-check passed
  • Design Token Generator

    dylanfeltus/skills

    Generates type scales, color palettes, spacing systems, WCAG contrast checks and dark mode palettes from formulas, as CSS custom properties, a Tailwind config or JSON tokens.

    179 GitHub stars~2.9k tokensUpdated 20 days ago
    Auto-check passed
  • Hacker News Search

    dylanfeltus/skills

    Searches and monitors Hacker News stories, comments and users through the free Algolia HN Search API, with tag, points and date filters.

    179 GitHub stars~1.7k tokensUpdated 20 days ago
    Auto-check passed
  • Framer Motion (Motion) patterns for React: spring presets, staggers, layout animations, micro-interactions, scroll effects and page transitions, with performance rules.

    179 GitHub stars~3k tokensUpdated 20 days ago
    Auto-check passed
  • Privacy.com Virtual Cards

    dylanfeltus/skills

    Creates, updates, and monitors Privacy.com virtual payment cards with spending limits for an agent making controlled purchases.

    179 GitHub stars~2.2k tokensUpdated 20 days ago
    Auto-check passed
  • Looks up Product Hunt launches, products and makers through its GraphQL API: daily top posts, topic browsing and per-post details, using a free developer token.

    179 GitHub stars~1.7k tokensUpdated 20 days ago
    Auto-check passed

Works with

Questions about App Store Intelligence

What does App Store Intelligence do?

Looks up app details, ratings and reviews and searches the iOS and Mac App Stores through Apple's free iTunes APIs, with a web-search fallback for Google Play. For Apple platforms the agent calls two iTunes endpoints with no API key: search by term, country and entity (iPhone software, iPad software or Mac software, with a result limit from 1 to 200 and a language option), and lookup by app id, bundle id or several ids at once. Results come back as JSON with metadata such as price, size, version and release notes.

When should I use App Store Intelligence?

App Store Intelligence fits situations like: checking an app's rating and review count; comparing apps in a category; researching a competitor's store listing; finding apps by keyword in a given country.

How do I install App Store Intelligence in Claude Code?

Run `npx skills add dylanfeltus/skills --skill appstore-intel -a claude-code`. Or copy the skill folder (appstore-intel in dylanfeltus/skills) into .claude/skills/appstore-intel in your project. Claude Code loads it when a task matches its description.

How do I install App Store Intelligence in Codex?

Run `npx skills add dylanfeltus/skills --skill appstore-intel -a codex`. Or copy the skill folder (appstore-intel in dylanfeltus/skills) into .agents/skills/appstore-intel in your project. Codex loads it when a task matches its description.

Can I use App Store Intelligence in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add dylanfeltus/skills --skill appstore-intel -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/appstore-intel, .gemini/skills/appstore-intel, .github/skills/appstore-intel and .opencode/skills/appstore-intel in your project.

What does App Store Intelligence need to run?

SKILL.md names no scripts, command-line tools or credentials: App Store Intelligence is instructions for the agent only. Our summary lists: Network access to the iTunes Search and Lookup APIs; Web search and fetch tools for Google Play lookups.

Does App Store Intelligence access the network?

SKILL.md names 5 domains. In commands or code: itunes.apple.com, apps.apple.com, play.google.com and is1-ssl.mzstatic.com; the agent is likely to contact these when it follows the instructions. As links in the text: developer.apple.com. This is read from the text; nothing was executed.

Is App Store Intelligence safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does App Store Intelligence use?

App Store Intelligence is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does App Store Intelligence use?

About 2k tokens (SKILL.md is roughly 7.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to App Store Intelligence?

Skills that share tags, products or a category with App Store Intelligence: Product Development (gustavscirulis/snapgrid, 117 stars), Product Agent (gustavscirulis/snapgrid, 117 stars), Amazon Best Sellers Finder (browser-act/skills, 6.1k stars) and Consulting Analysis (bytedance/deer-flow, 83k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains App Store Intelligence?

dylanfeltus (a GitHub user) maintains it in dylanfeltus/skills, which has 179 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on September 17, 2026.

Source: dylanfeltus/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.