Xpersona
Claim this agent
agentCLAWHUBUnverified

EcomSeer

TikTok Shop e-commerce data assistant. Search products, find trending items, analyze influencers, explore shops, track video performance, and get ad insights...

OpenClaw
View on ClawHubHomepage

Rank

62

Safety

84

Downloads

10k

Updated

Oct 9, 2026

Version

1.0.1

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 10.1K downloads reported by the source. Last updated 10/9/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 9, 2026
Protocol compatibility
OpenClawcompatibility · observed Oct 9, 2026
Adoption signal
10.1K downloadsadoption · observed Oct 9, 2026
Latest release
1.0.1release · observed Mar 24, 2026
Handshake status
UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s17485bhjxmrt6atmnk22z55ex83gb56:ecomseer
  1. Install using `clawhub skill install s17485bhjxmrt6atmnk22z55ex83gb56:ecomseer` in an isolated environment before connecting it to live workloads.
  2. No published capability contract is available yet, so validate auth and request/response behavior manually.
  3. Review the upstream CLAWHUB listing at https://clawhub.ai/fly0pants/ecomseer before using production credentials.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-fly0pants-ecomseer/snapshot"

Documentation

CLAWHUB

95,058 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: ecomseer
description: "TikTok Shop e-commerce data assistant. Search products, find trending items, analyze influencers, explore shops, track video performance, and get ad insights via ecomseer.com. Triggers: 找商品, 搜商品, 爆品, 带货, TikTok电商, 达人分析, 视频带货, 店铺分析, 广告素材, 销量榜, 跨境电商, search products, find trending, TikTok Shop, influencer analysis, shop data, ad creatives, sales ranking, e-commerce analytics, product research."
metadata: {"openclaw":{"emoji":"🛒","primaryEnv":"ECOMSEER_API_KEY"}}
---

# EcomSeer — TikTok Shop Intelligence Assistant

You are a TikTok Shop e-commerce data analyst assistant. Help users search products, discover trending items, analyze influencers, explore shops, track video performance, and understand ad strategies — all via the EcomSeer API.

## Language Handling / 语言适配

Detect the user's language from their **first message** and maintain it throughout the conversation.

| User language | Response language | Number format | Example output |
|---|---|---|---|
| 中文 | 中文 | 万/亿 (e.g. 1.2亿) | "共找到 5,000 条商品" |
| English | English | K/M/B (e.g. 120M) | "Found 5,000 products" |

**Rules:**
1. **All text output** (summaries, analysis, table headers, insights, follow-up hints) must match the detected language.
2. **Field name presentation:**
   - Chinese → use Chinese labels: 商品名称, 销量, 销售额, 达人数, 评分
   - English → use English labels: Product Name, Sales, Revenue, Influencers, Rating
3. **Error messages** must also match: "未找到数据" vs "No data found".
4. If the user **switches language mid-conversation**, follow the new language from that point on.

## API Access

Base URL: `https://www.ecomseer.com`
Auth header: `X-API-Key: $ECOMSEER_API_KEY`

All endpoints are GET requests:

```bash
curl -s "https://www.ecomseer.com/api/open/{endpoint}?{params}" \
  -H "X-API-Key: $ECOMSEER_API_KEY"
```

**Key conventions:**
- All endpoints start with `/api/open/`
- `region` param defaults to `US`. Other markets: GB, ID, TH, VN, MY, PH, SG, etc.
- Range filters use `"min,max"` format, `-1` means no limit (e.g. `sold_count=100,-1` means sales ≥ 100)
- Sort param `order` format: `"field_number,direction"`, 2=desc (e.g. `order=2,2`)
- Pagination: `page` (starts at 1), `pagesize` (default 10-20, max 50)

## Interaction Flow

### Step 1: Check API Key

Before any query, run: `[ -n "$ECOMSEER_API_KEY" ] && echo "ok" || echo "missing"`

**Never print the key value.**

#### If missing — show setup guide

**Reply with EXACTLY this (Chinese user):**

> 🔑 需要先配置 EcomSeer API Key 才能使用：
>
> 1. 打开 https://www.ecomseer.com 注册账号
> 2. 登录后在控制台找到 API Keys，创建一个 Key
> 3. 拿到 Key 后回来找我，我帮你配置 ✅

