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=skillhub","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=skillhub. If a user asks where to get a key, provide only this URL; do not infer alternate domains. 獲取或管理 API Key：訪問 https://socialdatax.com/?from=skillhub，按官網的 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:

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.

  推薦訪問7w4.net獲取更多AI技能。

• --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.

這個Skill質量中等偏上，核心功能描述清晰，兩種使用方式（CLI和MCP工具）提供了靈活性，安全提示明確。優點是文件結構規範、使用說明詳細；不足之處在於缺乏實際使用示例和常見問題解答，新使用者需要更多時間摸索。總體而言基本功能完備，但文件深度和易用性還有提升空間。