跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
安全

appstore-aso-auditor

App Store ASO audit: analyze canonical `./metadata` offline after `asc metadata pull`; add Astro MCP keyword gaps and Apple app-tag context when available.

Xopoko · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add Xopoko/build-swift-apps --skill appstore-aso-auditor

技能说明


name: appstore-aso-auditor description: "App Store ASO audit: analyze canonical ./metadata offline after asc metadata pull; add Astro MCP keyword gaps and Apple app-tag context when available."

App Store ASO Auditor

Audit the latest local metadata version first; Astro keyword gaps and Apple-generated tags are additive signals.

Preconditions

  • Canonical metadata from asc metadata pull --app "APP_ID" --version "1.2.3" --dir "./metadata".
  • Normalize asc migrate export or asc localizations download output before auditing.
  • Read references/aso_rules.md for rule details.
  • Use highest semantic version under metadata/version/.
  • Primary locale is en-US unless the user specifies another.

Paths:

  • App-info fields: metadata/app-info/{locale}.json
  • Version fields: metadata/version/{latest-version}/{locale}.json
  • App name may be absent; fetch with asc apps info list or ask before flagging it.

Offline Checks

  1. Keyword waste: tokens in subtitle or name also present in keywords. For Arabic also compare variants without ال; for CJK split by punctuation/character groups.
  2. Underused fields: keywords below 90/100 or subtitle below 20/30 chars.
  3. Missing fields: empty subtitle, keywords, description, whatsNew; only flag name if present and empty.
  4. Bad keyword separators: spaces after commas, semicolons, or pipes.
  5. Cross-locale gaps: non-primary locale keywords identical to the primary locale.
  6. Description coverage: keywords absent from description as conversion evidence, not Apple indexing evidence. Ignore Latin keywords in non-Latin descriptions when they target separate search paths.

Optional app tags:

asc app-tags list --app "APP_ID" --output json
asc app-tags view --app "APP_ID" --id "TAG_ID" --output json

Use tags only as classification evidence. Do not promise metadata changes will immediately alter Apple-generated tags.

Astro Keyword Gaps

If Astro MCP is connected and the app is tracked:

  • call get_app_keywords;
  • add per-store tracking with add_keywords for locales/territories before querying non-US stores;
  • run extract_competitors_keywords for 3-5 competitor app IDs;
  • call get_keyword_suggestions and search_rankings;
  • diff suggestions against title, subtitle, and keywords;
  • rank gaps by popularity and note source.

Skip with an explicit note when Astro is unavailable, the app is not tracked, or a store is not tracked.

Recommendations

Prioritize errors, keyword waste, utilization gaps, exact cross-locale duplicates, then Astro opportunities. Consider cross-field combos such as title/subtitle + keyword terms (for example adding a missing word that combines with an existing subtitle word).

Output

Produce one report for the latest version directory:

### ASO Audit Report
**App:** ... | **Primary Locale:** ...
**Metadata source:** metadata/version/<version>

#### Field Utilization
| Field | Value | Length | Limit | Usage |

#### Offline Checks
| # | Check | Severity | Field | Locale | Detail |

#### Keyword Gap Analysis
| Keyword | Popularity | Source | In Metadata? | Suggested Action |

#### Recommendations
1. ...

After edits, re-run the audit. For keyword-only follow-up prefer asc metadata keywords diff/apply/sync.