使用说明

维护MCP服务器

一个模型上下文协议（MCP）服务器，通过更易于接近的对话界面，Claude可以访问Keepa的产品和销售数据。它简化了Keepa复杂的面向工程师的设计，使其更容易探索产品研究、销售趋势、库存信号和竞争分析，而无需掌握Keepa的原生UI。

✨ 核心能力

📊 高级销售速度和库存优化

🚀 销售速度分析：识别产生现金流的快速移动产品（20+单位/天）
📈 库存周转情报：避免占用资金的行动迟缓者（<5个单位/月）
⚠️ 缺货风险管理：自动重新订购警报和数量建议
📅 季节模式识别：第四季度假期、返校和季度需求分析
💰 现金流优化：以20-35天的库存水平为目标，实现最大的投资回报率

🔍 专业产品研究与发现

🎯 高级产品查找器：20多个过滤器，包括评级、价格、竞争和销售量
⭐ 市场机会评分：寻找高机会、低竞争的产品
📋 批次分析：同时处理多达100个ASIN进行投资组合分析
💡 集成分析：Statistics Object提供产品查找中包含的持续速度数据
🏆 竞争情报：卖家数量分析和市场饱和度评分

💎 交易发现和利润分析

💰 增强的交易发现：查找20%以上折扣和利润潜力评分的交易
⚡ 闪电交易监控：通过紧急警报跟踪时间敏感的交易
🎯 利润潜力计算器：自动利润率和投资回报率分析
🌟 Prime合格筛选：专注于高转化率的Prime产品

🏢 类别和市场情报

📊 综合类别分析：市场规模、竞争水平和品牌集中度
🎯 机会评分：市场进入机会的算法评分（0-100%）
📈 绩效基准测试：与任何类别中的顶尖表现者进行比较
💡 战略建议：人工智能生成的市场进入和优化策略

🛠️ 可用的MCP工具

💬 自然语言接口：只需向Claude提问，无需JSON或技术语法！Claude会根据您的请求自动使用这些工具。

🔍 核心产品智能

keepa_product_lookup -深入的产品分析，包括统计对象分析
keepa_batch_product_lookup -同时对多达100个ASIN进行投资组合分析
keepa_price_history -历史定价趋势和市场稳定性分析

🎯 高级市场发现

keepa_product_finder - 20+高级过滤器 寻找机会
keepa_category_analysis - 全面的市场情报 有机会得分
keepa_search_deals - 增强交易发现 利润潜力分析
keepa_best_sellers -类别排名和趋势产品识别

📊 销售速度和现金流优化

keepa_sales_velocity - 行业标准速度计算 用于库存周转
keepa_inventory_analysis - 投资组合管理 进行缺货风险评估

🏢 竞争情报

keepa_seller_lookup -卖方绩效分析和竞争研究

🪙 许可证管理

keepa_token_status -检查剩余的API令牌和帐户状态

先决条件

保留API密钥：注册地址： https://keepa.com/#！api
- Keepa需要基于代币定价的付费订阅
- 不同的端点具有不同的令牌成本
- 产品历史通话比基本产品信息更昂贵
Node.js：版本18或更高版本

安装

克隆或下载此存储库
导航到项目目录：
```
cd keepa_mcp
```
安装依赖项：
```
npm install
```
构建TypeScript代码：
```
npm run build
```
您将在Claude Desktop配置（下一节）中配置您的Keepa API密钥

配置

环境变量

MCP服务器接受这些环境变量（在Claude Desktop中配置）：

KEEPA_API_KEY （必需）：您的Keepa API密钥
KEEPA_RATE_LIMIT_DELAY （可选）：请求之间的延迟（毫秒）（默认值：1000）
KEEPA_TIMEOUT （可选）：请求超时（毫秒）（默认值：30000）

Claude桌面配置

位置:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
视窗: %APPDATA%/Claude/claude_desktop_config.json

备注：如果文件不存在，请创建它。某些安装可能有 config.json 相反，将其复制到正确的文件名：

cp ~/Library/Application\ Support/Claude/config.json ~/Library/Application\ Support/Claude/claude_desktop_config.json

添加到您的Claude桌面 claude_desktop_config.json:

{
  "mcpServers": {
    "keepa": {
      "command": "node",
      "args": ["/path/to/keepa_mcp/dist/index.js"],
      "env": {
        "KEEPA_API_KEY": "your_keepa_api_key_here"
      }
    }
  }
}

