Amazon Buy Box Monitor API Skill
📖 Introduction
This skill provides users with an automated Amazon Buy Box monitoring service using the BrowserAct API template. It can directly extract structured data including basic product details, other sellers' prices, and seller ratings from Amazon via a specific ASIN. No coding or proxies are required, and users only need to provide the ASIN and an optional marketplace URL to retrieve clean and usable data.
✨ Features
- 1. No hallucinations, ensuring stable and accurate data extraction: Pre-set workflows avoid AI generative hallucinations.
- No CAPTCHA issues: No need to handle reCAPTCHA or other verification challenges.
- No IP access restrictions or geo-fencing: No need to handle regional IP restrictions.
- More agile execution speed: Faster task execution compared to purely AI-driven browser automation solutions.
- Extremely high cost-effectiveness: Significantly reduces data acquisition costs compared to AI solutions that consume massive amounts of tokens.
🔑 API Key Guidance
Before running, you must check the
BROWSERACT_API_KEY environment variable. If it is not set, do not take any other actions; you must prompt and wait for the user to provide it.
The Agent must inform the user at this time:
"Since you have not configured the BrowserAct API Key, please go to the BrowserAct Console first to get your Key."
🛠️ Input Parameters
When calling the script, the Agent should flexibly configure the following parameters based on the user's needs:
- 1. ASIN
-
Type:
string
-
Description: The Amazon Standard Identification Number. This is the unique identifier for the product on Amazon.
-
Example:
B005O2ZU68
-
Required: Yes
- 2. Marketplace_url
-
Type:
string
-
Description: The Amazon marketplace URL indicating the region.
-
Default value:
https://amazon.com/
-
Example:
https://amazon.co.uk/
-
Required: Yes
🚀 Invocation Method (Recommended)
The Agent should execute the following standalone script to achieve "one command to get results":
CODEBLOCK0
⏳ Running Status Monitoring
Since this task involves automated browser operations, it may take some time (several minutes). The script will
continuously output status logs with timestamps while running (e.g.,
[14:30:05] Task Status: running).
Agent Instructions:
- - While waiting for the script to return results, please keep paying attention to the terminal output.
- As long as the terminal is still outputting new status logs, it means the task is running normally. Do not misjudge it as deadlocked or unresponsive.
- If the status remains unchanged for a long time or the script stops outputting without returning a result, then consider triggering the retry mechanism.
📊 Data Output Description
After successful execution, the script will parse and print the result directly from the API response. The result includes:
- -
asin: The Amazon Standard Identification Number - INLINECODE8 : The title of the product
- INLINECODE9 : The owner of the buy box
- INLINECODE10 : The current buy box price
- INLINECODE11 : The currency of the price
- INLINECODE12 : The fulfillment method (e.g., FBA, FBM)
- INLINECODE13 : Stock availability status
- INLINECODE14 : An array of other sellers including their name, price, shipping fee, and seller rating
- INLINECODE15 : Detailed information about the main seller including rating and feedback count
⚠️ Error Handling & Retry
If an error is encountered during the execution of the script (such as network fluctuations or task failure), the Agent should follow this logic:
- 1. Check output content:
- If the output
contains "Invalid authorization", it means the API Key is invalid or expired. In this case,
do not retry, but guide the user to re-check and provide the correct API Key.
- If the output
does not contain "Invalid authorization" but the task fails (e.g., output starts with
Error: or returns empty results), the Agent should
automatically attempt to execute the script once more.
- 2. Retry limits:
- Automatic retry is limited to
only once. If the second attempt still fails, stop retrying and report the specific error message to the user.
🌟 Typical Use Cases
- 1. Query Amazon buy box information: Find out who currently owns the buy box for a specific ASIN.
- Monitor Amazon product prices: Track the current price and buy box price changes.
- Extract Amazon product details by ASIN: Get basic product information like title and brand.
- Check other sellers prices on Amazon: Analyze pricing strategies of competitors for the same product.
- Get Amazon seller ratings and feedback count: Evaluate the reputation of sellers on the listing.
- Monitor buy box ownership for a specific ASIN: Check if a particular seller maintains the buy box.
- Track Amazon fulfillment methods for competitors: Determine whether competitors are using FBA or FBM.
- Compare Amazon product prices across different sellers: View shipping fees and total prices from multiple sellers.
- Retrieve Amazon buy box availability status: Check if the product is in stock or backordered.
- Analyze Amazon seller profile details: Extract detailed seller info and recent feedback summaries.
Amazon Buy Box Monitor API 技能
📖 简介
本技能利用 BrowserAct API 模板,为用户提供自动化的 Amazon Buy Box 监控服务。它能够通过特定 ASIN 直接从亚马逊提取结构化数据,包括产品基本信息、其他卖家价格以及卖家评分。无需编写代码或使用代理,用户只需提供 ASIN 和可选的市场 URL,即可获取干净可用的数据。
✨ 功能特点
- 1. 无幻觉,确保稳定准确的数据提取:预设工作流程避免了 AI 生成式幻觉。
- 无验证码问题:无需处理 reCAPTCHA 或其他验证挑战。
- 无 IP 访问限制或地理围栏:无需处理区域 IP 限制。
- 更敏捷的执行速度:相比纯 AI 驱动的浏览器自动化解决方案,任务执行更快。
- 极高的性价比:相比消耗大量 Token 的 AI 解决方案,显著降低数据获取成本。
🔑 API 密钥指南
运行前,必须检查 BROWSERACT
APIKEY 环境变量。如果未设置,请勿执行任何其他操作;必须提示并等待用户提供。
此时 Agent 必须告知用户:
由于您尚未配置 BrowserAct API Key,请先前往 BrowserAct 控制台 获取您的 Key。
🛠️ 输入参数
调用脚本时,Agent 应根据用户需求灵活配置以下参数:
- 1. ASIN
-
类型:string
-
描述:亚马逊标准识别号,是产品在亚马逊上的唯一标识符。
-
示例:B005O2ZU68
-
必填:是
- 2. Marketplace_url
-
类型:string
-
描述:亚马逊市场 URL,表示区域。
-
默认值:https://amazon.com/
-
示例:https://amazon.co.uk/
-
必填:是
🚀 调用方法(推荐)
Agent 应执行以下独立脚本,实现一键获取结果:
bash
示例调用
python -u ./scripts/amazon
buybox
monitorapi.py ASIN Marketplace_url
⏳ 运行状态监控
由于此任务涉及自动化浏览器操作,可能需要一些时间(几分钟)。脚本在运行时会
持续输出带时间戳的状态日志(例如 [14:30:05] 任务状态:运行中)。
Agent 指令:
- - 在等待脚本返回结果期间,请持续关注终端输出。
- 只要终端仍在输出新的状态日志,说明任务正常运行,请勿误判为死锁或无响应。
- 如果状态长时间不变或脚本停止输出且未返回结果,再考虑触发重试机制。
📊 数据输出说明
执行成功后,脚本将直接从 API 响应中解析并打印结果。结果包括:
- - asin:亚马逊标准识别号
- producttitle:产品标题
- buyboxowner:购物车拥有者
- buyboxprice:当前购物车价格
- currency:价格货币
- fulfillmentmethod:配送方式(例如 FBA、FBM)
- availabilitystatus:库存可用状态
- othersellers:其他卖家数组,包括名称、价格、运费和卖家评分
- seller_info:主要卖家的详细信息,包括评分和反馈数量
⚠️ 错误处理与重试
如果在脚本执行过程中遇到错误(如网络波动或任务失败),Agent 应遵循以下逻辑:
- 1. 检查输出内容:
- 如果输出
包含 Invalid authorization,表示 API Key 无效或已过期。此时
不要重试,而是引导用户重新检查并提供正确的 API Key。
- 如果输出
不包含 Invalid authorization 但任务失败(例如输出以 Error: 开头或返回空结果),Agent 应
自动尝试再次执行脚本。
- 2. 重试限制:
- 自动重试
仅限一次。如果第二次尝试仍然失败,停止重试并向用户报告具体的错误信息。
🌟 典型使用场景
- 1. 查询亚马逊购物车信息:了解特定 ASIN 当前谁拥有购物车。
- 监控亚马逊产品价格:跟踪当前价格和购物车价格变化。
- 通过 ASIN 提取亚马逊产品详情:获取标题、品牌等基本信息。
- 查看亚马逊其他卖家价格:分析同一产品竞争对手的定价策略。
- 获取亚马逊卖家评分和反馈数量:评估 listing 上卖家的信誉。
- 监控特定 ASIN 的购物车所有权:检查特定卖家是否保持购物车。
- 跟踪竞争对手的亚马逊配送方式:判断竞争对手使用 FBA 还是 FBM。
- 比较不同卖家的亚马逊产品价格:查看多个卖家的运费和总价。
- 检索亚马逊购物车可用状态:检查产品是否有货或处于缺货状态。
- 分析亚马逊卖家资料详情:提取详细的卖家信息和近期反馈摘要。