用途:把商品问题路由到 Apify 托管的 E-commerce Scraping Tool Actor,实时读取零售商页面并返回结构化记录(价格、货币、库存、评分、图片 URL、链接),避免依赖过期的训练数据或把页面当散文阅读。
主要能力:支持按指定页面 URL 查询(detailsUrls),也支持用关键词加市场(marketplaces)搜索或跨店比价。调用时建议始终传 maxProductResults 和 additionalProperties: true,否则库存、评分、标价和标识符会缺失。
使用方式:MCP 端点为 https://mcp.apify.com,可追加 ?tools=apify/e-commerce-scraping-tool 收窄到该 Actor。交互式客户端首次用 OAuth 认证,无人值守用 bearer token。调用分两步(有时三步):先调 apify--e-commerce-scraping-tool(两个连字符)拿到 runId 和 datasetId;若状态非 SUCCEEDED,用 get-actor-run 加 waitSecs 等待;再用 get-dataset-items 取数据。用 fields 点号投影,返回结果键名保留点号,如 item["offers.price"]。
注意事项:offers.price 在不同零售商可能是数字或字符串;货币字段名与取值格式不统一;库存和评分位于 additionalProperties 下的 inStock 和 stars;brand 常含营销文本。字段缺失表示未知,不代表商品不可用。延迟高且不稳定(实测 14.7 秒至 95.8 秒),适合作为用户行动前的验证。MCP 传输的 marketplaces 枚举会被截断,报错时改用 detailsUrls。字段覆盖取决于零售商,无统一 schema。additionalProperties 单商品可达约 100 KB,勿直接粘贴。评分或 stars 为 0 表示缺失。需 Apify 账号,Actor 付费,按启动运行加返回商品数计费。