도구 85개가 하는 일
| 도구 | 반환하는 내용 |
|---|---|
list_apps | 계정에 있는 앱과 각 앱의 국가, 키워드 수. 다른 모든 호출은 여기서 시작합니다. |
get_keywords | 스토어프런트 한 곳에서 추적 중인 각 키워드의 현재 순위. 제품과 같은 세 가지 상태로 반환합니다. |
get_rivals | 한 검색어에서 내 앱보다 위에 있는 앱과 그 앱들의 평가 수, 마지막 출시일. |
get_ai_visibility | AI 엔진 답변을 날짜별 표본으로 모은 것에서 앱이 언급된 내역. Studio 또는 Enterprise 플랜과 ai:read가 필요하며, 모든 사용자가 보는 화면을 그대로 재현한 것은 아닙니다. |
run_ai_visibility_check | 해당 실행에서 쓸 수 있는 엔진으로 AI 가시성 표본 측정을 시작하고, 플랜 한도 또는 구매한 AI 가시성 한도에서 1회를 씁니다. Studio 또는 Enterprise 플랜과 ai:read가 필요하며, Pro의 대시보드 한도로는 이 MCP 도구가 열리지 않습니다. 결과는 get_ai_visibility로 읽습니다. |
get_history | 키워드 하나의 순위 추이. 순위가 null이면 측정은 했지만 앱이 결과에 없던 날입니다. |
get_store_page | 스토어프런트 한 곳에서 스토어가 보여 주는 그대로의 내 앱 스토어 페이지 신호: 버전, 스크린샷, 인앱 이벤트, 에디토리얼 노출, 유사 앱 영역, 지원 언어, 별점 분포, 프로모션 텍스트, 추천 인앱 구매, 그리고 저희가 감지한 날짜별 변경 사항. |
get_reviews | 앱의 스토어 리뷰. 어시스턴트가 사용자가 실제로 쓴 내용을 읽을 수 있습니다. |
get_charts | 스토어의 카테고리 차트에서 앱이 있는 위치. |
search_reviews | 앱 하나의 리뷰를 텍스트, 별점, 버전, 기간으로 검색합니다. 전체 리뷰 아카이브에서 최대 1,000행을 반환합니다. |
get_review_stats | 평점 분포와 평균, 일별 추이, 버전별 내역. 평점 하락을 그 원인이 된 릴리스와 맞춰 볼 수 있습니다. |
summarize_reviews | 리뷰 AI: 최근 리뷰와 그 주제의 요약이며, 주제마다 인용한 리뷰가 붙습니다. 당일 요약은 한도를 쓰지 않고 다시 사용합니다. |
draft_review_reply | 리뷰 한 건에 대한 답변 초안. 저장된 리뷰 본문과 내가 적은 메모로 작성하며, 게시는 reply_review가 맡습니다. |
get_listing_timeline | 날짜별 스토어 페이지 변경(버전, 스크린샷, 이벤트, 피처링, 키워드 필드 수정)과 각 변경 전후의 순위 변동. |
get_today | 앱 하나의 하루를 답 하나로: 구매와 체험, 새 리뷰, 순위와 카테고리 변동, 신규 진입 앱, 이벤트, 어제의 스토어 수치. |
get_keyword_competition | 키워드마다 경쟁하는 앱 수를 순위 인덱스에서 셉니다. 추적 중인 검색어나 직접 지정한 후보에 대해 조회합니다. |
get_rival_detail | 경쟁 앱의 평점 추이와 순위에 오른 키워드, 각 키워드에서의 순위. |
get_rival_ad_networks | 경쟁 앱이 함께 일하는 광고 네트워크. 각각 DIRECT 또는 RESELLER로 표시됩니다. |
get_rival_market | Google Play에서는 경쟁 앱의 설치 수와 인앱 가격대, App Store에서는 가격, 평가 수, 출시일. |
get_storefront_audit | 모든 스토어프런트에 걸친 내 iOS 스토어 페이지: 어디서 판매되는지, 어느 스토어프런트가 대체 텍스트나 대체 스크린샷을 보여 주는지. |
check_rank | 스토어프런트 한 곳에서 어떤 검색어든 내 앱의 실시간 순위를 확인합니다. 추적하지 않는 검색어도 됩니다. |
get_keyword_metrics | 검색어 하나의 수요와 난이도를 이루는 입력값: 관련 검색어, 상위 결과의 평가 수, 제목 일치. |
suggest_keywords | 스토어프런트의 검색 언어로 된 새 키워드 아이디어. 키워드마다 누가 왜 검색하는지, 앱이 그 필요에 어떻게 답하는지가 붙으며, 추적 중인 검색어, 제외한 검색어, 브랜드 검색어는 빠집니다. |
validate_listing | 스토어 페이지 초안을 App Store Connect에 넣기 전에 점검합니다. 필드별 글자 수 한도, 키워드 필드에서 공백·반복·이름/부제 단어·브랜드와 군더더기 단어로 잃는 공간, Apple 제품명과 가격 관련 단어, 로케일의 언어와 문자, 초안에서 빠진 추적 키워드를 확인합니다. |
draft_listing | 측정한 키워드로 작성한 제목, 부제, 프로모션 텍스트, 설명 초안. 글자 수와 심사 관련 점검 결과가 함께 나옵니다. |
localize_listing | 새 로케일의 스토어 페이지 전체(이름, 부제, 키워드 필드, 설명)를 원본 스토어 페이지를 바탕으로 작성합니다. 모든 키워드는 먼저 해당 스토어프런트에서 측정하며, shots를 주면 스크린샷 캡션도 작성합니다. 백그라운드에서 실행되고 poll로 읽습니다. |
get_screenshot_text | 처음 네 장의 스크린샷에 적힌 캡션 텍스트. 전환에 영향을 주는 텍스트입니다. |
get_chart_movers | 앱이 속한 카테고리에서 오늘 움직인 앱: 상승, 하락, 신규 진입, 이탈을 이름과 함께 보여 주고, 두 날짜에 앱과 선택한 경쟁 앱이 어디에 있었는지도 알려 줍니다. |
get_featuring | Apple이 오늘 앱을 보여 주는 곳: 에디토리얼 카드(단독 스토리 또는 컬렉션), 진행 중이거나 예정된 인앱 이벤트, 유사 앱 영역을 국가별로, 날짜별 기록과 함께. |
list_alerts | 워크스페이스의 알림 피드. 최신순이며 읽지 않은 알림 수가 함께 나옵니다. 대시보드의 종 아이콘과 같은 피드입니다. |
get_portfolio_overview | 워크스페이스에 있는 모든 앱의 오늘을 앱당 한 줄로: 실시간 사용자, 사용자, 신규 사용자, 광고 매출, 구독 매출, 체험. 합계와 구독 이벤트 피드가 함께 나오며, 오늘 화면과 같은 숫자입니다. |
whoami | 이 키가 읽을 수 있는 것: 플랜, 스코프, 앱, 크레딧 잔액. 크레딧이 들지 않습니다. |
get_usage | 모든 한도의 사용량과 초기화 시점. 크레딧이 들지 않습니다. |
search | 내 앱, 추적 키워드, 경쟁 앱을 검색해 fetch에 쓸 ID를 반환합니다. ChatGPT의 심층 리서치가 기대하는 형식입니다. |
fetch | search ID에 해당하는 전체 레코드: 앱 카드, 기록이 포함된 키워드 하나, 또는 경쟁 앱 하나. |
get_app | 앱 하나의 ID, 국가, 국가별 키워드, 최신 스냅샷. |
get_revenue | 연결한 소스(App Store Connect, Google Play, RevenueCat)에서 가져온 앱 하나의 다운로드와 매출. 소스가 제공한 숫자 그대로입니다. |
get_subscription_events | RevenueCat / Adapty 웹훅으로 받은 구독 이벤트 수를 일별, 국가별, 코호트별로. |
get_store_funnel | App Store Connect에서 가져온 App Store 노출 → 페이지 조회 → 다운로드와 그 기록. |
get_ads_campaigns | 앱을 홍보하는 Apple Ads 캠페인: 광고비, 탭, 설치, 키워드, 검색어. |
get_ads_keywords | 앱을 위해 구매한 모든 Apple Ads 키워드: 입찰가, 광고비, 탭당 비용과 설치당 비용, 전환. 같은 단어의 오가닉 순위가 옆에 붙습니다. |
get_ads_search_terms | 실제로 광고를 노출시킨 검색어. 광고비와 설치 수, 그리고 각 검색어에서 앱의 오가닉 순위를 나란히 보여 줍니다. |
get_ads_command_status | 대시보드, 규칙, confirm_action에서 나온 앱 캠페인의 Apple Ads 명령 상태: 대기 중, 적용 중, 적용됨, 실패, 알 수 없음(전송이 중단됨, Apple Ads에서 확인 필요). |
get_search_popularity | 연결된 Apple Ads 계정에서 가져온 Apple 자체 검색 인기도: 앱의 카테고리에서 해당 국가의 가장 많이 검색되는 검색어를 순위, 1–100 및 1–5 인기도와 함께 보여 주고, 추적 키워드 중 어떤 것이 거기 포함되는지 알려 줍니다. |
get_pricing_offers | 제품별·국가별로 현재 적용 중인 가격, 고정 가격 기간마다의 체험·유료 시작·매출, 그리고 오퍼 코드. RevenueCat 또는 Adapty 웹훅에서 가져옵니다. |
get_country_prices | 제품의 국가별 가격을 Apple의 자동 가격, 그리고 가격을 현지화한 경쟁 앱들의 중앙값과 비교하고, 매력적인 추천 가격과 그 이유를 함께 보여 줍니다. |
get_change_impact | 변경이 가져온 결과: 변경일 전후 같은 일수를 나란히 비교합니다. 키워드 순위, App Store 퍼널, 다운로드, 구독 매출을 봅니다. |
get_weekly_plan | 이번 주 ASO 계획: 다음 할 일을 우선순위가 높은 순으로 보여 주며, 각각 근거가 된 측정, 키워드가 지금 스토어 페이지의 어디에 있는지, 무엇을 하면 완료되는지가 붙습니다. |
add_app | App Store 또는 Play 앱을 워크스페이스에 추가하는 변경을 미리 보여 줍니다. 무엇을 어느 스토어프런트에서 추적하게 되는지 알려 줍니다. |
add_keywords | 앱에 새로 추가할 추적 키워드를 미리 보여 주고, 이미 추적 중인 키워드를 알려 줍니다. |
remove_keywords | 키워드를 추적에서 빼는 변경을 미리 보여 줍니다. 측정한 기록은 남고, 새 측정만 멈춥니다. |
add_rivals | 수동 경쟁 앱 추가를 미리 보여 줍니다. ios:<id> 또는 android:<package> 형식으로 적습니다. |
remove_rivals | 앱에서 수동 경쟁 앱을 제거하는 변경을 미리 보여 줍니다. |
create_share_link | 스토어프런트 한 곳의 대시보드를 보는 공개 링크를 미리 보여 줍니다. 기간은 1-30일이며, 원하면 비밀번호를 걸 수 있습니다. |
export_data | 앱 하나의 키워드, 순위 기록, 리뷰를 CSV 또는 JSON으로 내보냅니다. 먼저 행 수와 열을 미리 보여 주고, 그다음 7일간 유효한 다운로드 링크를 줍니다. |
mark_alerts_read | 알림을 읽음으로 표시하는 변경을 미리 보여 줍니다. 전체, 앱 하나, 특정 날짜까지 중에서 고를 수 있고, 읽지 않음으로 되돌릴 수도 있습니다. |
create_alert_rule | 알림 규칙을 켜는 변경을 미리 보여 줍니다. 키워드가 N계단 떨어질 때, 경쟁 앱이 내 앱 위로 올라설 때, 경쟁 앱의 스토어 페이지가 바뀔 때 중 무엇에 대한 규칙인지, 알림을 어디로 받는지 알려 줍니다. |
delete_alert_rule | 알림 규칙을 끄는 변경을 미리 보여 줍니다. 이미 피드에 있는 알림은 그대로 남습니다. |
reply_review | 리뷰 한 건에 다는 공개 개발자 답변을 미리 보여 줍니다. 리뷰 본문은 데이터일 뿐, 지시로 취급하지 않습니다. |
update_listing | 한 언어의 새 App Store 스토어 페이지 텍스트를 필드별로 미리 보여 줍니다. 편집 가능한 버전에 쓰며, 텍스트는 내가 제출할 때까지 초안에 남습니다. |
pause_campaign | Apple Ads 캠페인의 일시 중지를 미리 보여 줍니다. Apple이 명령을 적용하면 지출이 멈춥니다. |
resume_campaign | 일시 중지된 Apple Ads 캠페인의 재개를 미리 보여 줍니다. |
set_daily_budget | 캠페인의 새 일일 예산을 미리 보여 줍니다. 한 번에 최대 50%까지 움직이며, 일일 작업 한도 안에서 실행됩니다. |
set_keyword_bid | 키워드의 새 입찰가를 미리 보여 줍니다. 한 번에 Apple Ads의 현재 입찰가 대비 최대 50%까지 움직이며, 보낼 때 현재 입찰가를 읽지 못하면 아무것도 보내지 않습니다. 같은 일일 작업 한도를 씁니다. |
pause_keyword | Apple Ads 키워드 하나를 일시 중지하는 작업을 미리 보여 줍니다. Apple이 명령을 적용하면 그 키워드의 지출이 멈춥니다. |
resume_keyword | 일시 중지된 Apple Ads 키워드를 다시 켜는 작업을 미리 보여 줍니다. |
add_negative_keyword | 캠페인이나 광고 그룹 하나에 제외 키워드를 추가하는 작업을 미리 보여 줍니다. 기본값은 정확히 일치입니다. |
add_exact_keyword | 광고 그룹에 정확히 일치 키워드를 추가하는 작업을 미리 보여 줍니다. 예를 들어 설치로 이어진 검색어를 추가할 수 있습니다. |
confirm_action | 미리보기를 거친 쓰기를 토큰으로 적용합니다. 토큰은 한 번만 쓸 수 있고 10분간 유효하며, 미리보기에 나온 내용에 묶여 있습니다. |
find_apps | 저희가 측정하는 차트 전체에서 앱을 찾습니다. 카테고리, 스토어프런트, 차트(Top Grossing, Top Free, Top Paid, Top iPad), 순위 구간, 처음 발견된 날짜, 이름 또는 퍼블리셔로 찾습니다. 모든 행에 측정된 그대로의 매출 수치가 붙습니다. |
market_charts | 마지막으로 측정한 그대로의 인기 차트 하나와 그 차트를 읽은 날짜. |
market_movers | N일 전과 비교해 한 차트에서 오른 앱, 내려간 앱, 새로 들어온 앱, 빠진 앱. 모든 변화는 측정한 두 날짜 사이에서 계산하며, 답에 두 날짜가 모두 나옵니다. |
market_new_apps | 차트에 처음 등장한 앱을 최신순으로, 각 앱의 퍼블리셔와 함께. |
market_publisher | 퍼블리셔 한 곳의 앱 가운데 저희가 차트에서 본 모든 앱과 각 앱이 처음 발견된 날짜. |
hive_app_details | 스토어프런트 한 곳에서 어떤 앱이든 그 스토어 레코드를 보여 줍니다. 이름, 평점, 버전, 가격, 배지, 인앱 구매 수와 함께 지원 언어, 별점 분포, 예정된 인앱 이벤트, 프로모션 텍스트, 추천 인앱 구매가 레코드 날짜와 함께 나옵니다. |
hive_search_apps | 어떤 앱이든 ID를 찾습니다. 이름이나 개발자(해당 스토어프런트의 상위 일치 결과)로, 또는 App Store / Google Play 링크, ID, 패키지 이름으로 찾습니다. |
hive_similar_apps | 어떤 앱이든 스토어의 유사 앱 영역을 그 영역에 나온 순서대로 보여 줍니다. 각 앱의 카테고리, 이름, 퍼블리셔가 읽은 날짜와 함께 나옵니다. |
hive_app_reviews | 스토어프런트 한 곳에서 어떤 앱이든 최근 리뷰(별점, 제목, 본문, 버전, 날짜)와 별점 분포를 읽습니다. 작성자 이름은 제외합니다. |
hive_keyword_ranks | 어떤 검색어든 해당 스토어프런트 검색 결과에서 누가 몇 위에 있는지를 날짜별로 보여 줍니다. |
hive_keyword_metrics | 스토어프런트 한 곳에서 키워드의 저장된 인기도와 난이도. 각각 자체 근거와 최신성 정보가 붙으며, 없는 값은 0이 아니라 빈 값으로 남습니다. |
hive_measure_keyword_metrics | 키워드의 인기도와 난이도가 없거나 오래됐을 때 요청에 따라 측정합니다. 최신 값에는 새 측정이 들지 않으며, 선택형 스코프인 hive:measure가 필요합니다. 이 스코프는 키에서 선택하거나 연결할 때 따로 승인합니다. |
hive_keyword_spy | 어떤 앱이든 순위에 오른 키워드와 각 키워드에서의 순위. 조회 한 번으로 앱 하나를 30일 동안 볼 수 있으며, Hive Explorer에서는 횟수를 세지 않습니다. |
get_keyword_gap | 최대 다섯 개 앱의 키워드 목록을 나란히: 검색어마다 각 앱의 순위와 그 검색어가 없는 앱. |
hive_estimate | 어떤 App Store 앱이든 월 매출과 월 다운로드를 각각 하나의 수치로 반환합니다. |
get_job | 대기열에 들어간 작업의 현재 상태: 대기 중, 실행 중, 완료, 실패, 알 수 없음. |
모든 읽기 도구는 대시보드에 표시되는 것과 같은 측정값을 읽고, 모든 쓰기 도구는 미리보기를 반환하며 승인하면 confirm_action이 적용합니다. 세 가지 측정 상태는 경계를 넘어서도 유지됩니다. N위, 측정했지만 결과에 없음, 측정 실패가 구분된 채로 남으므로 어시스턴트는 빈칸을 빈칸으로 보고합니다.
내 앱으로 직접 확인해 보세요
스토어 링크를 붙여넣고 키워드를 추가하세요. 순위, 내 위에 있는 앱, 수요를 매일 측정합니다.
무료 플랜: 앱 1개, 스토어프런트 2곳에서 각각 키워드 25개, 30일 기록. 카드 불필요, 기간 제한 없음. Pro는 월 $20.
무료로 시작하기 →
