공개 검색 너머: 내 Apsity 데이터를 Claude로 가져오는 MCP 도구 15개

너무 오래 방치한 MCP의 빈틈

Apsity MCP 서버를 처음 출시했을 때, Claude에게 노출되는 도구는 4개 — 전부 공개 앱스토어 검색이었습니다. "미국에서 meditation 키워드 Top 50 뽑아줘" 같은 시장 리서치는 가능했지만, 정작 Apsity가 하는 일 — 내 앱을 분석하는 — 은 프로토콜 어디에도 없었습니다.

결과적으로 워크플로우는 이랬습니다: Apsity 열고 → 차트 보고 → 숫자 몇 개 복사해서 → Claude한테 붙여넣고 질문. 사람이 API였던 거죠. Apsity가 매일 수집·정규화·저장하는 데이터가 어시스턴트 바로 옆 탭에 있는데도 손이 가야 했습니다.

이번 릴리스가 그걸 메웁니다. MCP 서버에서 사용 가능한 도구가 19개 로 늘었고 (기존 4 + 신규 15), 새 도구들은 전부 내 Apsity 데이터를 Claude로 가져오는 것들입니다 — 매출·다운로드·리뷰·키워드 순위·경쟁앱 변경·AI 인사이트·플랜 사용량. 설계상 read-only입니다.

새 도구 15개 (카테고리별)

내 앱과 매출

• list_my_apps — Apsity에 연결한 앱 전체 + 앱스토어 ID + 성장 단계. 다른 도구들의 진입점.
• get_revenue — 일별 매출 + 다운로드 + 활성 구독자 (USD 환산). 단일 앱 또는 전체. 구독 매출은 대시보드와 동일하게 최신일 스냅샷만 사용해서 중복 합산 안 됨.
• get_downloads — 순수 설치만 (재다운로드·업데이트·IAP·구독 제외). "돈은 얼마 벌었어?"가 아니라 "새 유저 들어오고 있나?"가 궁금할 때 쓰는 도구.
• get_country_breakdown — 다운로드 기준 상위 30개국 + 국가별 USD 매출. "다음에 어디 현지화해야 하나?" 신호.
• revenue_compare — 동일 길이 두 기간 비교. 기본은 최근 7일 vs 직전 7일. 다운로드·매출 절대 차이와 % 변화 둘 다 제공.

리뷰

• get_reviews — 최근 리뷰 + 감성 라벨 + 통계. 별점/감성 필터 가능. body는 약 400자로 잘라서 Claude 컨텍스트 낭비 방지.
• summarize_reviews — 큐레이션된 묶음 (최근 부정·긍정·저평점 각각) + 감성 합계. get_reviews를 세 번 부르는 것보다 가벼움. 도구 안에서 AI 호출 없음 — 큐레이션된 데이터를 받고 Claude가 직접 합성.

키워드 (내 거)

• get_keyword_rankings — 앱별 트래킹 키워드 전체 + 최근 N개 순위 스냅샷. 상승/하락/Top 200 밖 여부가 한눈에.
• list_my_keywords — 전체 앱 통틀어 컴팩트 인벤토리. "지금 내가 뭘 트래킹 중이지?" 묻고 싶을 때.

경쟁앱

• list_my_competitors — 트래킹 경쟁앱 + 개발자·평점·버전·장르.
• get_competitor_rankings — 경쟁앱의 키워드 순위 ((키워드, 국가) 그룹별 짧은 히스토리).
• get_meta_changes — 경쟁앱 메타데이터 변경 로그. Apsity가 매일 이름·부제·설명·아이콘·버전을 스냅샷 떠서 diff를 기록합니다. 이번 릴리스에서 제일 마음에 드는 도구 — 경쟁앱 본인들의 분석 대시보드에도 없는 데이터를 내 Claude는 갖고 있는 셈입니다.

구독·AI 인사이트·한도

• get_subscription_trend — 일별 활성 구독자 시계열. 자동 갱신 구독 운영 앱에만 의미 있고, 데이터가 없으면 친절히 비어있다고 알려줍니다.
• get_growth_insights — Apsity의 야간 cron이 이미 생성한 AI 인사이트 (순위 하락 진단, 숨은 시장, 키워드 최적화, 매출 이상 등). 이 도구는 캐시 읽기만 — 새 분석을 트리거하진 않습니다.
• get_plan_usage — 현재 플랜·한도·소비량 (앱·키워드·경쟁앱·오늘 검색 횟수·워치리스트). 다른 도구가 quota 에러를 뱉었을 때 정확히 어디 걸렸는지 확인용.

