APIClaw — Amazon Data API for AI Agents
공식실시간 아마존 데이터 API로, AI 에이전트를 위해 구축되었습니다. 2억 개 이상의 제품, 10억 개 이상의 리뷰, 실시간 BSR, 가격 및 경쟁사 데이터를 깔끔한 JSON으로 제공합니다. 시장 조사, 경쟁사 모니터링, 가격 책정, 리스팅 감사 등을 위한 10가지 에이전트 스킬. 1,000개의 무료 크레딧.
APIClaw — Amazon Data API For AI Agents MCP(으)로 무엇을 할 수 있나요?
- 경쟁 구도 분석 — 어시스턴트에게
amazon-competitor-intelligence-monitor/를 사용하여 키워드 또는 ASIN에 대한 경쟁사 분석을 요청하고, 경쟁사 매트릭스, 브랜드 순위, 단계별 알림을 받아보세요. - 시장 기회 발굴 — 어시스턴트가
amazon-market-analysis/로 시장 진입 조건을 평가하고 카테고리 변화를 추적하여, 제품 후보 목록과 진입 평가를 제공하도록 하세요. - 리스팅 건강 감사 —
amazon-listing-audit-pro/를 통해 8개 차원의 리스팅 점수카드와 우선 수정 사항, 키워드 격차를 확인하고, 실행 가능한 재작성 제안도 받아보세요. - 가격 신호 추천 —
amazon-pricing-command-center/를 사용하여 ASIN 입력만으로 가격대 히트맵과 BuyBox 분석을 포함한 RAISE/HOLD/LOWER 신호를 요청하세요. - 소비자 리뷰 인사이트 —
amazon-review-intelligence-extractor/로 11개 차원에 걸쳐 사전 분석된 10억 개 이상의 리뷰에서 불만 사항, 구매 요인, 사용 패턴을 추출하세요. - 일일 시장 모니터링 —
amazon-daily-market-radar/를 사용하여 가격 변동, 신규 경쟁사, BSR 변동, 리뷰 급증에 대한 자동 알림을 설정하고, RED/YELLOW/GREEN 신호를 받아보세요.
문서
ZooData Skills
에이전트를 위해 구축된 데이터 인프라.
현재 2억 개 이상의 제품, 10억 개 이상의 리뷰, 실시간 신호로 Amazon 커머스를 지원합니다.
웹사이트 • API 키 받기 • Discord • 빠른 시작 • API 참조
ZooData란 무엇인가요?
ZooData는 에이전트를 위해 구축된 데이터 인프라입니다. 스크래핑 API도, 인간용 대시보드도 아닙니다. AI 에이전트에게 Amazon 커머스 신호에 대한 직접적인 접근을 제공하는 특수 목적의 데이터 레이어입니다 — 2억 개 이상의 인덱싱된 제품, 2년 이상의 이력, 구조화된 인사이트로 사전 처리된 10억 개 이상의 리뷰. 깨끗한 JSON, 실시간, 에이전트 준비 완료.
https://github.com/user-attachments/assets/305a161b-7a53-49b8-afdc-4469a4fbf361
스킬 개요
이 저장소에는 두 가지 계층으로 구성된 10개의 에이전트 스킬이 포함되어 있습니다:
🏗️ 기초 — 데이터 접근 및 전체 스펙트럼 분석:
| 스킬 | 기능 | 입력 | 출력 | 주요 장점 |
|---|---|---|---|---|
📦 zoodata/ | 25개의 Amazon 커머스 및 키워드 인텔리전스 엔드포인트에 대한 직접 접근 | 키워드, 카테고리, ASIN 또는 브랜드 | 필드 매핑 및 특이사항 문서화가 포함된 원시 API 데이터 | 완전한 API 참조 — 다른 모든 스킬이 이를 기반으로 구축됨 |
🎯 amazon-analysis/ | 13가지 내장 선택 모드 + 시장 조사, 경쟁사 분석, ASIN 평가, 가격 책정, 카테고리 조사 | 키워드/카테고리/ASIN + 의도 | 분석 결과, 상위 제품, ASIN 심층 분석, 신뢰도 태그가 지정된 인사이트 | 복합 명령(report, opportunity)이 한 번에 다중 엔드포인트 파이프라인 실행 |
🔎 amazon-keyword-traffic-analysis/ | 11개의 키워드 인텔리전스 엔드포인트를 기반으로 한 키워드 가치 및 제품 트래픽 상태 워크플로우 | 시드 키워드, 대상 키워드, ASIN 또는 ASIN + 키워드 | 확장 계층, 키워드 가치 분석, 제품 트래픽 구조, 추세 및 상태 진단 | 키워드 확장, 키워드 분석 및 제품 트래픽 분석을 위한 전용 흐름 |
📊 amazon-market-analysis/ | 시장 및 제품 후보 발견, 진입 조건 평가, 카테고리 변화 추적 | 시장 질문, 카테고리 또는 제품 기회 브리핑 | 관찰된 후보 목록, 조건부 진입 평가 또는 제한된 추세 분석 | 별도의 증거와 판매자 결정 경계가 있는 하나의 연결된 스토리 |
⚡ 특수 목적 — 특정 워크플로우를 위해 설계됨:
| 스킬 | 기능 | 입력 | 출력 | 주요 장점 |
|---|---|---|---|---|
⚔️ amazon-competitor-intelligence-monitor/ | 심층 경쟁사 인텔리전스 — 계층형 알림이 포함된 전체 스캔 또는 빠른 확인 | 키워드 또는 ASIN(들), 선택적으로 내 ASIN + 경쟁사 ASIN | 경쟁사 매트릭스, 브랜드 순위, 가격 맵, 30일 추세, 점수(1-100), 계층형 알림 | 이중 모드(전체 ~28-35 크레딧, 빠른 ~5-10) 및 3계층 알림 시스템 |
📡 amazon-daily-market-radar/ | 자동 일일 모니터링 — 가격 변동, 신규 경쟁사, BSR 변동, 리뷰 급증 | 내 ASIN(1-10) + 키워드 | RED/YELLOW/GREEN 알림, KPI 대시보드, 경쟁사 변동, 실행 항목 | 신호 검증(7일 이상 추세 vs 단일일 급증)으로 설정 후 방치 |
✅ amazon-listing-audit-pro/ | 최적화 권장 사항이 포함된 8차원 리스팅 상태 점검 | 내 ASIN + 키워드 | 점수(X/100, A-F), 8차원 점수 카드, 키워드 격차, 우선 수정 목록 | 고빈도 리뷰 언어를 사용한 실행 가능한 재작성; 대량 감사 지원 |
💰 amazon-pricing-command-center/ | 데이터 기반 가격 신호 — 리프 카테고리 자동 감지, 가격 환경 분석 | 하나 이상의 ASIN | RAISE/HOLD/LOWER 신호, 가격대 히트맵, 경쟁사 가격 맵, BuyBox 분석 | ASIN 전용 입력(키워드 불필요), 판매/경쟁 비율 |
💬 amazon-review-intelligence-extractor/ | 11개 차원에 걸친 10억 개 이상의 사전 분석 리뷰에서 얻은 심층 소비자 인사이트 | 단일 ASIN, 여러 ASIN 또는 카테고리 키워드 | 불만 사항, 구매 요인, 사용자 프로필, 사용 패턴, 차별화 로드맵 | 10억 개 이상의 사전 분석 리뷰(95% 토큰 절약), 11개 차원 |
🌐 web-extract/ | 공개 웹 페이지 및 검색 결과에서 구조화된 데이터 추출 | URL, 검색 쿼리 또는 사이트 | 구조화된 JSON 또는 페이지 콘텐츠 | 렌더링된 페이지 및 제한된 사이트 크롤링 처리 |
amazon-market-analysis는 통합 시장 스킬입니다. 이전 amazon-market-entry-analyzer, amazon-market-trend-scanner 및 amazon-opportunity-discoverer 디렉토리는 폐기된 소스로만 유지됩니다. 해당 진입점은 RETIRED.md로 명명되어 스킬 설치 프로그램과 게시자가 이를 발견하지 못합니다.
빠른 시작
1. 스킬 설치
npx skills add SerendipityOneInc/ZooData-Skills
설치할 스킬을 선택하라는 메시지가 표시됩니다:
🏗️ 기초:
- ZooData — 25 Amazon 커머스 및 키워드 인텔리전스 엔드포인트
- Amazon 분석 — 전체 스펙트럼 조사 및 판매자 인텔리전스
- Amazon 키워드 인텔리전스 — 확장, 역방향 ASIN 및 모니터링
- Amazon 시장 분석 — 발견, 진입 및 변화
⚡ 특수 목적:
- Amazon 경쟁사 인텔리전스 모니터 — 계층형 알림이 포함된 이중 모드 경쟁 인텔리전스
- Amazon 일일 시장 레이더 — 자동 모니터링 및 알림
- Amazon 리스팅 감사 프로 — 8차원 상태 점검
- Amazon 가격 명령 센터 — RAISE/HOLD/LOWER 신호
- Amazon 리뷰 인텔리전스 추출기 — 10억 개 이상의 리뷰에서 얻은 소비자 인사이트
- 웹 추출 — 구조화된 공개 웹 데이터 추출
또는 수동으로 클론:
git clone https://github.com/SerendipityOneInc/ZooData-Skills.git
2. API 키 설정
export ZOODATA_API_KEY='hms_live_xxx' # Get yours free at zoodata.ai/en/api-keys
🎁 무료 티어: 가입 시 1,000 크레딧. 1 크레딧 = 1 API 호출. 신용 카드 불필요.
3. 사용해 보기
AI 에이전트에게 물어보세요:
"Amazon US에서 50달러 미만 무선 이어버드의 경쟁 환경을 분석해 주세요"
또는 CLI를 직접 사용:
python amazon-analysis/scripts/zoodata.py products --keyword "wireless earbuds" --mode fast-movers
API 엔드포인트
기본 URL: https://api.zoodata.ai/openapi/v2
인증: Authorization: Bearer $ZOODATA_API_KEY
메서드: 모든 엔드포인트는 JSON 본문과 함께 POST 사용
| 엔드포인트 | 설명 | 예시 사용 사례 |
|---|---|---|
🔍 products/search | 20개 이상의 필터가 있는 제품 검색(CLI를 통한 13가지 사전 설정 모드) | "4성 이상, 80달러 미만 러닝화 찾기" |
📊 markets/search | 카테고리 발견 및 정확한 스냅샷 — 규모, 집중도, 선택된 상위 100개 가격 | "요가 매트 시장의 경쟁 수준은?" |
🧩 markets/structure-profile | 브랜드, 가격 및 기타 상위 100개 분포 | "어떤 가격대가 판매를 차지하나요?" |
📅 markets/history | 사용 가능한 월말 카테고리 시장 추세 | "이 카테고리는 월별로 어떻게 변했나요?" |
🏷️ products/competitors | 키워드, 브랜드 또는 ASIN별 경쟁사 발견 | "이 틈새 시장의 상위 판매자는 누구인가요?" |
⚡ realtime/product | 실시간 제품 세부 정보 — 리뷰, 기능, 변형 | "ASIN B0D5CRV4KL의 현재 세부 정보 가져오기" |
💬 reviews/analysis | AI 기반 리뷰 인사이트 — 감정, 불만 사항 | "고객이 이 제품에 대해 좋아하는/싫어하는 점은?" |
📁 categories | Amazon 카테고리 트리 탐색 | "전자제품 아래 하위 카테고리 표시" |
📈 products/price-band-overview | 최적 기회 밴드가 포함된 가격대 요약 | "요가 매트의 최적 가격대는?" |
📊 products/price-band-detail | 전체 5밴드 가격 분포 분석 | "무선 이어버드의 상세 가격대 분석 표시" |
🏢 products/brand-overview | 상위 브랜드 집중도 지표(CR10) | "브랜드 환경의 집중도는?" |
🏷️ products/brand-detail | 상위 제품이 포함된 브랜드별 분석 | "이 카테고리에서 어떤 브랜드가 지배하나요?" |
📅 products/history | ASIN에 대한 과거 일일 스냅샷 | "이 ASIN의 가격 및 BSR 이력 표시" |
13가지 제품 검색 모드
스킬 CLI(zoodata.py --mode)는 다양한 조사 전략을 위한 13가지 사전 설정 모드를 제공합니다. 모드는 클라이언트 측에서 구체적인 필터 필드(monthlySalesMin, salesGrowthRateMin, …)로 확장됩니다 — mode는 API 매개변수가 아니며, 이를 /openapi/v2/products/search에 보내면 422가 반환됩니다:
| 모드 | 전략 | 대상 |
|---|---|---|
fast-movers | 높은 판매 속도 | 빠른 수익 |
emerging | 상승 추세, 낮은 포화도 | 선발 주자 |
long-tail | 틈새 키워드, 안정적 수요 | 지속 가능한 수입 |
underserved | 높은 수요, 적은 판매자 | 시장 공백 |
new-release | 최근 출시 제품 | 트렌드 아이템 |
fbm-friendly | 판매자 위탁 이행에 적합 | 저투자 시작 |
low-price | 예산 친화적 제품 | 볼륨 전략 |
single-variant | 단순 리스팅, 변형 없음 | 쉬운 관리 |
high-demand-low-barrier | 높은 판매, 낮은 리뷰 장벽 | 확장 가능한 진입 |
broad-catalog | 광범위한 제품 범위 분석 | 카테고리 개요 |
selective-catalog | 선별된 고품질 선택 | 프리미엄 선택 |
speculative | 고위험, 고수익 기회 | 공격적 전략 |
top-bsr | 베스트 셀러 순위 선두 | 시장 리더 |
프로젝트 구조
├── zoodata/ # Data layer skill (lightweight)
│ ├── SKILL.md # 25 Amazon and keyword endpoints, quick start
│ └── references/
│ └── openapi-reference.md # API field reference
│
├── amazon-analysis/ # Deep analysis skill
│ ├── SKILL.md # Intent routing, workflows, evaluation criteria
│ ├── references/
│ │ ├── reference.md # Full API reference
│ │ ├── execution-guide.md # Step-by-step execution playbook
│ │ ├── scenarios-composite.md # Comprehensive recommendations
│ │ ├── scenarios-eval.md # Product evaluation, risk, reviews
│ │ ├── scenarios-pricing.md # Pricing strategy
│ │ ├── scenarios-ops.md # Market monitoring, alerts
│ │ ├── scenarios-expand.md # Expansion, trends
│ │ └── scenarios-listing.md # Listing writing, optimization
│ └── scripts/
│ └── zoodata.py # CLI — 8 subcommands, 13 preset modes
│
├── amazon-keyword-traffic-analysis/ # Keyword intelligence & traffic analysis
│ ├── SKILL.md
│ ├── README.md
│ └── references/
│ ├── reference.md # Keyword endpoint reference
│ ├── execution-guide.md # Execution and monitoring rules
│ ├── scenarios-expand.md # Keyword expansion
│ ├── scenarios-keyword-analysis.md # Keyword value and trend analysis
│ └── scenarios-product-traffic-analysis.md # Product traffic health analysis
│
├── amazon-competitor-intelligence-monitor/ # Competitor intelligence & monitoring
│ ├── SKILL.md
│ ├── references/
│ │ └── reference.md
│ └── scripts/
│ └── zoodata.py
│
├── amazon-daily-market-radar/ # Daily market pulse & anomaly detection
│ ├── SKILL.md
│ ├── references/
│ │ └── reference.md
│ └── scripts/
│ └── zoodata.py
│
├── amazon-listing-audit-pro/ # Listing quality audit & optimization
│ ├── SKILL.md
│ ├── references/
│ │ └── reference.md
│ └── scripts/
│ └── zoodata.py
│
├── amazon-market-analysis/ # Market discovery, entry assessment & change
│ ├── SKILL.md
│ ├── references/
│ │ └── reference.md
│ └── scripts/
│ └── zoodata.py
│
├── amazon-pricing-command-center/ # Pricing strategy & competitive signals
│ ├── SKILL.md
│ ├── references/
│ │ └── reference.md
│ └── scripts/
│ └── zoodata.py
│
├── amazon-review-intelligence-extractor/ # Review intelligence & insight extraction
│ ├── SKILL.md
│ ├── references/
│ │ └── reference.md
│ └── scripts/
│ └── zoodata.py
│
├── web-extract/ # Structured public web extraction
│ ├── SKILL.md
│ └── scripts/
│ └── webtools.py
│
├── scoring-methodology.md # Unified quality scoring framework
├── CHANGELOG.md
└── README.md
요구 사항
- Python 3.8+ (표준 라이브러리만, pip 의존성 없음)
- ZooData API 키 (무료로 받기)
기여
기여를 환영합니다! 지침은 CONTRIBUTING.md를 참조하세요.