ShipASO

ShipASO

在 App Store 和 Google Play 上实现从分析 → 执行的 ASO 闭环。

产品名是 ShipASO；代码库、本仓库和 Cloudflare 服务均名为 store-ops。

其他所有 AI ASO 工具都只覆盖一半。咨询型工具（以及大多数“AI ASO Agent”）会分析你的商品页，然后止步于复制粘贴这一步——而且依赖付费数据 API。部署型 CLI（Fastlane、原始 API）可以执行，却没有 ASO 的智能。ShipASO 两者兼备，覆盖两大应用商店，且不依赖付费数据。

尚待开拓的领域：Google Play。 目前没有公开工具能端到端地对 Google Play Console 商品页进行实际优化。ShipASO 同时支持 iOS 和 Android。

安装 — 适用于任何编码 Agent

闭环在你的编辑器和本机上运行，使用你的凭据。33 个技能是以纯 Markdown 编写的操作手册，调用的是普通 CLI 工具；引擎则采用标准库 Python 编写——因此不受任何单一供应商限制。

任何 Agent（Codex、Cursor、Copilot、Gemini、Amp、Aider……）：

git clone https://github.com/airowe/store-ops && cd store-ops

然后让你的 Agent 查看 AGENTS.md——大多数 Agent 会自动读取它。该文件是入口：包含技能索引、凭据规则，以及如何运行引擎。Cursor、Copilot 和 Gemini 也有指向该文件的指针文件。

Claude Code 还提供插件安装器：

/plugin marketplace add airowe/store-ops
/plugin install store-ops@store-ops

无论采用哪种方式，都可以审查任意商品页——只读，无需凭据或密钥：

python3 lib/aso_rank_check.py --bundle com.burbn.instagram "photo,stories,reels"

你会获得实时商品页的逐字段 ASO 评分，以及针对每项差距应运行的确切下一个技能。→ 完整演示及效果预览：https://shipaso.com/install

零安装：让你的 Agent 连接托管 MCP

无需克隆、密钥或账户：

claude mcp add shipaso --transport http https://api.shipaso.com/mcp

你的 Agent 会立即获得 preview_app——对任意 App Store 应用进行真实测量的预览（审核评分、自然排名最高的词条，以及进入前 10 的关键词数量）——以及 proof，即汇总排名提升记录。其余十个工具（商品页审核、关键词差距、排名检查、截图评分、竞品监控、战情室、本地化差距、文案草稿，以及两项 Google Play 审核）可通过 app.shipaso.com → Settings → Agent access 获取免费的 shipaso_ 密钥后解锁；使用 --header "Authorization: Bearer <key>" 重新添加服务。MCP 与供应商无关，因此 Cursor 和其他 MCP 客户端也能以相同方式使用。所有工具均为读取或起草操作；不会向线上应用商店发布任何内容。详情：skills/shipaso-mcp/SKILL.md。

本仓库包含什么

ShipASO 提供两种形式——自行运行，或使用托管 Agent 为你运行：

路径	内容
skills/ + lib/	免费的开源 Agent 插件——33 个技能 + 引擎（Python，200 项测试）。可在任何编码 Agent 中运行；Claude Code 还提供一条命令安装器。
cloud/	托管式自主 Agent——一款 Cloudflare 应用（Workers + D1 + Cron + Pages），按计划运行闭环，并将决策提交审批。引擎已移植为 TypeScript（2,160 项测试）。请参阅 cloud/README.md + cloud/DEPLOY.md。
commercial/、docs/	服务方案、发布文章、落地页。

插件是获客入口（通过运行插件发现 Agent）；托管应用才是产品（你开发时，它也会持续运行）。两者使用同一引擎，但提供不同的使用界面。

自行运行，或让它自动运行：

• 免费，在你的编辑器中运行——安装插件，然后在你现有的任意 Agent 中自行运行闭环。使用你的凭据，在你的机器上运行，完全免费。 从这里开始 ↓（安装）。
• 托管 + 自主运行——通过套件 ID 连接应用，Agent 就会按每周计划运行闭环：重新检查排名、监控竞品、起草下一项优化，并将每项决策提交给你审批。现已上线： https://app.shipaso.com

功能

audit  →  research keywords  →  optimize to char limits  →  push  →  verify rank
(asc/gplay) (no paid API)        (ready copy + commands)   (you approve) (free, over time)

