维护MCP服务器
一个模型上下文协议（MCP）服务器，通过更易于接近的对话界面，Claude可以访问Keepa的产品和销售数据。它简化了Keepa复杂的面向工程师的设计，使其更容易探索产品研究、销售趋势、库存信号和竞争分析，而无需掌握Keepa的原生UI。
✨ 核心能力
📊 高级销售速度和库存优化
- 🚀 销售速度分析：识别产生现金流的快速移动产品（20+单位/天）
- 📈 库存周转情报：避免占用资金的行动迟缓者（\ 💬 自然语言接口：只需向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 ( **💡 专业提示**：如果您使用无效的类别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仪表板](https://keepa.com/#!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](src/types.ts) 获取完整的TypeScript定义
- **MCP工具**：参见 [tools.ts](src/tools.ts) 适用于所有10个具有Zod验证的工具实现
- **分析引擎**：参见 [keepa-client.ts](src/keepa-client.ts) 用于高级算法
______________________________________________________________________
## 🚀 **通过3个步骤开始**
### **1.获取您的Keepa API密钥**
注册地址： [https://keepa.com/#！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服务器问题**:
- **📚 Keepa API问题**: [保持支持](https://keepa.com/#!api)
- **🔗 MCP协议**: [MCP官方文件](https://modelcontextprotocol.io/)
______________________________________________________________________
## 📄 **许可证**
MIT许可证-请参阅 [许可证](LICENSE) 文件以获取详细信息。
______________________________________________________________________
**🚀 准备好转变您的亚马逊市场情报了吗？今天就开始吧！**