替换 /path/to/keepa_mcp 根据您的实际路径和 your_keepa_api_key_here 使用您的Keepa API密钥。

⚠️ 重要：对您的 claude_desktop_config.json 文件，您必须完全关闭Claude Desktop（macOS上的Cmd+Q或Windows上的Alt+F4），然后重新启动它才能使更改生效。

授予MCP服务器权限

当您首次启动配置了MCP服务器的Claude Desktop时，您将看到一个权限对话框。点击 “允许” 根据需要授予服务器访问权限：

您必须授予这些权限，Keepa工具才能正常显示和运行。

🔧 故障排除

如果MCP工具未出现在Claude Desktop中：

检查克劳德桌面版本：确保您运行的是0.7.0或更高版本（需要MCP支持）
- 点击“克劳德”菜单→ “关于克劳德”

验证配置文件的位置和格式:

# Check if file exists
ls -la ~/Library/Application\ Support/Claude/claude_desktop_config.json

# Validate JSON format
cat ~/Library/Application\ Support/Claude/claude_desktop_config.json

手动测试MCP服务器:

cd /path/to/keepa_mcp
npm run build
KEEPA_API_KEY=your_key_here node dist/index.js

完全重新启动：强制退出Claude Desktop（Cmd+Q）并重新启动

简化配置：尝试删除其他设置并使用最小配置：

{
  "mcpServers": {
    "keepa": {
      "command": "node",
      "args": ["/full/path/to/keepa_mcp/dist/index.js"],
      "env": {
        "KEEPA_API_KEY": "your_keepa_api_key_here"
      }
    }
  }
}

检查日志：在Claude Desktop控制台或系统日志中查找错误消息

常见问题：

文件路径错误：确保路径 dist/index.js 绝对正确
缺少构建：运行 npm run build 任何代码更改后
无效的JSON：使用JSON验证器检查配置文件语法
缺少API密钥：确保 KEEPA_API_KEY 在配置的env部分中设置

🚀 使用示例

✅ 验证MCP服务器连接

配置完所有内容并重新启动Claude Desktop后，您应该会看到您的Keepa工具可用：

Keepa MCP服务器为亚马逊市场情报、销售速度分析和库存管理提供了10个强大的工具。

如果您在Claude Desktop中看到这些工具，则表示您的MCP服务器已成功连接并准备就绪！

✅ 验证设置：配置后，向Claude提出以下任何问题以测试您的MCP服务器连接。

🎯 销售速度优化

寻找现金流冠军：

"Use Keepa to find products in Electronics that sell 50+ units daily with high inventory turnover"

避免现金流杀手：

"Show me slow-moving products in my category that tie up capital for 60+ days using Keepa"

投资组合健康检查：

"Analyze my current inventory for stockout risks and cash flow optimization using Keepa ASINs: [your ASINs]"

💎 市场机会发现

寻找高机会利基：

"Use Keepa to find low-competition products in Home & Kitchen with 4+ star ratings and 1000+ monthly sales"

类别市场情报：

"Analyze the Pet Supplies category for market opportunities, competition levels, and profit potential using Keepa"

竞争差距分析：

"Find products with high sales but fewer than 5 sellers in the Beauty category using Keepa"

🔥 交易搜寻和利润分析

高利润交易发现：

"Find current Amazon Lightning Deals with 30%+ discounts and high profit potential using Keepa"

主要交易情报：

"Show me Prime-exclusive deals under $100 with 4+ star ratings that could be profitable using Keepa"

📊 高级分析和预测

季节性规划：

"Analyze seasonal patterns for Holiday products and recommend inventory levels for Q4 using Keepa"

绩效基准：

"Compare my product's sales velocity against top performers in its category using Keepa ASIN: [your ASIN]"

市场趋势分析：

"Identify trending products in Electronics with accelerating sales velocity using Keepa"

🪙 令牌管理和监控

检查令牌状态：

"Check my Keepa token status"

监视器使用情况：

"How many Keepa tokens do I have left?"

🎯 输出示例

🔍 产品搜索结果

Perfect! I found exactly what you're looking for. Here are the top 5 Industrial & Scientific products that meet all your criteria (4.4-5.0 star rating, 4-5 sellers, 2000+ monthly sales), sorted by highest monthly sales:

Top 5 High-Volume Products:

1. 🏆 MedPride Nitrile Exam Gloves (Large) - B00GS8VGP6
• Monthly Sales: ~30,000 units 🔥
• Rating: 4.4-5.0 stars
• Sellers: 4 (medium competition)
• Product: Powder-free nitrile exam gloves, 100-pack

