What makes 西柚-关键词洞察 notable?

1.4K downloads. Trust evidence available

How should 西柚-关键词洞察 be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

西柚-关键词洞察

西柚找词（西柚洞察）亚马逊 ASIN 与关键词分析，经 LinkFox 网关转发西柚 OpenAPI。覆盖 ASIN 流量得分、反查关键词、词排名/流量趋势、BSR、ABA 周趋势、关键词竞争度与建议竞价等 17 个接口，支持 US/UK/DE 等 13 个站点。当用户提到西柚找词、西柚洞察、Xiyou、ASIN 反查关键词、关键词分析、ABA 周搜索量、流量得分、词排名趋势、xiyou keyword research, ASIN traffic score, reverse ASIN lookup, search term analysis 时触发。即使用户未写「西柚」，只要需求是通过西柚找词查亚马逊 ASIN/关键词流量与排名数据，也应触发。使用前须配置 LINKFOXAGENT_API_KEY 以及环境变量 XIYOU_CLIENT_ID、XIYOU_CLIENT_SECRET。 Skill: 西柚-关键词洞察 Owner: linkfox-ai Summary: 西柚找词（西柚洞察）亚马逊 ASIN 与关键词分析，经 LinkFox 网关转发西柚 OpenAPI。覆盖 ASIN 流量得分、反查关键词、词排名/流量趋势、BSR、ABA 周趋势、关键词竞争度与建议竞价等 17 个接口，支持 US/UK/DE 等 13 个站点。当用户提到西柚找词、西柚洞察、Xiyou、ASIN 反查关键词、关键词分析、ABA 周搜索量、流量得分、词排名趋势、xiyou keyword research, ASIN traffic score, reverse ASIN lookup, search term analysis 时触发。即使用户未写「西柚」，只要需求是通过西柚找词查亚马逊 ASIN/关键词流量与排名数据，也应触发。使用前须配置 LINKFOXAGENT_API_KEY 以及环境变量 XIYOU_CLIENT_I

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

1.4k

Updated

Oct 10, 2026

Version

0.0.8

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.4K downloads reported by the source. Last updated 10/10/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 10, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 10, 2026
Adoption signal: 1.4K downloadsadoption · observed Oct 10, 2026
Latest release: 0.0.8release · observed Aug 14, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s171g8b6m2khwdy9ye8bxj0wx183vd4z:linkfox-xiyou-dongcha

Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-linkfox-ai-linkfox-xiyou-dongcha/snapshot"

Documentation

CLAWHUB

142,974 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: linkfox-xiyou-dongcha
description: 西柚找词（西柚洞察）亚马逊 ASIN 与关键词分析，经 LinkFox 网关转发西柚 OpenAPI。覆盖 ASIN 流量得分、反查关键词、词排名/流量趋势、BSR、ABA 周趋势、关键词竞争度与建议竞价等 17 个接口，支持 US/UK/DE 等 13 个站点。当用户提到西柚找词、西柚洞察、Xiyou、ASIN 反查关键词、关键词分析、ABA 周搜索量、流量得分、词排名趋势、xiyou keyword research, ASIN traffic score, reverse ASIN lookup, search term analysis 时触发。即使用户未写「西柚」，只要需求是通过西柚找词查亚马逊 ASIN/关键词流量与排名数据，也应触发。使用前须配置 LINKFOXAGENT_API_KEY 以及环境变量 XIYOU_CLIENT_ID、XIYOU_CLIENT_SECRET。
---

# Xiyou (西柚找词) — Amazon ASIN & Keyword Analytics

This skill queries **Xiyou Insights** (西柚洞察 / 西柚找词) data for Amazon ASINs and search terms via the **LinkFox tool gateway**. The gateway forwards requests to Xiyou OpenAPI (`https://openapi.xiyouzhaoci.com`).

## Environment Variables (Required)

本 skill 需要 **三组凭证**，缺一不可：

| Variable | Required | Description |
|----------|----------|-------------|
| `LINKFOXAGENT_API_KEY` | Yes | LinkFox Agent API Key（与其它 LinkFox skill 相同） |
| `XIYOU_CLIENT_ID` | Yes | 西柚 OpenAPI Client ID（16 位字符） |
| `XIYOU_CLIENT_SECRET` | Yes | 西柚 OpenAPI Client Secret（24 位字符） |

### 1. LinkFox API Key

