asinlens

asinlens

asinlens 是 Easyparser 托管 MCP 服务的轻量本地桥接工具，可将 Amazon 页面转换为结构化数据：商品详情和报价、关键词搜索、条码到 ASIN 的查询、销售历史、Best Sellers Rank、包装尺寸，以及卖家资料、反馈和商品目录；还可查看账户的批量任务、Webhook 日志、错误日志和额度余额。

该桥接工具不保留任何 Amazon 数据，也不会自行抓取数据。它会在本地提供上游服务的工具列表，与从实时端点捕获的内容完全一致，并将每次工具调用转发至上游，原样返回结果。捕获的所有工具都只读取数据：此次重建未添加任何写入能力。

工具

商品数据：

• get_product_detail — 完整的商品资料：标题、品牌、图片、要点、Buy Box 价格和库存情况、Prime 资格、评分、排名、变体、规格和热门评价。提供 asin 或 url，不可同时提供两者；domain、language、currency、a_plus_content 和 seller_id 均为可选参数。无必需参数。
• get_product_offers — 某件商品的所有卖家报价，包括价格、运费、商品状况、配送类型和 Buy Box 获胜者。必需参数：asin。可选筛选条件包括 prime、free_shipping、condition 和页码范围。
• search_products — 按关键词或搜索 URL 搜索，返回结构化商品列表和细化筛选条件。sort_by、exclude_sponsored、refinements 和页码范围均为可选参数。无必需参数。
• lookup_product — 将 UPC、EAN、GTIN、ISBN、JAN 或 MINSAN 编码（或 ASIN）转换为匹配的 Amazon ASIN，并返回商品快照。必需参数：identifier 和 identifier_type。
• get_sales_history — 最多 12 个月的流量、销量、价格和排名每周趋势。必需参数：asin；history_range 用于选择历史数据范围。
• get_bestseller_rank — 当前在主类目和子类目中的 Best Sellers Rank。必需参数：asin。
• get_package_dimensions — 精确的包装尺寸和重量，以及 Amazon 费用类别，用于估算 FBA 费用和运费。必需参数：asin。

卖家数据：

• get_seller_profile — 商家的法定企业名称、注册地址和反馈趋势。提供 seller_id 或 url。无必需参数。
• get_seller_products — 卖家的完整商品目录，包括价格、Prime 状态和评分。提供 seller_id 或 url。无必需参数。
• get_seller_feedback — 买家反馈条目，可按评分和时间段筛选。必需参数：seller_id。

账户和批量监控：

• list_operations — 上游操作目录，包含参数、额度成本和示例。
• list_bulk_jobs — 批量提取任务及其进度，可按状态、操作和域名筛选。
• get_bulk_job_items — 某个批量任务中的条目。必需参数：group_id。
• get_bulk_item_result — 某个批量条目的解析结果数据（任务完成后保留 24 小时）。必需参数：item_id。
• get_bulk_webhook_logs — 批量任务的 Webhook 投递日志，可选按单个 group_id 限定范围。
• get_error_logs — 账户的实时和批量 API 错误日志。
• check_credits — 套餐、额度余额、重置日期、速率限制，以及本月按操作划分的使用量。无参数。

配置

• EASYPARSER_MCP_URL（可选）— 覆盖上游端点。默认值为 https://mcp.easyparser.com/mcp。（此覆盖钩子是本次重建自行添加并标注的内容。）
• EASYPARSER_API_KEY（可选）— 设置后，每个上游请求都会携带 Authorization: Bearer <key> 标头。未设置时，不会发送身份验证标头。（此转发机制也是本次重建自行添加并标注的内容；原始接口是在无密钥的情况下捕获的，但注册表记录声明了 Authorization 标头。）

转发机制

首次调用工具时，客户端会与上游建立一个可流式传输的 HTTP 会话：发送 JSON-RPC initialize 请求（protocolVersion 2025-03-26， clientInfo name asinlens），然后发送 notifications/initialized 通知，接着发送 tools/call 请求，并原样携带调用方的参数。如果上游在响应 initialize 时返回 Mcp-Session-Id 标头，该值会随 此会话的每个后续请求发送，并在进程的整个生命周期内复用。 响应可能是纯 JSON，也可能是服务器发送事件；两种格式都会读取。

成功的上游结果会原样传递，包括上游设置的任何 isError 标记。 失败情况——JSON-RPC 错误、非 2xx 状态码、无法读取响应，或 无法完成的请求——会作为 isError 结果返回，其 文本以 asinlens error: 开头（此呈现方式是 本次重建自行标记的还原结果）。

CLI

每个工具也可以作为子命令使用，并接受一个 JSON 参数字符串（不接受参数的工具可省略）：

npx @reneturcios/asinlens get_product_offers '{"asin":"B0CJB6V2L5"}'
npx @reneturcios/asinlens lookup_product '{"identifier":"724382975021","identifier_type":"UPC"}'
npx @reneturcios/asinlens check_credits
npx @reneturcios/asinlens --version

退出代码：成功时为 0，结果为 isError 时为 1， 用法错误时为 2。

MCP 服务

npx -y @reneturcios/asinlens mcp

MCP 客户端配置：

{
  "mcpServers": {
    "asinlens": {
      "command": "npx",
      "args": ["-y", "@reneturcios/asinlens", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/asinlens
docker run --rm ghcr.io/cloudcorprecords/asinlens --version

容器的默认命令是 mcp，因此第一种形式是 stdio MCP 服务；其他参数 会照常传递给 CLI。

开发

npm install
npm run build
npm test
npm run dev

测试套件完全通过桩接的 JSON-RPC 上游运行，不会发起实时网络调用。

许可证

MIT — 参见 LICENSE。