playstore-publish

playstore-publish

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

사전 조건

1. MCP에 mimi-seed가 등록되어 있어야 한다.

2. Google 인증이 있어야 한다. 서비스 계정은 선택이다 — 로그인 토큰이 androidpublisher 스코프를 갖고 있어서 로컬 작업은 OAuth 만으로 된다 (requirePlayStoreAuth 가 SA → OAuth 로 폴백). SA 는 브라우저가 없는 환경(CI·서버)에서만 필요하다.

   미인증이면 사용자에게 터미널에서 아래를 실행하라고 안내한다 (대화형이라 네가 대신 실행할 수 없다):

   mimi-seed setup             # 안 된 계정만 순서대로 연결
   mimi-seed auth login        # Google OAuth 만
   mimi-seed auth playstore    # 서비스 계정 (CI/헤드리스용)
   

   SA 를 쓴다면 그 GCP 프로젝트에 Android Publisher API 가 활성화되어 있어야 한다 — 아니면 모든 호출이 403 이고, 겉보기엔 권한 문제와 똑같지만 아니다. Play Console 권한 부여 후 ~5분 전파도 필요하다. 발급 절차: docs/credentials.md

도구 로딩

호출 전 schema 로드:

ToolSearch(query="select:playstore_get_app,playstore_get_listing,playstore_update_listing,playstore_update_details,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")

인앱 상품·리뷰·통계까지 다룰 때 추가로:

ToolSearch(query="select:playstore_list_products,playstore_list_inapp_products,playstore_list_subscriptions,playstore_create_onetime_product,playstore_create_subscription,playstore_update_product,playstore_update_product_listing,playstore_update_subscription_listing,playstore_update_product_state,playstore_list_reviews,playstore_reply_review,playstore_get_statistics,generate_review_reply")

실행 흐름

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)

인앱 상품 · 구독

playstore_list_products(일회성+구독 통합) 또는 playstore_list_inapp_products / playstore_list_subscriptions로 현재 상태를 먼저 읽는다. 생성은 playstore_create_onetime_product / playstore_create_subscription, 가격·설정 변경은 playstore_update_product, 상품/구독 등록정보는 playstore_update_product_listing / playstore_update_subscription_listing이다.

• 활성화는 playstore_update_product_state(DRAFT ↔ 활성)로 하며, 활성 상품은 사용자에게 즉시 노출되므로 명시 승인 후에만 바꾼다.
• 상품 ID는 출시 후 재사용·변경이 사실상 불가능하다. 만들기 전에 ID 규칙을 사용자에게 확인한다.

리뷰 · 통계

playstore_list_reviews로 미답변 리뷰를 모으고, 초안은 generate_review_reply(ANTHROPIC_API_KEY 필요)로 만든 뒤 사용자 확인을 거쳐 playstore_reply_review로 게시한다. 답변은 공개되고 수정 이력이 남는다. 설치·평점 추이는 playstore_get_statistics로 읽는다.

출시 후 긴급 복구

이미 배포된 앱이 치명적으로 망가졌을 때만 쓴다. playstore_list_recovery_actions로 현황을 보고, playstore_create_recovery_action으로 DRAFT를 만든 뒤(대상: allUsers 또는 versionCodes/versionRange — 둘은 함께 못 쓴다), 사용자 승인을 받아 playstore_deploy_recovery_action으로 배포한다.

• 롤백이 아니다. 고친 빌드를 먼저 올려둬야 원격 인앱 업데이트가 의미를 가진다.
• 대상은 생성 때 고른 기준 안에서만 넓힐 수 있다 — 범위를 처음에 신중히 잡는다.
• 취소해도 이미 적용된 기기는 되돌아가지 않는다. 배포 전에 대상 범위를 반드시 사용자와 확인한다.

안전 규칙

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

imageType 참고

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

참고 (온톨로지)

• Play 도구 전체 목록: docs/domain/tool-catalog.md
• 함정(draft-app 트랙 제약, Play↔Console 덮어쓰기, 403≠권한): docs/domain/pitfalls.md