asobeast README

项目的 README,来自 github.com/AsoBeast/asobeast。合并为一个 markdown 文件:README.md。

AsoBeast

AsoBeast

AsoBeast is an open source App Store Optimization (ASO) tool and keyword rank tracker for the Apple App Store and Google Play.

Use the hosted service at asobeast.com, or self-host the open source edition on your own server.

License: AGPL-3.0 Latest release CI status Commits per month GitHub stars Documentation

Website · Quickstart · Self-host · MCP server · API · Support · Changelog

The AsoBeast app overview in dark mode: search visibility up 47 points in 30 days, 14 of 24 tracked keywords in the top 10, the top open actions, a visibility chart climbing over the month and the rank distribution of every keyword

What is AsoBeast?

AsoBeast is an App Store Optimization (ASO) tool and keyword rank tracker for the Apple App Store and Google Play. It imports a listing, tracks keyword rankings daily to a depth of 200, watches competitors, reviews and metadata, and turns that history into a prioritized queue of ASO work. This repository is the free, open source edition that you run on your own server, and the hosted service at asobeast.com runs the same code.

Every store request runs on the machine hosting AsoBeast as an ordinary public search or page request, so Apple and Google see each tracked phrase the way they see any search. You sign up with no ASO vendor, buy no API key, and share your keyword list with nobody. Beyond those store requests, your data stays in your deployment unless you explicitly enable an outbound integration such as webhook alerts, email, OpenAI assistance, Apple Ads search popularity or store status updates.

Who is AsoBeast for?

AsoBeast is built for people who ship apps and want their ASO data to stay theirs: indie developers, small studios and agencies tracking a handful of apps across several storefronts. It fits if you want ASO tracking without a per keyword subscription, need the data on your own infrastructure, or want to query your ASO history from an agent or a script instead of a dashboard. It collects from the public store endpoints at a deliberately modest rate, so it suits a portfolio measured in apps rather than hundreds. See who AsoBeast is for.

Why AsoBeast?

Features

Feature What it does
Two live stores Import an Apple App Store or Google Play URL, snapshot the metadata, refresh on demand and diff every field
Keyword tracking Track any validated storefront, see daily positions and history, bulk edit, and keep the private 100 character iOS keyword field by hand
Keyword inspection Research any phrase in any storefront before you track it: the top 50 results, the store autocomplete, popularity, difficulty and opportunity with their source, a summary of the top 10 and the change since the last run
Market suggestions Reads the languages your listing ships and suggests the storefronts that read them, with the daily request cost, then seeds a chosen market with the keywords of its own listing
Rank checks to depth 200 One search per keyword and market serves your app and all of its competitors, so competitor tracking costs no extra requests
Transparent scoring Popularity and difficulty with provenance and confidence, plus opportunity derived on read
SERP and category intelligence Retained SERP snapshots, volatility, entrants and movers, and top charts by country and category with movement, trending apps and chart follows
Competitor discovery Find competitors from live search results, compare listings and find keyword gaps
Reviews and change detection Sync reviews and rating history, draft replies to them with AI and post them to the store, mine review language for keyword ideas, and detect owned and competitor metadata changes
Store funnel Optionally connect an App Store Connect key or a Google Play service account and see each store's own funnel by market beside your rankings and every listing change: impressions, product page views, Get taps and conversion with history back to 2024 on the App Store, store listing visitors, acquisitions and installs per search term on Google Play
ASO audit and metadata workbench A deterministic audit rubric with history, store metadata lints and strategic keyword buckets
ASO Action Center Seventeen deterministic rules produce recommendations with a priority, an estimated impact, the evidence behind them, a deep link, a full lifecycle and a verified outcome
Portfolio analysis Group linked listings across stores and countries, compare group visibility and generate weekly digests
Alerts Signed webhooks or SMTP email for rank, SERP, metadata, review and new action events, with resumable batched delivery
MCP server 42 read tools, plus 8 opt-in tools that change keywords, competitors, actions and annotations or queue a keyword inspection, over stdio or a remote endpoint, so Claude Code, Claude Desktop, Cursor, VS Code and other MCP clients can work with your instance

A guide for each of these lives in the documentation.

Quick start

One-click deploy

Deploy on Railway

