{
  "markdown": "# openaso — App Store Optimization for AI agents\n\nopenaso is a hosted [MCP](https://modelcontextprotocol.io) server that gives AI agents real App Store\nOptimization data from Apple's public app-store APIs: keyword ranks, search-autocomplete\nsuggestions, keyword popularity (real Apple Search Ads popularity where available), competitor\nintelligence, review mining, chart positions, local metadata keyword-coverage analysis, and\naccount-scoped daily rank tracking.\n\n- **Website / signup:** <https://openaso.ai>\n- **Endpoint:** `https://mcp.openaso.ai/mcp` (Streamable HTTP, stateless)\n- **Official MCP registry:** [`ai.openaso/openaso`](https://registry.modelcontextprotocol.io/v0.1/servers/ai.openaso%2Fopenaso/versions/latest)\n- **Docs:** <https://openaso.ai/docs> · tool contracts: <https://openaso.ai/tools>\n- **Agent-readable docs:** <https://openaso.ai/llms.txt> and <https://openaso.ai/llms-full.txt>\n  (every docs page is also served as markdown at its URL + `.md`)\n\n> This repository is the public home of openaso: connection docs, examples, and the\n> [issue tracker](https://github.com/xekor/openaso-mcp/issues). The server's source code is\n> proprietary and is not published here.\n\n## Quick start\n\n1. Create a free account and mint an API key at <https://openaso.ai> (free tier: 500 tool\n   calls/day, 500 tracked app × keyword × storefront combinations).\n2. Connect your client.\n\n**Claude Code**\n\n```sh\nclaude mcp add openaso --transport http https://mcp.openaso.ai/mcp \\\n    --header \"Authorization: Bearer YOUR_KEY\"\n```\n\n**Any MCP client (JSON config)**\n\n```json\n{\n  \"mcpServers\": {\n    \"openaso\": {\n      \"url\": \"https://mcp.openaso.ai/mcp\",\n      \"headers\": { \"Authorization\": \"Bearer YOUR_KEY\" }\n    }\n  }\n}\n```\n\nAuthentication is `Authorization: Bearer <key>` (an `x-api-key` header also works).\n\n## Tools\n\nEverything is per-storefront: ranks, availability, suggestions and popularity differ by country,\nso tools take an explicit `countries` list (default `[\"US\"]`).\n\n| Tool | What it returns |\n| --- | --- |\n| `rank` | An app's position in App Store search results for a keyword (top 200), per storefront. |\n| `suggest` | App Store search-autocomplete suggestions for a seed term — the terms Apple itself suggests. |\n| `volume` | Keyword demand (popularity 0–100, Apple Search Ads popularity where available) plus competition count. |\n| `competitors` | Top-ranking apps for a keyword: position, ratings, genre, keyword-in-title. |\n| `app` | Metadata for one app per storefront, including whether it is available there. |\n| `audit` | One-call ASO research bundle: current listing, indexed word pool, autocomplete-discovered keyword candidates scored for demand and competition. |\n| `coverage` | Which search phrases a metadata draft can rank for — computed locally from the title/subtitle/keyword-field word pool, no network. |\n| `reviews` | Recent customer reviews from Apple's public RSS: rating distribution, average, texts. |\n| `charts` | Position on the top-free, top-paid and top-grossing charts (top 100), per storefront. |\n| `revenue` | Order-of-magnitude revenue estimate modeled from public top-grossing chart rank. |\n| `track_config` | Manage the account's tracked set of (app × keyword × storefront) combinations. |\n| `track` | Snapshot ranks for everything in the tracked set, on demand. |\n| `history` | Server-side rank history — written by `track` and by the managed daily tracking run. |\n\n## Why agents like it\n\nApple indexes an app's title (30 chars), subtitle (30) and hidden keyword field (100) as **one\ncombined word pool** — an app can rank for any query assembled from words across those fields.\nopenaso's tools are built around that model: `audit` finds the candidates, `coverage` scores a\ndraft's pool locally, `rank`/`volume` verify against the real store. The full model is explained\nin the [docs](https://openaso.ai/docs) (agents: [`llms.txt`](https://openaso.ai/llms.txt)).\n\n## Support\n\n- Bugs and feature requests: [issues](https://github.com/xekor/openaso-mcp/issues)\n- Email: <hector@instasize.com>\n\n## Legal\n\n© 2026 Hector Lopez. All rights reserved. openaso is not affiliated with, endorsed by, or\nsponsored by Apple Inc. App Store® and iTunes® are trademarks of Apple Inc. Data is retrieved\nfrom Apple's public endpoints; you are responsible for using it in compliance with Apple's terms.\n",
  "bytes": 4340,
  "sha": "69d8581b57d2af8f59fcb67e95771d9420a9d96cf950b4a8079eabb6c723caec",
  "repo_slug": "xekor/openaso-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_ai_openaso_openaso_fc727e3c/readme"
}