AI 에이전트가 iOS 및 Android 앱의 App Store Optimization(ASO) 리서치, 키워드 순위 추적, 경쟁사 분석 및 앱 메타데이터 감사를 수행할 수 있도록 지원합니다.
다른 이름 trysonar/mcp, mcp, @sonarapp/mcp
- 스타
- 0
- Tools
- 43
- 다운로드, 30일
- —
- 최신 버전
- 0.7.0
- 마지막 커밋
- 2026년 10월 1일
- 라이선스
- MIT
Sonar MCP란?
Sonar은(는) MCP server입니다. AI 에이전트가 iOS 및 Android 앱의 App Store Optimization(ASO) 리서치, 키워드 순위 추적, 경쟁사 분석 및 앱 메타데이터 감사를 수행할 수 있도록 지원합니다. 43개 도구를 제공합니다. 예: sonar_app_lookup, sonar_app_search, sonar_app_aso_score.
프로젝트 README에서 생성된 요약
Sonar MCP server 정보
Sonar는 AI 에이전트가 모바일 앱의 노출도를 관리할 수 있도록 설계된 종합적인 App Store Optimization 도구 모음을 제공합니다. 사용자는 iOS 및 Android 플랫폼 모두에서 키워드 리서치, 순위 추적, 경쟁사 분석 및 메타데이터 감사를 수행할 수 있습니다. 이 MCP server는 npx를 통한 로컬 설치 또는 hosted HTTP 엔드포인트를 통해 Claude Desktop, Claude Code, Cursor, Cline을 포함한 다양한 클라이언트를 지원합니다.
기능은 Sonar 플랜에 따라 서로 다른 액세스 티어로 나뉩니다. sonar_app_search 및 sonar_app_aso_score와 같은 상태 비저장(Stateless) 도구는 일일 제한이 있는 무료 티어에서 실행할 수 있습니다. Indie 플랜 사용자는 sonar_app_rankings 및 sonar_competitor_landscape와 같은 워크스페이스 관리 도구를 사용할 수 있으며, Agency 플랜에서는 sonar_app_sales와 같은 App Store Connect 데이터를 추가로 사용할 수 있습니다. hosted 엔드포인트를 사용하는 경우, OAuth를 통해 수동 API 키 설정 없이 워크스페이스와 직접 상호작용할 수 있습니다.
활용 사례
- 1App Store 감사 수행에이전트에게 앱의 메타데이터를 평가하고 최적화 점수를 제공하도록 요청합니다.
- 2키워드 리서치 실시난이도 및 인기도 지표를 분석하여 잠재력이 높은 키워드를 식별합니다.
- 3경쟁사 격차 분석경쟁사가 순위를 차지하고 있는 키워드를 발견하여 새로운 기회를 찾습니다.
- 4리뷰 인사이트 추출최근 리뷰에서 공통된 테마를 그룹화하여 사용자 피드백을 요약합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
Sonar MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 Sonar MCP 설치
$ claude mcp add --env 'SONAR_API_KEY=<YOUR_SONAR_API_KEY>' mcp -- npx -y @sonarapp/mcpCursor에 Sonar MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@sonarapp/mcp"
],
"env": {
"SONAR_API_KEY": "<YOUR_SONAR_API_KEY>"
}
}
}
}VS Code에 Sonar MCP 설치
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@sonarapp/mcp"
],
"env": {
"SONAR_API_KEY": "<YOUR_SONAR_API_KEY>"
}
}
}
}VS Code CLI에 Sonar MCP 설치
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@sonarapp/mcp"],"env":{"SONAR_API_KEY":"<YOUR_SONAR_API_KEY>"}}'Claude Desktop에 Sonar MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@sonarapp/mcp"
],
"env": {
"SONAR_API_KEY": "<YOUR_SONAR_API_KEY>"
}
}
}
}Codex에 Sonar MCP 설치
$ codex mcp add mcp --env 'SONAR_API_KEY=<YOUR_SONAR_API_KEY>' -- npx -y @sonarapp/mcpCodex config.toml에 Sonar MCP 설치
~/.codex/config.toml
[mcp_servers.mcp] command = "npx" args = ["-y", "@sonarapp/mcp"] [mcp_servers.mcp.env] SONAR_API_KEY = "<YOUR_SONAR_API_KEY>"
Gemini CLI에 Sonar MCP 설치
$ gemini mcp add -s user -e 'SONAR_API_KEY=<YOUR_SONAR_API_KEY>' mcp npx -- -y @sonarapp/mcpGemini settings.json에 Sonar MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@sonarapp/mcp"
],
"env": {
"SONAR_API_KEY": "<YOUR_SONAR_API_KEY>"
}
}
}
}Sonar MCP 도구 43
README에서 감지됨sonar_app_lookupsonar_app_searchsonar_app_aso_scoresonar_app_extract_keywordssonar_app_reviewssonar_app_revenuesonar_keyword_searchsonar_keyword_metricssonar_keyword_suggestionssonar_top_chartssonar_list_productssonar_list_apps
| sonar_app_lookup | — | |
| sonar_app_search | — | |
| sonar_app_aso_score | — | |
| sonar_app_extract_keywords | — | |
| sonar_app_reviews | — | |
| sonar_app_revenue | — | |
| sonar_keyword_search | — | |
| sonar_keyword_metrics | — | |
| sonar_keyword_suggestions | — | |
| sonar_top_charts | — | |
| sonar_list_products | — | |
| sonar_list_apps | — |
도구 43개 모두 보기도구 수 줄이기
sonar_get_appsonar_app_overviewsonar_app_keywordssonar_app_rankingssonar_app_changessonar_keyword_rankingssonar_discovered_keywordssonar_competitor_keywordssonar_competitor_landscapesonar_review_insightssonar_list_alertssonar_alert_eventssonar_portfoliosonar_app_salessonar_app_engagementsonar_create_productsonar_track_appsonar_track_competitorsonar_remove_competitorsonar_delete_productsonar_untrack_appsonar_track_keywordssonar_update_keyword_notesonar_star_keywordsonar_delete_tracked_keywordsonar_untrack_keywordssonar_scan_competitorsonar_analyze_competitorssonar_generate_review_insightssonar_set_alertsonar_delete_alert
| sonar_get_app | — | |
| sonar_app_overview | — | |
| sonar_app_keywords | — | |
| sonar_app_rankings | — | |
| sonar_app_changes | — | |
| sonar_keyword_rankings | — | |
| sonar_discovered_keywords | — | |
| sonar_competitor_keywords | — | |
| sonar_competitor_landscape | — | |
| sonar_review_insights | — | |
| sonar_list_alerts | — | |
| sonar_alert_events | — | |
| sonar_portfolio | — | |
| sonar_app_sales | — | |
| sonar_app_engagement | — | |
| sonar_create_product | — | |
| sonar_track_app | — | |
| sonar_track_competitor | — | |
| sonar_remove_competitor | — | |
| sonar_delete_product | — | |
| sonar_untrack_app | — | |
| sonar_track_keywords | — | |
| sonar_update_keyword_note | — | |
| sonar_star_keyword | — | |
| sonar_delete_tracked_keyword | — | |
| sonar_untrack_keywords | — | |
| sonar_scan_competitor | — | |
| sonar_analyze_competitors | — | |
| sonar_generate_review_insights | — | |
| sonar_set_alert | — | |
| sonar_delete_alert | — |
구성
SONAR_API_KEY필수비밀Your Sonar API key (aso_...). Create one at https://trysonar.app
SONAR_API_URLAPI base URL. Defaults to https://trysonar.app.
| 이름 | 설명 | 유형 |
|---|---|---|
| SONAR_API_KEY | Your Sonar API key (aso_...). Create one at https://trysonar.app | 필수비밀 |
| SONAR_API_URL | API base URL. Defaults to https://trysonar.app. |
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능trysonar/mcp is public and reachablegithub.com/trysonar/mcp ↗통과
- 패키지가 이 저장소를 소스로 명시@sonarapp/mcp names trysonar/mcp as sourcenpmjs.com/package/@sonarapp/mcp ↗통과
- 빌드 출처(Sigstore 증명)No build attestation published for this release검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-10-01github.com/trysonar/mcp ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음No popular package one edit away from @sonarapp/mcp통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음99 resolved dependencies checked; no critical advisoryosv.dev ↗통과
- 모델에 대한 숨겨진 지침 없음43 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨No tool named like delete, drop or exec통과
- 원격 엔드포인트가 MCP 핸드셰이크에 응답initialize answered with protocol 2025-06-18 in 110 ms통과
README
GitHub에서 보기@sonarapp/mcp
The official Sonar MCP server — App Store Optimization tools for AI agents.
For the hosted Grok Build and Cursor marketplace plugin, see plugin setup, authentication, and permissions.
Lets Claude Desktop, Claude Code, Cursor, Cline, and any Model Context Protocol-compatible client look up apps, research keywords, audit ASO, mine reviews, and estimate revenue across the iOS App Store and Google Play. Powered by Sonar.
Tools
55 tools covering the whole Sonar REST API, grouped by what they need.
Read tools — stateless (any plan with credits)
| Tool | What it does | Works without a key |
|---|---|---|
sonar_app_lookup |
Look up app metadata by store ID | Yes |
sonar_app_search |
Search apps by keyword (returns store ranking order) | Yes |
sonar_app_aso_score |
ASO audit score (0-100) with itemized checks | Yes |
sonar_app_extract_keywords |
Extract target keywords from an app's listing | Yes |
sonar_app_reviews |
Fetch reviews with rating filters and sort options | — |
sonar_app_revenue |
Estimate monthly revenue with a confidence grade | — |
sonar_keyword_search |
Keyword research (difficulty, popularity, related terms) | — |
sonar_keyword_metrics |
Difficulty + popularity for specific keywords (up to 25 per call) | Yes (5 keywords/day) |
sonar_keyword_suggestions |
Autocomplete suggestions from the store | Yes |
sonar_top_charts |
Top free/paid/grossing chart with day-over-day movement | Yes |
Stateless tools work on any plan with credits (API Credits, Indie or Agency), for both iOS and Android. The ones marked "Yes" also run keyless on the free tier (see "Try it free" below).
Read tools — your workspace (Indie plan)
| Tool | What it does |
|---|---|
sonar_list_products |
List your products with their linked store versions and competitor counts |
sonar_list_apps |
List your tracked apps with latest snapshots (rating, reviews, installs) |
sonar_get_app |
App detail + up to 90 days of snapshot history |
sonar_app_overview |
Dashboard scoreboard for an app: visibility, share of voice, movement, opportunities |
sonar_app_keywords |
Keywords tracked for an app, with difficulty, popularity, notes and stars |
sonar_app_rankings |
Daily rank history for an app's tracked keywords |
sonar_app_changes |
Detected releases, metadata edits, screenshot/price/category changes |
sonar_keyword_rankings |
SERP history for a tracked keyword (who ranked, when) |
sonar_discovered_keywords |
Untracked keywords Sonar discovered for an app, sorted by opportunity |
sonar_competitor_keywords |
Keywords a competitor ranks for + gap analysis vs your app |
sonar_competitor_landscape |
Gaps, threats and leads vs all your competitors + latest AI insight |
sonar_review_insights |
Latest AI review analysis: praise/complaint themes, quotes, trends |
sonar_list_alerts |
List your alert rules (type, scope, threshold, enabled) |
sonar_alert_events |
Detected alert events (rank moves, rating drops, review spikes), newest first |
Workspace reads require an Indie plan or higher (an active trial counts); the default read-scope key is enough.
Read tools — Agency plan
| Tool | What it does |
|---|---|
sonar_portfolio |
Portfolio rollup: per-app KPIs, biggest movers, needs-attention list, top opportunities |
sonar_app_sales |
App Store Connect sales: downloads, redownloads, IAP units, approximate proceeds |
sonar_app_engagement |
App Store Connect funnel: impressions, page views, downloads, sources, sessions |
These require the Agency plan (an Agency trial counts) and return 403 on other plans. sonar_app_sales and sonar_app_engagement are iOS-only and also need an App Store Connect connection at trysonar.app/settings/connections; engagement data needs an Admin-role App Store Connect key.
Write tools (Indie plan + write scope)
| Tool | What it does |
|---|---|
sonar_create_product |
Create a product in your Sonar workspace and start tracking its app(s) |
sonar_track_app |
Link the second-store version (iOS ↔ Android) of an existing product |
sonar_track_competitor |
Add a competitor app under a product |
sonar_remove_competitor |
Remove a competitor from a product |
sonar_delete_product |
Delete a product and untrack its apps |
sonar_untrack_app |
Untrack an app and its tracking data |
sonar_track_keywords |
Start daily rank tracking for keywords on an app (bulk, idempotent) |
sonar_update_keyword_note |
Set or clear the note on a tracked keyword |
sonar_star_keyword |
Star or unstar a tracked keyword (mark it as a target) |
sonar_delete_tracked_keyword |
Stop tracking one keyword/app pair |
sonar_untrack_keywords |
Bulk-untrack an app's keywords (selected IDs or all) |
sonar_scan_competitor |
Run an AI keyword discovery scan on a competitor (read results with sonar_competitor_keywords) |
sonar_analyze_competitors |
Generate a fresh AI competitive insight for one of your apps (7-day cooldown) |
sonar_generate_review_insights |
Generate a fresh AI review analysis for a tracked app (90-day cooldown) |
sonar_set_alert |
Create or update an alert rule |
sonar_delete_alert |
Delete an alert rule |
Write tools mutate your workspace and require an Indie plan or higher (an active trial counts) plus either an OAuth sign-in on the hosted endpoint (which carries write access) or an API key created with the write scope. The two AI generation tools, sonar_analyze_competitors and sonar_generate_review_insights, need a paid plan and are not available during the trial. The server enforces all of this — without it, calls return a 403 explaining what to fix.
Together these close the loop for agents: set up tracking with the write tools, then read back rankings, changes, and gap analyses with the workspace tools.
Screenshot Studio (Indie plan)
| Tool | What it does | Scope |
|---|---|---|
sonar_screenshot_layout_guide |
Layout-format reference; read it once before authoring layouts | none |
sonar_screenshot_devices |
Supported device sizes and their canvas dimensions | read |
sonar_list_screenshot_sets |
A product's screenshot sets (metadata only) | read |
sonar_get_screenshot_set |
A full set: every screen's layout plus translation overrides | read |
sonar_create_screenshot_set |
Create a screenshot set for a product | write |
sonar_update_screenshot_set |
Rename a set, replace its locales, or reorder its screens | write |
sonar_delete_screenshot_set |
Delete a set and everything in it | write |
sonar_add_screenshot |
Append a screen to a set | write |
sonar_update_screenshot |
Replace one screen's layout | write |
sonar_delete_screenshot |
Delete one screen (a set keeps at least one) | write |
sonar_set_screenshot_translations |
Write a locale's translation overrides | write |
sonar_export_screenshots |
Render store-ready PNGs into one local ZIP per locale | read |
Agents author screenshot sets as layout JSON; humans review and fine-tune the same sets in the Screenshot Studio. The layout guide is embedded in the server and needs no key. sonar_export_screenshots writes files on the machine running the server, so it's available over stdio only, not on the hosted endpoint.
Hosted endpoint — no install, no API key
OAuth-capable MCP clients (Claude Code, claude.ai custom connectors) can skip both the npm install and the API key entirely:
claude mcp add --transport http sonar https://trysonar.app/mcp
The first tool call that needs your account opens a browser sign-in — approve it with your Sonar login and the agent has full access to the workspace you own (read + write). Clients without OAuth support can pass an API key instead: --header "Authorization: Bearer aso_...".
ChatGPT submission and hosted behavior
Submit https://trysonar.app/mcp/chatgpt to OpenAI. This endpoint returns tool-level sign-in challenges; /mcp retains HTTP 401 challenges for Claude and other MCP clients. Both advertise OAuth per tool. Anonymous store lookups can run without linking; workspace tools return a native sign-in challenge when authorization is missing or expired. Connect an existing Sonar account and approve access to the workspace you own. Existing account permissions and entitlements apply.
The ChatGPT endpoint requires resource-bound JWT access tokens for its canonical /mcp/chatgpt audience; the existing /mcp endpoint retains Clerk opaque-token support. Provider configuration and an end-to-end login must be verified before submitting the ChatGPT endpoint.
The hosted catalog excludes sonar_export_screenshots, which writes ZIP files to the local MCP host. It remains available over stdio. A native directory listing requires separate OpenAI review and publication; hosting an MCP endpoint does not itself create a listing.
Try it free — no API key needed
The server runs without a key in free mode: sonar_app_search, sonar_app_lookup, sonar_app_aso_score, sonar_app_extract_keywords, sonar_keyword_suggestions, and sonar_top_charts share a free allowance of 30 requests/day per IP, and sonar_keyword_metrics (keyword difficulty + popularity) gets 5 keywords/day. Just install it with no env block and ask your agent about ASO. When you hit the limit, the error tells you how to sign up.
Get an API key
For everything else (tracking, rankings, competitors, higher limits) you'll need a Sonar API key — get one at trysonar.app/developers.
The cheapest path is prepaid API credits — packs from $10 (1,000 credits), with 50 free credits on signup and no subscription. Built specifically for this use case. See pricing.
Install
Claude Desktop
Add to your config file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):
{
"mcpServers": {
"sonar": {
"command": "npx",
"args": ["-y", "@sonarapp/mcp"],
"env": {
"SONAR_API_KEY": "aso_your_key_here"
}
}
}
}
Restart Claude Desktop. The sonar_* tools will appear in the tool picker.
Claude Code
claude mcp add sonar -e SONAR_API_KEY=aso_your_key_here -- npx -y @sonarapp/mcp
Cursor
Add to ~/.cursor/mcp.json (or your project's .cursor/mcp.json):
{
"mcpServers": {
"sonar": {
"command": "npx",
"args": ["-y", "@sonarapp/mcp"],
"env": {
"SONAR_API_KEY": "aso_your_key_here"
}
}
}
}
Cline / other MCP clients
Most clients use the same command + args + env shape as above. Point the command at npx -y @sonarapp/mcp and pass SONAR_API_KEY in the env.
Configuration
| Variable | Required | Default | Description |
|---|---|---|---|
SONAR_API_KEY |
no (free mode without it) | — | Your Sonar API key (aso_...) |
SONAR_API_URL |
no | https://api.trysonar.app |
Override the API base URL (only used for self-hosting / staging) |
Example prompts
"Use Sonar to look up Spotify on iOS in the US store and report its rating, review count, and category."
"Run an ASO audit on
com.duolingoon Android and tell me what to fix."
"Research the keyword 'habit tracker' on iOS — give me difficulty, popularity, and 5 related terms with lower difficulty I should consider."
"Pull the 50 most recent 1- and 2-star reviews of
1517783697on iOS US and group complaints by theme."
"Search 'meditation' on the App Store and estimate monthly revenue for the top 5 results."
Privacy Policy
Full policy: https://trysonar.app/privacy
The MCP server is a thin client around Sonar's REST API — it stores nothing locally and no data is logged by this package itself.
- Data collected: tool inputs (app IDs, keywords, country codes) are sent to Sonar's API over HTTPS to produce results; authenticated requests include your API key as a
Bearertoken. Sonar logs API requests (endpoint, status, timing) for rate limiting and abuse prevention. - Data usage: inputs are used solely to serve the request (keyword metrics, app lookups, etc.); resulting JSON is returned to your AI client.
- Storage & retention: the package keeps no state on disk. Server-side request logs are retained for 90 days; workspace data (tracked apps/keywords) persists in your Sonar account until you delete it.
- Third-party sharing: no user data is sold or shared with third parties; queries against public app-store data (Apple, Google) contain no personal information.
- Contact: hello@trysonar.app
Troubleshooting
"SONAR_API_KEY is not set — running in free mode" — Expected if you haven't configured a key: the free tools keep working with per-IP daily limits. If you DID configure a key, the MCP client did not pass the env var through — check the env section of your client's config file. Some clients require an absolute path to npx — try which npx and use that.
"Authentication failed" — Your key is invalid, expired, or your subscription lapsed. Visit trysonar.app/developers to check.
"Access denied. This endpoint may require an Indie plan subscription" — The 10 stateless read tools work on any plan with credits. The workspace read, write, and Screenshot Studio tools require an Indie plan or higher (an active trial counts); write tools additionally need an API key created with the write scope. sonar_portfolio, sonar_app_sales, and sonar_app_engagement require the Agency plan, and the two AI generation tools need a paid plan (not a trial). If you're on a setup or trial-expired plan, reactivate first.
Companion: CLI
Prefer the terminal? Use @sonarapp/cli (sonar binary) — same data, same API key.
License
MIT © Peter Sutarik
Sonar MCP 질문
Sonar MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --env 'SONAR_API_KEY=<YOUR_SONAR_API_KEY>' mcp -- npx -y @sonarapp/mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
Sonar MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
Sonar MCP는 어떤 도구를 제공하나요?
43개 도구를 제공합니다. 예: sonar_app_lookup, sonar_app_search, sonar_app_aso_score, sonar_app_extract_keywords, sonar_app_reviews.
고급 기능을 위한 API 키는 어떻게 받나요?
Sonar 개발자 포털에서 API 키를 받을 수 있으며, $10부터 시작하는 선불 API 크레딧 옵션이 제공됩니다.