ASO Audit

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install metarun-aso-audit
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 metarun-aso-audit。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

ASO Audit 使用 MetaRun 评估应用在两个不同渠道中的可发现性：App Store 搜索排名，以及回答“X 的最佳应用是什么”这类问题的答案引擎。它将关键词排名、列表元数据质量、Apple 搜索分析数据、竞争对手变化和 AI 助手可见度整合到一个诊断工作流中。
此技能负责衡量并提供建议；不会发布内容、植入推荐或自动更改元数据。建议的列表变更会先作为预览暂存，供用户审核和确认。答案引擎扫描会消耗计划用量，且运行前需要确认，因此这套 Openclaw Skills 工作流透明且由用户掌控。

应用场景

查明应用为何未能在重要关键词或地区获得排名。
检查当前位置、排名历史，以及哪些竞争对手在某个搜索词中领先。
找出元数据问题，例如词语重复、关键词字符浪费或超出预算限制。
发掘各 storefront 语言区域中尚未使用的关键词容量。
查看 Apple 衡量的搜索和浏览曝光量、产品页面浏览量及各地区转化率。
跟踪竞争对手列表的变化，包括应用名称、副标题和截图数量。
确定 AI 助手是否会推荐某款应用，并将其可见度与竞争对手进行比较。
找出答案引擎使用但未提及该应用的网站来源，从而建立站外待办事项列表。

工作原理

使用 aso_list_tracked_keywords 查看已跟踪的关键词。如果尚未跟踪任何关键词，则使用 aso_suggest_keywords 生成建议，取得用户确认后，再使用 aso_track_keywords 添加选定词条。
使用 aso_scan_ranks 刷新关键词排名，通过 aso_check_rank 抽查某个词条和地区，并使用 aso_keyword_history 和 aso_keyword_leaders 检查趋势或领先者。
使用 aso_lint_metadata 检查线上列表，并使用 aso_cross_locale_plan 找出各 storefront 语言区域中尚未使用的关键词空间。建议的列表修复需通过 localize-listing 任务中的预览和应用步骤完成。
使用 aso_get_search_performance 检查 Apple 的真实分析数据。如果尚未启用分析功能，则提供 aso_enable_search_analytics；此操作需要 Admin key，且 Apple 的首批报告可能需要 1–2 天才能生成。
使用 aso_scan_rivals 比较已跟踪的竞争对手，该工具会识别其列表相对于先前快照的变化。
使用 aeo_visibility_report 查看答案引擎的声量份额。使用 aeo_suggest_questions 和 aeo_track_questions 建议并跟踪买家问题；只有在告知用户并获得确认后，才能运行会计费的 aeo_scan_answers。
使用 aeo_source_gap 找出答案引擎读取的网站来源及其中未提及该应用的来源，然后提交一份按优先级排序的报告，涵盖元数据机会、排名趋势、Apple 分析数据、竞争对手活动和答案引擎缺口。
所有建议的列表变更都必须经过预览、用户确认和应用；不会自动应用任何变更。

配置指南

此技能需要 npx，并使用 MetaRun 的 MCP 服务器或 MetaRun CLI。通过交互式登录流程进行身份验证，或将 MetaRun 个人访问令牌设置为 METARUN_TOKEN。
npx metarun login
登录流程会将凭据保存在 ~/.metarun/config.json；登录后无需设置环境变量。或者，使用你偏好的密钥管理方式设置 METARUN_TOKEN。调用不熟悉的工具前，请先检查其输入 schema，并通过以下命令查找 ASO 工具：
npx metarun tools aso
npx metarun tools aso_scan_ranks --json
可以使用 npx metarun run '' 直接运行工具，也可以通过 MetaRun 的 MCP 服务器运行。启用 Apple 搜索分析需要 Admin key。答案引擎扫描会计入用户计划用量，因此运行前须说明用量并征求确认。

数据架构

此技能未定义本地报告文件格式，也不会生成指定的磁盘审计文件。它通过 MetaRun 工具读取和更新可发现性记录；登录流程会将配置保存在 ~/.metarun/config.json。
数据领域 工具示例 处理的信息
关键词跟踪 aso_list_tracked_keywords, aso_track_keywords 已跟踪的搜索词及其相关应用／storefront 上下文
排名 aso_scan_ranks, aso_check_rank, aso_keyword_history, aso_keyword_leaders 当前或历史排名，以及词条的领先者
列表元数据 aso_lint_metadata, aso_cross_locale_plan 元数据质量问题和语言区域关键词空间机会
Apple 分析数据 aso_get_search_performance 搜索与浏览曝光量、产品页面浏览量、地区转化率及精选推荐检测
竞争对手 aso_scan_rivals 与先前快照相比的列表差异
答案引擎 aeo_visibility_report, aeo_track_questions, aeo_scan_answers, aeo_source_gap 助手可见度、已跟踪的买家问题、扫描结果，以及未提及该应用的网站来源
持续监测结果 aso_list_sentinel_findings Sentinel 对已跟踪排名进行监测所得的发现
列表建议会通过预览／应用工作流暂存，并且需要用户确认。此技能不会联系 aeo_source_gap 找到的网站来源。

高级特性

跨语言区域关键词规划：
找出通过 storefront 语言区域索引可获得的额外关键词字段容量；技能指出，美国 storefront 会读取九种语言区域。
Apple 搜索分析：
区分经衡量的搜索与浏览表现，并查看各地区转化率，同时提供精选推荐检测器。
竞争对手快照差异：
检测列表变化，例如应用更名、副标题更新和截图数量变化。
答案引擎声量份额：
比较哪些助手会提及该应用、其排名位置以及竞争对手的可见度。
来源缺口优先排序：
将答案引擎读取但未提及该应用的网站来源转化为可执行的站外待办事项列表；MetaRun 不会进行联系。
后台监测：
Sentinel 会监控已跟踪的排名，并记录可通过
aso_list_sentinel_findings
查看的问题发现。
定时促销文本：
可使用
aso_schedule_promo_text
安排促销文本。
由人工掌控的变更：
元数据建议采用预览、用户确认和应用步骤，而非自动发布。
计量扫描保护措施：
答案引擎扫描会使用计划配额，只有在告知用户并获得确认后才会建议运行。

name: aso-audit description: >- Audit and improve an app's App Store discoverability through MetaRun:
keyword rankings per country, metadata lint, rival tracking, real Apple
search analytics, and answer-engine (AI assistant) visibility. Trigger
phrases: "ASO audit", "why am I not ranking", "check my keywords",
"does ChatGPT recommend my app", "compare me to competitors".