卖家精灵 API 对接模块

功能概述

通过卖家精灵API实现自动化数据获取，支持：

前置要求

1. 获取API密钥

1. 访问 https://open.sellersprite.com/app/list
2. 注册/登录账号
3. 申请创建应用获取 secret-key

2. 安装依赖

pip install requests

配置方式

方式1: config.json 配置文件（推荐）

在 config.json 中设置：

{
  "sellersprite": {
    "secret_key": "你的密钥",
    "marketplace": "amazon_us"
  }
}

配置文件路径可通过环境变量 SELLERSPRITE_CONFIG 自定义。

方式2: 环境变量

set SELLERSPRITE_KEY=你的密钥

方式3: 代码中直接设置

client = SellerSpriteAPI(secret_key="你的密钥")

使用示例

基础用法

from sellersprite_api import SellerSpriteAPI

# 方式1: 自动从config.json读取密钥
client = SellerSpriteAPI()

# 方式2: 直接传入密钥
client = SellerSpriteAPI(secret_key="你的密钥")

# 获取API可用次数
visits = client.get_visits()
print(f"可用次数: {visits}")

# 关键词搜索
keywords = client.keyword_search(
    keyword="wireless earbuds",
    marketplace="amazon_us"
)

# ASIN详情
asin_info = client.asin_detail(
    asin="B09V3KXJPB",
    marketplace="amazon_us"
)

# 市场概览
market_data = client.get_market_overview(
    marketplace="amazon_us",
    keyword="laptop stand"
)

在Skill中使用

用户说"帮我分析无线耳机市场"，AI自动：

# 1. 调用API获取数据
client = SellerSpriteAPI(secret_key=用户密钥)
market_data = client.get_market_overview(keyword="wireless earbuds")
keywords = client.keyword_search(keyword="wireless earbuds")

# 2. 整理数据
# ...

# 3. AI分析并输出报告

API 端点速查

注意事项

• 并发限制: 40次/分钟
• 数据限制: 同一查询条件只支持TOP2K数据
• 频率控制: 查询前每个模块需先请求1次进行初始化
• 错误处理: API返回 ERROR_VISIT_MAX 表示次数用尽

错误码

与SIF数据对比

结论: 卖家精灵API覆盖市场/关键词/评论类数据，SIF需手动导出流量类数据。