AsoBeast

什么是 AsoBeast？

AsoBeast 是一款用于 Apple App Store 和 Google Play 的应用商店优化（ASO）工具和关键词排名追踪器。它会导入应用商店列表，每天追踪关键词排名（深度达 200 位），监控竞争对手、评价和元数据，并将这些历史数据转化为按优先级排序的 ASO 工作队列。本仓库是可在自己的服务器上运行的免费开源版本，托管服务 asobeast.com 也运行相同的代码。

每次商店请求都会在托管 AsoBeast 的机器上发出，形式为普通的公开搜索或页面请求，因此 Apple 和 Google 看到每个被追踪词组的方式，就和看到任何搜索一样。你无需注册 ASO 服务商账号，无需购买 API 密钥，也无需与任何人分享关键词列表。除这些商店请求外，你的数据都会保留在自己的部署中，除非你明确启用出站集成，例如 webhook 警报、电子邮件、OpenAI 助手、Apple Ads 搜索热度或商店状态更新。

AsoBeast 适合谁？

AsoBeast 面向发布应用并希望掌握自己 ASO 数据的用户：独立开发者、小型工作室和代理机构，他们会在多个店面追踪少量应用。如果你想在无需按关键词订阅的情况下追踪 ASO，需要将数据保存在自己的基础设施中，或者希望通过 Agent 或脚本而非仪表板查询 ASO 历史数据，那么 AsoBeast 就适合你。它以刻意保持适中的速率从公开商店端点收集数据，因此适合应用数量有限的组合，而非数百个应用。请参阅 AsoBeast 适合哪些用户。

为什么选择 AsoBeast？

• 无需账号，也无需供应商 API 密钥。 AsoBeast 以刻意保持温和的速率从公开的商店接口采集数据。你只需要 Docker，无需其他东西。
• 关键词列表归你所有。 它保存在你的数据库中，绝不会发送给 ASO 供应商，因此没有任何竞品情报产品能根据你的搜索整理出这份列表。商店每次只会看到一条搜索。
• 两个商店，统一作为一个跟踪实体。 一个应用条目就能跟踪多个店面的关键词，因此 us 和 de 是同一应用页面对应的两个市场，而不是两项订阅。
• 每项评分都附有依据。 热度和难度评分会标明来源、计算版本、采集日期和置信度，让你可以质疑一个数字，而不是盲目相信它。
• 推荐结果确定且可解释。 十七条规则会将存储的历史记录转化为可解释的待办队列。AI 只是可选的点缀，可以概述一项行动，但绝不会凭空编造行动或调整其顺序。
• AGPL-3.0，无开放核心版。 托管服务运行的每项功能都包含在此代码仓库中。

功能

功能	作用
两个实时商店	导入 Apple App Store 或 Google Play URL，保存元数据快照，按需刷新并比较每个字段
关键词跟踪	跟踪任意已验证的商店页面，查看每日排名和历史记录，批量编辑，并手动维护私有的 100 字符 iOS 关键词字段
市场建议	读取应用商店页面支持的语言，并推荐使用这些语言的商店页面，同时显示每日请求成本；随后使用所选市场自身商店页面中的关键词为其初始化
最多检查至第 200 名的排名	每个关键词和市场只需进行一次搜索，即可查询你的应用及其所有竞争对手，因此跟踪竞争对手不会产生额外请求
评分透明	显示人气度和难度及其来源和置信度，并在读取时计算机会值
搜索结果页和类别情报	保留搜索结果页快照，跟踪波动、新晋应用和排名变动者；按国家和类别查看热门榜单、排名变动、趋势应用和榜单关注情况
竞争对手发现	从实时搜索结果中查找竞争对手、比较商店页面并找出关键词差距
评价与变更检测	同步评价和评分历史记录，使用 AI 起草回复并发布到商店，从评价用语中挖掘关键词建议，并检测自有应用和竞争对手的元数据变更
商店转化漏斗	可选连接 App Store Connect 密钥或 Google Play 服务账号，并在排名和每次商店页面变更旁查看各市场的商店专属转化漏斗：曝光量、产品页面浏览量、获取点击量和转化率；App Store 可追溯至 2024 年的历史数据，Google Play 可查看商店页面访客、获取量及每个搜索词带来的安装量
ASO 审核和元数据工作台	确定性的审核规则及历史记录、商店元数据检查，以及战略关键词分类
ASO 行动中心	17 条确定性规则生成建议，包含优先级、预估影响、依据、深层链接、完整生命周期和已验证结果
产品组合分析	将不同商店和国家/地区的关联商店页面分组，比较各组的可见度并生成每周摘要
提醒	通过签名 Webhook 或 SMTP 电子邮件接收排名、搜索结果页、元数据、评价和新行动事件提醒，并支持可恢复的批量投递
MCP 服务	提供 37 个只读工具，以及 7 个可选启用、用于更改关键词、竞争对手、行动和注释的工具；支持 stdio 或远程端点，让 Claude Code、Claude Desktop、Cursor、VS Code 和其他 MCP 客户端与您的实例协同工作
这些内容的指南均可在文档中找到。

