Mogut

Apple 생태계(iOS + Mac App Store)를 위한 읽기 전용 App Store 성장 분석(ASO) MCP 서버.

Mogut은 App Store에 절대 쓰기를 수행하지 않습니다. 쓰기 작업은 사용자가 승인한, 바로 실행 가능한 Heimdall 도구 호출로 넘겨집니다.

1.0: 13개의 실시간 데이터 소스에 걸친 47개 도구, 보고서 오케스트레이터로 마무리됩니다. report_app은 한 번의 호출로 전체 App Report를 생성하며, 주기 등급 (일간/주간/월간)은 로컬 기록의 델타를 보고합니다. CHANGELOG.md를 참조하세요.

설치

npm install -g mogut
mogut setup

설치 마법사는 감지한 MCP 클라이언트(Claude Code & Desktop, Codex, Cursor, VS Code, Windsurf, Antigravity)에 Mogut을 등록합니다. 이후 클라이언트를 한 번 재시작하세요.

설치 마법사는 자격 증명을 macOS Keychain(com.milowda.credentials)에 저장하며, .env 폴백을 제공합니다. 비밀 정보는 터미널에서만 입력됩니다. 채팅으로 입력하거나, 로그로 남거나, 표시되는 일이 절대 없습니다. SECURITY.md를 참조하세요.

Related MCP server: ASO Score MCP

MCP 설정

{
  "mcpServers": {
    "mogut": { "command": "mogut", "args": [] }
  }
}

기본적으로 9개의 도구가 노출됩니다. mogut_* 메타 도구 6개와 보고서 오케스트레이터 3개(report_app, report_competitor_deep, report_comparison — 네 번째 report_actions는 v1.1에 추가됨)입니다. 그 밖의 모든 것은 프로필별로 선택 활성화됩니다. MOGUT_PROFILES="keyword,competitor"(또는 "all")를 설정하세요. mogut_search_tools는 도구를 찾아 어떤 프로필에서 활성화할 수 있는지 알려줍니다. 전체 흐름은 GUIDE.md에서 확인할 수 있습니다.

결과의 형태

모든 도구는 데이터(structuredContent)와 함께 호스트 모델용 작성 지침을 반환합니다. 통계는 항상 코드에서 계산되며 모델에 위임되지 않습니다. 모든 결과에는 source, confidence, lastCheckedAt이 포함되고, 잘린 부분도 표시됩니다(가져온/분석된 항목 수). 리뷰 및 경쟁사 텍스트는 신뢰할 수 없는 데이터로 표시됩니다. 깨진 소스는 눈에 띄게 건너뛴 섹션으로 표시될 뿐, 절대 지어낸 숫자를 만들지 않습니다.

등급

mogut_status는 현재 등급을 보여주고, 자격 증명을 실시간으로 검증(verify: true)하며 180일 Apple Ads 키 교체까지 남은 기간을 카운트다운합니다.

App Store Connect 역할별 열리는 기능

피드는 그 POST 이후에만 데이터를 만들기 시작합니다. Mogut은 MCP 화면에서 이 호출을 절대 보내지 않습니다. 터미널에서 npx mogut analytics enable --app <id>를 실행하세요(Admin .p8 경로를 묻고, 메모리에서만 사용한 뒤 아무것도 저장하지 않습니다). 또는 Admin을 가진 사람이 쓸 요청을 출력하려면 --print-only를 사용하세요. disable는 이를 되돌립니다.

고급: Apple Ads 인기 지수

공식 Apple Ads API에는 인기 지수가 없습니다(실시간 확인: POST /api/v5/keywords/popularities → 404). Ads UI가 보여주는 숫자는 문서화되지 않은 엔드포인트에서 온 것으로, OAuth가 아닌 웹 세션으로 인증합니다. Mogut은 그것을 읽을 수 있지만, 설치 마법사는 이를 묻지 않습니다. 이는 복사한 브라우저 쿠키라서 만료할 뿐 아니라, Apple Ads 약관상 그레이 존에 해당합니다. 이 값이 없으면 keyword_popularity_fetch는 낮은 신뢰도로 표시된 프록시 점수로 대체됩니다.

그래도 사용하려면:

1. https://app-ads.apple.com에 로그인하고 아무 캠페인 화면이나 엽니다.

2. 개발자 도구 → Network 탭을 열고 /cm/api를 필터링한 다음 요청 하나를 선택합니다.

3. 그 요청의 Cookie 요청 헤더 전체를 복사합니다.

4. MCP 클라이언트에서 Mogut을 실행하는 환경에 export MOGUT_APPLE_ADS_SESSION='<the cookie header>'를 설정하거나, com.milowda.credentials Keychain 서비스의 apple-ads-session 계정에 저장합니다.

세션이 만료하면 다시 수행합니다. 엔드포인트가 거부하는 일이 생기면 mogut_discover_sources가 해당 소스를 down으로 표시합니다.

보고서의 형태

report_app은 요청 시점에 맞춘 전체 보고서를 생성하고, daily_digest, weekly_change_report, monthly_status_report는 주기 보고서로 만들어 로컬 기록에서 델타를 읽습니다. 두 유형의 익명화된 골든 예시입니다. EXAMPLE_REPORT_FULL.md · EXAMPLE_REPORT_PERIODIC.md.

개발

npm install && npm run build && npm test

데이터 소스를 추가하시겠어요? CONTRIBUTING.md를 읽으세요 — 어댑터 계약과 픽스처 요구 사항은 테스트로 강제됩니다.

src/core/catalog.ts는 docs/TOOL_CATALOG.md에서 생성됩니다 — node scripts/gen-catalog.mjs로 다시 생성하세요.

MIT.