Puch AI MCP服务器价格比较
该MCP服务器允许Puch使用单个上游数据源(通过Serper API的Google Shopping)在一组严格的源之间比较产品价格。
支持的来源:
- 亚马逊
- Blinkkit
- 泽普托
- Swiggy Instamart
- JioMart杂货店
- 大篮子
所有结果均来自通过Serper API查询的谷歌购物数据。其他网站的结果被忽略。
🚀 特性
工具
- 价格比较 --在亚马逊、Blinkit、Zepto、Swiggy Instamart、JioMart Grocery和BigBasket上搜索特定产品的价格。返回产品标题、数量(如果检测到)、价格、可用的交货信息、平台和直接链接。如果要求特定尺寸(例如750ml),则结果仅限于该尺寸;否则,该工具会过滤掉明显的变体风格,并更喜欢最常见的尺寸。
- 价格搜索 --别名
price_comparison.
数据源和过滤
- 数据来源:谷歌购物通过Serper API
- 仅返回以下来源:亚马逊、Blinkit、Zepto、Swiggy Instamart
- 如果没有找到上述来源,服务器会响应:“我们在在线快速商务网站上找不到所请求的产品。”
🛠️ 安装说明
先决条件
- Python 3.11或更高版本
- Puch AI账号
- 您的WhatsApp号码
步骤1:安装依赖项
# Navigate to the price comparison directory
cd PuchAI-price-comparison
# Install required packages
pip install -r requirements.txt步骤2:配置环境
创建一个 .env 文件在 PuchAI-price-comparison 目录:
AUTH_TOKEN=your_secret_token_here
MY_NUMBER=919876543210
SERPER_API_KEY=your_serper_api_key重要提示:
AUTH_TOKEN:您用于身份验证的秘密令牌(请确保其安全!)MY_NUMBER:您的WhatsApp号码格式{country_code}{number}(例如。,919876543210致电+91-9876543210)
步骤3:运行服务器
python mcp_price_comparison.py您将看到: 🚀 Starting Price Comparison MCP server on http://0.0.0.0:8086
第四步:公开(Puch要求)
由于Puch需要通过HTTPS访问您的服务器,因此您需要公开您的本地服务器:
选项A:使用ngrok(建议用于开发)
- 安装ngrok:
下载自https://ngrok.com/download
- 获取您的authtoken:
- 首选https://dashboard.ngrok.com/get-started/your-authtoken - 复制您的authtoken - 运行: ngrok config add-authtoken YOUR_AUTHTOKEN
- 启动隧道:
ngrok http 8086选项B:部署到云端(建议用于生产环境)
部署到以下服务:
- 铁路 -通过GitHub集成轻松部署
- 渲染 -免费套餐可用
- Heroku -可靠的云平台
- 数字海洋应用平台 -可扩展的解决方案
🔗 与Puch AI连接
- 打开Puch AI 在浏览器中
- 开始新的对话
- 使用以下连接命令之一:
- 承载令牌(推荐):
/mcp connect https://your-domain.ngrok.app/mcp your_secret_token_here您的MCP服务器将公开 validate 接受承载令牌并以以下格式返回您的电话号码的工具 {country_code}{number}.
- OAuth(如果你单独实现它):
/mcp connect https://your-domain.ngrok.app/mcp调试模式
要获取更详细的错误消息:
/mcp diagnostics-level debug🛒 例子
问Puch以下任何一个问题:
Compare prices for iPhone 15 128GB
Check price of Amul milk 500ml
Find price for Coca Cola 2L💡 用例
对于消费者
- 智能购物:购买前比较价格
- 预算规划:在您的预算范围内找到最佳交易
- 快速商务:让杂货在几分钟内送达
- 价格跟踪:等待最佳购买时机
对于企业
- 市场调研:监控竞争对手的定价
- 价格优化:了解市场趋势
- 库存计划:跟踪产品可用性
🔧 技术细节
建筑
- FastMCP --MCP服务器框架
- 异步/等待 --非阻塞I/O操作
- 派丹蒂克 --数据验证和序列化
数据源
- Serper API公司 (谷歌购物)
安全
- 承载令牌身份验证:安全访问控制
- 需要HTTPS:所有连接都必须加密
- 速率限制:防止滥用外部API
🚨 重要提示
免费等级限制
- 此服务器使用免费数据源和API
- 某些平台可能有速率限制
- Web抓取用于API不可用的情况
遵守法律
- 尊重robots.txt文件
- 在请求之间实施适当的延迟
- 遵循平台服务条款
生产注意事项
- 实施适当的错误处理
- 添加缓存以获得更好的性能
- 监控API速率限制
- 设置日志记录和监控
🐛 故障排除
常见问题
- 连接失败
- 确保您的服务器在端口8086上运行 - 检查ngrok(或您的主机)是否通过HTTPS正确配置 - 验证您的AUTH_TOKEN是否正确
- 没有价格结果
- 确保 SERPER_API_KEY 已设置且有效 - 尝试不同的搜索关键字 - 如果结果仅存在于不受支持的网站上,则将被过滤掉
- 认证错误
- 验证您的 MY_NUMBER 格式(国家代码+数字) - 检查一下 AUTH_TOKEN 匹配您在Puch中使用的内容
调试命令
# Check server status
curl http://localhost:8086/health
# Test authentication
curl -H "Content-Type: application/json" -d '{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"name":"validate","arguments":{"bearer_token":"YOUR_TOKEN"}}}' http://localhost:8086/mcp | jq🤝 贡献
这是一个旨在对Puch AI社区有用的项目。请随意:
- 添加对更多平台的支持
- 提高价格准确性
- 添加新功能
- 报告错误和问题
📞 支持
- Puch AI不和谐: https://discord.gg/VMCnMvYx
- Puch AI文档: https://puch.ai/mcp
- Puch WhatsApp: +91 99988 81729
📄 许可证
这个项目是开源的,可以在MIT许可证下使用。
______________________________________________________________________
购物愉快! 🛒✨
使用标签 #BuildWithPuch 共享您的MCP服务器时!