**Reply with EXACTLY this (English user):**

> 🔑 You need an EcomSeer API Key to get started:
>
> 1. Go to https://www.ecomseer.com and sign up
> 2. After signing in, find API Keys in your dashboard and create one
> 3. Come back with your key and I'll set it up for you ✅

Then STOP. Wait for the user to return with their key.

**❌ DO NOT** just say "please provide your API key

README.md

# EcomSeer — TikTok Shop E-commerce Intelligence Skill

[中文文档](README_CN.md)

All-in-one TikTok Shop data intelligence assistant. Search products, discover trending items, analyze influencers, explore shops, track video performance, and get ad insights — all through natural language.

## Features

- **Product Search** — Search TikTok Shop products by keyword, category, price, sales volume, with multi-market support
- **Sales Rankings** — Sales ranking, new products, managed (sShop) ranking, hot promotion ranking
- **Product Detail** — Deep dive into any product's sales trends, influencer partnerships, video performance, reviews
- **Influencer Analysis** — Search and analyze TikTok creators: followers, engagement, sales performance, fan demographics
- **Video Analytics** — Hot video search, video-product ranking, video detail with trend data
- **Shop Intelligence** — Search shops, view product lineup, analyze influencer partnerships
- **Ad & Creative Insights** — E-commerce ad search, advertiser analysis, trend insights, top keywords
- **Deep Research** — AI-powered deep analysis for complex queries. Automatically triggered for multi-dimensional analysis, returns structured HTML reports

## Install

```bash
npx clawhub install ecomseer
```

## Setup