이제야 말이 되는 워크플로우

월요일 아침 주간 리뷰

탭 다섯 개 열 일을 프롬프트 하나로:

“apsity로 지난 주 매출·다운로드를 모든 앱에 대해 뽑고, revenue_compare로 직전 주랑 비교해줘. 20% 이상 떨어진 앱 있으면 국가별로 더 파고 들어줘.”

Claude가 도구를 순서대로 골라서 부르고, 숫자 정규화해서, 월요일 아침 요약을 읽어줍니다. 대시보드는 아예 안 열어도 됨.

릴리스 직전 리뷰 트리아지

“apsity:summarize_reviews를 최근 30일로 호출해줘. 부정 테마들 묶고, 가장 큰 묶음을 해결할 제품 개선안 3개 제안해줘.”

도구가 최근 부정 5건 + 긍정 5건 + 저평점 5건 — 100개 리뷰 컨텍스트 안 태우고도 테마 잡기엔 충분.

경쟁앱 감시

“apsity:get_meta_changes 최근 14일로 돌려줘. 부제목·스크린샷 바꾼 경쟁앱마다 뭘 바꿨고 어떤 기능 푸시랑 맞물리는지 정리해줘.”

이게 진짜 킬러. 대부분 팀은 경쟁앱이 조용히 부제목을 새 키워드 따라 다시 쓴 걸 못 보고 지나갑니다. Apsity는 이미 감지하고 있고, 이 MCP 도구가 그 diff를 Claude 컨텍스트에 바로 꽂아줍니다.

키워드 건강검진

“apsity:get_keyword_rankings 돌리고, 지난 주 5계단 이상 떨어진 키워드 골라줘. 그리고 apsity:keyword_search로 대체 키워드 후보 제안해줘.”

ASO 컨설턴트한테 돈 주고 시키던 루프가 이제 프롬프트 한 줄.

설계상 read-only

새 도구는 전부 읽기 전용입니다. add_keyword·add_competitor·delete_app 같은 건 의도적으로 빼뒀습니다. 두 가지 이유:

• 환각 리스크. 캐주얼한 한 문장으로 LLM이 트래킹 대상 등록하게 두면 화요일 오후엔 쓸데없는 키워드로 quota 다 채워져 있습니다. 셋업 액션은 클릭 한 번 더 거치는 대시보드가 더 안전.
• 키 노출 시 피해 반경. API 키가 어디 공개돼 버려도, read-only면 최악의 경우 통계 노출만. write가 있으면 트래킹 오염·quota 소진·알림 폭격이 가능해집니다.

진짜 필요한 워크플로우가 생기면 write 도구도 나중에 고려합니다. 지금은 대시보드에서 "추가" 누르는 마찰이 버그가 아니라 기능.

인증 방식

기존과 동일. Settings → MCP API Keys에서 키 발급, 클라이언트 설정에 붙여넣기 (Claude Desktop, Cursor, Claude Code, MCP 지원 클라이언트 어디든). 모든 도구 호출이 해당 계정으로 스코프됩니다. Free 플랜은 여전히 401 — MCP는 Starter·Pro 전용 기능입니다.

유저 데이터 만지는 모든 도구는 같은 체크로 시작합니다: Bearer 토큰을 ApiKey 테이블에서 조회 → 해석된 user id를 호출에 attach → 데이터 쿼리는 userId로 필터. 다른 유저의 app id를 넘기면 "App not found or not owned" — 한 고객의 키가 다른 고객 데이터에 닿을 시나리오는 없습니다.

뭐가 달라지나

이전: Apsity는 사용자가 여는 곳이었습니다. 지금: Apsity는 Claude가 이미 아는 것입니다. 이 릴리스의 솔직한 프레이밍은 "도구 15개 추가"가 아니라 "AI 어시스턴트가 드디어 내 데이터를 볼 수 있게 됐다"입니다.

전체 도구 레퍼런스와 연결 스니펫은 /docs/mcp에서 확인하세요. 이미 연결돼 있다면 새 도구는 다음 대화 시작 시 자동으로 보입니다 — 설정 변경 불필요.