2. 🧴 Zep Industrial Sprayer Bottle - B08JSKYBKQ
• Monthly Sales: ~10,000 units
• Rating: 4.4-5.0 stars
• Sellers: 5 (medium competition)
• Product: 48oz sprayer with 30ft range, adjustable nozzle

3. 💍 BYASKZIV Ultrasonic Jewelry Cleaner - BOD7L961CR
• Monthly Sales: ~10,000 units
• Rating: 4.4-5.0 stars
• Sellers: 4 (medium competition)
• Product: 48KHz cleaner with dual modes, stainless steel tank

4. MedPride Nitrile Gloves (X-Large) - B00GS8VIKE
• Monthly Sales: ~10,000 units
• Rating: 4.4-5.0 stars
• Sellers: 4 (medium competition)
• Product: Powder-free nitrile exam gloves, 100-pack

5. MedPride Nitrile Gloves (Small) - B00GS8W2HC
• Monthly Sales: ~10,000 units
• Rating: 4.4-5.0 stars
• Sellers: 4 (medium competition)
• Product: Powder-free nitrile exam gloves, 100-pack

Key Insights:
• MedPride gloves dominate with the highest sales volume (30K monthly for Large size)
• Medical/safety products show strong consistent demand
• Medium competition level across all top products (4-5 sellers)
• Consumable products tend to have higher sales volumes

Would you like me to get more detailed information about any of these specific products, including price history or current pricing data?

📈 销售速度分析输出

✅ Electronics Portfolio Analysis Complete!

📊 Portfolio Overview:
- Total Products: 25
- Average Turnover Rate: 18.5 times/year
- Portfolio Health: Excellent - High velocity, low risk

📈 Performance Metrics:
- Average Velocity: 145.2 units/month
- Total Revenue Velocity: $2,847.33/day
- Average Days Inventory: 22 days

⚠️ Risk Assessment:
- High Risk Products: 2 (8%)
- Fast Movers (≥30/month): 76%
- Slow Movers (<10/month): 8%

💡 Strategic Recommendations:
🚀 Strong portfolio velocity - maintain current strategy
🟡 Monitor 2 products with stockout risks
📈 Focus marketing on accelerating trend products
🎯 Optimal inventory levels for maximum cash flow

🎯 市场机会发现输出

📊 Home & Kitchen Category Analysis:

🏷️ Market Overview:
- Category Size: 2.3M+ products
- Average Price: $34.67
- Competition Level: Medium
- Opportunity Score: 78%

💡 Key Insights:
• Budget-friendly category with high volume potential
• Quality improvement opportunities exist (avg 3.8★)  
• 15% of products have fewer than 5 sellers
• Growing trend toward eco-friendly products

🎯 Top Opportunities:
1. Kitchen gadgets $15-45 price range
2. Storage solutions with premium materials  
3. Smart home integration products
4. Seasonal/holiday-themed items

💰 Profit Potential: HIGH
🏆 Market Entry Difficulty: LOW-MEDIUM

🪙 令牌状态检查输出

🪙 Keepa API Token Status

💰 Tokens Remaining: 247

✅ Status: EXCELLENT - Plenty of tokens available
💡 Recommendation: Use advanced analytics freely

📊 Check detailed usage: https://keepa.com/#!api
⏰ Tokens refresh: According to your Keepa subscription plan

这些示例显示了您将从Keepa MCP服务器获得的专业市场情报水平。

📂 已验证的亚马逊类别ID

✅ 100%验证：所有35个类别ID都经过测试和验证，可以与Keepa API一起使用。项目取得圆满成功，品类覆盖全面。

主要类别（美国市场）

电子学: 172282 ✅
家居与厨房: 1055398 ✅
工业与科学: 16310091 ✅
汽车: 15684181 ✅
运动与户外: 3375251 ✅
工具和家居装修: 228013 ✅
健康与家居: 3760901 ✅
美容及个人护理: 3760911 ✅
服装、鞋类和珠宝: 7141123011 ✅
玩具和游戏: 165793011 ✅
宠物用品: 2619533011 ✅
办公用品: 1064954 ✅
婴儿用品: 165796011 ✅
杂货和美食: 16310101 ✅
工艺美术与缝纫: 2617941011 ✅
乐器: 11091801 ✅
庭院、草坪和花园: 2972638011 ✅
电子游戏: 468642 ✅
书籍: 283155 ✅
电影和电视: 2625373011 ✅

数字和专业类别

