{"skill":{"slug":"keepa-api","displayName":"Keepa Api","summary":"Keepa API 客户端 - 亚马逊产品价格历史追踪工具。提供 ASIN 查询、价格历史等数据查询功能。","description":"---\nname: keepa-api\ndescription: Keepa API 客户端 - 亚马逊产品价格历史追踪工具。提供 ASIN 查询、价格历史等数据查询功能。\nmetadata:\n  version: 1.0.0\n  dependencies:\n    - curl\n    - jq\n---\n\n# Keepa API 客户端\n\n基于 Keepa API 的亚马逊产品价格历史追踪工具。\n\n## 依赖\n\n- curl (HTTP 请求)\n- jq (JSON 解析)\n\n安装依赖:\n```bash\n# macOS\nbrew install curl jq\n\n# Ubuntu/Debian\napt-get install curl jq\n```\n\n## Usage\n\n```bash\n# ASIN 查询 - 获取产品详情和价格历史\n/keepa-api asin B08XYZ123\n\n# 批量 ASIN 查询\n/keepa-api batch-asin B08XYZ123,B09ABC456,B07DEF789\n\n# 查询价格历史\n/keepa-api price-history B08XYZ123 --days 90\n\n# 关键词搜索产品\n/keepa-api search \"wireless earbuds\" --category Electronics\n\n# 查询 Best Sellers\n/keepa-api bestsellers --category Electronics --page 1\n\n# 指定亚马逊站点\n/keepa-api asin B08XYZ123 --domain JP\n\n# 直接输入 ASIN\n/keepa-api\n[paste ASIN or product URL]\n```\n\n## Options\n\n| Option | Description |\n|--------|-------------|\n| `--domain <US\\|UK\\|DE\\|...>` | 亚马逊站点 (默认：US) |\n| `--days <number>` | 历史数据天数：30, 90, 180 (默认：90) |\n| `--category <name>` | 商品类目 (Electronics, Home, Beauty 等) |\n| `--output <table\\|json>` | 输出格式 (默认：table) |\n| `--page <number>` | 分页页码 (用于搜索和 Best Sellers) |\n\n## Core Tools\n\n### 1. Product Query (产品查询)\n\n查询单个 ASIN 的详细信息，包括价格历史、销售排名、评论等。\n\n```bash\n/keepa-api asin <ASIN> [--marketplace US] [--days 90]\n```\n\n**返回数据**:\n- 产品基础信息 (标题、品牌、类目、图片)\n- 当前价格 (Amazon 价格、第三方价格)\n- 价格历史记录\n- 销售排名 (BSR)\n- 评论数量和评分\n- 库存状态\n\n### 2. Price History (价格历史)\n\n获取产品历史价格数据，支持自定义时间范围。\n\n```bash\n/keepa-api price-history <ASIN> [--days 30|90|180|365]\n```\n\n**返回数据**:\n- 每日价格点\n- 价格变化时间线\n- 历史最低价/最高价\n- 平均价格\n\n### 3. Sales Rank History (销售排名历史)\n\n追踪产品销售排名变化趋势，与 asin 命令一起返回。\n\n```bash\n/keepa-api asin <ASIN> --days 90\n```\n\n**返回数据**:\n- 每日 BSR 排名\n- 排名变化趋势\n- 类目前 100 记录\n\n### 4. Product Search (产品搜索)\n\n通过关键词搜索亚马逊产品。\n\n```bash\n/keepa-api search \"<keyword>\" [--category <category>] [--page <n>]\n```\n\n**返回数据**:\n- 匹配产品列表\n- ASIN、标题、价格\n- 评分和评论数\n- 图片链接\n\n### 5. Best Sellers (热销榜)\n\n获取类目热销榜产品。\n\n```bash\n/keepa-api bestsellers --category <category> [--page <n>]\n```\n\n**返回数据**:\n- 热销产品排名\n- 产品 ASIN 和信息\n- 当前价格\n\n## Three Dimensions\n\n| Dimension | Controls | Options |\n|-----------|----------|---------|\n| **Data Type** | 数据类型 | product, price, rank, offers, search |\n| **Marketplace** | 亚马逊站点 | US, EU, UK, JP, CA, AU, IN |\n| **Output Format** | 数据输出格式 | table, json |\n\n## Marketplace Reference\n\n| Marketplace | Code | Domain |\n|-------------|------|--------|\n| 美国 | US | amazon.com |\n| 英国 | UK | amazon.co.uk |\n| 德国 | DE | amazon.de |\n| 法国 | FR | amazon.fr |\n| 日本 | JP | amazon.co.jp |\n| 加拿大 | CA | amazon.ca |\n| 澳大利亚 | AU | amazon.com.au |\n| 印度 | IN | amazon.in |\n\n## Workflow\n\n### Progress Checklist\n\n```\nKeepa API Query Progress:\n- [ ] Step 0: Check API configuration ⛔ BLOCKING\n- [ ] Step 1: Understand data requirement\n- [ ] Step 2: Confirm query parameters ⚠️ REQUIRED\n- [ ] Step 3: Execute API request\n- [ ] Step 4: Parse and display results\n```\n\n### Flow\n\n```\nInput → [Step 0: Config Check] ─┬─ Configured → Continue\n                                │\n                                └─ Not configured → Setup required ⛔ BLOCKING\n                                                   │\n                                                   └─ Complete setup → Save config → Continue\n```\n\n### Step 0: Configuration Check ⛔ BLOCKING\n\n**Purpose**: Check Keepa API configuration.\n\n**Configuration paths**:\n1. Project-level: `.teamclaw-skills/keepa-api/CONFIG.md`\n2. User-level: `~/.teamclaw-skills/keepa-api/CONFIG.md`\n\n**Check command**:\n```bash\n# Check project-level first\ntest -f .teamclaw-skills/keepa-api/CONFIG.md && echo \"project\"\n\n# Then user-level\ntest -f \"$HOME/.teamclaw-skills/keepa-api/CONFIG.md\" && echo \"user\"\n```\n\n**First-Time Setup** (if config not found):\n\nUse `AskUserQuestion` with questions:\n\n1. **Keepa API Key** (required):\n   - Input your Keepa API key\n   - Get key from: https://keepa.com/#!api\n\n2. **Default marketplace**:\n   - US (amazon.com)\n   - UK (amazon.co.uk)\n   - DE (amazon.de)\n   - JP (amazon.co.jp)\n   - Other\n\n3. **Default history days**:\n   - 30 days\n   - 90 days (default)\n   - 180 days\n   - 365 days\n\n4. **Output format**:\n   - Table (default, readable)\n   - JSON (for integration)\n\n**Configuration file format** (`CONFIG.md`):\n```yaml\n---\napi_key: your-keepa-api-key-here\nmarketplace: US\ndefault_days: 90\noutput_format: table\n---\n```\n\n### Step 1: Understand Data Requirement\n\n**Analyze user request**:\n- Data type needed (product/price/rank/offers/search)\n- Target ASIN(s) or keyword(s)\n- Marketplace\n- Time period\n\n### Step 2: Confirm Query Parameters ⚠️\n\n**Display confirmation**:\n- Query type\n- Target (ASIN/keyword)\n- Marketplace\n- Days range\n- Output format\n\n### Step 3: Execute API Request\n\n**Execute curl request**:\n```bash\ncurl -s \"https://api.keepa.com/product?key=$API_KEY&domain=$DOMAIN&asin=$ASIN\"\n```\n\n### Step 4: Parse and Display Results\n\n**Output format**:\n```\n═══ Keepa Product Report ═══\n\nASIN: B08XYZ123\nTitle: [Product Title]\nBrand: [Brand Name]\nCategory: [Category]\n\nCurrent Price:\n- Amazon: $29.99\n- 3rd Party New: $27.99\n- 3rd Party Used: $22.99\n\nSales Rank: #1,234 in Electronics\nRating: 4.5/5 (2,847 reviews)\n\nPrice History (90 days):\n- Lowest: $24.99 (2024-01-15)\n- Highest: $34.99 (2024-02-01)\n- Average: $29.50\n```\n\n## API Endpoints\n\n### Product Endpoint\n\n```\nGET /product\nParameters:\n- key: API key\n- domain: Amazon domain (1=US, 3=UK, 4=DE, 5=FR, 6=JP, 7=CA, 9=AU, 10=IN)\n- asin: ASIN or comma-separated list\n- history: Include price history (1/0)\n- rating: Include rating (1/0)\n```\n\n### Search Endpoint\n\n```\nGET /search\nParameters:\n- key: API key\n- domain: Amazon domain\n- query: Search query\n- category: Category ID (optional)\n- page: Page number (optional)\n```\n\n### Best Sellers Endpoint\n\n```\nGET /bestsellers\nParameters:\n- key: API key\n- domain: Amazon domain\n- categoryId: Category ID\n- page: Page number (optional)\n```\n\n## Category IDs\n\n| Category | ID |\n|----------|-----|\n| Electronics | 172282 |\n| Computers | 541966 |\n| Home & Kitchen | 1055398 |\n| Beauty & Personal Care | 3760911 |\n| Sports & Outdoors | 3375251 |\n| Toys & Games | 165793011 |\n| Clothing | 7141123011 |\n| Books | 283155 |\n| Office Products | 1064954 |\n| Garden & Outdoor | 2972638011 |\n\n## File Structure\n\n```\nskills/keepa-api/\n├── SKILL.md                 # Skill 定义\n├── scripts/\n│   └── keepa.sh             # 主脚本 (纯 curl 实现)\n├── references/\n│   └── api-docs.md          # API 文档参考\n└── CONFIG.template.md       # 配置文件模板\n```\n\n## Configuration\n\n### Get API Key\n\n1. Visit [Keepa API](https://keepa.com/#!api)\n2. Register or login\n3. Go to Account → API Key\n4. Copy your API key\n\n### Rate Limits\n\n| Plan | Tokens/Day | Cost per Request |\n|------|------------|------------------|\n| Free | 100 | 1-2 tokens |\n| Basic (9€/mo) | 100,000 | 1-2 tokens |\n| Pro (19€/mo) | 500,000 | 1-2 tokens |\n| Ultra (49€/mo) | 2,000,000 | 1-2 tokens |\n\n### Token Costs\n\n| Request Type | Token Cost |\n|--------------|------------|\n| Product (single ASIN) | 1-2 tokens |\n| Product (batch 10 ASINs) | 10-20 tokens |\n| Search | 1 token |\n| Best Sellers | 1 token |\n| Offers | 1-3 tokens |\n\n## Output Examples\n\n### Product Query Result\n\n```\n═══ Keepa Product Report ═══\n\nASIN: B08XYZ123\nTitle: Wireless Bluetooth Earbuds\nBrand: SoundTech\nCategory: Electronics > Headphones\n\nCurrent Price:\n- Amazon: $29.99\n- 3rd Party New: $27.99\n- 3rd Party Used: $22.99\n- Lowest in 30 days: $24.99\n\nSales Rank: #1,234 in Electronics (#45 in Earbud Headphones)\nRating: 4.5/5 (2,847 reviews)\n\nPrice History (90 days):\n┌──────────────┬────────────┐\n│ Date         │ Price      │\n├──────────────┼────────────┤\n│ 2024-01-15   │ $24.99 (Low)│\n│ 2024-02-01   │ $34.99 (High)│\n│ Current      │ $29.99     │\n└──────────────┴────────────┘\n\nRecommendation: Price is near average. Wait for deal if not urgent.\n```\n\n### Search Result\n\n```\n═══ Search Results: \"wireless earbuds\" ═══\n\nPage 1 of 5 (48 results)\n\n#1  B08XYZ123  Wireless Earbuds Pro    $29.99  ★★★★☆ (2,847)\n#2  B09ABC456  Bluetooth Earbuds Sport $24.99  ★★★★☆ (1,523)\n#3  B07DEF789  True Wireless Earbuds   $39.99  ★★★★★ (987)\n...\n```\n\n## Best Practices\n\n### 数据准确性\n- 价格数据每 15 分钟更新\n- 销售排名每小时更新\n- 历史数据最多保留 2 年\n\n### API 优化\n- 批量查询 ASIN 节省 tokens\n- 仅请求需要的字段\n- 缓存常用查询结果\n\n### 价格追踪\n- 设置价格提醒\n- 关注历史低价\n- 比较多个卖家\n\n## Troubleshooting\n\n| Issue | Solution |\n|-------|----------|\n| Invalid API Key | Verify key in Keepa dashboard |\n| Token limit exceeded | Wait for daily reset or upgrade plan |\n| Product not found | Check ASIN and marketplace |\n| Rate limit | Slow down requests |\n\n## References\n\n- [Keepa API Documentation](https://keepa.com/#!api)\n- [Category Tree](https://keepa.com/#!category)\n- [API Examples](https://github.com/keepacom/api)\n\n## Notes\n\n- 需要有效的 Keepa API key\n- 免费账户每日 100 tokens\n- 数据更新频率：15 分钟\n- 支持 8 个亚马逊站点\n","tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":832,"installsAllTime":31,"installsCurrent":0,"stars":1,"versions":1},"createdAt":1772452008294,"updatedAt":1778994517803},"latestVersion":{"version":"1.0.0","createdAt":1772452008294,"changelog":"Initial release of keepa-api: an Amazon price history tracking tool using the Keepa API.\n\n- Provides ASIN-based product queries, price history, sales rank, search, and best seller listings.\n- Supports multiple Amazon marketplaces and customizable query parameters (domain, days, category, output format, etc).\n- Requires curl and jq as dependencies.\n- Guides users through API key/setup and configuration on first use.\n- Clear workflow steps for API config, query confirmation, execution, and result display.","license":null},"metadata":null,"owner":{"handle":"boyd4y","userId":"s1757rnrfs9d1em0chtwvhk16x83mtxg","displayName":"Yang Jun","image":"https://avatars.githubusercontent.com/u/815438?v=4"},"moderation":null}