listingbureau-mcp

Name: Listing Bureau - Amazon Organic Ranking
Author: listingbureau

AI 어시스턴트를 통해 관리되는 아마존 제품 오가닉 랭킹 캠페인입니다.

랭킹 중심의 유일한 아마존 MCP 서버입니다. Claude, Cursor 또는 MCP 호환 클라이언트에서 랭킹 캠페인을 생성하고, 일정을 설정하며, 키워드 순위를 추적하고, 순위 변동을 모니터링하세요.

1,700개 이상의 제품을 첫 페이지에 올린 것과 동일한 인프라를 기반으로 구축되었습니다. 중앙값 소요 시간: 48일. 과거의 성과가 미래의 결과를 보장하지는 않습니다.

🚀 주요 기능

이 MCP 서버는 귀하의 AI 어시스턴트를 Listing Bureau의 아마존 랭킹 인프라에 연결합니다. 세 가지 신호 유형이 오가닉 랭킹 향상을 주도합니다:

Search-Find-Buy (SFB): 실제 쇼핑객이 키워드를 검색하고, 제품을 찾아 구매했다는 신호를 A10 알고리즘에 전달합니다.
Add-to-Cart (ATC): 전환 의도 및 구매 의도 신호를 구축합니다.
Page Views (PGV): 오가닉 발견을 지원하는 세션 수준의 브라우징 행동을 생성합니다.

귀하의 어시스턴트가 전체 워크플로우를 처리합니다: 모든 ASIN 및 키워드에 대한 프로젝트 생성, 일일 캠페인 일정 설정, 실행 전 비용 추정, 순위 변동 추적을 위한 보고서 추출.

📦 빠른 시작

Claude Desktop (원클릭)

데스크톱 확장 프로그램을 다운로드하고 더블 클릭하여 설치하세요. Claude Desktop이 API 키를 요청할 것입니다.

listingbureau-mcp.mcpb 다운로드 (Claude Desktop 4.0 이상 필요)

claude_desktop_config.json에 추가하세요:

{
  "mcpServers": {
    "listingbureau": {
      "command": "npx",
      "args": ["-y", "listingbureau-mcp"],
      "env": {
        "LB_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code

마켓플레이스에서 플러그인을 설치하세요:

/plugin install listingbureau@claude-plugins-official

이 작업은 MCP 서버와 캠페인 방법론 스킬을 함께 설치합니다. Claude Code를 시작하기 전에 셸 환경에서 LB_API_KEY를 설정하세요.

claude mcp add listingbureau -e LB_API_KEY=your-api-key -- npx -y listingbureau-mcp

Cursor

클릭 후, 대화 상자에서 your-api-key-here를 실제 API 키로 교체한 뒤 확인하세요.

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

{
  "mcpServers": {
    "listingbureau": {
      "command": "npx",
      "args": ["-y", "listingbureau-mcp"],
      "env": {
        "LB_API_KEY": "your-api-key-here"
      }
    }
  }
}

모든 MCP 클라이언트

npx를 통해 서버를 실행하고 stdio를 통해 연결되도록 클라이언트를 구성하세요:

npx -y listingbureau-mcp

LB_API_KEY를 환경 변수로 설정하세요. 클라이언트별 구성은 MCP 사양을 참조하세요.

🔑 API 키 받기

listingbureau.com에서 계정을 만드세요. API 키는 대시보드의 설정(Settings) 메뉴에서 확인할 수 있습니다.

⚙️ 환경 변수

변수	필수	기본값	설명
`LB_API_KEY`	예	-	Listing Bureau API 키
`LB_BASE_URL`	아니오	`https://listingbureau.com`	API 기본 URL (스테이징/개발용으로 재정의)

🔧 도구

7개 카테고리에 걸친 21개의 도구.

📂 프로젝트 (6개 도구)

도구	설명
`lb_projects_list`	지역/활성 필터를 사용하여 프로젝트 목록 조회
`lb_projects_create`	새 아마존 프로젝트 생성 (ASIN + 키워드 + 지역)
`lb_projects_get`	프로젝트 세부 정보 조회 (일정, 서비스, SERP 데이터)
`lb_projects_update`	프로젝트 업데이트 (일시 중지/재개)
`lb_projects_archive`	프로젝트 보관 (소프트 삭제)
`lb_projects_get_stats`	일일 통계 조회 (SFB, ATC, PGV, SERP, ARA, BR, SQR)

📅 일정 (3개 도구)

도구	설명
`lb_schedule_get`	현재 일일 일정 조회
`lb_schedule_set`	전체 일일 일정 설정 (기존 일정 대체)
`lb_schedule_quick_set`	일일 볼륨을 균일하게 빠르게 설정

💲 비용 추정 (1개 도구)

도구	설명
`lb_estimate_cost`	실행 전 캠페인 비용 추정. 총 비용, 일일 평균, 지갑 잔액 지속 가능성을 계산합니다.

💰 지갑 (3개 도구)

도구	설명
`lb_wallet_get_balance`	지갑 잔액 조회 (크레딧 및 USD)
`lb_wallet_get_transactions`	거래 내역 조회 (페이지네이션)
`lb_wallet_topup`	지갑 잔액 충전을 위한 Stripe 결제 URL 생성

📦 주문 (3개 도구)

도구	설명
`lb_orders_list`	주문 목록 조회 (페이지네이션, 최신순)
`lb_orders_get`	주문 세부 정보 조회
`lb_orders_report_issue`	주문 관련 문제 보고

👤 계정 (4개 도구)

도구	설명
`lb_account_get`	계정 정보 조회 (이메일, 이름, 계정 상태, 지갑 잔액)
`lb_account_update_profile`	프로필 필드 업데이트 (이름, 성, 회사)
`lb_account_get_service_rates`	현재 서비스 가격 요율 조회
`lb_account_get_subscription`	구독 정보 조회 (플랜, 요금, 할인)

💬 피드백 (1개 도구)

도구	설명
`lb_feedback_submit`	피드백, 기능 요청 또는 제안 제출 (10-5000자)

🧠 캠페인 방법론 스킬

이 MCP 서버는 9단계 캠페인 워크플로우를 안내하는 skills/amazon-product-ranking/의 보조 스킬과 함께 제공됩니다. 이 스킬은 AI에게 제품 평가, 경쟁 분석, 퍼널 프로필 선택, 램프업 일정, 비용/ROI 예측, 실행 및 모니터링 등 도구를 효과적으로 사용하는 방법을 가르칩니다.

Claude Code (플러그인): Claude Code 플러그인에는 이 스킬이 자동으로 포함되어 있습니다. /plugin install listingbureau@claude-plugins-official을 통해 설치하세요.

Claude Code (수동): skills/amazon-product-ranking/ 폴더를 .claude/skills/ 디렉토리에 복사하거나 심볼릭 링크를 생성하세요.

기타 플랫폼: 서버 지침은 자동으로 이 스킬을 참조합니다. AI는 지침에 포함된 GitHub 링크에서 방법론을 읽을 수 있습니다.

🛠️ 개발

npm install
npm run build
npm run dev    # watch mode
npm test

🔗 링크

📄 라이선스

MIT

Listing Bureau - Amazon Organic Ranking