电器: 2619525011 ✅
应用程序和游戏: 2350149011 ✅
有声读物和原创作品: 18145289011 ✅
CD和乙烯基: 5174 ✅
手机及配件: 2335752011 ✅
收藏品与美术: 4991425011 ✅
信用卡和支付卡: 3561432011 ✅
数字音乐: 163856011 ✅
其他一切: 10272111 ✅
礼品卡: 2238192011 ✅
手工制品: 11260432011 ✅
商店: 133140011 ✅
奢侈品商店: 18981045011 ✅
杂志订阅: 599858 ✅
Prime视频: 2858778011 ✅
软件: 229534 ✅
视频短片: 9013971011 ✅

💡 专业提示：如果您使用无效的类别ID，MCP服务器会自动验证类别ID并建议替代方案。

🌍 多市场支持

亚马逊11个市场的全球情报：

🇺🇸 美国（亚马逊）- 违约和最全面
🇬🇧 英国（亚马逊网站）
🇩🇪 德国（amazon.de）
🇫🇷 法国（亚马逊。fr）
🇯🇵 日本（亚马逊）
🇨🇦 加拿大 （亚马逊）
🇮🇹 意大利 （亚马逊.it）
🇪🇸 西班牙 （亚马逊）
🇮🇳 印度（亚马逊.in）
🇲🇽 墨西哥 （amazon.com.mx）
🇨🇳 中国（亚马逊中国）

💬 使用简单：只需提及国家： “使用Keepa在德国亚马逊上查找优惠”

💰 代币使用和成本信息

Keepa API在基于令牌的系统上运行，每个API查询都会消耗您帐户中的令牌。不同的端点消耗不同数量的令牌，并在所有请求中跟踪您的使用情况。

📊 代币使用指南

产品查询：~1个令牌（包括统计对象数据，无需额外付费）
市场分析：~5-15个代币（取决于类别大小）
交易发现：约3-8个令牌（因过滤器而异）
速度分析：~2-5个代币（包括投资组合指标）

💡 成本优化功能

统计对象集成：产品查找中包括销售速度和库存分析（不需要额外的令牌）
智能批处理：在单个请求中处理多达100个ASIN，以最大限度地减少令牌使用
高效缓存：内置速率限制和请求优化

⚠️ 重要提示：代币耗尽行为

关键限制：当您的Keepa API代币耗尽（≤0）时，MCP服务器将失败并返回“未找到产品”消息，而不是有意义的数据。

发生了什么：

❌ 搜索返回空结果 （不是实际的空类别）
❌ 没有指示令牌耗尽的错误 （显示为搜索失败）
❌ 所有工具似乎都损坏了 直到令牌刷新

如何识别：

使用专用的令牌状态工具：询问Claude “检查我的Keepa令牌状态”
多个类别返回“未找到产品”
最近的工作搜索突然失败
搜索结果中的低令牌警告

解决：

等待令牌刷新 （每日或每月，具体取决于您的Keepa计划）
升级您的Keepa计划 获取更多代币
检查您的使用情况 在保持API仪表板

低令牌警告：当您剩余的令牌少于5个时，服务器会发出警告。

🔧 开发人员参考

👥 对于普通用户：跳过本节-用自然语言问克劳德问题！ 🛠️ 对于开发者：集成和定制的技术细节。

🛠️ 开发脚本

npm run build     # Build TypeScript to JavaScript  
npm run dev       # Development mode with auto-reload
npm start         # Start the built server
npm run lint      # Run ESLint
npm run type-check # Check TypeScript types

📚 技术文档

API类型：参见 types.ts 获取完整的TypeScript定义
MCP工具：参见 tools.ts 适用于所有10个具有Zod验证的工具实现
分析引擎：参见 keepa-client.ts 用于高级算法

🚀 通过3个步骤开始

1.获取您的Keepa API密钥

注册地址： https://keepa.com/#！api

2.配置克劳德桌面

增添 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "keepa": {
      "command": "node",
      "args": ["/path/to/keepa_mcp/dist/index.js"],
      "env": {
        "KEEPA_API_KEY": "your_keepa_api_key_here"
      }
    }
  }
}

3.问克劳德·斯马特问题

"Use Keepa to find fast-moving products in Electronics with high profit potential"

📞 支持和资源

🛠️ MCP服务器问题: 在GitHub上创建问题
📚 Keepa API问题: 保持支持
🔗 MCP协议: MCP官方文件

📄 许可证

MIT许可证-请参阅许可证文件以获取详细信息。