快速开始

一键部署

在 Railway 上运行已发布的镜像，并配置 PostgreSQL 和 Redis，还会为你生成所有密钥。请参阅在 Railway 上部署。

Docker Compose

你需要安装 Docker 和 Compose，并准备大约 2 GB 内存和 5 GB 磁盘空间。

git clone https://github.com/AsoBeast/asobeast.git
cd asobeast
printf 'POSTGRES_PASSWORD=%s\nAUTH_SECRET=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
chmod 600 .env
docker compose up --build -d --wait

打开 http://localhost:3001 并创建所有者账户。账户创建后，注册会自动关闭。Safari 不会在纯 HTTP 连接中保留会话 Cookie，因此本地体验时请使用 Chrome 或 Firefox，或参阅登录后返回登录表单。导入商店 URL 后，关键词跟踪会立即开始。

想使用已发布的镜像，而不是自行构建？docker-compose.pull.yml 无需克隆代码库，即可通过 GHCR 运行相同的服务栈：

curl -fsSLO https://raw.githubusercontent.com/AsoBeast/asobeast/main/docker-compose.pull.yml
printf 'POSTGRES_PASSWORD=%s\nAUTH_SECRET=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
chmod 600 .env
docker compose -f docker-compose.pull.yml up -d --wait

完整操作指南：快速入门。镜像标签、固定版本和升级：运行已发布的版本。

连接 AI Agent

每个实例都会提供一个模型上下文协议端点。在集成页面创建个人 API 令牌，然后将 Claude Code 指向该端点：

claude mcp add --transport http asobeast https://your-host/api/backend/mcp --header "Authorization: Bearer asob_…"

你可以询问它本周哪些关键词排名下降、哪些竞争对手进入了前 10 名，或行动中心建议优先处理什么。设置 MCP 服务中提供了 Claude Desktop、Cursor、VS Code、Gemini CLI、Windsurf 和本地 stdio 服务的配置方法；MCP 使用示例则提供了可直接使用的提示词。

AsoBeast 的对比

	AsoBeast（可自托管）	订阅制 ASO 平台
商店请求的运行位置	你的机器	对方的基础设施
谁能看到你的关键词列表	你	供应商
费用模式	你的托管费用	按席位、应用或关键词计费
关键词历史	归你所有，按你的条件保留	订阅结束时也会终止
评分方法	已发布、可版本追踪、可检查	通常为专有方法
扩展方式	自行分叉，采用 AGPL-3.0 协议	提交功能请求

托管版 AsoBeast 是基于同一代码库构建的独立产品。可自托管安装可使用所有功能。

技术栈

pnpm 和 Turborepo、全程采用严格模式的 TypeScript、NestJS、Prisma、PostgreSQL 18、BullMQ、Redis 8、搭配 Tailwind 的 Next.js、Docker Compose。

贡献者设置、架构和模块概览：本地开发和 AsoBeast 的工作原理。

配置

配置参考中记录了每个环境变量、默认值及其影响。apps/api/.env.example 和 apps/web/.env.example 是代码库中的权威变量列表。

默认安装只需要两个变量：POSTGRES_PASSWORD 和 AUTH_SECRET。其他所有变量都有可用的默认值。

常见问题

什么是应用商店优化？

应用商店优化是通过改进应用在 App Store 和 Google Play 搜索中的排名与转化效果来优化应用的实践。它涵盖索引元数据字段中的关键词定位、竞争对手定位、评分与评论，以及类别表现。

AsoBeast 需要 App Store Connect 或 Google Play Console 账号吗？

不需要。AsoBeast 会读取公开的商店数据，因此你可以跟踪任何应用，包括竞争对手的应用，而且它完全不需要 ASO 供应商的 API 密钥。连接 App Store Connect 密钥或 Google Play 服务账号是可选的：这样可以获取商店自有的、针对你应用的访问量、下载量和转化数据；密钥会以密封形式静态存储。请参阅商店漏斗。

