Amazon Product Search via Scavio
Search Amazon products or retrieve full product details by ASIN. Returns structured JSON. Supports 12 Amazon marketplaces.
When to trigger
Use this skill when the user asks to:
- - Find products on Amazon with price or rating requirements
- Look up a specific product by ASIN
- Research Amazon pricing, availability, or reviews
- Compare Amazon products or find best sellers in a category
Setup
Get a free API key at https://scavio.dev (1,000 free credits/month, no card required):
CODEBLOCK0
Workflow
- 1. If the user has an ASIN, call
/api/v1/amazon/product directly. - If the user has a keyword, call
/api/v1/amazon/search with appropriate filters (sort_by, domain, zip_code). - If the user asks about a specific market (e.g. "Amazon Germany"), set the
domain param accordingly. - Present results with name, price, rating, review count, and URL. Note Prime status.
Endpoints
| Endpoint | Description |
|---|
| INLINECODE6 | Keyword search with filters |
| INLINECODE7 |
Full product details by ASIN |
CODEBLOCK1
Search Parameters
| Parameter | Type | Default | Description |
|---|
| INLINECODE8 | string | required | Search query (1-500 chars) |
| INLINECODE9 |
string |
com |
com,
co.uk,
de,
fr,
co.jp,
ca,
it,
es,
in,
com.au,
com.br,
com.mx |
|
sort_by | string | -- |
most_recent,
price_low_to_high,
price_high_to_low,
featured,
average_review,
bestsellers |
|
start_page | integer |
1 | Starting page |
|
pages | integer |
1 | Number of pages |
|
category_id | string | -- | Amazon category/department ID |
|
currency | string | -- | ISO 4217 (e.g.
USD,
EUR) |
|
zip_code | string | -- | ZIP code for localized pricing and availability |
|
device | string |
desktop |
desktop,
mobile, or
tablet |
Product Detail Parameters
| Parameter | Type | Default | Description |
|---|
| INLINECODE44 | string | required | Amazon ASIN (e.g. B09XS7JWHH) |
| INLINECODE46 |
string |
com | Amazon domain suffix |
|
currency | string | -- | ISO 4217 currency code |
|
zip_code | string | -- | ZIP code for localized pricing |
Examples
CODEBLOCK2
Search Response
CODEBLOCK3
Product detail response also includes: description, features, images, categories, availability, seller, list_price.
Guardrails
- - Never fabricate product names, ASINs, prices, or ratings. Only return data from the API.
- If the user asks for a price comparison, search both terms and present both results.
- If an ASIN is not found, tell the user and suggest a keyword search instead.
- Always include the product URL so the user can verify.
Failure handling
- - If the API returns an error, report the status code and stop.
- If no products are returned, tell the user and suggest different keywords or filters.
- If
SCAVIO_API_KEY is not set, prompt the user to export it before continuing.
LangChain
CODEBLOCK4
CODEBLOCK5
通过Scavio进行亚马逊产品搜索
通过ASIN搜索亚马逊产品或获取完整产品详情。返回结构化JSON数据。支持12个亚马逊市场。
触发时机
当用户要求以下内容时使用此技能：
- - 按价格或评分要求查找亚马逊产品
- 通过ASIN查询特定产品
- 研究亚马逊价格、库存或评论
- 比较亚马逊产品或查找品类中的畅销品
设置
在 https://scavio.dev 获取免费API密钥（每月1000次免费额度，无需信用卡）：
bash
export SCAVIOAPIKEY=skliveyour_key
工作流程
- 1. 如果用户有ASIN，直接调用 /api/v1/amazon/product。
- 如果用户有关键词，使用适当的筛选条件（sortby、domain、zipcode）调用 /api/v1/amazon/search。
- 如果用户询问特定市场（例如亚马逊德国），相应设置 domain 参数。
- 展示结果，包括名称、价格、评分、评论数量和URL。标注Prime状态。
接口
| 接口 | 描述 |
|---|
| POST https://api.scavio.dev/api/v1/amazon/search | 带筛选条件的关键词搜索 |
| POST https://api.scavio.dev/api/v1/amazon/product |
通过ASIN获取完整产品详情 |
Authorization: Bearer $SCAVIOAPIKEY
搜索参数
| 参数 | 类型 | 默认值 | 描述 |
|---|
| query | 字符串 | 必填 | 搜索查询（1-500字符） |
| domain |
字符串 | com | com、co.uk、de、fr、co.jp、ca、it、es、in、com.au、com.br、com.mx |
| sort
by | 字符串 | -- | mostrecent、price
lowto
high、pricehigh
tolow、featured、average_review、bestsellers |
| start_page | 整数 | 1 | 起始页码 |
| pages | 整数 | 1 | 页数 |
| category_id | 字符串 | -- | 亚马逊品类/部门ID |
| currency | 字符串 | -- | ISO 4217（例如 USD、EUR） |
| zip_code | 字符串 | -- | 用于本地化定价和库存的邮政编码 |
| device | 字符串 | desktop | desktop、mobile 或 tablet |
产品详情参数
| 参数 | 类型 | 默认值 | 描述 |
|---|
| query | 字符串 | 必填 | 亚马逊ASIN（例如 B09XS7JWHH） |
| domain |
字符串 | com | 亚马逊域名后缀 |
| currency | 字符串 | -- | ISO 4217货币代码 |
| zip_code | 字符串 | -- | 用于本地化定价的邮政编码 |
示例
python
import os, requests
BASE = https://api.scavio.dev
HEADERS = {Authorization: fBearer {os.environ[SCAVIOAPIKEY]}}
搜索
results = requests.post(f{BASE}/api/v1/amazon/search, headers=HEADERS,
json={query: wireless headphones, sort
by: averagereview}).json()
通过ASIN获取产品
product = requests.post(f{BASE}/api/v1/amazon/product, headers=HEADERS,
json={query: B09XS7JWHH}).json()
搜索响应
json
{
data: [
{
name: Sony WH-1000XM5 Wireless Noise Canceling Headphones,
asin: B09XS7JWHH,
url: https://www.amazon.com/dp/B09XS7JWHH,
price: $278.00,
currency: USD,
rating: 4.6,
total_reviews: 12450,
is_prime: true,
isbestseller: false
}
],
credits_used: 1,
credits_remaining: 999
}
产品详情响应还包括：description、features、images、categories、availability、seller、list_price。
使用规范
- - 绝不虚构产品名称、ASIN、价格或评分。仅返回API提供的数据。
- 如果用户要求价格比较，搜索两个关键词并展示两个结果。
- 如果未找到ASIN，告知用户并建议改用关键词搜索。
- 始终包含产品URL，以便用户验证。
错误处理
- - 如果API返回错误，报告状态码并停止。
- 如果没有返回产品，告知用户并建议使用不同的关键词或筛选条件。
- 如果未设置 SCAVIOAPIKEY，提示用户先导出密钥再继续。
LangChain
bash
pip install scavio-langchain
python
from scavio_langchain import ScavioSearchTool
tool = ScavioSearchTool(engine=amazon)
