#pabal-web-mcp 문서

ASO(App Store Optimization)와 웹 SEO 데이터 간 양방향 변환을 위한 MCP (Model Context Protocol) 서버.

이 라이브러리는 ASO 데이터를 웹 SEO 용도로 원활하게 재사용할 수 있도록 하며, ASO 메타데이터를 웹 SEO 콘텐츠로 직접 변환하거나 그 반대로 변환할 수 있습니다. App Store Connect 및 Google Play Console의 ASO 데이터를 기반으로 동기화된 웹사이트를 구축하여 앱 스토어 목록과 웹 프레젠스를 완벽하게 동기화합니다.

💡 예제: 이 라이브러리로 구축된 실제 웹사이트를 확인해보세요. labs.quartz.best에서는 앱 스토어 데이터가 자동으로 동기화되어 아름답고 SEO 최적화된 웹 프레젠스를 만듭니다.

#🛠️ 설치

#요구사항

• Node.js >= 18
• pabal-mcp 설치 및 설정 필요

#라이브러리로 설치

웹사이트 프로젝트에 이 라이브러리를 설치하세요:

npm install pabal-web-mcp
# 또는
yarn add pabal-web-mcp
# 또는
pnpm add pabal-web-mcp

#MCP 클라이언트 설정

참고: mcp-appstore 서버는 키워드 연구 기능에 필요합니다. 먼저 의존성을 설치하세요: cd external-tools/mcp-appstore && npm install

#Cursor에 설치

~/.cursor/mcp.json (전역) 또는 프로젝트 .cursor/mcp.json에 추가:

{
  "mcpServers": {
    "pabal-web-mcp": {
      "command": "npx",
      "args": ["-y", "pabal-web-mcp"]
    },
    "mcp-appstore": {
      "command": "node",
      "args": [
        "/절대경로/TO/pabal-web-mcp/external-tools/mcp-appstore/server.js"
      ],
      "cwd": "/절대경로/TO/pabal-web-mcp/external-tools/mcp-appstore"
    }
  }
}

전역 설치인 경우:

{
  "mcpServers": {
    "pabal-web-mcp": {
      "command": "pabal-web-mcp"
    },
    "mcp-appstore": {
      "command": "node",
      "args": [
        "/절대경로/TO/pabal-web-mcp/external-tools/mcp-appstore/server.js"
      ],
      "cwd": "/절대경로/TO/pabal-web-mcp/external-tools/mcp-appstore"
    }
  }
}

#VS Code에 설치

settings.json MCP 섹션 예시:

"mcp": {
  "servers": {
    "pabal-web-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "pabal-web-mcp"]
    },
    "mcp-appstore": {
      "type": "stdio",
      "command": "node",
      "args": ["/절대경로/TO/pabal-web-mcp/external-tools/mcp-appstore/server.js"],
      "cwd": "/절대경로/TO/pabal-web-mcp/external-tools/mcp-appstore"
    }
  }
}

전역 설치인 경우:

"mcp": {
  "servers": {
    "pabal-web-mcp": {
      "type": "stdio",
      "command": "pabal-web-mcp"
    },
    "mcp-appstore": {
      "type": "stdio",
      "command": "node",
      "args": ["/절대경로/TO/pabal-web-mcp/external-tools/mcp-appstore/server.js"],
      "cwd": "/절대경로/TO/pabal-web-mcp/external-tools/mcp-appstore"
    }
  }
}

#Claude Code에 설치

[!TIP] 자세한 설정 옵션은 공식 Claude Code MCP 문서를 참조하세요.

Claude Code MCP 설정에 추가 (JSON 형식):

{
  "mcpServers": {
    "pabal-web-mcp": {
      "command": "npx",
      "args": ["-y", "pabal-web-mcp"]
    },
    "mcp-appstore": {
      "command": "node",
      "args": [
        "/절대경로/TO/pabal-web-mcp/external-tools/mcp-appstore/server.js"
      ],
      "cwd": "/절대경로/TO/pabal-web-mcp/external-tools/mcp-appstore"
    }
  }
}

전역 설치인 경우:

{
  "mcpServers": {
    "pabal-web-mcp": {
      "command": "pabal-web-mcp"
    },
    "mcp-appstore": {
      "command": "node",
      "args": [
        "/절대경로/TO/pabal-web-mcp/external-tools/mcp-appstore/server.js"
      ],
      "cwd": "/절대경로/TO/pabal-web-mcp/external-tools/mcp-appstore"
    }
  }
}

#Windsurf에 설치

{
  "mcpServers": {
    "pabal-web-mcp": {
      "command": "npx",
      "args": ["-y", "pabal-web-mcp"]
    },
    "mcp-appstore": {
      "command": "node",
      "args": [
        "/절대경로/TO/pabal-web-mcp/external-tools/mcp-appstore/server.js"
      ],
      "cwd": "/절대경로/TO/pabal-web-mcp/external-tools/mcp-appstore"
    }
  }
}

#🔐 인증 정보 설정

pabal-web-mcp는 pabal-mcp의 설정 파일을 사용합니다. 자세한 인증 설정 방법(App Store Connect API 키, Google Play 서비스 계정 등)은 pabal-mcp README를 참조하세요.

#⚠️ 중요: dataDir 경로 설정

~/.config/pabal-mcp/config.json에서 dataDir을 로컬 머신에 저장된 pabal-web 프로젝트의 절대 경로로 설정해야 합니다.

{
  "dataDir": "/절대경로/TO/pabal-web",
  "appStore": {
    "issuerId": "xxxx",
    "keyId": "xxxx",
    "privateKeyPath": "./app-store-key.p8"
  },
  "googlePlay": {
    "serviceAccountKeyPath": "./google-play-service-account.json"
  }
}

예시:

• macOS: "/Users/username/projects/pabal-web"
• Linux: "/home/username/projects/pabal-web"
• Windows: "C:\\Users\\username\\projects\\pabal-web"

#MCP 서버

이 패키지는 Claude 또는 기타 MCP 호환 클라이언트를 통해 ASO 데이터를 관리하는 MCP 서버를 포함합니다.

#사용 가능한 툴

#외부 키워드 MCP 사용 (appreply-co/mcp-appstore)

mcp-appstore 서버는 keyword-research 툴과 함께 작동하는 키워드 연구 기능을 제공합니다. 사용하려면:

1. 기존 클론에서 의존성 설치: cd external-tools/mcp-appstore && npm install
2. MCP 클라이언트에 mcp-appstore 등록 (위 설정 예시 참조)
3. improve-public 전에 키워드 데이터를 제공하기 위해 keyword-research와 함께 사용 (.aso/keywordResearch/...에 저장).

참고: MCP 클라이언트가 허용하는 경우, LLM이 키워드 연구 전에 이 프로세스를 시작하고 이후에 중지하도록 하세요. 그렇지 않으면 수동으로 시작/중지하세요.

#지원 로케일

각 스토어에서 지원하는 모든 언어를 지원합니다.

#라이선스

MIT

#🌐 Pabal Web

ASO와 SEO를 함께 관리하고 싶으신가요? Pabal Web을 확인해보세요.

Pabal Web은 Next.js 기반 웹 인터페이스로, ASO, SEO, Google Search Console 인덱싱 등을 통합 관리하는 완전한 솔루션을 제공합니다.

👉 Pabal Web 방문