AsoBeast 支持哪些应用商店？

支持 Apple App Store 和 Google Play。Apple 会索引标题、副标题和一个私有的 100 字符关键词字段。Google Play 会索引标题、80 字符的简短说明和完整说明，因此副标题和关键词字段只是 Apple 专有的概念。请参阅商店。

排名多久检查一次？

默认每天检查一次，使用你可自行控制的 UTC cron。排名检查会记录最多 200 名的排名位置；null 表示已检查但在该范围内未找到，而不是零。请参阅排名位置。

我可以跟踪多个国家/地区吗？

可以。应用只需导入一次，关键词跟踪会单独设置店面，因此同一个应用列表可以同时跟踪多个市场中的关键词。每增加一个市场，每日商店请求量都会相应增加，设置页面上的预算卡片会估算请求扩增量。请参阅国家/地区与市场。

我的数据会被发送到其他地方吗？

只有商店请求本身会发送数据：它会将每个跟踪的短语作为普通搜索发送到 App Store 或 Google Play，请求来自你自己的地址，或者在你配置代理服务商时通过该服务商发送。除此之外，Webhook 提醒、SMTP 电子邮件、OpenAI 助手、Apple Ads 搜索热度和商店状态轮询是唯一的出站集成，并且只有在配置后才会启用。不会收集遥测数据。请参阅哪些数据会离开你的部署环境。

我可以将 AsoBeast 连接到 Claude 或其他 AI Agent 吗？

可以。AsoBeast 附带 Model Context Protocol 服务，提供 37 个只读工具，可作为本地 stdio 进程运行，也可作为你实例上的远程端点运行。每个连接都需要个人 API 令牌，且默认只能读取数据。另有 7 个可更改关键词、竞争对手、操作和注释的工具，仅会向你授予写入权限的令牌显示。请参阅 MCP。

AsoBeast 真的免费吗？

软件完全免费。它采用 AGPL-3.0 协议，没有开源核心，也没有任何功能被留给商业版，因此可自托管的安装版本包含所有功能。基于同一代码库构建的托管服务只会按所用托管资源收费，不会按功能收费。如果你将修改后的版本作为网络服务运行，AGPL 要求你向用户提供修改后的源代码。

文档

主题	链接
快速入门和首次导入	docs.asobeast.com/quickstart
使用 Docker Compose 自托管	install/docker-compose
配置参考	configuration/reference
概念：评分、排名、国家	concepts
指南：关键词、竞争对手、提醒	guides
运维：备份、恢复、升级	operations
故障排查与支持	support
API 参考和 OpenAPI	api-reference
MCP 工具	mcp/tools
面向大模型的完整网站内容	llms.txt 和 llms-full.txt

限制

在依赖它之前，值得了解以下内容：

• 评分是针对各应用商店的估算值。 人气和难度的评估依据各应用商店不同的公开数据，因此不同应用商店之间的数字不可比较，也不能替代第一方获客数据。
• 爬虫可能会失效。 AsoBeast 会读取公开端点。当应用商店更改端点时，解析器可能会失效。失败会导致任务失败，BullMQ 会通过退避机制重试，并且不会影响请求处理。
• 应用商店的速率限制比硬件更早成为容量瓶颈。 公开端点对每个地址只容许适度的请求速率，这限制了单个实例可跟踪的关键词市场数量。请参阅容量和限制。
• 运维由你负责。 备份、TLS、密钥轮换、监控和升级均由运营者负责。依赖备份之前，请验证能否成功恢复。

路线图

当前版本线为 1.x，最新版本请见更新日志。尚待完成的事项：

• 比所有者和成员更精细的用户权限模型，以及让一个账户加入多个工作区。
• 使用授权或第一方获客数据改进人气校准。
• 按市场区分的评论、类别排名和评分历史记录。目前已采集商品列表及其截图说明，并可按市场切换。
• 在相同的选择加入机制下，逐步增加更多 MCP 写入工具，每次只进行一项可撤销的更改。

发布政策和 1.x 兼容性承诺：升级和回滚。

贡献

欢迎提交拉取请求。请先阅读 CONTRIBUTING.md，了解提交规范、兼容性承诺以及测试套件的运行方式。Bug、问题和功能请求请提交至 GitHub issues。安全问题请通过 SECURITY.md 报告，切勿提交到公开 issue。

许可证

此代码库的源代码遵循 AGPL-3.0 许可证。