Runs the published images on Railway with PostgreSQL and Redis, and generates every secret for you. See deploy on Railway.

Docker Compose

You need Docker with Compose, roughly 2 GB of memory and 5 GB of disk.

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

Open http://localhost:3001 and create the owner account. Registration closes automatically once it exists. Safari does not keep the session cookie over plain HTTP, so use Chrome or Firefox for a local evaluation, or see signing in returns to the sign in form. Import a store URL and keyword tracking starts immediately.

Prefer published images to a build? docker-compose.pull.yml runs the same stack from GHCR without a clone:

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

Full walkthrough: quickstart. Image tags, pinning and upgrades: run a published release.

Connect an AI agent

Every instance serves a Model Context Protocol endpoint. Create a personal API token on the Integrations page, then point Claude Code at it:

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

Ask it which keywords dropped this week, which competitor entered the top 10 or what the Action Center wants done first. Configuration for Claude Desktop, Cursor, VS Code, Gemini CLI, Windsurf and the local stdio server is in set up the MCP server, and MCP recipes has prompts to start from.

How AsoBeast compares

AsoBeast (self-hosted) Subscription ASO platforms
Where store requests run Your machine Their infrastructure
Who sees your keyword list You The vendor
Cost model Your hosting bill Per seat, per app or per keyword
Keyword history Yours, retained on your terms Ends when the subscription does
Score methodology Published, versioned, inspectable Usually proprietary
Extending it Fork it, it is AGPL-3.0 File a feature request

A hosted AsoBeast is a separate product built from this same repository. Self-hosted installations get every feature.

Tech stack

pnpm and Turborepo, TypeScript strict throughout, NestJS, Prisma, PostgreSQL 18, BullMQ, Redis 8, Next.js with Tailwind, Docker Compose.

Contributor setup, architecture and the module map: local development and how AsoBeast works.

Configuration

Every environment variable, with defaults and what each one changes, is documented in the configuration reference. apps/api/.env.example and apps/web/.env.example are the authoritative lists in the repository.

A default installation needs two variables, POSTGRES_PASSWORD and AUTH_SECRET. Everything else has a working default.

FAQ

What is App Store Optimization?

App Store Optimization is the practice of improving how an app ranks and converts in App Store and Google Play search. It covers keyword targeting in indexed metadata fields, competitor positioning, ratings and reviews, and category performance.

Does AsoBeast need an App Store Connect or Google Play Console account?

No. AsoBeast reads public store data, so you can track any app including your competitors, and it never needs an ASO vendor API key. Connecting an App Store Connect key or a Google Play service account is optional: it adds the store's own visits, downloads and conversion for your apps, and the key is sealed at rest. See the store funnel.

Which app stores does AsoBeast support?

Both the Apple App Store and Google Play. Apple indexes a title, a subtitle and a private 100 character keyword field. Google Play indexes a title, an 80 character short description and a long description, so subtitle and keyword field stay Apple only concepts. See stores.

How often does it check rankings?

Once a day by default, on a UTC cron you control. Rank checks capture position to a depth of 200, and a position of null means checked and not found within that depth rather than zero. See positions.

Can I track more than one country?

Yes. An app is imported once, and keyword tracking carries its own storefront, so one listing can track keywords in many markets at once. Each added market multiplies daily store requests, and the settings page shows a budget card that estimates the fan-out. See countries and markets.

Is any of my data sent anywhere?

Only the store requests themselves, which send each tracked phrase to the App Store or Google Play as an ordinary search, from your own address or through a proxy provider if you configure one. Beyond those, webhook alerts, SMTP email, OpenAI assistance, Apple Ads search popularity and the store status poll are the only outbound integrations, and each is off until configured. There is no telemetry. See what leaves your deployment.

Can I connect AsoBeast to Claude or another AI agent?

Yes. AsoBeast ships a Model Context Protocol server with 42 read tools, available as a local stdio process or as a remote endpoint on your instance. Every connection needs a personal API token and reads by default. Eight more tools that change keywords, competitors, actions and annotations or queue a keyword inspection are listed only to a token you give the write scope. See MCP.

Is AsoBeast really free?

The software is, entirely. It is AGPL-3.0 with no open core and no feature held back for a commercial edition, so a self-hosted installation has everything. A hosted service built from this same repository is charged for the hosting it uses, never for features. If you run a modified version as a network service, the AGPL asks you to offer that modified source to its users.

