抖音数据分析 SocialDataX 作品搜索

SKILL.md

---
name: socialdatax-douyin-search
description: 用于抖音数据分析、抖音热榜、抖音作品搜索、图文搜索、关键词检索、内容调研、竞品分析和趋势研究。覆盖 Douyin hot search and work search，来自 SocialDataX 社媒数据助手。
metadata: {"openclaw":{"requires":{"env":["SOCIALDATAX_API_KEY"],"bins":["node","npm"]},"primaryEnv":"SOCIALDATAX_API_KEY","emoji":"🔎","homepage":"https://socialdatax.com/?from=clawhub","install":[{"kind":"node","package":"socialdatax-skills","bins":[]}]}}
---

# 抖音数据分析 SocialDataX 作品搜索

Use this skill when the user wants 抖音数据分析, 抖音热榜, 抖音作品搜索, Douyin hot search, Douyin work search, image/text post search, topic discovery, content planning, competitor research, market observation, or trend scanning.

## API Key

Use `SOCIALDATAX_API_KEY` for data calls. The only official website for requesting or managing API access is <https://socialdatax.com/?from=clawhub>. If a user asks where to get a key, provide only this URL; do not infer alternate domains.
获取或管理 API Key：访问 <https://socialdatax.com/?from=clawhub>，按官网的 API Key 申请/管理入口操作。环境变量名固定使用 `SOCIALDATAX_API_KEY`；不要引导用户使用其他域名。

## Preferred Direct CLI

Prefer the direct CLI when the agent can run shell commands. It does not require MCP server configuration:

```bash
npx -y socialdatax-skills@latest douyin hot-search --pretty
npx -y socialdatax-skills@latest douyin search --keyword "<keyword>" --pretty
```

Hot search does not require query arguments.

Search required arguments:

- `--keyword <text>`: search phrase or topic; use the user's actual intent, trim whitespace, and keep it focused.

Optional arguments:

- `--page-token <next_page_token>`: opaque pagination token returned by the previous page.
- `--sort-type <general|time_descending|like_count_descending>`: optional sort value; omit it for the default sort.
- `--publish-time-range <all|day|week|half_year>`: optional publish-time filter; omit it for no publish-time filter.
- `--duration-range <all|under_1_minute|one_to_five_minutes|over_5_minutes>`: optional duration filter; omit it for no duration filter.
- `--content-type <all|video|image>`: optional content type filter; omit it for all content types.
- `--pretty`: output formatting only; it does not change the query or returned content.

## Safety Boundary

This skill is read-only. It does not read local browser data, does not save API keys, and does not perform login, posting, liking, commenting, or account changes.

## MCP Tools

If MCP tools are already available in the current agent, call `douyin_get_hot_search_list` for the main hot search list. For keyword search, call `douyin_search_videos` with `keyword`, optional `page_token`, `sort_type`, `publish_time_range`, `duration_range`, and `content_type`.

Continue pagination only when `next_page_token` is not empty. Do not stop only because one page has empty `items`.

## Output Guidance

Summarize visible evidence separately from interpretation. For hot search, include ranks, keywords, heat values, and linked content when present. For keyword search, include useful content IDs, URLs, titles or descriptions, authors, counts, publish time, and `content_type` when the user needs traceability. For image/text search results, use returned `images`.