app-store-aso

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Apple App Store ASO Optimization

Apple App Store ASO优化

Overview

概述

This skill enables comprehensive Apple App Store Optimization (ASO) analysis and metadata generation. Analyze existing app listings, generate optimized metadata following Apple's guidelines and character limits, provide competitive insights, and recommend screenshot storyboard strategies.

该技能可实现全面的Apple App Store优化（ASO）分析和元数据生成。分析现有应用列表，遵循Apple的指南和字符限制生成优化后的元数据，提供竞品洞察，并推荐截图故事板策略。

Core Workflow

核心工作流程

When a user requests ASO optimization or metadata review:

Analyze the App Context
- Understand the app's purpose, features, and target audience
- Identify unique value propositions and competitive differentiators
- Note any changes or updates the user mentions
Load ASO Knowledge Base
- Reference
```
references/aso_learnings.md
```
  for comprehensive ASO best practices
- Apply competitive analysis strategies
- Use proven optimization patterns
Generate Optimized Metadata
- Create optimized app name, subtitle, and promotional text
- Write compelling description with keyword optimization
- Generate keyword list with strategic placement
- Ensure all metadata follows Apple's character limits
Validate Character Counts
- Use
```
scripts/validate_metadata.py
```
  to verify all metadata meets Apple's requirements
- Display validation results with character counts and limit compliance
- Flag any violations with specific corrections needed
Provide Screenshot Strategy
- Recommend screenshot storyboard sequence
- Suggest messaging hierarchy and visual focus areas
- Align screenshot strategy with metadata messaging

当用户请求ASO优化或元数据审核时：

分析应用背景
- 了解应用的用途、功能和目标受众
- 识别独特价值主张和竞品差异化优势
- 记录用户提及的任何变更或更新内容
加载ASO知识库
- 参考
```
references/aso_learnings.md
```
  获取全面的ASO最佳实践
- 应用竞品分析策略
- 使用经过验证的优化模式
生成优化后的元数据
- 创建优化后的应用名称、副标题和推广文本
- 撰写融入关键词优化的有吸引力的描述
- 生成具有策略性布局的关键词列表
- 确保所有元数据符合Apple的字符限制
验证字符计数
- 使用
```
scripts/validate_metadata.py
```
  验证所有元数据是否符合Apple的要求
- 显示带有字符计数和合规性的验证结果
- 标记任何违规项并给出具体的修正建议
提供截图策略
- 推荐截图故事板顺序
- 建议信息层级和视觉焦点区域
- 使截图策略与元数据传达的信息保持一致

Apple App Store Character Limits

Apple App Store字符限制

Critical Limits to Validate:

App Name: 30 characters maximum
Subtitle: 30 characters maximum
Promotional Text: 170 characters maximum
Description: 4,000 characters maximum
Keywords: 100 characters maximum (comma-separated, no spaces)
What's New: 4,000 characters maximum

需验证的关键限制：

应用名称：最多30个字符
副标题：最多30个字符
推广文本：最多170个字符
描述：最多4000个字符
关键词：最多100个字符（逗号分隔，无空格）
更新日志：最多4000个字符

Metadata Validation Process

元数据验证流程

After generating recommendations, always validate using the validation script:

bash

python scripts/validate_metadata.py

The script will:

Prompt for each metadata field
Calculate character counts
Check against Apple's limits
Display results with ✅ (pass) or ❌ (fail) indicators
Show exact character counts and remaining characters

Integration Pattern:

Generate metadata recommendations
Run validation script with recommended content
Display validation results to user
Adjust any failing fields and re-validate

生成建议后，务必使用验证脚本进行验证：

bash

python scripts/validate_metadata.py

该脚本将：

提示输入每个元数据字段
计算字符数
对照Apple的限制进行检查
显示带有 ✅（通过）或 ❌（失败）标识的结果
显示精确的字符计数和剩余字符数

集成模式：

生成元数据建议
使用建议内容运行验证脚本
向用户显示验证结果
调整任何未通过的字段并重新验证

Output Format

输出格式

Structure recommendations as:

建议内容按以下结构呈现：

📱 App Metadata Recommendations

📱 应用元数据建议

App Name (X/30 characters) [optimized name]

Subtitle (X/30 characters) [optimized subtitle]

Promotional Text (X/170 characters) [promotional text]

Keywords (X/100 characters) [keyword,list,no,spaces]

Description (X/4000 characters) [full description]

应用名称（X/30字符） [优化后的名称]

副标题（X/30字符） [优化后的副标题]

推广文本（X/170字符） [推广文本]

关键词（X/100字符） [keyword,list,no,spaces]

