App Intel SDK — App Store 및 Google Play 데이터를 위한 Node, Python, AI 에이전트용 SDK

App Intel API의 공식 클라이언트 + MCP 서버: iOS App Store 및 Google Play 앱 데이터를 위한 단일 JSON API — 검색, 전체 앱 상세 정보(스크린샷, 프리뷰 비디오, 인앱 구매 가격 목록, 설치 구간), 리뷰, 국가별 인기 차트 & 순위, 유사 앱, 키워드 추천(ASO), 다운로드 & 수익 추정치, 일별 순위 / 평점 이력.

먼저 키를 받으세요 (무료 티어: 월 300회 요청): RapidAPI에서 구독 → https://rapidapi.com/kotuaigor/api/app-intel-api-app-store-google-play-data → 아무 엔드포인트 페이지에서 X-RapidAPI-Key를 복사하세요. 요금제 & 가격.

JavaScript / TypeScript — app-intel-api

의존성 제로, fetch 기반. Node 18+, Bun, Deno, 브라우저, 엣지 런타임.

npm i app-intel-api

import { AppIntel } from "app-intel-api";

const api = new AppIntel({ rapidApiKey: process.env.RAPIDAPI_KEY!, country: "us" });

// 1) find the app
const { data: hits } = await api.search("candy crush", { store: "ios" });
// 2) pull everything about it (screenshots, videos, IAP prices, estimate…)
const { data: app } = await api.app(hits[0].id, { estimate: true });
console.log(app.name, app.iap.items, app.previewVideos, app.estimate);

await api.app("com.king.candycrushsaga");               // Android by package name
await api.app("com.burbn.instagram", { store: "ios" }); // iOS by bundle id
await api.reviews("com.king.candycrushsaga", { sort: "rating", limit: 50 });
await api.charts({ store: "android", chart: "top-grossing", category: "GAME", country: "gb" });

모든 호출은 { data, meta: { cached, stale?, fetchedAt } }로 반환됩니다. 오류는 AppIntelError(status, code, requestId)를 던집니다. 전체 메서드 목록 → packages/client.

Python — app-intel-api

동기 및 비동기 클라이언트(httpx). Python 3.9+.

pip install app-intel-api

from app_intel_api import AppIntel

api = AppIntel("YOUR_RAPIDAPI_KEY", country="us")   # or set RAPIDAPI_KEY in env

hits = api.search("candy crush", store="ios")["data"]
app = api.app(hits[0]["id"], estimate=True)["data"]
print(app["name"], app["iap"]["items"], app["previewVideos"], app["estimate"])

api.app("com.king.candycrushsaga")                   # Android
api.reviews("com.king.candycrushsaga", sort="rating", limit=50)
api.charts(store="android", chart="top-grossing", category="GAME", country="gb")

from app_intel_api import AsyncAppIntel
async with AsyncAppIntel("YOUR_RAPIDAPI_KEY") as api:
    top = await api.charts(store="ios", chart="top-grossing", category="Health & Fitness")

문서 → packages/python.

MCP 서버 — app-intel-mcp (Claude Code, Claude Desktop, Cursor, Windsurf, …)

MCP를 지원하는 모든 AI 클라이언트에 App Store / Google Play 실시간 데이터를 도구로 제공합니다: search_apps, get_app, get_apps, get_reviews, top_charts, list_categories, suggest_keywords, similar_apps, estimate_revenue, rank_history, developer_apps, android_permissions, android_data_safety.

요구 사항: Node 18+ 및 RAPIDAPI_KEY. 서버는 npx를 통해 stdio로 로컬에서 실행됩니다 — 추가 설치 불필요.

Claude Code

# add for the current project (stored in .mcp.json)
claude mcp add app-intel -e RAPIDAPI_KEY=YOUR_RAPIDAPI_KEY -- npx -y app-intel-mcp

# or for all your projects
claude mcp add --scope user app-intel -e RAPIDAPI_KEY=YOUR_RAPIDAPI_KEY -- npx -y app-intel-mcp

claude mcp list            # should show "app-intel: … - ✓ Connected"

그런 다음 예를 들어 *"app-intel을 사용하여 영국 iOS에서 수익 상위 10개 명상 앱을 찾고 구독 가격을 비교해 줘"*라고 물어보세요. Claude Code가 top_charts → get_app을 자동으로 호출합니다. Claude Code 내에서 /mcp를 실행하면 서버와 도구를 확인할 수 있습니다.

파일을 직접 편집하려는 경우의 동일한 .mcp.json (프로젝트 루트):

{
  "mcpServers": {
    "app-intel": {
      "command": "npx",
      "args": ["-y", "app-intel-mcp"],
      "env": { "RAPIDAPI_KEY": "YOUR_RAPIDAPI_KEY" }
    }
  }
}

Claude Desktop

설정 → 개발자 → 구성 편집 (claude_desktop_config.json 열림)에서 위와 동일한 mcpServers 블록을 추가하고 Claude Desktop을 다시 시작하세요. 도구는 채팅 상자의 🔌 / 도구 아이콘 아래에 나타납니다.

Cursor

설정 → MCP → 새 전역 MCP 서버 추가(~/.cursor/mcp.json에 기록), 또는 프로젝트 내 .cursor/mcp.json에 위 블록을 넣으세요. 서버를 활성화하면 에이전트가 도구를 자동으로 사용합니다.

Windsurf

설정 → Cascade → MCP 서버 → 서버 추가 → 원시 구성, 동일한 블록을 붙여넣기(~/.codeium/windsurf/mcp_config.json).

기타 클라이언트 (Zed, Continue, Cline, VS Code Copilot, OpenAI Agents SDK, …)

stdio MCP 서버를 지원하는 모든 클라이언트에서 사용 가능: 명령 npx, 인자 ["-y", "app-intel-mcp"], 환경 변수 RAPIDAPI_KEY.

문제 해결

• 도구에서 Error 401/403 → 키가 없거나 잘못되었거나 구독이 없는 경우: RAPIDAPI_KEY와 구독 상태를 https://rapidapi.com/kotuaigor/api/app-intel-api-app-store-google-play-data에서 확인하세요.

• Error 429 → 요금제 할당량/요율 제한 도달 — 업그레이드하거나 대기하세요.

• 서버가 시작되지 않음 → node --version이 ≥ 18인지 확인하고 터미널에서 npx -y app-intel-mcp가 실행되는지 확인하세요(stdio 입력을 기다리며, Ctrl-C로 종료).

지원 엔드포인트

search · suggest · charts · categories · app · apps (batch) · appByBundleId · reviews · similar · estimates · history · androidPermissions · androidDataSafety · developerApps — 대화형 플레이그라운드 및 전체 참조는 RapidAPI에서 확인하세요.

라이선스

MIT. 데이터는 공개 App Store / Google Play 페이지에서 가져옵니다. 미디어 URL은 Apple/Google CDN에 핫링크됩니다. 추정치는 측정값이 아닌 모델 기반입니다.