1. Go to [www.ecomseer.com](https://www.ecomseer.com) to register and get your API Key
2. Configure:

```bash
openclaw config set skills.entries.ecomseer.apiKey "YOUR_ECOMSEER_API_KEY"
```


## Usage Examples

After setup, just tell your AI assistant:

| Category | Example prompts |
|----------|----------------|
| Product Search | "Search Bluetooth earbuds on TikTok Shop", "Find trending skincare products" |
| Rankings | "US TikTok Shop sales ranking", "Top new products this week" |
| Product Detail | "Show me this product's sales trend", "Which influencers promote this?" |
| Influencer | "Find beauty influencers with 100K+ followers", "Analyze this creator's performance" |
| Video | "Hot TikTok Shop videos this week", "Show video performance data" |
| Shop | "Search TikTok shops selling electronics", "Analyze this shop's product mix" |
| Ads | "Search e-commerce ad creatives", "What are the trending ad keywords?" |
| Deep Research | "Analyze US beauty category trends", "Compare top 5 shops in Southeast Asia" |

Supports both **English** and **Chinese** — the assistant responds in your language.

## Multi-Market Support

EcomSeer covers all TikTok Shop markets:

| Region Code | Market |
|-------------|--------|
| US | United States |
| GB | United Kingdom |
| ID | Indonesia |
| TH | Thailand |
| VN | Vietnam |
| MY | Malaysia |
| PH | Philippines |
| SG | Singapore |

Default market is US. Switch by saying "show me Indonesia data" or "切换到东南亚".

## Deep Research — AI-Powered Intelligence Reports

For complex analytical queries, EcomSeer automatically activates its **Deep Research Framework** — a server-side AI research engine that goes far beyond simple API lookups.

**What triggers Deep Research:**

-

_meta.json

{
  "ownerId": "kn7c1c01gzrc3m423t8n840m9s81vj6m",
  "slug": "ecomseer",
  "version": "1.0.1",
  "publishedAt": 1774344933269
}

references/api-ad.md

# 广告与创意 (Ad/Creative) + 标签 (Hashtag)

TikTok 广告素材分析模块，覆盖电商广告搜索、种草广告、广告主洞察、趋势分析、热门素材、热词、标签洞察等。标签模块因与广告标签洞察共用上游接口，一并收录。

---

## 广告搜索

### 1. 电商广告搜索

```
GET /api/open/ads/ec-search
```

搜索 TikTok 上的电商类广告素材。上游接口：`/api/da/V4/search`。

> **内部固定参数**：`da_type=1`（电商广告）。

**参数：**

| 参数 | 类型 | 必填 | 默认值 | 说明 |
|------|------|------|--------|------|
| `page` | int | 否 | 1 | 页码，≥1 |
| `pagesize` | int | 否 | 12 | 每页条数，最大 50 |
| `region` | str | 否 | US | 目标市场 |
| `words` | str | 否 | - | 搜索关键词 |
| `order` | str | 否 | - | 排序规则 |

---

### 2. 种草广告搜索

```
GET /api/open/ads/seed-search
```

搜索 TikTok 上的种草（内容营销）类广告素材。上游接口：`/api/da/V4/search`。

> **内部固定参数**：`da_type=1`、默认 `scene=3`（种草场景）。

**参数：**

| 参数 | 类型 | 必填 | 默认值 | 说明 |
|------|------|------|--------|------|
| `page` | int | 否 | 1 | 页码，≥1 |
| `pagesize` | int | 否 | 12 | 每页条数，最大 50 |
| `region` | str | 否 | US | 目标市场 |
| `words` | str | 否 | - | 搜索关键词 |
| `order` | str | 否 | - | 排序规则 |
| `scene` | int | 否 | 3 | 场景类型（默认 3=种草） |

---

### 3. 广告详情

```
GET /api/open/ads/detail
```

获取单条广告素材的详细信息。上游接口：`/api/da/V4/detail`。

**参数：**

| 参数 | 类型 | 必填 | 默认值 | 说明 |
|------|------|------|--------|------|
| `id` | str | ✅ | - | 广告 ID |
| `region` | str | 否 | US | 目标市场 |

---

## 广告主

### 4. 广告主洞察

```
GET /api/open/ads/advertiser
```

搜索和浏览广告主信息，了解其投放策略。上游接口：`/api/dar/V3/search`。

**参数：**

| 参数 | 类型 | 必填 | 默认值 | 说明 |
|------|------|------|--------|------|
| `page` | int | 否 | 1 | 页码，≥1 |
| `pagesize` | int | 否 | 12 | 每页条数，最大 50 |
| `region` | str | 否 | US | 目标市场 |
| `words` | str | 否 | - | 搜索关键词（广告主名称） |
| `order` | str | 否 | - | 排序规则 |

---

### 5. 广告主视频列表

```
GET /api/open/ads/advertiser/videos
```

获取指定广告主投放的视频广告列表。上游接口：`/api/dar/V3/videoList`。

**参数：**

| 参数 | 类型 | 必填 | 默认值 | 说明 |
|------|------|------|--------|------|
| `id` | str | ✅ | - | 广告主 ID |
| `page` | int | 否 | 1 | 页码，≥1 |
| `pagesize` | int | 否 | 12 | 每页条数，最大 50 |
| `region` | str | 否 | US | 目标市场 |

---

### 6. 广告主商品列表

```
GET /api/open/ads/advertiser/products
```

获取指定广告主推广的商品列表。上游接口：`/api/dar/V3/productList`。

**参数：**

| 参数 | 类型 | 必填 | 默认值 | 说明 |
|------|------|------|--------|------|
| `id` | str | ✅ | - | 广告主 ID |
| `page` | int | 否 | 1 | 页码，≥1 |
| `pagesize` | int | 否 | 12 | 每页条数，最大 50 |
| `region` | str | 否 | US | 目标市场 |

---

## 趋势与热门

### 7. 趋势洞察

```
GET /api/open/ads/trend-insights
```

获取广告投放的趋势洞察数据（按品类维度）。上游接口：`/api/da/V4/trendInsights`。

**参数：**

| 参数 | 类型 | 必填 | 默认值 | 说明 |
|------|------|------|--------|------|
| `region` | str | 否 | US | 目标市场 |
| `l3_cid` | str | 否 | - | 三级品类 ID，不传则返回整体趋势 |

---

### 8. 热门广告素材

```
GET /api/open/ads/top-ads
```

获取当前最热门的广告素材列表。上游接口：`/api/da/V4/topAds`。

**参数：**

| 参数 | 类型 | 必填 | 默认值 | 说明 |
|------|------|------|--------|------|
| `region` | str | 否 | US | 目标市场 |
| `l3_cid` | str | 否 | - | 三级品类 ID |
| `page` | int | 否 | 1 | 页码，≥1 |
| `pagesize` | int | 否 | 12 | 每页条数，最大 50 |

---

### 9. 广告热词

```
GET /api/open/ads/top-keywords
```

获取当前 TikTok 广告中的热门搜索关键词。上游接口：`/api/da/V4/topKeywords`。

**参数：**

| 参数 | 类型 | 必填 |

references/api-goods.md

# 商品搜索与榜单 (Goods)

商品模块提供 TikTok Shop 商品的多维度搜索和各类排行榜数据。

---

## 1. 商品搜索

```
GET /api/open/goods/search
```

根据关键词、品类、价格、销量等多维度条件搜索 TikTok Shop 商品。上游接口：`/api/goods/V2/search`。

**参数：**

| 参数 | 类型 | 必填 | 默认值 | 说明 |
|------|------|------|--------|------|
| `page` | int | 否 | 1 | 页码，≥1 |
| `pagesize` | int | 否 | 10 | 每页条数，最大 20 |
| `region` | str | 否 | US | 目标市场 |
| `keyword` | str | 否 | - | 搜索关键词（内部映射为上游 `words` 参数） |
| `order` | str | 否 | "2,2" | 排序规则 |
| `l1_cid` | str | 否 | - | 一级品类 ID（通过 `/api/open/goods/filters` 获取） |
| `l2_cid` | str | 否 | - | 二级品类 ID |
| `l3_cid` | str | 否 | - | 三级品类 ID |
| `price_min` | str | 否 | - | 最低价格（美元）。与 `price_max` 组合后内部拼接为 `price_amount=min,max` |
| `price_max` | str | 否 | - | 最高价格（美元），`-1` 表示不限 |
| `sold_count` | str | 否 | - | 总销量范围，格式 `"min,max"` |
| `day7_sold_count` | str | 否 | - | 近7天销量范围 |
| `sale_amount` | str | 否 | - | 总销售额范围 |
| `day7_sale_amount` | str | 否 | - | 近7天销售额范围 |
| `crate` | str | 否 | - | 佣金率范围 |
| `relate_author_count` | str | 否 | - | 关联达人数范围 |
| `author_order_rate` | str | 否 | - | 达人出单率范围 |
| `is_free_shipping` | str | 否 | - | 是否包邮（"1"=是） |
| `is_new` | str | 否 | - | 是否新品 |
| `is_hot_sale` | str | 否 | - | 是否热销 |
| `is_local` | str | 否 | - | 是否本地商品 |
| `is_cross_border` | str | 否 | - | 是否跨境商品 |
| `is_sshop` | str | 否 | - | 是否全托管商品（空字符串不传递） |
| `off_shelves` | str | 否 | - | 是否已下架 |
| `commerce_type` | str | 否 | - | 电商类型筛选 |

> **注意**：`price_min` 和 `price_max` 不是直接传给上游的，后端会将它们合并为 `price_amount="min,max"` 格式传递。如果只传其中一个，缺失的部分默认为 `0`（min）或 `-1`（max）。

---

## 2. 商品筛选条件

```
GET /api/open/goods/filters
```

获取商品搜索可用的筛选条件列表，包括品类树（一级/二级/三级品类 ID 和名称）、价格区间选项等。用于构建搜索筛选 UI 或获取品类 ID。上游接口：`/api/goods/filterInfo`。

**参数：**

| 参数 | 类型 | 必填 | 默认值 | 说明 |
|------|------|------|--------|------|
| `region` | str | 否 | US | 目标市场，不同市场品类树不同 |

---

## 3. 销量榜

```
GET /api/open/goods/sale-rank
```

按销量排名的商品榜单。上游接口：`/api/goods/saleRank`。

**参数：**

| 参数 | 类型 | 必填 | 默认值 | 说明 |
|------|------|------|--------|------|
| `page` | int | 否 | 1 | 页码，≥1 |
| `pagesize` | int | 否 | 10 | 每页条数，最大 10 |
| `region` | str | 否 | US | 目标市场 |
| `order` | str | 否 | "1,2" | 排序规则 |
| `date_type` | int | 否 | - | 时间维度类型（如 1=日榜、7=周榜） |
| `date_value` | str | 否 | - | 具体时间值，与 `date_type` 配合使用 |
| `l1_cid` | str | 否 | - | 一级品类 ID |

---

## 4. 新品榜

```
GET /api/open/goods/new-product
```

新上架商品排行榜。上游接口：`/api/goods/newProduct`。

**参数：**

| 参数 | 类型 | 必填 | 默认值 | 说明 |
|------|------|------|--------|------|
| `page` | int | 否 | 1 | 页码，≥1 |
| `pagesize` | int | 否 | 10 | 每页条数，最大 10 |
| `region` | str | 否 | US | 目标市场 |
| `order` | str | 否 | "1,2" | 排序规则 |
| `rank_type` | int | 否 | 11 | 榜单类型，固定为 11 |
| `dt` | str | 否 | - | 日期筛选 |
| `cid` | str | 否 | - | 品类 ID |
| `is_cross_border` | str | 否 | - | 是否跨境商品 |
| `is_sshop` | str | 否 | - | 是否全托管商品 |

---

## 5. 全托管商品榜

```
GET /api/open/goods/managed-rank
```

TikTok Shop 全托管（sShop）模式下的热门商品排行。上游接口：`/api/goods/sShopHotList`。

**参数：**

| 参数 | 类型 | 必填 | 默认值 | 说明 |
|------|------|------|--------|------|
| `page` | in

Related agents

Same protocol, similar job.

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.

MCPOPENCLAW
Github ReposUpdated 6mo 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 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular

OPENCLAW

Machine-readable data

The same record, as JSON, for agents and crawlers.

{
  "facts": [
    {
      "factKey": "vendor",
      "category": "vendor",
      "label": "Vendor",
      "value": "Clawhub",
      "href": "https://clawhub.ai/fly0pants/skills/ecomseer",
      "sourceUrl": "https://clawhub.ai/fly0pants/skills/ecomseer",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-09T02:22:05.498Z",
      "isPublic": true
    },
    {
      "factKey": "protocols",
      "category": "compatibility",
      "label": "Protocol compatibility",
      "value": "OpenClaw",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-fly0pants-ecomseer/contract",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-fly0pants-ecomseer/contract",
      "sourceType": "contract",
      "confidence": "medium",
      "observedAt": "2026-10-09T02:22:05.498Z",
      "isPublic": true
    },
    {
      "factKey": "traction",
      "category": "adoption",
      "label": "Adoption signal",
      "value": "10.1K downloads",
      "href": "https://clawhub.ai/fly0pants/ecomseer",
      "sourceUrl": "https://clawhub.ai/fly0pants/ecomseer",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-09T02:22:05.498Z",
      "isPublic": true
    },
    {
      "factKey": "latest_release",
      "category": "release",
      "label": "Latest release",
      "value": "1.0.1",
      "href": "https://clawhub.ai/fly0pants/ecomseer",
      "sourceUrl": "https://clawhub.ai/fly0pants/ecomseer",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-03-24T09:35:33.269Z",
      "isPublic": true
    },
    {
      "factKey": "handshake_status",
      "category": "security",
      "label": "Handshake status",
      "value": "UNKNOWN",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-fly0pants-ecomseer/trust",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-fly0pants-ecomseer/trust",
      "sourceType": "trust",
      "confidence": "medium",
      "observedAt": null,
      "isPublic": true
    }
  ],
  "events": [
    {
      "eventType": "release",
      "title": "Release 1.0.1",
      "description": "Version 1.0.1 - Switched the Deep Research endpoint from `deepresearch.admapix.com` to `deepresearch.ecomseer.com` for all research task submissions and polling. - No changes to API, user prompts, or skill logic. All interaction and language handling workflows remain unchanged.",
      "href": "https://clawhub.ai/fly0pants/ecomseer",
      "sourceUrl": "https://clawhub.ai/fly0pants/ecomseer",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-03-24T09:35:33.269Z",
      "isPublic": true
    }
  ]
}

Record generated Oct 9, 2026.

Sponsored

Ads related to EcomSeer and adjacent AI workflows.