描述（X/4000字符） [完整描述]

🎯 Competitive Analysis

🎯 竞品分析

[Key insights and positioning recommendations]

[关键洞察和定位建议]

📸 Screenshot Storyboard Strategy

📸 截图故事板策略

[Ordered list of screenshot recommendations with messaging]

[带有信息说明的截图建议有序列表]

✅ Validation Results

✅ 验证结果

[Output from validation script showing compliance]

[验证脚本输出的合规性结果]

Krankie: App Store Ranking Tracker

Krankie：App Store排名追踪工具

Krankie is an agent-first CLI tool for tracking App Store keyword rankings. Use it to monitor keyword performance, track ranking changes over time, and inform ASO optimization decisions with real data.

Krankie是一款基于Agent的CLI工具，用于追踪App Store关键词排名。使用它可以监控关键词表现、追踪排名随时间的变化，并通过真实数据为ASO优化决策提供依据。

Installation

安装

bash

bun install -g krankie

bash

bun install -g krankie

or run directly

或直接运行

bunx krankie

undefined

bunx krankie

undefined

Key Commands

核心命令

App Management:

bash

undefined

应用管理：

bash

undefined

Search for apps

搜索应用

krankie app search "<query>" --platform ios

Add an app to track

添加要追踪的应用

krankie app create <app_id> --platform ios

List tracked apps

列出已追踪的应用

krankie app list


**Keyword Tracking:**
```bash

krankie app list


**关键词追踪：**
```bash

Add keywords to track for an app

为应用添加要追踪的关键词

krankie keyword add <app_id> "<keyword>" --store us

List tracked keywords

列出已追踪的关键词

krankie keyword list


**Ranking Checks:**
```bash

krankie keyword list


**排名查询：**
```bash

Run ranking checks for all tracked keywords

对所有已追踪的关键词进行排名查询

krankie check run

View current rankings

查看当前排名

krankie rankings

See biggest movers (gains/losses)

查看排名变动最大的关键词（上升/下降）

krankie rankings movers

View ranking history for a keyword

查看某个关键词的排名历史

krankie rankings history <keyword_id>

Check status of last run

查看上次查询的状态

krankie check status


**Automation:**
```bash

krankie check status


**自动化：**
```bash

Install daily cron job (default: 6 AM)

安装每日定时任务（默认：早上6点）

krankie cron install --hour 6

Check cron status

检查定时任务状态

krankie cron status

undefined

krankie cron status

undefined

Agent Integration

Agent集成

All commands support

--json

flag for structured output:

bash

krankie rankings --json
krankie app list --json

Get agent-friendly instructions:

bash

krankie instructions --format json

所有命令均支持

--json

标志以输出结构化数据：

bash

krankie rankings --json
krankie app list --json

获取适合Agent的操作说明：

bash

krankie instructions --format json

Data Notes

数据说明

Rankings track positions 1-200; null indicates outside this range
Data stored locally in
```
~/.krankie/krankie.db
```
(SQLite)
Daily re-checks are rate-limited; use
```
--force
```
to override
Logs available at
```
~/.krankie/check.log
```

排名追踪范围为1-200名；null表示超出该范围
数据本地存储于
```
~/.krankie/krankie.db
```
（SQLite数据库）
每日重新查询有速率限制；使用
```
--force
```
标志可强制查询
日志文件位于
```
~/.krankie/check.log
```

ASO Workflow Integration

ASO工作流集成

Before optimization: Use
```
krankie rankings
```
to establish baseline keyword positions
Competitive analysis: Track competitor apps and their keyword rankings
After metadata changes: Monitor
```
krankie rankings movers
```
to measure impact
Trend analysis: Use
```
krankie rankings history
```
to identify patterns

优化前：使用
```
krankie rankings
```
建立关键词排名基准
竞品分析：追踪竞品应用及其关键词排名
元数据变更后：监控
```
krankie rankings movers
```
以衡量优化效果
趋势分析：使用
```
krankie rankings history
```
识别排名模式

Resources

资源

scripts/validate_metadata.py

Python script that validates App Store metadata against Apple's character limits. Provides interactive validation with clear pass/fail indicators.

用于验证App Store元数据是否符合Apple字符限制的Python脚本。提供交互式验证，并显示清晰的通过/失败标识。

references/aso_learnings.md

Comprehensive ASO knowledge base containing optimization strategies, competitive analysis frameworks, keyword research techniques, and proven best practices. Load this file to inform all ASO recommendations.

全面的ASO知识库，包含优化策略、竞品分析框架、关键词研究技巧和经过验证的最佳实践。加载此文件可为所有ASO建议提供依据。