playstore-publish

playstore-publish

mimi-seed MCP 서버(@yoonion/mimi-seed-mcp)의 Google Play 도구로 스토어 등록정보(제목/설명), 이미지(아이콘/스크린샷), 릴리스 노트를 업로드하고 트랙 출시·승격을 수행한다. 프로젝트 중립 스킬이며, 각 프로젝트의 CLAUDE.md/AGENTS.md에 있는 패키지명과 Android 스크린샷 매니페스트를 참조한다.

사전 조건

1. MCP에 mimi-seed가 등록되어 있어야 한다.
2. Play 서비스 계정 인증(~/.mimi-seed/play-service-accounts/<packageName>.json 또는 default)이 있어야 한다. 미설정 시:

   npx -y @yoonion/mimi-seed-mcp mimi-seed-playstore-auth
   

   또는 playstore_register_service_account로 패키지별 등록. SA의 GCP 프로젝트에 Android Publisher API가 활성화되어 있어야 한다 (아니면 모든 호출 403).

도구 로딩

호출 전 schema 로드:

ToolSearch(query="select:playstore_get_app,playstore_get_listing,playstore_update_listing,playstore_list_tracks,playstore_upload_image,playstore_list_images,playstore_update_latest_release_notes,playstore_promote_release,playstore_submit_release,playstore_check_submission_risks,playstore_plan_release")

실행 흐름

1. playstore_list_tracks — 현재 트랙별 버전/상태(production/beta/alpha/internal) 확인.
2. playstore_check_submission_risks — 블로커(전체 설명/스크린샷/아이콘 등) 점검 후 사용자에게 체크리스트로 보고.
3. 누락분 업로드:
   • 텍스트: playstore_update_listing (title ≤30 / short ≤80 / full ≤4000)
   • 이미지: playstore_upload_image (아래 표의 imageType·해상도 준수)
   • 노트: playstore_update_latest_release_notes
4. 출시/승격은 사용자 승인 후:
   • 같은 트랙 출시: playstore_submit_release
   • 트랙 간 승격: playstore_promote_release (fromTrack→toTrack, versionCode)

안전 규칙

• status=completed(전체 출시/Google 검토 시작)는 비가역에 가깝다 — 명시 승인 없이는 draft 유지.
• Draft 앱 제약: 앱이 첫 게시 전이면 internal 트랙만 completed 가능, alpha/beta/production은 draft만 생성됨. 비공개/공개 테스트 출시는 콘텐츠 등급·데이터 보안·타깃 연령(Console 전용) 완료가 선행되어야 한다.
• 이미지 전체 삭제(playstore_delete_all_images)는 되돌릴 수 없으니 수량을 먼저 알린다.
• 파일은 절대경로. 이미지 바이트를 컨텍스트에 싣지 않는다.

imageType 참고

imageType	규격
icon	512×512 PNG
featureGraphic	1024×500
phoneScreenshots	320–3840px (각 변), 최소 2장
sevenInchScreenshots / tenInchScreenshots	태블릿

업로드 전 실제 PNG 해상도를 확인한다.