完整闭环，不只完成一半。 数据工具（Astro、AppTweak、Sensor Tower）只会告诉你“该怎么做”，然后就把你留在 App Store Connect 表单里。ShipASO 会挑选关键词、撰写元数据、为你提交更新，然后验证排名是否真的有所提升——这是唯一能闭合整个工作流的部分，也是其他人都没有提供的功能。

/store-ops myapp                     # full chain, both stores
/store-ops myapp --store playstore   # Google Play only
/store-ops myapp --audit-only        # just score the live listing

30 秒上手（无需凭据，无需设置）

验证／监控部分基于免费的 iTunes 公共 API 运行——现在就可以对任何已上线的应用试用：

# organic App Store rank for some keywords (any app's bundle id)
python3 lib/aso_rank_check.py \
    --bundle com.burbn.instagram "photo,stories,reels"

# score an app's screenshots against ASO best practice
python3 lib/aso_screenshot_score.py \
    --app instagram --bundle com.burbn.instagram

# resolve a non-US market's keyword-volume + rank constants
python3 lib/aso_locale.py --locale de-DE

运行测试套件（仅使用标准库——无需网络，无需密钥）：

python3 lib/run_tests.py

技能

推理（核心 IP）：

技能	作用
aso-audit	按字段对照 ASO 最佳实践为实时 iOS/Android 商店详情页评分。只读。
issue-verify	开始处理前，根据源代码检查未解决的问题——发现“缺少此项”之类过时的说法。
aso-teardown	根据公开的实测数据，为任意应用撰写可发布的长篇拆解报告。绝不估算收入。
aso-keyword-research	根据商店自动补全结果、竞品抓取结果和同义词对关键词排序。不使用付费数据 API。
aso-metadata-optimization	按精确字符数限制生成最终文案，并输出推送命令。绝不自动发布。
aso-rank-check	读取你的应用在 App Store 中每个关键词的自然排名并记录变化——变更是否生效？使用免费的公开 iTunes API，无需密钥。
store-ops	完整流程的路由器。

更多推理——审计、风险与研究：

技能	作用
aso-context	为其他 ASO 技能提供所需的应用级 context.md 框架。从这里开始。
aso-review-mine	挖掘你自己的评论，找出真实用户描述应用时使用的词语。
aso-offstore-mine	挖掘“最佳 <category> 应用”文章和 YouTube，寻找商店外的发现用语。
aso-localize-research	按市场（de-DE、ja-JP、es-MX……）而非仅针对美国开展关键词和排名研究。
aso-competitor-watch	跟踪竞品详情页随时间的变化——名称、副标题、价格、评分。
aso-screenshot-score	为实时截图集评分——数量、设备/宽高比覆盖范围、前两张的叙事效果。
aso-review-risk	标记可能导致应用被拒绝的文案——无法验证的声明、“#1”、竞品名称。
aso-rejection-assistant	将一次拒绝转化为针对审核人员实际引用的指南的计划。
aso-ppo-treatment	设计免费的截图 A/B 测试（Product Page Optimization）。
aso-rank-monitor	按计划周期运行一组关键词，让你获得变化量，而非单次快照。

执行——App Store Connect（通过 asc CLI）：

技能	作用
asc-metadata-write-lane	创建可编辑版本、附加构建版本、推送文案——在提交前停止。
asc-screenshot-write-lane	通过 ShipASO，将已批准运行的截图条带放到可编辑版本上——解析 ID、逐张记录，在提交前停止。
asc-metadata-sync	同步并验证元数据；迁移旧版元数据格式。
asc-localize-metadata	翻译并跨区域设置同步元数据。
asc-submission-health	提交前检查、提交构建版本并监控审核状态。
asc-id-resolver	根据易读名称解析应用、构建版本、版本和群组 ID。
asc-ppp-pricing	根据购买力设置各地区价格。
asc-shots-pipeline	通过 xcodebuild / simctl / AXe 捕获 iOS 截图。
aso-goldie-config	根据一次运行生成 goldie.config.ts——按审计顺序排列场景，并使用建议文案作为标题，在你自己的 Mac 上渲染。

执行——Google Play（通过 gplay CLI）：

