iamhenry Astro ASO Skill
Query your local Astro Mac app database for App Store Optimization insights.
When to Use
Invoke this skill when the user asks about:
- Keyword rankings and tracking
- Historical ranking data and trends
- Competitor analysis for keywords
- App ratings and reviews data
- Keyword opportunities and recommendations
- ASO health analysis
- Ranking predictions and anomalies
Prerequisites
- Astro Mac app installed: https://astro.app
- App must have data (tracked apps/keywords)
Usage
Run commands via the bundled script:
node .agents/skills/astro-aso/scripts/astro-query.mjs <command> '<json-params>'
Available Commands
list_apps
List all tracked apps in Astro.
node .agents/skills/astro-aso/scripts/astro-query.mjs list_apps '{}'
search_rankings
Search keyword rankings for apps.
| Param | Type | Required | Description |
|---|---|---|---|
| keyword | string | YES | Keyword to search |
| store | string | no | Filter by store (ios/mac) |
| appName | string | no | Filter by app name |
| appId | string | no | Filter by app ID |
node .agents/skills/astro-aso/scripts/astro-query.mjs search_rankings '{"keyword": "photo editor"}'
historical_rankings
Get historical ranking data for a keyword.
| Param | Type | Required | Description |
|---|---|---|---|
| keyword | string | YES | Keyword to track |
| appName | string | no | Filter by app name |
| appId | string | no | Filter by app ID |
| daysBack | number | no | Days of history (default: 30) |
| store | string | no | Filter by store |
node .agents/skills/astro-aso/scripts/astro-query.mjs historical_rankings '{"keyword": "photo editor", "daysBack": 90}'
app_keywords
Get all tracked keywords for an app.
| Param | Type | Required | Description |
|---|---|---|---|
| appName | string | no* | App name to query |
| appId | string | no* | App ID to query |
| store | string | no | Filter by store |
*One of appName or appId required
node .agents/skills/astro-aso/scripts/astro-query.mjs app_keywords '{"appName": "My App"}'
keyword_trends
Analyze keyword ranking trends over time.
| Param | Type | Required | Description |
|---|---|---|---|
| keyword | string | YES | Keyword to analyze |
| appName | string | no | Filter by app name |
| appId | string | no | Filter by app ID |
| period | string | no | week/month/year/all (default: month) |
| store | string | no | Filter by store |
node .agents/skills/astro-aso/scripts/astro-query.mjs keyword_trends '{"keyword": "photo editor", "period": "month"}'
compare_rankings
Compare rankings between two dates.
| Param | Type | Required | Description |
|---|---|---|---|
| keyword | string | YES | Keyword to compare |
| date1 | string | YES | First date (ISO format) |
| date2 | string | YES | Second date (ISO format) |
| appName | string | no | Filter by app name |
| appId | string | no | Filter by app ID |
| store | string | no | Filter by store |
node .agents/skills/astro-aso/scripts/astro-query.mjs compare_rankings '{"keyword": "photo editor", "date1": "2024-01-01", "date2": "2024-02-01"}'
app_ratings
Get app ratings and review data.
| Param | Type | Required | Description |
|---|---|---|---|
| appName | string | no* | App name to query |
| appId | string | no* | App ID to query |
| store | string | no | Filter by store |
| daysBack | number | no | Days of history (default: 30) |
*One of appName or appId required
node .agents/skills/astro-aso/scripts/astro-query.mjs app_ratings '{"appName": "My App", "daysBack": 60}'
keyword_competitors
Find competing apps ranking for a keyword.
| Param | Type | Required | Description |
|---|---|---|---|
| keyword | string | YES | Keyword to analyze |
| store | string | no | Filter by store |
| limit | number | no | Max results (default: 10) |
node .agents/skills/astro-aso/scripts/astro-query.mjs keyword_competitors '{"keyword": "photo editor", "limit": 20}'
keyword_recommendations
Get recommended keywords based on existing ones.
| Param | Type | Required | Description |
|---|---|---|---|
| keyword | string | YES | Base keyword |
| appName | string | no | Filter by app name |
| appId | string | no | Filter by app ID |
| store | string | no | Filter by store |
| limit | number | no | Max results (default: 10) |
node .agents/skills/astro-aso/scripts/astro-query.mjs keyword_recommendations '{"keyword": "photo"}'
competitive_landscape
Analyze competitive position for an app.
| Param | Type | Required | Description |
|---|---|---|---|
| appName | string | no* | App name to analyze |
| appId | string | no* | App ID to analyze |
| store | string | no | Filter by store |
| limit | number | no | Max competitors (default: 10) |
*One of appName or appId required
node .agents/skills/astro-aso/scripts/astro-query.mjs competitive_landscape '{"appName": "My App"}'
keyword_opportunities
Find keyword opportunities (low difficulty, high popularity).
| Param | Type | Required | Description |
|---|---|---|---|
| appName | string | no* | App name to analyze |
| appId | string | no* | App ID to analyze |
| store | string | no | Filter by store |
| minPopularity | number | no | Min popularity score |
| maxDifficulty | number | no | Max difficulty score |
*One of appName or appId required
node .agents/skills/astro-aso/scripts/astro-query.mjs keyword_opportunities '{"appName": "My App", "maxDifficulty": 30}'
ranking_anomalies
Detect sudden ranking changes and anomalies.
| Param | Type | Required | Description |
|---|---|---|---|
| appName | string | no* | App name to analyze |
| appId | string | no* | App ID to analyze |
| daysBack | number | no | Days to analyze (default: 7) |
| threshold | number | no | Change threshold (default: 10) |
| store | string | no | Filter by store |
*One of appName or appId required
node .agents/skills/astro-aso/scripts/astro-query.mjs ranking_anomalies '{"appName": "My App", "threshold": 15}'
ranking_predictions
Predict future rankings based on trends.
| Param | Type | Required | Description |
|---|---|---|---|
| keyword | string | YES | Keyword to predict |
| appName | string | no | Filter by app name |
| appId | string | no | Filter by app ID |
| store | string | no | Filter by store |
| daysForward | number | no | Days to predict (default: 7) |
node .agents/skills/astro-aso/scripts/astro-query.mjs ranking_predictions '{"keyword": "photo editor", "daysForward": 14}'
low_competition_keywords
Find keywords with low competition.
| Param | Type | Required | Description |
|---|---|---|---|
| store | string | no | Filter by store |
| maxDifficulty | number | no | Max difficulty (default: 30) |
| minPopularity | number | no | Min popularity (default: 20) |
| limit | number | no | Max results (default: 20) |
node .agents/skills/astro-aso/scripts/astro-query.mjs low_competition_keywords '{"maxDifficulty": 25, "minPopularity": 30}'
analyze_aso_health
Get overall ASO health analysis for an app.
| Param | Type | Required | Description |
|---|---|---|---|
| appName | string | no* | App name to analyze |
| appId | string | no* | App ID to analyze |
| store | string | no | Filter by store |
*One of appName or appId required
node .agents/skills/astro-aso/scripts/astro-query.mjs analyze_aso_health '{"appName": "My App"}'
Output Format
All commands return JSON with either:
{ "success": true, "data": ... }on success{ "success": false, "error": "..." }on failure
Example Workflow
List all tracked apps:
node .agents/skills/astro-aso/scripts/astro-query.mjs list_apps '{}'Get keywords for a specific app:
node .agents/skills/astro-aso/scripts/astro-query.mjs app_keywords '{"appName": "My App"}'Analyze keyword trends:
node .agents/skills/astro-aso/scripts/astro-query.mjs keyword_trends '{"keyword": "productivity", "period": "month"}'Find opportunities:
node .agents/skills/astro-aso/scripts/astro-query.mjs keyword_opportunities '{"appName": "My App", "maxDifficulty": 40}'