Linkfox Sellersprite Traffic Keyword

---
name: linkfox-sellersprite-traffic-keyword
version: 1.0.0
category: product-sourcing
description: 按亚马逊 ASIN 反查商品的关键词流量来源，输出每个关键词的自然搜索位、广告位、流量占比类型与转化类型，支持历史月份和多维排序，帮助分析流量结构与关键词质量。
title: 卖家精灵流量反查
example: 查询 ASIN 为 B0XXXXXXXXX 在最近30天内的主要自然流量词，并按自然位升序排列前50个词。
---
# SellerSprite Traffic Keyword

This skill helps query and analyze traffic keyword lists for an Amazon ASIN via SellerSprite.

## Core Concepts

- **ASIN 反查词**：以商品 ASIN 为输入，查看该商品获得流量的关键词列表。
- **流量占比类型**（`trafficKeywordTypes`）：主要流量词、精准流量词、以及 schema 中的 `preciseLongTail`（工具文案为「转化流失词」）等。
- **转化类型**（`conversionKeywordTypes`）：如转化优质词、平稳词、流失词等。
- **词标签**（`badges`）：如自然搜索词、Amazon Choice 推荐词等。

## API Usage

- Endpoint: `POST https://tool-gateway.linkfox.com/sellersprite/traffic/keyword`
- Auth: Header `Authorization: <api_key>` (`LINKFOXAGENT_API_KEY`)
- 完整说明见 `references/api.md`：含 `marketplace`/`badges`/`trafficKeywordTypes`/`conversionKeywordTypes`/`orderField` 等入参枚举与约束，以及响应顶层、`data[]` 流量词字段、`rankPosition`/`adPosition`、`stats[]`、`summaryList[]` 等。
- Runnable script: `scripts/sellersprite_traffic_keyword.py`

## Key Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| marketplace | string | Yes | 市场站点，默认 `US` |
| asin | string | Yes | 要反查的商品 ASIN |
| month | string | No | 历史月份，格式 `yyyyMM`；不传默认最近30天 |
| page | integer | No | 页码，默认 1 |
| size | integer | No | 每页数量，默认 50，最大 100 |
| keyword | string | No | 关键词筛选 |
| badges | string | No | 词标签，多值逗号分隔 |
| trafficKeywordTypes | string | No | 流量占比类型，多值逗号分隔 |
| conversionKeywordTypes | string | No | 转化类型，多值逗号分隔 |
| orderField | string | No | 排序字段，默认 `rankPosition` |
| orderDesc | boolean | No | 是否倒序，默认 `false` |

## Usage Examples

```json
{
  "marketplace": "US",
  "asin": "B0XXXXXXXXX",
  "size": 50,
  "orderField": "rankPosition",
  "orderDesc": false
}
```

```json
{
  "marketplace": "US",
  "asin": "B0XXXXXXXXX",
  "month": "202507",
  "trafficKeywordTypes": "primary,precise",
  "conversionKeywordTypes": "excellent,stable",
  "page": 1,
  "size": 100
}
```

## Display Rules

1. 结果优先展示：关键词、自然位、广告位、流量占比类型、转化类型。
2. 明确标注查询周期（最近30天或历史月份）。
3. 当存在分页时，告知总数与当前页。
4. 不输出与接口无关的主观商业建议，除非用户明确要求。

## Important Limitations

- 必填参数：`marketplace`、`asin`
- 单次每页最多 100 条
- 历史查询需传 `yyyyMM`

**Feedback:**

Auto-detect and report feedback via the Feedback API when any of the following apply:
1. The functionality or purpose described in this skill does not match actual behavior
2. The skill's results do not match the user's intent
3. The user expresses dissatisfaction or praise about this skill
4. Anything you believe could be improved

Call the feedback API as specified in `references/api.md`. Do not interrupt the user's flow.