Skip to main content
Glama
Sign In
deenesjakoruzh
amazon-lyr

amazon-lyr

by ishan-parihar
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

一个代理会话，从头到尾

这是与运行 amazon-lyr 的代理进行的一次真实对话——没有隐藏任何步骤：

1. search_products("noise cancelling headphones", max_price=300, min_rating=4)
2. review_insights("B0X1234567")            # star spread + keyword themes
3. search_in_reviews("B0X1234567", query="broke")     # what actually breaks?
4. add_to_cart("B0X1234567", quantity=1)
5. checkout_preview()                        # totals + address + payment, nothing bought
6. place_order(confirm="PLACE_ORDER")       # only after the user said "buy it"
   ✓ order placed · #111-2223334-5556667
7. track_shipment("111-2223334-5556667")
8. initiate_return("111-2223334-5556667", reason="defective", asin_hint="…")
9. list_returns()                           # refund status confirmed

每一步都是类型化的 MCP 工具调用。购买步骤被刻意设计为难以意外触发——参见安全模型。

Related MCP server: Amazon Cart MCP Server

为什么与众不同

无需 API 密钥

通过 curl_cffi 配合 Chrome TLS 模拟，直接对接 Amazon 自身的 Web 端点——与您的浏览器使用相同的会话

完整生命周期

不仅仅是抓取：购物车变更、心愿单写入、带确认解析的结账、退货向导、取消订单

面向代理的原生错误

CAPTCHA、登出重定向和软限流以带恢复提示的类型化错误形式呈现（possibly_throttled、手动回退 URL）——绝不会静默返回垃圾数据

工作原理

browser cookies ──▶ AmazonClient (curl_cffi, captcha-aware)
                        │
                        ▼
              bs4 parsers ──▶ normalized dicts ──▶ 21 FastMCP tools
                                                   (readOnly / destructive annotations)

认证使用您自己的会话：amazon-lyr login 通过 obscura-core 从 Chrome、Brave、Firefox、Edge 或 Zen 导入 Cookie，或从显式 JSON 导出导入。读取操作需要登录令牌；购物车、订单、退货和结账还需要会话上下文 Cookie。

安装

# Persistent install — uv tool (isolated; bootstraps uv on clean systems)
curl -sSL https://raw.githubusercontent.com/ishan-parihar/amazon-lyr/main/install.sh | bash

# Zero-install run without persistence:
uvx --from git+https://github.com/ishan-parihar/amazon-lyr amazon-lyr --version

然后认证一次并启动服务：

amazon-lyr login --browser chrome            # or: --cookies-file cookies.json
amazon-lyr search "mechanical keyboard"      # shell works immediately
amazon-lyr serve                             # MCP server (stdio)
{
  "mcpServers": {
    "amazon": {
      "command": "amazon-lyr",
      "args": ["serve"]
    }
  }
}

工具（21 个）

类别

工具

搜索

search_products（部门、价格区间、最低评分筛选）

产品

get_product、compare_products（最多 5 个 ASIN）

评论

get_reviews、review_insights、search_in_reviews

购物车

add_to_cart、view_cart、update_cart_quantity、remove_from_cart

心愿单

add_to_wishlist、get_wishlist

订单

get_orders、get_order_details、track_shipment

退货

list_returns、initiate_return（友好的原因代码）

购买

checkout_preview、place_order

危险区域

cancel_order

会话

get_session_status

安全模型

资金操作恰好经过两道关卡：

  1. 会话关卡——每次变更操作都需要完整的登录 Cookie（at-main + session-id/ubid-main）。只读会话在任何请求发出之前就会被拒绝。

  2. 同意关卡——place_order 除非传入精确的字面量 confirm="PLACE_ORDER"，否则拒绝执行。预期流程是：为用户预览 → 用户批准 → 然后传入该字面量。cancel_order 和 initiate_return 同样被标注为破坏性/非幂等操作，以便代理框架相应处理。

卡片验证（OTP / 3-D Secure）会在结账过程中被检测到，并以 needs_verification 形式报告，附带浏览器操作说明——绝不会猜测通过。

限制

诚实的上限，全部以类型化错误而非错误数据的形式呈现：

  • CAPTCHA 墙——账户区域页面比商品目录更严格；重新导入新 Cookie 或等待解除（CaptchaError 包含提示）

  • 软限流——低于 3 秒的请求节奏会静默返回空网格；怀疑受限时响应会携带 possibly_throttled: true

  • 地区价格变体——某些变体在客户端渲染价格；搜索回退到文本扫描，get_product 保持权威

  • 未经同意不自动购买——设计如此；结账要求显式的确认字面量和用户批准

开发

git clone https://github.com/ishan-parihar/amazon-lyr && cd amazon-lyr
uv sync --extra dev
uv run ruff check . && uv run pytest -q

架构说明、不变式和发布流程详见 AGENTS.md。

许可证

MIT © Ishan Parihar

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues

Resources

Related MCP Connectors

Related MCP Servers