用途
amazon-in-mcp 是一个 MCP（Model Context Protocol）服务器，让你在支持 MCP 的大语言模型客户端中直接查询 amazon.in（亚马逊印度站）的商品信息。它的目标是把购物查询能力交给 LLM：找最低价、找性价比最优、查看商品详情和价格历史。项目不依赖任何付费 API，无需 API 密钥或账号。
主要能力
服务器提供三个可由 LLM 调用的工具（针对 amazon.in）：
- 搜索类工具（search_amazon_in）：可指定关键词、最大结果数，返回商品列表。示例调用 search_amazon_in("wireless mouse", max_results=3) 返回商品信息。
- 商品详情工具（get_product）：在搜索结果基础上增加商品要点（bullets）、品牌（brand）、卖家（seller）、折扣百分比（discount_percent）、库存可用性（availability）等字段。
- 性价比排序：在库存充足且评论数至少 10 条的商品中，按公式 score = rating × log10(reviews + 10) / sqrt(price) 计算得分，得分最高者为“最佳性价比”。cheapest_in_stock 则是直接取有货商品中 price_inr 最低者，适合需要纯粹低价的情形。
- 价格历史链接：返回的 amazon.in 商品链接会附带 Keepa 价格历史链接（默认包含作者的亚马逊联盟标签 artech-21）。
- 可选 Keepa API 支持：用户可自行提供 Keepa API 密钥以获取真实价格历史数据。
- 过滤辅助：支持 min_rating、min_reviews、under_price 等筛选参数。
- 无需 API 密钥或账号，通过 stdio 在本地运行，直接抓取 HTML，使用轮换用户代理并在遇到机器人检查页面时重试。
使用方式
- 安装（以 Claude Code 为例，具体安装命令请参考项目仓库说明）。
- 重启你的 MCP 客户端（Claude Code、Cursor、Claude Desktop 等）。
- 用自然语言提问，例如：“Find me a good 1TB external SSD on amazon.in under ₹10,000. Best value pick.” 或“find me a mechanical keyboard under 3000”，也可直接粘贴 amazon.in 链接或 ASIN。LLM 会调用 search_amazon_in，按性价比排序，返回真实商品、当前价格和 Keepa 价格历史链接。
- 配置 MCP 客户端：编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（Claude Desktop 路径示例）；其他客户端使用同样的 JSON 配置，放入其 MCP 设置文件。
- 可选环境变量：在 MCP 客户端配置的 env 块中设置，默认值保持原有行为。例如可通过 AMAZON_IN_PROXY 设置代理、缩短缓存到 30 秒等。示例——通过代理并缩短缓存：在 env 中配置相应变量。
- 自动路由：安装后，服务器会在 initialize 握手时返回 MCP 服务器说明，指示模型默认对任何 amazon.in 购物、价格、库存或评论问题使用 search_amazon_in / get_product，包括用户只粘贴 amazon.in 链接或 ASIN 的情况。工具描述中也携带相同触发关键词，作为不读取服务器说明的客户端的回退方案。
- 图像输入：服务器有意不接受图像输入，以保持对不同提供商的中立性。可把图片粘贴到 LLM 客户端，让它描述商品，再自动调用 search_amazon_in 并传入合适关键词。
- 可通过 MCP Inspector 进行交互测试（具体命令见项目仓库）。
适用场景
- 在 LLM 客户端中快速查询 amazon.in 商品的价格、库存、评分、卖家等信息。
- 寻找最低价有货商品或平衡评分、评论数与价格的“最佳性价比”商品。
- 查看商品价格历史（Keepa 链接）。
- 适合个人研究和助手用途。
限制与注意事项
- 抓取的是公开可访问的 amazon.in 页面，不绕过认证、付费墙或验证码；当 Amazon 返回机器人检查页面时，工具会停止并报告错误。
- 重度使用下预计约 1–5% 的请求会因机器人检查失败。可等待 30–60 秒后重试、换网络运行，或设置 AMAZON_IN_PROXY。
- 页面 DOM 选择器为尽力而为，Amazon 更新布局时可能失效，需要社区帮助修复。项目欢迎 PR。
- 作者提示：返回的 amazon.in 链接默认包含其亚马逊联盟标签 artech-21，点击购买后作者获得少量佣金，你支付价格不变；这是项目保持免费、MIT 许可和持续维护的唯一方式。可通过 AMAZON_IN_AFFILIATE_TAG 环境变量随时覆盖或禁用（例如设置为你自己的标签）。
- 你需要自行确保使用符合 Amazon 服务条款和当地法律。项目不提供任何正常运行时间、准确性或适用性保证。
- 服务器说明和工具描述中的自动路由是模型层面的引导，由宿主客户端呈现，并非硬性协议保证；忽略服务器说明和工具描述的客户端不会被强制路由。
- 项目采用 MIT 许可证，作者为 Aditya Raj Singh。