Documentation

Topic Link
Quickstart and first import docs.asobeast.com/quickstart
Self-hosting with Docker Compose install/docker-compose
Configuration reference configuration/reference
Concepts: scoring, positions, countries concepts
Guides: keywords, competitors, alerts guides
Operations: backups, restore, upgrades operations
Troubleshooting and support support
API reference and OpenAPI api-reference
MCP tools mcp/tools
The whole site for an LLM llms.txt and llms-full.txt

Limitations

Worth knowing before you rely on it:

Roadmap

The 1.x line is current, and the changelog names the latest release. What remains open:

Release policy and the 1.x compatibility promise: upgrade and roll back.

Contributing

Pull requests are welcome. Read CONTRIBUTING.md first for the commit conventions, the compatibility promise and how the test suites are run. Bugs go to GitHub issues, while questions and ideas go to GitHub Discussions. Security reports go through SECURITY.md, never a public issue.

Contributors to AsoBeast

License

This repository's source code is available under the AGPL-3.0 license.

asobeast (AsoBeast/asobeast)

正在搜索数据库…

这是什么?AsoBeast 是一款开源的应用商店优化(ASO)工具和关键词排名追踪器,适用于苹果 App Store 和谷歌 Play。它可以导入应用商店页面,每天追踪关键词排名(追踪深度为前 200 名),监控竞争对手和用户评价,并将这些历史数据转化为按优先级排列的 ASO 工作队列。
怎样才能把它跑起来?可以使用一键部署 Railway(它会自动配置 Postgres、Redis 和所有密钥),也可以在本地用 Docker 和 Compose 运行 docker-compose.yml;docker-compose.pull.yml 则直接运行已发布的 GHCR 镜像,无需克隆代码仓库。打开网页界面后,即可创建一次性的所有者账户。
我需要 App Store Connect 或 Google Play Console 账户吗?不需要。AsoBeast 直接读取公开的应用商店数据,因此无需任何 ASO 服务商账户或 API 密钥。连接 App Store Connect 密钥或 Google Play 服务账户是可选的,只会额外提供展示次数、安装量等第一方转化数据。
热度和难度分数有多可靠?这些分数是针对各个商店、基于不同公开数据估算出来的,因此苹果和谷歌的数值不能直接比较,也不能替代第一方的获客数据。由于 AsoBeast 抓取的是商店的公开接口,每当商店更改页面时,解析器都可能失效。
AsoBeast 是为谁设计的?面向独立开发者、小型工作室和代理机构,适合需要在多个商店地区追踪少量应用的用户。如果你希望把 ASO 数据存放在自己的基础设施上,而不是按关键词付费订阅,它会很适合你。
AGPL-3.0 许可证对我意味着什么?自托管版本完全免费,没有任何功能被限制在商业版中。如果你将修改后的 AsoBeast 作为网络服务运行,AGPL 要求你向该服务的用户提供修改后的源代码。
MCP 服务器能让 AI 代理做什么?它提供 37 个只读工具,以及 7 个需要主动开启的写入工具(用于关键词、竞争对手、行动项和备注),可通过标准输入输出或远程端点调用。借助它,Claude Code、Claude Desktop、Cursor 或 VS Code 可以查询你的 ASO 数据并据此操作。
我能在多个国家追踪同一个应用吗?可以。应用只需导入一次,每个被追踪的关键词都有各自的商店地区,因此同一个应用页面可以同时在多个市场追踪关键词。设置页面会显示预算估算,说明每增加一个市场,每日的商店请求量会增加多少。
AsoBeast 如何决定接下来该处理什么?十七条确定性规则会把已存储的历史数据转化为按优先级排列的“行动中心”队列。每个条目都包含优先级、预计影响、依据和深层链接。AI 是可选的,它只能概括某个行动,不能凭空生成或调整行动的顺序。
它与订阅制 ASO 平台有什么不同?商店搜索请求在你自己的机器上运行,而不是通过服务商的基础设施;你的关键词列表从不被分享;没有按座位或按关键词收费;评分方法公开且可查验,而不是专有的黑盒。
作者
AsoBeast
大小
31 MB
星标
145
时长
2个月
提交 · 90 天