1. 前往 [LinkFox API Key 申请文档](https://skill.linkfox.com/linkfoxskills/guide.htm) 获取 Key  
2. 写入环境变量 `LINKFOXAGENT_API_KEY`

### 2. 西柚找词 Client ID / Client Secret

1. 打开 [西柚洞察 OpenAPI 控制台](https://www.xydc.com/openapi?xiyou-insights-web=%2Fopenapi)  
2. 登录后在控制台创建或查看应用，复制 **Client ID**（16 位）与 **Client Secret**（24 位）  
3. 写入环境变量 `XIYOU_CLIENT_ID` 与 `XIYOU_CLIENT_SECRET`  
4. **请勿**将 Secret 提交到 Git、写入 SKILL 参数或聊天记录；仅通过环境变量供本地脚本读取

### 3. 配置示例

**macOS / Linux（当前终端会话）**

```bash
export LINKFOXAGENT_API_KEY="your-linkfox-api-key"
export XIYOU_CLIENT_ID="your-16-char-id"
export XIYOU_CLIENT_SECRET="your-24-char-secret"
```

**macOS / Linux（持久化，写入 `~/.zshrc` 或 `~/.bashrc`）**

```bash
echo 'export LINKFOXAGENT_API_KEY="your-linkfox-api-key"' >> ~/.zshrc
echo 'export XIYOU_CLIENT_ID="your-16-char-id"' >> ~/.zshrc
echo 'export XIYOU_CLIENT_SECRET="your-24-char-secret"' >> ~/.zshrc
source ~/.zshrc
```

**Windows PowerShell（当前会话）**

```powershell
$env:LINKFOXAGENT_API_KEY = "your-linkfox-api-key"
$env:XIYOU_CLIENT_ID = "your-16-char-id"
$env:XIYOU_CLIENT_SECRET = "your-24-char-secret"
```

**Windows（系统环境变量）**：设置 → 系统 → 关于 → 高级系统设置 → 环境变量 → 新建上述三个用户变量。

**Cursor / Agent 运行环境**：在 IDE 或 Agent 所在环境的 env 配置中添加上述三个变量，否则脚本会报错并提示缺少哪一项。

> 脚本 `scripts/xiyou.py` 与 `scripts/_xiyou_common.py` 会自动把 `XIYOU_CLIENT_ID` / `XIYOU_CLIENT_SECRET` 注入请求 Body；调用时 **不要** 在 `--params` 里重复传 `clientId` / `clientSecret`。

## Core Concepts

西柚找词提供亚马逊 **ASIN 维度** 与 **关键词维度** 的流量、排名、ABA、竞争度等数据，典型用途：

- **ASIN 反查关键词**：看某 ASIN 近 7 天或指定月份带来流量的搜索词
- **关键词分析**：看某词下哪些 ASIN 占流量、排名与获得率
- **趋势分析**：ASIN 流量得分、BSR、广告变动、词排名/流量随时间变化
- **选词辅助**：关键词 ABA 周搜索量、竞争难度、建议 CPC

## Supported Marketplaces

`country` 常用 2 位大写代码：`US`、`CA`、`MX`、`BR`、`UK`、`DE`、`ES`、`IT`、`FR`、`JP`、`AU`、`SA`、`AE`。默认 `US`。

**例外**：`asinSearchTermRankTrendHourly` 仅支持 `US`、`UK`、`DE`。

## 调用方式

- **API 端点**：`POST /xiyou`（不同操作通过请求体区分；完整参数/响应/错误码见 `references/api.md`）
- **Python 脚本**：

_meta.json

{
  "ownerId": "kn7dmc1t4j28hem1twwyav85p182pb1j",
  "slug": "linkfox-xiyou-dongcha",
  "version": "0.0.8",
  "publishedAt": 1786720983512
}

references/api.md

# 西柚找词 API 参考

> 本文档按 **路由** 逐个给出完整说明：每个路由都独立列出「调用信息 + 入参 + 出参（含嵌套对象字段）」，无需跨章节查阅。
> 全局通用的鉴权、站点枚举、公共响应字段见「通用约定」，各路由不再重复整张表。

## 调用规范

- **网关地址**：`${LINKFOX_TOOL_GATEWAY}/xiyou/<路由名>`（如 `asinTraffic` → `.../xiyou/asinTraffic`）
- **请求方式**：POST，`Content-Type: application/json`
- **LinkFox 认证**：请求头 `Authorization: <LINKFOX_AGENT_API_KEY 或 LINKFOXAGENT_API_KEY>`（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理）
- **西柚认证**：请求体 JSON 中的 `clientId`、`clientSecret`（脚本从环境变量 `XIYOU_CLIENT_ID`、`XIYOU_CLIENT_SECRET` 自动注入，**无需**在 `--params` 中手写）
- **上游服务**：西柚找词 OpenAPI（`https://openapi.xiyouzhaoci.com`），经 LinkFox 网关转发

### 环境变量

| 变量 | 必填 | 说明 |
|------|------|------|
| `LINKFOXAGENT_API_KEY` | 是 | LinkFox Agent API Key（如未配置 按 SKILL.md 的 **## 解决认证和积分问题** 处理） |
| `XIYOU_CLIENT_ID` | 是 | 西柚 OpenAPI Client ID（16 位） |
| `XIYOU_CLIENT_SECRET` | 是 | 西柚 OpenAPI Client Secret（24 位） |

西柚 `clientId` / `clientSecret` 获取：[西柚洞察 OpenAPI 控制台](https://www.xydc.com/openapi?xiyou-insights-web=%2Fopenapi)

### 命令行示例

```bash
export LINKFOXAGENT_API_KEY=your-linkfox-key
export XIYOU_CLIENT_ID=your-16-char-client-id
export XIYOU_CLIENT_SECRET=your-24-char-client-secret

python scripts/xiyou.py --list-apis
python scripts/xiyou.py --api asinTraffic --params '{"entities":[{"country":"US","asin":"B06XZTZ7GB"}]}'
```

---

## 通用约定

仅以下三类内容为所有路由共用，故集中说明一次；各路由的入参/出参表均**自包含**，不再引用其它章节。

### 鉴权字段（所有路由必填）

| 字段 | 类型 | 必填 | 说明 |
|------|------|------|------|
| `clientId` | string | 是 | 西柚 OpenAPI Client ID（16 位，脚本自动注入） |
| `clientSecret` | string | 是 | 西柚 OpenAPI Client Secret（24 位，脚本自动注入） |

> 下文各路由入参表为简洁起见省略 `clientId` / `clientSecret`，但它们对每个路由都必填。

### 站点国家代码 `country`

2 位大写枚举：`US`(美国)、`CA`(加拿大)、`MX`(墨西哥)、`BR`(巴西)、`UK`(英国)、`DE`(德国)、`ES`(西班牙)、`IT`(意大利)、`FR`(法国)、`JP`(日本)、`AU`(澳大利亚)、`SA`(沙特)、`AE`(阿联酋)。默认 `US`。

**例外**：`asinSearchTermRankTrendHourly` 仅支持 `US` / `UK` / `DE`。

### 公共响应字段

列表/趋势类路由出参除业务字段外，通常还包含以下固定字段（各路由出参表只列业务字段，下列字段默认存在）：

| 字段 | 类型 | 说明 |
|------|------|------|
| `sourceType` | string | 固定 `"amazon"` |
| `sourceTool` | string | 固定 `"xiyou"` |
| `type` | string | 固定 `"tableListWorkbenches"`（工作台表格渲染） |
| `columns` | array | 前端列定义 |
| `title` | string | 接口标题 |
| `total` | integer | 数据条数 / 趋势点数量 |

---

# 一、ASIN 模块

## 1. ASIN 流量得分 — `asinTraffic`

| 项目 | 说明 |
|------|------|
| **路由** | `POST /xiyou/asinTraffic` |
| **上游** | `POST v1/asins/traffic` |
| **计费** | 每 10 个 ASIN 计 1 Credit |
| **用途** | 批量查询 ASIN 近 7 天自然/广告/总流量得分及环比 |

### 入参

| 字段 | 类型 | 必填 | 说明 |
|------|------|------|------|
| `entities` | array | 是 | ASIN 查询实体列表，最多 100 个 |
| `entities[].country` | string | 是 | 站点国家代码 |
| `entities[].asin` | string | 是 | 10 位 ASIN，如 `B06XZTZ7GB` |

### 出参

| 字段 | 类型 | 说明 |
|------|------|------|
| `entities` | array | ASIN 流量得分列表 |
| `total` | integer | 返回条数 |
| `title` | string | 固定 `"ASIN流量得分"` |
**`entities[]` 元素**

| 字段 | 类型 | 说明 |
|------|------|------|
| `country` | string | 站点国家代码 |
| `asin` | string | ASIN |
| `organicTrafficScore` | integer | 近 7 天自然流量得分 |
| `advertisingTrafficScore` |

references/onboarding.md

# 解决认证和积分问题

调用本 skill 时若网关返回 **auth** 或 **billing** 错误，走本 skill 自带的 `scripts/onboarding.py` 完成引导。

**auth 场景**：`errcode=401` 或消息含 `authorized error`/`鉴权失败`/`未授权`/`unauthorized`；或 `LINKFOX_AGENT_API_KEY` 与 `LINKFOXAGENT_API_KEY` 均为空。
1. 若已配置 key → 先让用户重启会话（最常见误判），仍失败让用户重新取 key 或换手机号重注册
2. 未配置 → 询问：自助去 https://agent.linkfox.com/ 取 key，或提供手机号让脚本注册
3. 手机号路径：
   - `python scripts/onboarding.py send-code <phone>` → 展示 JSON 里的 phone/agreements
   - 收到验证码后：`python scripts/onboarding.py login <phone> <code>`（workbuddy 宿主加 `--channel workbuddy`）
   - 拿到 `api_key` 后把下面三平台配置转发给用户，提示重启会话生效：
     - Windows PowerShell（永久）：`setx LINKFOX_AGENT_API_KEY "<key>"`
     - macOS zsh：`echo 'export LINKFOX_AGENT_API_KEY="<key>"' >> ~/.zshrc && source ~/.zshrc`
     - Linux bash：`echo 'export LINKFOX_AGENT_API_KEY="<key>"' >> ~/.bashrc && source ~/.bashrc`
     - 变量名 `LINKFOX_AGENT_API_KEY`（主推）或 `LINKFOXAGENT_API_KEY`（老规范）任一即可

**billing 场景**：`errcode=402` 或消息含 `积分/余额/quota/insufficient/充值/套餐到期`。
- `python scripts/onboarding.py list-plans` → 有 AskUserQuestion 就弹菜单，否则输出编号清单让用户选
- 校验 `plan_id` ∈ 清单、支付方式 ∈ 该套餐 `available_methods`（通常 `wechat/alipay`）
- `python scripts/onboarding.py order <plan_id> <method>` → 展示优先级 PNG > `pay_url` > `ascii_qr`（标注兜底）
- 已付款可选调 `python scripts/onboarding.py query <order_id>`，不主动轮询

排除 `errcode=403`（无权限，不归入这两类）。所有子命令输出 stdout JSON，`error` 字段已含阶段前缀，透传给用户即可。完整用法：`python scripts/onboarding.py --help`。

skill-card.md

## Description:

西柚-关键词洞察 helps agents query Xiyou Insights through LinkFox for Amazon ASIN and keyword traffic, ranking, BSR, ABA trend, competition, and suggested CPC analysis across supported marketplaces.

This skill is ready for commercial/non-commercial use.

## Publisher:

[linkfox-ai](https://clawhub.ai/user/linkfox-ai)

### License/Terms of Use:

MIT-0

## Use Case:

External Amazon sellers, marketplace analysts, and agent users use this skill to retrieve Xiyou ASIN and keyword analytics for product research, keyword discovery, trend review, and competitive analysis.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: The skill handles LinkFox API keys, Xiyou client credentials, and phone-login flows.

Mitigation: Install only when the publisher is trusted; keep credentials in environment variables and avoid placing secrets in chats or source control.

Risk: The skill can invoke billing-related flows and API calls that may consume credits or require payment.

Mitigation: Confirm endpoint settings, plan selection, payment method, and repeated data requests before proceeding.

Risk: Full API responses may be stored locally without retention limits.

Mitigation: Review saved JSON files for sensitive marketplace data and delete or restrict access according to local retention needs.

Risk: Security evidence flags suspicious behavior involving credential handling, billing, feedback reporting, and persistent local storage.

Mitigation: Review the skill before deployment and disable or avoid automatic feedback reporting where local policy requires it.

## Reference(s):

- [ClawHub Skill Page](https://clawhub.ai/linkfox-ai/skills/linkfox-xiyou-dongcha)
- [Xiyou API Reference](references/api.md)
- [Authentication and Billing Onboarding](references/onboarding.md)
- [LinkFox API Key Guide](https://skill.linkfox.com/linkfoxskills/guide.htm)
- [Xiyou OpenAPI Console](https://www.xydc.com/openapi?xiyou-insights-web=%2Fopenapi)

## Skill Output:

**Output Type(s):** [text, markdown, shell commands, configuration, guidance, JSON files]

**Output Format:** [Markdown guidance with shell commands and JSON response summaries; full API responses are persisted as JSON files.]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [Responses of 8 KB or less are printed inline; larger responses are summarized while the full JSON is saved under a LinkFox session data directory.]

## Skill Version(s):

0.0.8 (source: release evidence)

## Ethical Considerations:

Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.

Github ReposUpdated 21h agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.