技能	作用
gplay-metadata-sync	同步商店详情页，包括 Fastlane 格式。
gplay-review-management	监控、筛选并回复评论。
gplay-rollout-management	编排并监控分阶段发布。
gplay-vitals-monitoring	崩溃、ANR、性能和错误。
gplay-screenshot-automation	通过 adb + Espresso 跨设备和区域设置捕获 Android 截图。
gplay-ppp-pricing	按地区设置价格。

托管：

技能	作用
shipaso-mcp	将你的 Agent 指向托管的 ShipASO MCP 服务，并通过它驱动整个流程。

每个会写入数据的 asc-* / gplay-* 技能都会先询问要使用哪个 API 密钥—— asc 会从默认配置文件中解析凭据；如果注册了多个配置文件，通过错误的配置文件推送也会成功，但会操作错误的账户。

原则

• 不依赖付费数据 — 基于免费数据和自有数据进行推理（商店自动补全建议、公开列表、自有的 asc/gplay 导出数据）。每个需要凭据的数据源都是可选的加速方式，并有免费替代方案，绝不会成为门槛：
  • 搜索量 — 提供你自己的 Apple Search Ads / Google Keyword Planner 密钥，以获取真实的搜索热度数据；没有密钥时，则使用诚实的自动补全排名代理指标。
  • 抓取 — 提供 context.dev 密钥，以干净地抓取竞品列表和品牌数据；没有密钥时，则使用 WebFetch / Crawl4AI。 你提供自己的密钥（这是你的数据，符合 ToS）；该插件绝不转售数据。
• 覆盖两个商店，使用官方 API。
• 未经你批准，绝不发布任何内容 — 推理会编写文案并打印命令；由你执行推送。
• 不绑定特定应用 — 使用 --app <slug> 和一个 context.md。不硬编码应用，插件中不存放密钥。

要求

• 要执行操作：安装 asc 和 gplay CLI，并使用你自己的开发者凭据完成认证。
• 推理技能可独立运行（它们会输出供你稍后执行的命令）。

安装

/plugin marketplace add airowe/store-ops
/plugin install store-ops@store-ops

开放核心 — 免费版与托管版的区别

该插件永久免费且采用 MIT 许可证。 以上所有功能——完整的审核 → 调研 → 优化 → 推送 → 验证流程、两个商店和全部 33 项技能——都可使用你自己的凭据在本地免费运行。你可以使用它、派生它，并用它发布应用。对于习惯在终端中操作的用户来说，这就是完整产品。

托管版提供的是便利，而非能力。免费插件功能完整；付费版帮你摆脱繁琐的设置和记忆负担。托管 Agent 现已上线： https://app.shipaso.com — 连接一个应用，即可查看该流程按计划运行。

	免费版（此插件）	托管 Agent
33 项技能 + 完整流程	✅ 全部包含	✅ 相同引擎
真实搜索量数据	自带 Apple/Google 密钥	引导式设置
排名跟踪	手动运行 aso-rank-check	定期运行，每周更新 + 历史记录 + 变化提醒
持续自主运行（每周 cron）	❌ 需要你重新运行	✅ Indie / Startup / Scale
应用数量	无限（在本地运行）	1 个（Free）· 3 个（Indie）· 10 个（Startup）· 50 个（Scale）
审批关卡	由你执行推送	由代码强制执行——只有你批准后才会提供命令

套餐：

套餐	价格	包含内容
Free	$0	在任意编码 Agent 中自行运行 Agent。完整流程，在你的设备上运行。连接 1 个应用，仅支持手动运行。
Indie	$6.99/month	每周自主检查，最多支持 3 个应用。它提出建议，由你批准，再由它发布。
Startup	$19.99/month	每周检查最多 10 个应用，并提供排名历史和竞品监控。
Scale	$64.99/month	最多支持 50 个应用，另提供作品集汇总。适合代理机构和开发多个应用的团队。

我们绝不会通过共享账户转售 Apple/Google 数据（这会违反其 ToS）——托管版同样需要你自带凭据，而且我们绝不会保管你的商店凭据；推送采用生成命令后交由你执行的方式。你付费购买的是引导式入门、调度器和历史记录。我们的差异化优势不在数据——所有人都能获得 Apple 的热度数据，而在于 ShipASO 会发布元数据，并验证排名是否提升。

→ 试用托管 Agent：https://app.shipaso.com

许可证

MIT — 参见 LICENSE。