3快速开始（curl 3 行试通）
3.1 列出全部站点（验证 key）
# 站点清单 · 验证 key 有效
curl -H "X-API-Key: sck_ikuBVCAjAKygdAxu8_DNSDc9iOJkgXMY7jBf5ceMmlw" \
"https://smartcrawler.io/api/v1/sites"
3.2 查询某站商品（最常用）
# 查 vidaxl_de 在售商品 top 100
curl -H "X-API-Key: sck_iku..." \
"https://smartcrawler.io/api/v1/products?site=vidaxl_de&page_size=100"
# 含字段：sku/spu/title/sale_price/original_price/currency/rating/
# review_count/30day_sales/category_path/image_urls/url
3.3 商品详情 + 价格历史
# 单个 SKU 详情 + 30 天价格曲线
curl -H "X-API-Key: sck_iku..." \
"https://smartcrawler.io/api/v1/products/songmics_us/SOL-3782"
3.4 评论（VOC）
# Trustpilot 某商家全部负面评论
curl -H "X-API-Key: sck_iku..." \
"https://smartcrawler.io/api/v1/reviews?platform=trustpilot&max_rating=2&page_size=50"
5响应格式
v1 endpoints 统一信封
{
"object": "list",
"count": 100,
"total": 10452,
"has_more": true,
"data": [
{
"sku": "SOL-3782",
"spu": "H-1234",
"site": "songmics_us",
"brand": "SONGMICS",
"title": "电动升降桌 48英寸",
"category": "Office Furniture/Desks",
"price": {
"sale": 189.99,
"original": 209.99,
"currency": "USD",
"on_promotion": true
},
"rating": { "score": 4.6, "review_count": 412 },
"estimate": { "30day_sales": 137, "revenue": 26028.63 },
"images": ["https://..."],
"url": "https://songmics.com/products/sol-3782",
"identifiers": { "mpn": "...", "gtin": "..." },
"first_seen": "2026-04-15",
"last_seen": "2026-05-24"
}
]
}
错误响应
{
"detail": "未授权" # 401
}
{
"detail": "站点不存在" # 404
}
7MCP 服务器（推荐给 AI Agent 用）
如果你们对接方是 AI Agent（Claude / GPT），直接走 MCP 协议更稳。
# Claude Code / MCP-compatible client 配置
{
"mcpServers": {
"smart-crawler": {
"url": "https://smartcrawler.io/mcp",
"headers": {
"Authorization": "Bearer sck_ikuBVCAjAKygdAxu8_DNSDc9iOJkgXMY7jBf5ceMmlw"
}
}
}
}
暴露 12 个工具：list_data_sources / search_competitor_products / get_product_detail / list_promotions / get_voc_reviews / voc_summary / competitor_landscape / amazon_voc_report / fetch_amazon_reviews / reddit_top_contributors / reddit_user_activity / reddit_subreddit_playbook