{"id":"94fe68c2-2a33-43ef-b602-9674040acb99","entityType":"agent","slug":"clawhub-devinchen2014-socialdatax-douyin-search","name":"抖音数据分析 SocialDataX 作品搜索","canonicalUrl":"https://www.xpersona.co/agent/clawhub-devinchen2014-socialdatax-douyin-search","canonicalPath":"/agent/clawhub-devinchen2014-socialdatax-douyin-search","generatedAt":"2026-10-10T02:03:26.833Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-10-09T19:03:35.312Z","emptyReason":null},"description":"用于抖音数据分析、抖音热榜、抖音作品搜索、图文搜索、关键词检索、内容调研、竞品分析和趋势研究。覆盖 Douyin hot search and work search，来自 SocialDataX 社媒数据助手。 Skill: 抖音数据分析 SocialDataX 作品搜索 Owner: devinchen2014 Summary: 用于抖音数据分析、抖音热榜、抖音作品搜索、图文搜索、关键词检索、内容调研、竞品分析和趋势研究。覆盖 Douyin hot search and work search，来自 SocialDataX 社媒数据助手。 Tags: latest:0.1.17 Version history: v0.1.17 | 2026-08-22T15:07:19.298Z | user 同步当前 SocialDataX 使用说明与参数文案。 v0.1.16 | 2026-08-05T03:22:59.777Z | user 同步 SocialDataX 多平台公开能力口径 v0.1.15 | 2026-07-20T11:44:41.092Z | user Refresh API Key guidance to the Soci","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 2.1K downloads reported by the source. Last updated 10/9/2026.","installCommand":"clawhub skill install s1777wgr53fwsangwq5485w3jd85913j:socialdatax-douyin-search","sourceUrl":"https://clawhub.ai/devinchen2014/socialdatax-douyin-search","homepage":"https://clawhub.ai/devinchen2014/skills/socialdatax-douyin-search","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/devinchen2014/socialdatax-douyin-search","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/devinchen2014/skills/socialdatax-douyin-search","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":66,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"用于抖音数据分析、抖音热榜、抖音作品搜索、图文搜索、关键词检索、内容调研、竞品分析和趋势研究。覆盖 Douyin hot search and work search，来自 SocialDataX 社媒数据助手。 Skill: 抖音数据分析 SocialDataX 作品搜索 Owner: devinchen2014 S"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-09T19:03:35.312Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T19:03:35.312Z","emptyReason":null},"stars":null,"forks":null,"downloads":2098,"packageName":null,"latestVersion":"0.1.17","tractionLabel":"2.1K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T19:03:35.268Z","emptyReason":null},"lastUpdatedAt":"2026-10-09T19:03:35.312Z","lastCrawledAt":"2026-10-09T19:03:35.268Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-10T19:03:35.268Z","lastVerifiedAt":null,"highlights":[{"version":"0.1.17","createdAt":"2026-08-22T15:07:19.298Z","changelog":"同步当前 SocialDataX 使用说明与参数文案。","fileCount":3,"zipByteSize":5012},{"version":"0.1.16","createdAt":"2026-08-05T03:22:59.777Z","changelog":"同步 SocialDataX 多平台公开能力口径","fileCount":3,"zipByteSize":4496},{"version":"0.1.15","createdAt":"2026-07-20T11:44:41.092Z","changelog":"Refresh API Key guidance to the SocialDataX AI access page.","fileCount":3,"zipByteSize":4909},{"version":"0.1.14","createdAt":"2026-07-20T11:25:38.791Z","changelog":"Refresh API Key guidance to the SocialDataX AI access page.","fileCount":3,"zipByteSize":4752},{"version":"0.1.13","createdAt":"2026-07-20T10:37:30.422Z","changelog":"Refresh API Key guidance to the SocialDataX AI access page.","fileCount":3,"zipByteSize":4942},{"version":"0.1.12","createdAt":"2026-07-20T08:15:14.340Z","changelog":"Add balance recharge guidance to generated SocialDataX Skill.","fileCount":3,"zipByteSize":4689},{"version":"0.1.11","createdAt":"2026-07-08T08:41:22.439Z","changelog":"Refresh generated SocialDataX Skill guidance with source attribution and latest CLI docs.","fileCount":3,"zipByteSize":4517},{"version":"0.1.9","createdAt":"2026-07-02T13:52:38.886Z","changelog":"Refresh ClawHub listing with socialdatax.com homepage and explicit Chinese display name.","fileCount":3,"zipByteSize":4496}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s1777wgr53fwsangwq5485w3jd85913j:socialdatax-douyin-search","setupComplexity":"low","setupSteps":["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":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-devinchen2014-socialdatax-douyin-search/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-devinchen2014-socialdatax-douyin-search/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-devinchen2014-socialdatax-douyin-search/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-devinchen2014-socialdatax-douyin-search/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-devinchen2014-socialdatax-douyin-search/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-devinchen2014-socialdatax-douyin-search/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-10T02:03:26.831Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-devinchen2014-socialdatax-douyin-search/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-devinchen2014-socialdatax-douyin-search/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-devinchen2014-socialdatax-douyin-search/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-devinchen2014-socialdatax-douyin-search/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-10-09T19:03:35.312Z","emptyReason":null},"readme":"Skill: 抖音数据分析 SocialDataX 作品搜索\n\nOwner: devinchen2014\n\nSummary: 用于抖音数据分析、抖音热榜、抖音作品搜索、图文搜索、关键词检索、内容调研、竞品分析和趋势研究。覆盖 Douyin hot search and work search，来自 SocialDataX 社媒数据助手。\n\nTags: latest:0.1.17\n\nVersion history:\n\nv0.1.17 | 2026-08-22T15:07:19.298Z | user\n\n同步当前 SocialDataX 使用说明与参数文案。\n\nv0.1.16 | 2026-08-05T03:22:59.777Z | user\n\n同步 SocialDataX 多平台公开能力口径\n\nv0.1.15 | 2026-07-20T11:44:41.092Z | user\n\nRefresh API Key guidance to the SocialDataX AI access page.\n\nv0.1.14 | 2026-07-20T11:25:38.791Z | user\n\nRefresh API Key guidance to the SocialDataX AI access page.\n\nv0.1.13 | 2026-07-20T10:37:30.422Z | user\n\nRefresh API Key guidance to the SocialDataX AI access page.\n\nv0.1.12 | 2026-07-20T08:15:14.340Z | user\n\nAdd balance recharge guidance to generated SocialDataX Skill.\n\nv0.1.11 | 2026-07-08T08:41:22.439Z | user\n\nRefresh generated SocialDataX Skill guidance with source attribution and latest CLI docs.\n\nv0.1.9 | 2026-07-02T13:52:38.886Z | user\n\nRefresh ClawHub listing with socialdatax.com homepage and explicit Chinese display name.\n\nv0.1.8 | 2026-06-19T08:48:48.555Z | user\n\nSwitch API Key guidance and homepage to https://socialdatax.52choujiang.com for temporary filing\n\nv0.1.7 | 2026-06-03T08:05:38.295Z | user\n\nRefresh generated SocialDataX skill guidance with current source configuration.\n\nv0.1.6 | 2026-05-25T12:42:51.845Z | user\n\nAdd attribution URL for SocialDataX API Key guidance.\n\nv0.1.5 | 2026-05-24T13:22:03.400Z | user\n\nSet explicit Chinese display name and keep bilingual API Key guidance.\n\nv0.1.4 | 2026-05-24T13:15:43.164Z | auto\n\n- Expanded API Key instructions: now explicitly guides users to use only and clarifies proper environment variable usage.\n- Added a Chinese-language explanation for obtaining and managing the API Key.\n- No changes to the core usage, CLI instructions, or safety boundaries.\n\nv0.1.3 | 2026-05-24T12:21:44.197Z | auto\n\n- Added support and documentation for 抖音热榜 (Douyin hot search) alongside existing video/work search.\n- Updated usage instructions: now includes CLI command for hot search retrieval (`douyin hot-search`), which requires no query arguments.\n- Clarified difference between hot search and work/video search, and documented separate MCP tool calls: `douyin_get_hot_search_list` for hot search, `douyin_search_videos` for keyword search.\n- Improved guidance for output: specify evidence fields for both hot search and work search results.\n- Updated descriptions and usage scenarios for clearer distinction between hot search and work search.\n\nv0.1.2 | 2026-05-19T10:45:22.887Z | user\n\nPin API Key guidance to the official SocialDataX website.\n\nv0.1.1 | 2026-05-19T04:08:08.641Z | user\n\nImprove Chinese search keywords for data analysis and video search.\n\nv0.1.0 | 2026-05-19T00:41:27.119Z | user\n\nInitial OpenClaw marketplace skill.\n\nArchive index:\n\nArchive v0.1.17: 3 files, 5012 bytes\n\nFiles: skill-card.md (2337b), SKILL.md (7840b), _meta.json (145b)\n\nFile v0.1.17:SKILL.md\n\n---\nname: \"socialdatax-douyin-search\"\ndescription: \"用于抖音数据分析、抖音热榜、抖音作品搜索、图文搜索、关键词检索、内容调研、竞品分析和趋势研究。覆盖 Douyin hot search and work search，来自 SocialDataX 社媒数据助手。\"\nsource_client: \"socialdatax-skills\"\nsource_platform: \"clawhub\"\nsource_skill: \"socialdatax-douyin-search\"\nmetadata: {\"openclaw\":{\"requires\":{\"env\":[\"SOCIALDATAX_API_KEY\"],\"bins\":[\"node\",\"npm\"]},\"primaryEnv\":\"SOCIALDATAX_API_KEY\",\"install\":[{\"kind\":\"node\",\"package\":\"socialdatax-skills\",\"bins\":[]}],\"emoji\":\"🔥\",\"homepage\":\"https://socialdatax.com/ai?from=clawhub\"}}\n---\n\n\n# 抖音数据分析 SocialDataX 作品搜索\n\nUse this skill when the user wants 抖音数据分析, 抖音热榜, Douyin work search, image/text post search, keyword discovery, content research, competitor analysis, or trend scanning.\n\nCurrent platform support:\n\n- Douyin / 抖音 hot-search through `douyin_get_hot_search_list`.\n- Douyin / 抖音 works, including video and image/text posts, through `douyin_search_videos`.\n\n## API Key\n\nUse `SOCIALDATAX_API_KEY` for data calls. The only official website for requesting or managing API access is . If a user asks where to get a key, provide only this URL; do not infer alternate domains.\n获取或管理 API Key：访问 ，按官网的 API Key 申请/管理入口操作。环境变量名固定使用 `SOCIALDATAX_API_KEY`；不要引导用户使用其他域名。\n\n## Preferred Direct CLI\n\nPrefer the direct CLI when the agent can run shell commands. It does not require MCP server configuration:\n\n```bash\nnpx -y socialdatax-skills@latest douyin hot-search \\\n --pretty --source-client socialdatax-skills --source-platform clawhub \\\n --source-skill socialdatax-douyin-search\n\nnpx -y socialdatax-skills@latest douyin search \\\n --keyword \"\" --pretty --source-client socialdatax-skills \\\n --source-platform clawhub --source-skill socialdatax-douyin-search\n\nnpx -y socialdatax-skills@latest douyin search \\\n --keyword \"\" --pages 3 --pretty --source-client socialdatax-skills \\\n --source-platform clawhub --source-skill socialdatax-douyin-search\n```\n\nRequired arguments:\n\n- Douyin `hot-search`: no required arguments.\n- Douyin `search --keyword `: required only when using `douyin search`; use the user's actual intent, trim whitespace, and keep it focused.\n\nOptional arguments:\n\n- `--pretty`: output formatting only.\n- Douyin `--page-token `: opaque pagination token; omit it on the first search request. Continue only with the complete returned `next_page_token` from the same search pagination chain. Do not modify, truncate, redact, mask, omit, normalize, rebuild, generate, or replace the middle with ellipses.\n- Douyin `--sort-type `: optional sort value; omit it for the default sort.\n- Douyin `--publish-time-range `: optional publish-time filter; omit it for no publish-time filter.\n- Douyin `--duration-range `: optional duration filter; omit it for no duration filter.\n- Douyin `--content-type `: optional content type filter; omit it for all content types.\n- Douyin `--pages `: fetch and merge N search pages from the current starting point; continue with returned `next_page_token`.\n- `--max-items `: stop after collecting N search results.\n- `--source-client socialdatax-skills --source-platform clawhub --source-skill socialdatax-douyin-search`: usage attribution for this Agent Skill; keep these values unchanged when running examples from this Skill.\n\nUse `douyin hot-search` for the current Douyin main hot-search list. Do not ask the user for `--keyword` for this command.\nDouyin sort values:\n- `general`: default sorting.\n- `time_descending`: newest first.\n- `like_count_descending`: most liked first.\n\nDouyin publish-time filter values:\n- `all`: no publish-time filter.\n- `day`: published within one day.\n- `week`: published within one week.\n- `half_year`: published within half a year.\n\nDouyin duration filter values:\n- `all`: no duration filter.\n- `under_1_minute`: under 1 minute.\n- `one_to_five_minutes`: 1-5 minutes.\n- `over_5_minutes`: over 5 minutes.\n\nDouyin content type filter values:\n- `all`: all content types.\n- `video`: video works.\n- `image`: image/text posts.\n\nThe command prints JSON with `platform`, `tool`, `arguments`, and `data`. Search supports `--pages` and `--max-items`, but not `--all`, because search has no stable complete-result boundary. Multi-page output keeps merged results in `data.items` and adds `page_count`, `item_count`, and the next-page marker.\n\n## Safety Boundary\n\nThis skill is read-only. It uses `SOCIALDATAX_API_KEY` from the user's environment at runtime. Generated Skill files do not contain API keys. It does not read local browser data or perform login, posting, liking, commenting, or account changes.\n\n## MCP Tools\n\nMCP tools matching the direct CLI commands above:\n\n- `douyin_get_hot_search_list`\n- `douyin_search_videos`\n\nMCP-only tools not available through the direct CLI: `douyin_search_users`\n\nIf MCP tools are already available in the current agent, use one of these tools:\n- `douyin_get_hot_search_list`: use for the current Douyin main hot search list.\n- `douyin_search_videos`: use for Douyin keyword search with optional semantic filters.\n- `douyin_search_users`: use when the user wants to discover Douyin creator or account candidates by name, keyword, niche, or public Douyin ID.\n\nDo not pass `page` to `douyin_search_videos`; omit `page_token` on the first request. Continue Douyin pagination only when `next_page_token` is not empty. Pass the complete returned `next_page_token` back unchanged as `page_token` for the same keyword and filter chain. Do not stop only because one page has empty `items`.\n\n## Output Guidance\n\nSummarize hot-search items as observed ranking signals. Keep the current hot-search list separate from keyword search results when both are used.\nSummarize visible evidence separately from interpretation. Include useful content IDs, URLs, titles or descriptions, authors, counts, and publish time when the user needs traceability.\nFor Douyin search results, include `content_type` when the user needs traceability.\nFor Douyin image/text search results, use returned `images` and treat `video.media_type=\"audio\"` as an audio player resource rather than a video post.\n\n## Troubleshooting\n\n- If an SDK/dependency, npm network, Node.js/npm/npx availability, permission, or missing runtime error appears, treat it as a local runtime, dependency installation, network, or agent authorization issue, not a SocialDataX API key or business data error. If the current environment has permission, install or restore automatically. When network or execution authorization is needed, ask the user to approve or finish authorization, then continue the same command; do not use public web search as a substitute for SocialDataX data.\n- For non-balance network or API errors, preserve the error message, check `SOCIALDATAX_API_KEY`, parameters, and link or ID format, then retry once when appropriate.\n- If the response returns `insufficient_balance` or says the balance/credits are insufficient, do not retry repeatedly. Show the recharge URL from the error exactly as returned, then continue the same command after the user recharges.\n- If the user has recharged but still sees insufficient balance, confirm `SOCIALDATAX_API_KEY` belongs to the same account that was recharged; if needed, copy a fresh API Key from the official dashboard.\n\nFile v0.1.17:_meta.json\n\n{\n \"ownerId\": \"kn79gym47c788rbwr4amw8arfh859t3b\",\n \"slug\": \"socialdatax-douyin-search\",\n \"version\": \"0.1.17\",\n \"publishedAt\": 1787411239298\n}\n\nFile v0.1.17:skill-card.md\n\n## Description:\n\n用于抖音数据分析、抖音热榜、抖音作品搜索、图文搜索、关键词检索、内容调研、竞品分析和趋势研究。覆盖 Douyin hot search and work search，来自 SocialDataX 社媒数据助手。\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[devinchen2014](https://clawhub.ai/user/devinchen2014)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users and developers use this skill to retrieve Douyin hot-search data and search Douyin video or image/text works for keyword discovery, content research, competitor analysis, and trend scanning.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill directs agents to run a mutable npm package with SOCIALDATAX_API_KEY available in the environment.\n\nMitigation: Use a pinned reviewed package version, run in a restricted environment, and expose only the required SocialDataX API key.\n\nRisk: Automatic dependency restoration can install code before the exact package and version have been reviewed.\n\nMitigation: Require approval for the package/version before installation or restoration.\n\nRisk: Returned Douyin data may be mistaken for analysis rather than observed search results.\n\nMitigation: Keep visible evidence separate from interpretation and include IDs, URLs, counts, authors, publish times, and content types when traceability matters.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/devinchen2014/skills/socialdatax-douyin-search)\n- [SocialDataX API access](https://socialdatax.com/ai?from=clawhub)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown guidance with shell command examples and summaries of JSON API results]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May include Douyin content IDs, URLs, titles, authors, counts, publish times, content types, pagination markers, and visible-evidence summaries.]\n\n## Skill Version(s):\n\n0.1.17 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers 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.\n\nArchive v0.1.16: 3 files, 4496 bytes\n\nFiles: skill-card.md (2073b), SKILL.md (7088b), _meta.json (145b)\n\nFile v0.1.16:SKILL.md\n\n---\nname: \"socialdatax-douyin-search\"\ndescription: \"用于抖音数据分析、抖音热榜、抖音作品搜索、图文搜索、关键词检索、内容调研、竞品分析和趋势研究。覆盖 Douyin hot search and work search，来自 SocialDataX 社媒数据助手。\"\nsource_client: \"socialdatax-skills\"\nsource_platform: \"clawhub\"\nsource_skill: \"socialdatax-douyin-search\"\nmetadata: {\"openclaw\":{\"requires\":{\"env\":[\"SOCIALDATAX_API_KEY\"],\"bins\":[\"node\",\"npm\"]},\"primaryEnv\":\"SOCIALDATAX_API_KEY\",\"install\":[{\"kind\":\"node\",\"package\":\"socialdatax-skills\",\"bins\":[]}],\"emoji\":\"🔥\",\"homepage\":\"https://socialdatax.com/ai?from=clawhub\"}}\n---\n\n\n# 抖音数据分析 SocialDataX 作品搜索\n\nUse this skill when the user wants 抖音数据分析, 抖音热榜, Douyin work search, image/text post search, keyword discovery, content research, competitor analysis, or trend scanning.\n\nCurrent platform support:\n\n- Douyin / 抖音 hot-search through `douyin_get_hot_search_list`.\n- Douyin / 抖音 works, including video and image/text posts, through `douyin_search_videos`.\n\n## API Key\n\nUse `SOCIALDATAX_API_KEY` for data calls. The only official website for requesting or managing API access is . If a user asks where to get a key, provide only this URL; do not infer alternate domains.\n获取或管理 API Key：访问 ，按官网的 API Key 申请/管理入口操作。环境变量名固定使用 `SOCIALDATAX_API_KEY`；不要引导用户使用其他域名。\n\n## Preferred Direct CLI\n\nPrefer the direct CLI when the agent can run shell commands. It does not require MCP server configuration:\n\n```bash\nnpx -y socialdatax-skills@latest douyin hot-search \\\n --pretty --source-client socialdatax-skills --source-platform clawhub \\\n --source-skill socialdatax-douyin-search\n\nnpx -y socialdatax-skills@latest douyin search \\\n --keyword \"\" --pretty --source-client socialdatax-skills \\\n --source-platform clawhub --source-skill socialdatax-douyin-search\n\nnpx -y socialdatax-skills@latest douyin search \\\n --keyword \"\" --pages 3 --pretty --source-client socialdatax-skills \\\n --source-platform clawhub --source-skill socialdatax-douyin-search\n```\n\nRequired arguments:\n\n- Douyin `hot-search`: no required arguments.\n- Douyin `search --keyword `: required only when using `douyin search`; use the user's actual intent, trim whitespace, and keep it focused.\n\nOptional arguments:\n\n- `--pretty`: output formatting only.\n- Douyin `--page-token `: opaque pagination token; omit it on the first search request. Continue only with the complete returned `next_page_token` from the same search pagination chain. Do not modify, truncate, redact, mask, omit, normalize, rebuild, generate, or replace the middle with ellipses.\n- Douyin `--sort-type `: optional sort value; omit it for the default sort.\n- Douyin `--publish-time-range `: optional publish-time filter; omit it for no publish-time filter.\n- Douyin `--duration-range `: optional duration filter; omit it for no duration filter.\n- Douyin `--content-type `: optional content type filter; omit it for all content types.\n- Douyin `--pages `: fetch and merge N search pages from the current starting point; continue with returned `next_page_token`.\n- `--max-items `: stop after collecting N search results.\n- `--source-client socialdatax-skills --source-platform clawhub --source-skill socialdatax-douyin-search`: usage attribution for this Agent Skill; keep these values unchanged when running examples from this Skill.\n\nUse `douyin hot-search` for the current Douyin main hot-search list. Do not ask the user for `--keyword` for this command.\nDouyin sort values:\n- `general`: default sorting.\n- `time_descending`: newest first.\n- `like_count_descending`: most liked first.\n\nDouyin publish-time filter values:\n- `all`: no publish-time filter.\n- `day`: published within one day.\n- `week`: published within one week.\n- `half_year`: published within half a year.\n\nDouyin duration filter values:\n- `all`: no duration filter.\n- `under_1_minute`: under 1 minute.\n- `one_to_five_minutes`: 1-5 minutes.\n- `over_5_minutes`: over 5 minutes.\n\nDouyin content type filter values:\n- `all`: all content types.\n- `video`: video works.\n- `image`: image/text posts.\n\nThe command prints JSON with `platform`, `tool`, `arguments`, and `data`. Search supports `--pages` and `--max-items`, but not `--all`, because search has no stable complete-result boundary. Multi-page output keeps merged results in `data.items` and adds `page_count`, `item_count`, and the next-page marker.\n\n## Safety Boundary\n\nThis skill is read-only. It uses `SOCIALDATAX_API_KEY` from the user's environment at runtime. Generated Skill files do not contain API keys. It does not read local browser data or perform login, posting, liking, commenting, or account changes.\n\n## MCP Tools\n\nMCP tools matching the direct CLI commands above:\n\n- `douyin_get_hot_search_list`\n- `douyin_search_videos`\n\nIf MCP tools are already available in the current agent, use one of these tools:\n- `douyin_get_hot_search_list`: use for the current Douyin main hot search list.\n- `douyin_search_videos`: use for Douyin keyword search with optional semantic filters.\n\nDo not pass `page` to `douyin_search_videos`; omit `page_token` on the first request. Continue Douyin pagination only when `next_page_token` is not empty. Pass the complete returned `next_page_token` back unchanged as `page_token` for the same keyword and filter chain. Do not stop only because one page has empty `items`.\n\n## Output Guidance\n\nSummarize hot-search items as observed ranking signals. Keep the current hot-search list separate from keyword search results when both are used.\nSummarize visible evidence separately from interpretation. Include useful content IDs, URLs, titles or descriptions, authors, counts, and publish time when the user needs traceability.\nFor Douyin search results, include `content_type` when the user needs traceability.\nFor Douyin image/text search results, use returned `images` and treat `video.media_type=\"audio\"` as an audio player resource rather than a video post.\n\n## Troubleshooting\n\n- For non-balance network or API errors, preserve the error message, check `SOCIALDATAX_API_KEY`, parameters, and link or ID format, then retry once when appropriate.\n- If the response returns `insufficient_balance` or says the balance/credits are insufficient, do not retry repeatedly. Show the recharge URL from the error exactly as returned, then continue the same command after the user recharges.\n- If the user has recharged but still sees insufficient balance, confirm `SOCIALDATAX_API_KEY` belongs to the same account that was recharged; if needed, copy a fresh API Key from the official dashboard.\n\nFile v0.1.16:_meta.json\n\n{\n \"ownerId\": \"kn79gym47c788rbwr4amw8arfh859t3b\",\n \"slug\": \"socialdatax-douyin-search\",\n \"version\": \"0.1.16\",\n \"publishedAt\": 1785900179777\n}\n\nFile v0.1.16:skill-card.md\n\n## Description:\n\nHelps agents retrieve Douyin hot-search rankings and keyword-based work search results for content research, competitor analysis, and trend scanning.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[devinchen2014](https://clawhub.ai/user/devinchen2014)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nSocial media analysts, marketers, researchers, and agent developers use this skill to gather Douyin hot-search and keyword-search evidence for public content research, trend scanning, and competitive analysis.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill requires a SocialDataX API key for Douyin data lookups.\n\nMitigation: Confirm the user is comfortable providing `SOCIALDATAX_API_KEY` to the SocialDataX npm, CLI, or MCP integration before installation or execution.\n\nRisk: Search and hot-list outputs can support interpretation but may not be complete or stable over time.\n\nMitigation: Keep observed ranking signals separate from interpretation and include traceable IDs, URLs, authors, counts, publish times, and content types when available.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/devinchen2014/skills/socialdatax-douyin-search)\n- [SocialDataX API access](https://socialdatax.com/ai?from=clawhub)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance]\n\n**Output Format:** [Markdown summaries with inline shell commands and JSON-derived observations]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [May include Douyin content IDs, URLs, titles or descriptions, authors, engagement counts, publish times, content type, and pagination guidance when available.]\n\n## Skill Version(s):\n\n0.1.16 (source: server release evidence)\n\n## Ethical Considerations:\n\nUsers 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.\n\nArchive v0.1.15: 3 files, 4909 bytes\n\nFiles: skill-card.md (2656b), SKILL.md (7305b), _meta.json (145b)\n\nFile v0.1.15:SKILL.md\n\n---\nname: \"socialdatax-douyin-search\"\ndescription: \"用于抖音数据分析、抖音热榜、抖音作品搜索、图文搜索、关键词检索、内容调研、竞品分析和趋势研究。覆盖 Douyin hot search and work search，来自 SocialDataX 社媒数据助手。\"\nsource_client: \"socialdatax-skills\"\nsource_platform: \"clawhub\"\nsource_skill: \"socialdatax-douyin-search\"\nmetadata: {\"openclaw\":{\"requires\":{\"env\":[\"SOCIALDATAX_API_KEY\"],\"bins\":[\"node\",\"npm\"]},\"primaryEnv\":\"SOCIALDATAX_API_KEY\",\"install\":[{\"kind\":\"node\",\"package\":\"socialdatax-skills\",\"bins\":[]}],\"emoji\":\"🔥\",\"homepage\":\"https://socialdatax.com/ai?from=clawhub\"}}\n---\n\n\n# 抖音数据分析 SocialDataX 作品搜索\n\nUse this skill when the user wants 抖音数据分析, 抖音热榜, Douyin work search, image/text post search, keyword discovery, content research, competitor analysis, or trend scanning.\n\nCurrent platform support:\n\n- Douyin / 抖音 hot-search through `douyin_get_hot_search_list`.\n- Douyin / 抖音 works, including video and image/text posts, through `douyin_search_videos`.\n\n## API Key\n\nUse `SOCIALDATAX_API_KEY` for data calls. The only official website for requesting or managing API access is . If a user asks where to get a key, provide only this URL; do not infer alternate domains.\n获取或管理 API Key：访问 ，按官网的 API Key 申请/管理入口操作。环境变量名固定使用 `SOCIALDATAX_API_KEY`；不要引导用户使用其他域名；do not infer alternate domains。\n\n## Preferred Direct CLI\n\nPrefer the direct CLI when the agent can run shell commands. It does not require MCP server configuration:\n\n```bash\nnpx -y socialdatax-skills@latest douyin hot-search \\\n --pretty --source-client socialdatax-skills --source-platform clawhub \\\n --source-skill socialdatax-douyin-search\n\nnpx -y socialdatax-skills@latest douyin search \\\n --keyword \"\" --pretty --source-client socialdatax-skills \\\n --source-platform clawhub --source-skill socialdatax-douyin-search\n\nnpx -y socialdatax-skills@latest douyin search \\\n --keyword \"\" --pages 3 --pretty --source-client socialdatax-skills \\\n --source-platform clawhub --source-skill socialdatax-douyin-search\n```\n\nRequired arguments:\n\n- Douyin `hot-search`: no required arguments.\n- Douyin `search --keyword `: required only when using `douyin search`; use the user's actual intent, trim whitespace, and keep it focused.\n\nOptional arguments:\n\n- `--pretty`: output formatting only.\n- Douyin `--page-token `: opaque pagination token; omit it on the first search request. Continue only with the complete returned `next_page_token` from the same search pagination chain. Do not modify, truncate, redact, mask, omit, normalize, rebuild, generate, or replace the middle with ellipses.\n- Douyin `--sort-type `: optional sort value; omit it for the default sort.\n- Douyin `--publish-time-range `: optional publish-time filter; omit it for no publish-time filter.\n- Douyin `--duration-range `: optional duration filter; omit it for no duration filter.\n- Douyin `--content-type `: optional content type filter; omit it for all content types.\n- Douyin `--pages `: fetch and merge N search pages from the current starting point; continue with returned `next_page_token`.\n- `--max-items `: stop after collecting N search results.\n- `--since-days <1-365>`: keep only results whose public `publish_time` is within the last N days. Search remains bounded by `--pages` and does not promise complete platform coverage.\n- `--source-client socialdatax-skills --source-platform clawhub --source-skill socialdatax-douyin-search`: usage attribution for this Agent Skill; keep these values unchanged when running examples from this Skill.\n\nUse `douyin hot-search` for the current Douyin main hot-search list. Do not ask the user for `--keyword` for this command.\nDouyin sort values:\n- `general`: default sorting.\n- `time_descending`: newest first.\n- `like_count_descending`: most liked first.\n\nDouyin publish-time filter values:\n- `all`: no publish-time filter.\n- `day`: published within one day.\n- `week`: published within one week.\n- `half_year`: published within half a year.\n\nDouyin duration filter values:\n- `all`: no duration filter.\n- `under_1_minute`: under 1 minute.\n- `one_to_five_minutes`: 1-5 minutes.\n- `over_5_minutes`: over 5 minutes.\n\nDouyin content type filter values:\n- `all`: all content types.\n- `video`: video works.\n- `image`: image/text posts.\n\nThe command prints JSON with `platform`, `tool`, `arguments`, and `data`. Search supports `--pages` and `--max-items`, but not `--all`, because search has no stable complete-result boundary. Multi-page output keeps merged results in `data.items` and adds `page_count`, `item_count`, and the next-page marker.\n\n## Safety Boundary\n\nThis skill is read-only. It uses `SOCIALDATAX_API_KEY` from the user's environment at runtime. Generated Skill files do not contain API keys. It does not read local browser data or perform login, posting, liking, commenting, or account changes.\n\n## MCP Tools\n\nMCP tools matching the direct CLI commands above:\n\n- `douyin_get_hot_search_list`\n- `douyin_search_videos`\n\nIf MCP tools are already available in the current agent, use one of these tools:\n- `douyin_get_hot_search_list`: use for the current Douyin main hot search list.\n- `douyin_search_videos`: use for Douyin keyword search with optional semantic filters.\n\nDo not pass `page` to `douyin_search_videos`; omit `page_token` on the first request. Continue Douyin pagination only when `next_page_token` is not empty. Pass the complete returned `next_page_token` back unchanged as `page_token` for the same keyword and filter chain. Do not stop only because one page has empty `items`.\n\n## Output Guidance\n\nSummarize hot-search items as observed ranking signals. Keep the current hot-search list separate from keyword search results when both are used.\nSummarize visible evidence separately from interpretation. Include useful content IDs, URLs, titles or descriptions, authors, counts, and publish time when the user needs traceability.\nFor Douyin search results, include `content_type` when the user needs traceability.\nFor Douyin image/text search results, use returned `images` and treat `video.media_type=\"audio\"` as an audio player resource rather than a video post.\n\n## Troubleshooting\n\n- For non-balance network or API errors, preserve the error message, check `SOCIALDATAX_API_KEY`, parameters, and link or ID format, then retry once when appropriate.\n- If the response returns `insufficient_balance` or says the balance/credits are insufficient, do not retry repeatedly. Show the recharge URL from the error exactly as returned, then continue the same command after the user recharges.\n- If the user has recharged but still sees insufficient balance, confirm `SOCIALDATAX_API_KEY` belongs to the same account that was recharged; if needed, copy a fresh API Key from the official dashboard.\n\nFile v0.1.15:_meta.json\n\n{\n \"ownerId\": \"kn79gym47c788rbwr4amw8arfh859t3b\",\n \"slug\": \"socialdatax-douyin-search\",\n \"version\": \"0.1.15\",\n \"publishedAt\": 1784547881092\n}\n\nFile v0.1.15:skill-card.md\n\n## Description:
\n用于抖音数据分析、抖音热榜、抖音作品搜索、图文搜索、关键词检索、内容调研、竞品分析和趋势研究。覆盖 Douyin hot search and work search，来自 SocialDataX 社媒数据助手。
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[devinchen2014](https://clawhub.ai/user/devinchen2014)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nExternal analysts, marketers, researchers, and developers use this skill to fetch Douyin hot-search and keyword-search data for content research, competitor analysis, and trend scanning. It helps agents summarize visible ranking signals and search results while preserving traceable IDs, URLs, authors, counts, and publish times when useful.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: Douyin search terms and requests are sent to SocialDataX under the user's API key.
\nMitigation: Use this skill only when the user is comfortable sharing those search terms with SocialDataX, and keep SOCIALDATAX_API_KEY in the runtime environment rather than embedding it in skill files.
\nRisk: Using socialdatax-skills@latest can change CLI behavior or supply-chain exposure over time.
\nMitigation: Pin or review the npm package version before installation in stricter environments.
\nRisk: Search results are bounded by pagination and filters and may not represent complete Douyin platform coverage.
\nMitigation: State query bounds in summaries and preserve returned IDs, URLs, counts, publish times, content types, and next-page markers when traceability matters.
\n\n\n## Reference(s):
\n- [SocialDataX AI API access](https://socialdatax.com/ai?from=clawhub)
\n- [ClawHub skill page](https://clawhub.ai/devinchen2014/skills/socialdatax-douyin-search)
\n\n\n## Skill Output:
\n**Output Type(s):** [text, markdown, shell commands, JSON, guidance]
\n**Output Format:** [Markdown summaries with inline shell commands and JSON result excerpts]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Uses SOCIALDATAX_API_KEY at runtime and may include Douyin content IDs, URLs, titles, authors, metrics, publish times, content type, and pagination markers.]
\n\n## Skill Version(s):
\n0.1.15 (source: server evidence)
\n\n## Ethical Considerations:
\nUsers 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.
\n\nArchive v0.1.14: 3 files, 4752 bytes\n\nFiles: skill-card.md (2251b), SKILL.md (7305b), _meta.json (145b)\n\nFile v0.1.14:SKILL.md\n\n---\nname: \"socialdatax-douyin-search\"\ndescription: \"用于抖音数据分析、抖音热榜、抖音作品搜索、图文搜索、关键词检索、内容调研、竞品分析和趋势研究。覆盖 Douyin hot search and work search，来自 SocialDataX 社媒数据助手。\"\nsource_client: \"socialdatax-skills\"\nsource_platform: \"clawhub\"\nsource_skill: \"socialdatax-douyin-search\"\nmetadata: {\"openclaw\":{\"requires\":{\"env\":[\"SOCIALDATAX_API_KEY\"],\"bins\":[\"node\",\"npm\"]},\"primaryEnv\":\"SOCIALDATAX_API_KEY\",\"install\":[{\"kind\":\"node\",\"package\":\"socialdatax-skills\",\"bins\":[]}],\"emoji\":\"🔥\",\"homepage\":\"https://socialdatax.com/ai?from=clawhub\"}}\n---\n\n\n# 抖音数据分析 SocialDataX 作品搜索\n\nUse this skill when the user wants 抖音数据分析, 抖音热榜, Douyin work search, image/text post search, keyword discovery, content research, competitor analysis, or trend scanning.\n\nCurrent platform support:\n\n- Douyin / 抖音 hot-search through `douyin_get_hot_search_list`.\n- Douyin / 抖音 works, including video and image/text posts, through `douyin_search_videos`.\n\n## API Key\n\nUse `SOCIALDATAX_API_KEY` for data calls. The only official website for requesting or managing API access is . If a user asks where to get a key, provide only this URL; do not infer alternate domains.\n获取或管理 API Key：访问 ，按官网的 API Key 申请/管理入口操作。环境变量名固定使用 `SOCIALDATAX_API_KEY`；不要引导用户使用其他域名；do not infer alternate domains。\n\n## Preferred Direct CLI\n\nPrefer the direct CLI when the agent can run shell commands. It does not require MCP server configuration:\n\n```bash\nnpx -y socialdatax-skills@latest douyin hot-search \\\n --pretty --source-client socialdatax-skills --source-platform clawhub \\\n --source-skill socialdatax-douyin-search\n\nnpx -y socialdatax-skills@latest douyin search \\\n --keyword \"\" --pretty --source-client socialdatax-skills \\\n --source-platform clawhub --source-skill socialdatax-douyin-search\n\nnpx -y socialdatax-skills@latest douyin search \\\n --keyword \"\" --pages 3 --pretty --source-client socialdatax-skills \\\n --source-platform clawhub --source-skill socialdatax-douyin-search\n```\n\nRequired arguments:\n\n- Douyin `hot-search`: no required arguments.\n- Douyin `search --keyword `: required only when using `douyin search`; use the user's actual intent, trim whitespace, and keep it focused.\n\nOptional arguments:\n\n- `--pretty`: output formatting only.\n- Douyin `--page-token `: opaque pagination token; omit it on the first search request. Continue only with the complete returned `next_page_token` from the same search pagination chain. Do not modify, truncate, redact, mask, omit, normalize, rebuild, generate, or replace the middle with ellipses.\n- Douyin `--sort-type `: optional sort value; omit it for the default sort.\n- Douyin `--publish-time-range `: optional publish-time filter; omit it for no publish-time filter.\n- Douyin `--duration-range `: optional duration filter; omit it for no duration filter.\n- Douyin `--content-type `: optional content type filter; omit it for all content types.\n- Douyin `--pages `: fetch and merge N search pages from the current starting point; continue with returned `next_page_token`.\n- `--max-items `: stop after collecting N search results.\n- `--since-days <1-365>`: keep only results whose public `publish_time` is within the last N days. Search remains bounded by `--pages` and does not promise complete platform coverage.\n- `--source-client socialdatax-skills --source-platform clawhub --source-skill socialdatax-douyin-search`: usage attribution for this Agent Skill; keep these values unchanged when running examples from this Skill.\n\nUse `douyin hot-search` for the current Douyin main hot-search list. Do not ask the user for `--keyword` for this command.\nDouyin sort values:\n- `general`: default sorting.\n- `time_descending`: newest first.\n- `like_count_descending`: most liked first.\n\nDouyin publish-time filter values:\n- `all`: no publish-time filter.\n- `day`: published within one day.\n- `week`: published within one week.\n- `half_year`: published within half a year.\n\nDouyin duration filter values:\n- `all`: no duration filter.\n- `under_1_minute`: under 1 minute.\n- `one_to_five_minutes`: 1-5 minutes.\n- `over_5_minutes`: over 5 minutes.\n\nDouyin content type filter values:\n- `all`: all content types.\n- `video`: video works.\n- `image`: image/text posts.\n\nThe command prints JSON with `platform`, `tool`, `arguments`, and `data`. Search supports `--pages` and `--max-items`, but not `--all`, because search has no stable complete-result boundary. Multi-page output keeps merged results in `data.items` and adds `page_count`, `item_count`, and the next-page marker.\n\n## Safety Boundary\n\nThis skill is read-only. It uses `SOCIALDATAX_API_KEY` from the user's environment at runtime. Generated Skill files do not contain API keys. It does not read local browser data or perform login, posting, liking, commenting, or account changes.\n\n## MCP Tools\n\nMCP tools matching the direct CLI commands above:\n\n- `douyin_get_hot_search_list`\n- `douyin_search_videos`\n\nIf MCP tools are already available in the current agent, use one of these tools:\n- `douyin_get_hot_search_list`: use for the current Douyin main hot search list.\n- `douyin_search_videos`: use for Douyin keyword search with optional semantic filters.\n\nDo not pass `page` to `douyin_search_videos`; omit `page_token` on the first request. Continue Douyin pagination only when `next_page_token` is not empty. Pass the complete returned `next_page_token` back unchanged as `page_token` for the same keyword and filter chain. Do not stop only because one page has empty `items`.\n\n## Output Guidance\n\nSummarize hot-search items as observed ranking signals. Keep the current hot-search list separate from keyword search results when both are used.\nSummarize visible evidence separately from interpretation. Include useful content IDs, URLs, titles or descriptions, authors, counts, and publish time when the user needs traceability.\nFor Douyin search results, include `content_type` when the user needs traceability.\nFor Douyin image/text search results, use returned `images` and treat `video.media_type=\"audio\"` as an audio player resource rather than a video post.\n\n## Troubleshooting\n\n- For non-balance network or API errors, preserve the error message, check `SOCIALDATAX_API_KEY`, parameters, and link or ID format, then retry once when appropriate.\n- If the response returns `insufficient_balance` or says the balance/credits are insufficient, do not retry repeatedly. Show the recharge URL from the error exactly as returned, then continue the same command after the user recharges.\n- If the user has recharged but still sees insufficient balance, confirm `SOCIALDATAX_API_KEY` belongs to the same account that was recharged; if needed, copy a fresh API Key from the official dashboard.\n\nFile v0.1.14:_meta.json\n\n{\n \"ownerId\": \"kn79gym47c788rbwr4amw8arfh859t3b\",\n \"slug\": \"socialdatax-douyin-search\",\n \"version\": \"0.1.14\",\n \"publishedAt\": 1784546738791\n}\n\nFile v0.1.14:skill-card.md\n\n## Description:
\n用于抖音数据分析、抖音热榜、抖音作品搜索、图文搜索、关键词检索、内容调研、竞品分析和趋势研究。覆盖 Douyin hot search and work search，来自 SocialDataX 社媒数据助手。
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[devinchen2014](https://clawhub.ai/user/devinchen2014)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nExternal analysts, marketers, and developers use this skill to have an agent retrieve Douyin hot-search and work-search data for content research, keyword discovery, competitor analysis, and trend scanning.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: The skill uses SOCIALDATAX_API_KEY and can make network requests that may consume account balance.
\nMitigation: Provide the API key only in trusted environments, review the npm package or source before execution, and monitor account balance usage.
\nRisk: Search results and hot-search rankings can be incomplete, time-sensitive, or require interpretation.
\nMitigation: Summarize observed data separately from interpretation and include traceable IDs, URLs, counts, authors, publish times, and content types when available.
\n\n\n## Reference(s):
\n- [SocialDataX AI Access](https://socialdatax.com/ai?from=clawhub)
\n- [ClawHub Skill Page](https://clawhub.ai/devinchen2014/skills/socialdatax-douyin-search)
\n\n\n## Skill Output:
\n**Output Type(s):** [Text, Markdown, Shell commands, Configuration, Guidance]
\n**Output Format:** [Markdown with inline shell commands and summaries of JSON API results]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [May include Douyin content IDs, URLs, titles, authors, counts, publish times, content types, and pagination markers when available.]
\n\n## Skill Version(s):
\n0.1.14 (source: release evidence)
\n\n## Ethical Considerations:
\nUsers 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.
\n\nArchive v0.1.13: 3 files, 4942 bytes\n\nFiles: skill-card.md (2740b), SKILL.md (7305b), _meta.json (145b)\n\nFile v0.1.13:SKILL.md\n\n---\nname: \"socialdatax-douyin-search\"\ndescription: \"用于抖音数据分析、抖音热榜、抖音作品搜索、图文搜索、关键词检索、内容调研、竞品分析和趋势研究。覆盖 Douyin hot search and work search，来自 SocialDataX 社媒数据助手。\"\nsource_client: \"socialdatax-skills\"\nsource_platform: \"clawhub\"\nsource_skill: \"socialdatax-douyin-search\"\nmetadata: {\"openclaw\":{\"requires\":{\"env\":[\"SOCIALDATAX_API_KEY\"],\"bins\":[\"node\",\"npm\"]},\"primaryEnv\":\"SOCIALDATAX_API_KEY\",\"install\":[{\"kind\":\"node\",\"package\":\"socialdatax-skills\",\"bins\":[]}],\"emoji\":\"🔥\",\"homepage\":\"https://socialdatax.com/ai?from=clawhub\"}}\n---\n\n\n# 抖音数据分析 SocialDataX 作品搜索\n\nUse this skill when the user wants 抖音数据分析, 抖音热榜, Douyin work search, image/text post search, keyword discovery, content research, competitor analysis, or trend scanning.\n\nCurrent platform support:\n\n- Douyin / 抖音 hot-search through `douyin_get_hot_search_list`.\n- Douyin / 抖音 works, including video and image/text posts, through `douyin_search_videos`.\n\n## API Key\n\nUse `SOCIALDATAX_API_KEY` for data calls. The only official website for requesting or managing API access is . If a user asks where to get a key, provide only this URL; do not infer alternate domains.\n获取或管理 API Key：访问 ，按官网的 API Key 申请/管理入口操作。环境变量名固定使用 `SOCIALDATAX_API_KEY`；不要引导用户使用其他域名；do not infer alternate domains。\n\n## Preferred Direct CLI\n\nPrefer the direct CLI when the agent can run shell commands. It does not require MCP server configuration:\n\n```bash\nnpx -y socialdatax-skills@latest douyin hot-search \\\n --pretty --source-client socialdatax-skills --source-platform clawhub \\\n --source-skill socialdatax-douyin-search\n\nnpx -y socialdatax-skills@latest douyin search \\\n --keyword \"\" --pretty --source-client socialdatax-skills \\\n --source-platform clawhub --source-skill socialdatax-douyin-search\n\nnpx -y socialdatax-skills@latest douyin search \\\n --keyword \"\" --pages 3 --pretty --source-client socialdatax-skills \\\n --source-platform clawhub --source-skill socialdatax-douyin-search\n```\n\nRequired arguments:\n\n- Douyin `hot-search`: no required arguments.\n- Douyin `search --keyword `: required only when using `douyin search`; use the user's actual intent, trim whitespace, and keep it focused.\n\nOptional arguments:\n\n- `--pretty`: output formatting only.\n- Douyin `--page-token `: opaque pagination token; omit it on the first search request. Continue only with the complete returned `next_page_token` from the same search pagination chain. Do not modify, truncate, redact, mask, omit, normalize, rebuild, generate, or replace the middle with ellipses.\n- Douyin `--sort-type `: optional sort value; omit it for the default sort.\n- Douyin `--publish-time-range `: optional publish-time filter; omit it for no publish-time filter.\n- Douyin `--duration-range `: optional duration filter; omit it for no duration filter.\n- Douyin `--content-type `: optional content type filter; omit it for all content types.\n- Douyin `--pages `: fetch and merge N search pages from the current starting point; continue with returned `next_page_token`.\n- `--max-items `: stop after collecting N search results.\n- `--since-days <1-365>`: keep only results whose public `publish_time` is within the last N days. Search remains bounded by `--pages` and does not promise complete platform coverage.\n- `--source-client socialdatax-skills --source-platform clawhub --source-skill socialdatax-douyin-search`: usage attribution for this Agent Skill; keep these values unchanged when running examples from this Skill.\n\nUse `douyin hot-search` for the current Douyin main hot-search list. Do not ask the user for `--keyword` for this command.\nDouyin sort values:\n- `general`: default sorting.\n- `time_descending`: newest first.\n- `like_count_descending`: most liked first.\n\nDouyin publish-time filter values:\n- `all`: no publish-time filter.\n- `day`: published within one day.\n- `week`: published within one week.\n- `half_year`: published within half a year.\n\nDouyin duration filter values:\n- `all`: no duration filter.\n- `under_1_minute`: under 1 minute.\n- `one_to_five_minutes`: 1-5 minutes.\n- `over_5_minutes`: over 5 minutes.\n\nDouyin content type filter values:\n- `all`: all content types.\n- `video`: video works.\n- `image`: image/text posts.\n\nThe command prints JSON with `platform`, `tool`, `arguments`, and `data`. Search supports `--pages` and `--max-items`, but not `--all`, because search has no stable complete-result boundary. Multi-page output keeps merged results in `data.items` and adds `page_count`, `item_count`, and the next-page marker.\n\n## Safety Boundary\n\nThis skill is read-only. It uses `SOCIALDATAX_API_KEY` from the user's environment at runtime. Generated Skill files do not contain API keys. It does not read local browser data or perform login, posting, liking, commenting, or account changes.\n\n## MCP Tools\n\nMCP tools matching the direct CLI commands above:\n\n- `douyin_get_hot_search_list`\n- `douyin_search_videos`\n\nIf MCP tools are already available in the current agent, use one of these tools:\n- `douyin_get_hot_search_list`: use for the current Douyin main hot search list.\n- `douyin_search_videos`: use for Douyin keyword search with optional semantic filters.\n\nDo not pass `page` to `douyin_search_videos`; omit `page_token` on the first request. Continue Douyin pagination only when `next_page_token` is not empty. Pass the complete returned `next_page_token` back unchanged as `page_token` for the same keyword and filter chain. Do not stop only because one page has empty `items`.\n\n## Output Guidance\n\nSummarize hot-search items as observed ranking signals. Keep the current hot-search list separate from keyword search results when both are used.\nSummarize visible evidence separately from interpretation. Include useful content IDs, URLs, titles or descriptions, authors, counts, and publish time when the user needs traceability.\nFor Douyin search results, include `content_type` when the user needs traceability.\nFor Douyin image/text search results, use returned `images` and treat `video.media_type=\"audio\"` as an audio player resource rather than a video post.\n\n## Troubleshooting\n\n- For non-balance network or API errors, preserve the error message, check `SOCIALDATAX_API_KEY`, parameters, and link or ID format, then retry once when appropriate.\n- If the response returns `insufficient_balance` or says the balance/credits are insufficient, do not retry repeatedly. Show the recharge URL from the error exactly as returned, then continue the same command after the user recharges.\n- If the user has recharged but still sees insufficient balance, confirm `SOCIALDATAX_API_KEY` belongs to the same account that was recharged; if needed, copy a fresh API Key from the official dashboard.\n\nFile v0.1.13:_meta.json\n\n{\n \"ownerId\": \"kn79gym47c788rbwr4amw8arfh859t3b\",\n \"slug\": \"socialdatax-douyin-search\",\n \"version\": \"0.1.13\",\n \"publishedAt\": 1784543850422\n}\n\nFile v0.1.13:skill-card.md\n\n## Description:
\n用于抖音数据分析、抖音热榜、抖音作品搜索、图文搜索、关键词检索、内容调研、竞品分析和趋势研究，覆盖 Douyin hot search and work search，来自 SocialDataX 社媒数据助手。
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[devinchen2014](https://clawhub.ai/user/devinchen2014)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nExternal users and developers use this skill to retrieve Douyin hot-search and work-search data for content research, competitor analysis, keyword discovery, and trend scanning. It supports read-only SocialDataX API-key-authenticated queries and helps agents summarize observed ranking signals and search results.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: The skill uses SocialDataX API-key-authenticated network calls for Douyin research queries.
\nMitigation: Install and use it only where sharing those query parameters with SocialDataX is acceptable, and provide SOCIALDATAX_API_KEY through the runtime environment rather than embedding credentials in files.
\nRisk: The direct CLI examples fetch the socialdatax-skills npm package using the latest tag.
\nMitigation: Pin or review the package version before deployment in stricter or production-controlled environments.
\nRisk: Search results may be partial because multi-page search is bounded by pages, max item limits, and returned pagination tokens.
\nMitigation: Treat returned Douyin data as observed evidence from the requested query and filters, and keep visible fields separate from analysis or interpretation.
\n\n\n## Reference(s):
\n- [ClawHub skill page](https://clawhub.ai/devinchen2014/skills/socialdatax-douyin-search)
\n- [SocialDataX AI access page](https://socialdatax.com/ai?from=clawhub)
\n- [Publisher profile](https://clawhub.ai/user/devinchen2014)
\n\n\n## Skill Output:
\n**Output Type(s):** [Guidance, Shell commands, Configuration, Text, JSON summaries]
\n**Output Format:** [Markdown guidance with inline shell commands and summarized JSON results]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Requires SOCIALDATAX_API_KEY plus node and npm; data calls are read-only and may use pagination tokens returned by the service.]
\n\n## Skill Version(s):
\n0.1.13 (source: server release evidence)
\n\n## Ethical Considerations:
\nUsers 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.
\n\nArchive v0.1.12: 3 files, 4689 bytes\n\nFiles: skill-card.md (2376b), SKILL.md (7299b), _meta.json (145b)\n\nFile v0.1.12:SKILL.md\n\n---\nname: \"socialdatax-douyin-search\"\ndescription: \"用于抖音数据分析、抖音热榜、抖音作品搜索、图文搜索、关键词检索、内容调研、竞品分析和趋势研究。覆盖 Douyin hot search and work search，来自 SocialDataX 社媒数据助手。\"\nsource_client: \"socialdatax-skills\"\nsource_platform: \"clawhub\"\nsource_skill: \"socialdatax-douyin-search\"\nmetadata: {\"openclaw\":{\"requires\":{\"env\":[\"SOCIALDATAX_API_KEY\"],\"bins\":[\"node\",\"npm\"]},\"primaryEnv\":\"SOCIALDATAX_API_KEY\",\"install\":[{\"kind\":\"node\",\"package\":\"socialdatax-skills\",\"bins\":[]}],\"emoji\":\"🔥\",\"homepage\":\"https://socialdatax.com/?from=clawhub\"}}\n---\n\n\n# 抖音数据分析 SocialDataX 作品搜索\n\nUse this skill when the user wants 抖音数据分析, 抖音热榜, Douyin work search, image/text post search, keyword discovery, content research, competitor analysis, or trend scanning.\n\nCurrent platform support:\n\n- Douyin / 抖音 hot-search through `douyin_get_hot_search_list`.\n- Douyin / 抖音 works, including video and image/text posts, through `douyin_search_videos`.\n\n## API Key\n\nUse `SOCIALDATAX_API_KEY` for data calls. The only official website for requesting or managing API access is . If a user asks where to get a key, provide only this URL; do not infer alternate domains.\n获取或管理 API Key：访问 ，按官网的 API Key 申请/管理入口操作。环境变量名固定使用 `SOCIALDATAX_API_KEY`；不要引导用户使用其他域名；do not infer alternate domains。\n\n## Preferred Direct CLI\n\nPrefer the direct CLI when the agent can run shell commands. It does not require MCP server configuration:\n\n```bash\nnpx -y socialdatax-skills@latest douyin hot-search \\\n --pretty --source-client socialdatax-skills --source-platform clawhub \\\n --source-skill socialdatax-douyin-search\n\nnpx -y socialdatax-skills@latest douyin search \\\n --keyword \"\" --pretty --source-client socialdatax-skills \\\n --source-platform clawhub --source-skill socialdatax-douyin-search\n\nnpx -y socialdatax-skills@latest douyin search \\\n --keyword \"\" --pages 3 --pretty --source-client socialdatax-skills \\\n --source-platform clawhub --source-skill socialdatax-douyin-search\n```\n\nRequired arguments:\n\n- Douyin `hot-search`: no required arguments.\n- Douyin `search --keyword `: required only when using `douyin search`; use the user's actual intent, trim whitespace, and keep it focused.\n\nOptional arguments:\n\n- `--pretty`: output formatting only.\n- Douyin `--page-token `: opaque pagination token; omit it on the first search request. Continue only with the complete returned `next_page_token` from the same search pagination chain. Do not modify, truncate, redact, mask, omit, normalize, rebuild, generate, or replace the middle with ellipses.\n- Douyin `--sort-type `: optional sort value; omit it for the default sort.\n- Douyin `--publish-time-range `: optional publish-time filter; omit it for no publish-time filter.\n- Douyin `--duration-range `: optional duration filter; omit it for no duration filter.\n- Douyin `--content-type `: optional content type filter; omit it for all content types.\n- Douyin `--pages `: fetch and merge N search pages from the current starting point; continue with returned `next_page_token`.\n- `--max-items `: stop after collecting N search results.\n- `--since-days <1-365>`: keep only results whose public `publish_time` is within the last N days. Search remains bounded by `--pages` and does not promise complete platform coverage.\n- `--source-client socialdatax-skills --source-platform clawhub --source-skill socialdatax-douyin-search`: usage attribution for this Agent Skill; keep these values unchanged when running examples from this Skill.\n\nUse `douyin hot-search` for the current Douyin main hot-search list. Do not ask the user for `--keyword` for this command.\nDouyin sort values:\n- `general`: default sorting.\n- `time_descending`: newest first.\n- `like_count_descending`: most liked first.\n\nDouyin publish-time filter values:\n- `all`: no publish-time filter.\n- `day`: published within one day.\n- `week`: published within one week.\n- `half_year`: published within half a year.\n\nDouyin duration filter values:\n- `all`: no duration filter.\n- `under_1_minute`: under 1 minute.\n- `one_to_five_minutes`: 1-5 minutes.\n- `over_5_minutes`: over 5 minutes.\n\nDouyin content type filter values:\n- `all`: all content types.\n- `video`: video works.\n- `image`: image/text posts.\n\nThe command prints JSON with `platform`, `tool`, `arguments`, and `data`. Search supports `--pages` and `--max-items`, but not `--all`, because search has no stable complete-result boundary. Multi-page output keeps merged results in `data.items` and adds `page_count`, `item_count`, and the next-page marker.\n\n## Safety Boundary\n\nThis skill is read-only. It uses `SOCIALDATAX_API_KEY` from the user's environment at runtime. Generated Skill files do not contain API keys. It does not read local browser data or perform login, posting, liking, commenting, or account changes.\n\n## MCP Tools\n\nMCP tools matching the direct CLI commands above:\n\n- `douyin_get_hot_search_list`\n- `douyin_search_videos`\n\nIf MCP tools are already available in the current agent, use one of these tools:\n- `douyin_get_hot_search_list`: use for the current Douyin main hot search list.\n- `douyin_search_videos`: use for Douyin keyword search with optional semantic filters.\n\nDo not pass `page` to `douyin_search_videos`; omit `page_token` on the first request. Continue Douyin pagination only when `next_page_token` is not empty. Pass the complete returned `next_page_token` back unchanged as `page_token` for the same keyword and filter chain. Do not stop only because one page has empty `items`.\n\n## Output Guidance\n\nSummarize hot-search items as observed ranking signals. Keep the current hot-search list separate from keyword search results when both are used.\nSummarize visible evidence separately from interpretation. Include useful content IDs, URLs, titles or descriptions, authors, counts, and publish time when the user needs traceability.\nFor Douyin search results, include `content_type` when the user needs traceability.\nFor Douyin image/text search results, use returned `images` and treat `video.media_type=\"audio\"` as an audio player resource rather than a video post.\n\n## Troubleshooting\n\n- For non-balance network or API errors, preserve the error message, check `SOCIALDATAX_API_KEY`, parameters, and link or ID format, then retry once when appropriate.\n- If the response returns `insufficient_balance` or says the balance/credits are insufficient, do not retry repeatedly. Show the recharge URL from the error exactly as returned, then continue the same command after the user recharges.\n- If the user has recharged but still sees insufficient balance, confirm `SOCIALDATAX_API_KEY` belongs to the same account that was recharged; if needed, copy a fresh API Key from the official dashboard.\n\nFile v0.1.12:_meta.json\n\n{\n \"ownerId\": \"kn79gym47c788rbwr4amw8arfh859t3b\",\n \"slug\": \"socialdatax-douyin-search\",\n \"version\": \"0.1.12\",\n \"publishedAt\": 1784535314340\n}\n\nFile v0.1.12:skill-card.md\n\n## Description:
\nHelps agents retrieve Douyin hot-search and keyword-search data for content research, competitor analysis, and trend scanning through SocialDataX.
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[devinchen2014](https://clawhub.ai/user/devinchen2014)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nDevelopers, researchers, and analysts use this skill to ask an agent for Douyin hot-search rankings and keyword-based work searches. It supports content research, image/text post discovery, competitor analysis, and trend monitoring with traceable result summaries.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: The skill sends SOCIALDATAX_API_KEY to SocialDataX-backed CLI or MCP calls.
\nMitigation: Use a scoped key where available, keep it in the runtime environment, and install only when SocialDataX is an acceptable data provider.
\nRisk: Examples use npx with a package name, so future package versions may change behavior.
\nMitigation: Pin socialdatax-skills to a reviewed version in controlled or production environments.
\nRisk: Douyin search results are bounded by pagination and may not represent complete platform coverage.
\nMitigation: Report retrieved ranking signals and visible evidence separately from interpretation, including IDs, URLs, counts, and publish times when traceability matters.
\n\n\n## Reference(s):
\n- [ClawHub skill page](https://clawhub.ai/devinchen2014/skills/socialdatax-douyin-search)
\n- [SocialDataX homepage and API access](https://socialdatax.com/?from=clawhub)
\n\n\n## Skill Output:
\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance]
\n**Output Format:** [Markdown guidance with shell command examples and JSON result summaries]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Uses SOCIALDATAX_API_KEY and may require node, npm, or matching MCP tools.]
\n\n## Skill Version(s):
\n0.1.12 (source: server release evidence)
\n\n## Ethical Considerations:
\nUsers 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.
\n\nArchive v0.1.11: 3 files, 4517 bytes\n\nFiles: skill-card.md (2439b), SKILL.md (6613b), _meta.json (145b)\n\nFile v0.1.11:SKILL.md\n\n---\nname: \"socialdatax-douyin-search\"\ndescription: \"用于抖音数据分析、抖音热榜、抖音作品搜索、图文搜索、关键词检索、内容调研、竞品分析和趋势研究。覆盖 Douyin hot search and work search，来自 SocialDataX 社媒数据助手。\"\nsource_client: \"socialdatax-skills\"\nsource_platform: \"clawhub\"\nsource_skill: \"socialdatax-douyin-search\"\nmetadata: {\"openclaw\":{\"requires\":{\"env\":[\"SOCIALDATAX_API_KEY\"],\"bins\":[\"node\",\"npm\"]},\"primaryEnv\":\"SOCIALDATAX_API_KEY\",\"install\":[{\"kind\":\"node\",\"package\":\"socialdatax-skills\",\"bins\":[]}],\"emoji\":\"🔥\",\"homepage\":\"https://socialdatax.com/?from=clawhub\"}}\n---\n\n\n# 抖音数据分析 SocialDataX 作品搜索\n\nUse this skill when the user wants 抖音数据分析, 抖音热榜, Douyin work search, image/text post search, keyword discovery, content research, competitor analysis, or trend scanning.\n\nCurrent platform support:\n\n- Douyin / 抖音 hot-search through `douyin_get_hot_search_list`.\n- Douyin / 抖音 works, including video and image/text posts, through `douyin_search_videos`.\n\n## API Key\n\nUse `SOCIALDATAX_API_KEY` for data calls. The only official website for requesting or managing API access is . If a user asks where to get a key, provide only this URL; do not infer alternate domains.\n获取或管理 API Key：访问 ，按官网的 API Key 申请/管理入口操作。环境变量名固定使用 `SOCIALDATAX_API_KEY`；不要引导用户使用其他域名。\n\n## Preferred Direct CLI\n\nPrefer the direct CLI when the agent can run shell commands. It does not require MCP server configuration:\n\n```bash\nnpx -y socialdatax-skills@latest douyin hot-search --pretty --source-client socialdatax-skills --source-platform clawhub --source-skill socialdatax-douyin-search\nnpx -y socialdatax-skills@latest douyin search --keyword \"\" --pretty --source-client socialdatax-skills --source-platform clawhub --source-skill socialdatax-douyin-search\nnpx -y socialdatax-skills@latest douyin search --keyword \"\" --pages 3 --pretty --source-client socialdatax-skills --source-platform clawhub --source-skill socialdatax-douyin-search\n```\n\nRequired arguments:\n\n- Douyin `hot-search`: no required arguments.\n- Douyin `search --keyword `: required only when using `douyin search`; use the user's actual intent, trim whitespace, and keep it focused.\n\nOptional arguments:\n\n- `--pretty`: output formatting only.\n- Douyin `--page-token `: opaque pagination token; omit it on the first search request. Continue only with the complete returned `next_page_token` from the same search pagination chain. Do not modify, truncate, redact, mask, omit, normalize, rebuild, generate, or replace the middle with ellipses.\n- Douyin `--sort-type `: optional sort value; omit it for the default sort.\n- Douyin `--publish-time-range `: optional publish-time filter; omit it for no publish-time filter.\n- Douyin `--duration-range `: optional duration filter; omit it for no duration filter.\n- Douyin `--content-type `: optional content type filter; omit it for all content types.\n- Douyin `--pages `: fetch and merge N search pages from the current starting point; continue with returned `next_page_token`.\n- `--max-items `: stop after collecting N search results.\n- `--since-days <1-365>`: keep only results whose public `publish_time` is within the last N days. Search remains bounded by `--pages` and does not promise complete platform coverage.\n- `--source-client socialdatax-skills --source-platform clawhub --source-skill socialdatax-douyin-search`: usage attribution for this Agent Skill; keep these values unchanged when running examples from this Skill.\n\nUse `douyin hot-search` for the current Douyin main hot-search list. Do not ask the user for `--keyword` for this command.\nDouyin sort values:\n- `general`: default sorting.\n- `time_descending`: newest first.\n- `like_count_descending`: most liked first.\n\nDouyin publish-time filter values:\n- `all`: no publish-time filter.\n- `day`: published within one day.\n- `week`: published within one week.\n- `half_year`: published within half a year.\n\nDouyin duration filter values:\n- `all`: no duration filter.\n- `under_1_minute`: under 1 minute.\n- `one_to_five_minutes`: 1-5 minutes.\n- `over_5_minutes`: over 5 minutes.\n\nDouyin content type filter values:\n- `all`: all content types.\n- `video`: video works.\n- `image`: image/text posts.\n\nThe command prints JSON with `platform`, `tool`, `arguments`, and `data`. Search supports `--pages` and `--max-items`, but not `--all`, because search has no stable complete-result boundary. Multi-page output keeps merged results in `data.items` and adds `page_count`, `item_count`, and the next-page marker.\n\n## Safety Boundary\n\nThis skill is read-only. It uses `SOCIALDATAX_API_KEY` from the user's environment at runtime. Generated Skill files do not contain API keys. It does not read local browser data or perform login, posting, liking, commenting, or account changes.\n\n## MCP Tools\n\nMCP tools matching the direct CLI commands above:\n\n- `douyin_get_hot_search_list`\n- `douyin_search_videos`\n\nIf MCP tools are already available in the current agent, use one of these tools:\n- `douyin_get_hot_search_list`: use for the current Douyin main hot search list.\n- `douyin_search_videos`: use for Douyin keyword search with optional semantic filters.\n\nDo not pass `page` to `douyin_search_videos`; omit `page_token` on the first request. Continue Douyin pagination only when `next_page_token` is not empty. Pass the complete returned `next_page_token` back unchanged as `page_token` for the same keyword and filter chain. Do not stop only because one page has empty `items`.\n\n## Output Guidance\n\nSummarize hot-search items as observed ranking signals. Keep the current hot-search list separate from keyword search results when both are used.\nSummarize visible evidence separately from interpretation. Include useful content IDs, URLs, titles or descriptions, authors, counts, and publish time when the user needs traceability.\nFor Douyin search results, include `content_type` when the user needs traceability.\nFor Douyin image/text search results, use returned `images` and treat `video.media_type=\"audio\"` as an audio player resource rather than a video post.\n\nFile v0.1.11:_meta.json\n\n{\n \"ownerId\": \"kn79gym47c788rbwr4amw8arfh859t3b\",\n \"slug\": \"socialdatax-douyin-search\",\n \"version\": \"0.1.11\",\n \"publishedAt\": 1783500082439\n}\n\nFile v0.1.11:skill-card.md\n\n## Description:
\n用于抖音数据分析、抖音热榜、抖音作品搜索、图文搜索、关键词检索、内容调研、竞品分析和趋势研究。覆盖 Douyin hot search and work search，来自 SocialDataX 社媒数据助手。
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[devinchen2014](https://clawhub.ai/user/devinchen2014)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nExternal users, analysts, and developers use this skill to retrieve Douyin hot-search data and search Douyin video or image/text works for keyword research, content analysis, competitor review, and trend scanning.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: The skill depends on the external SocialDataX service and the socialdatax-skills npm package for Douyin data requests.
\nMitigation: Install only in environments where that package and service dependency are acceptable, and review returned data before relying on it for decisions.
\nRisk: Douyin requests require a SOCIALDATAX_API_KEY, and query data is sent through the configured SocialDataX integration.
\nMitigation: Use a scoped API key from the official SocialDataX site and avoid submitting sensitive or unnecessary query terms.
\n\n\n## Reference(s):
\n- [ClawHub skill page](https://clawhub.ai/devinchen2014/skills/socialdatax-douyin-search)
\n- [SocialDataX homepage and API access](https://socialdatax.com/?from=clawhub)
\n- [Publisher profile](https://clawhub.ai/user/devinchen2014)
\n\n\n## Skill Output:
\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance]
\n**Output Format:** [Markdown guidance with shell command examples and JSON-result interpretation guidance]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Outputs may include observed Douyin rankings, item identifiers, URLs, titles or descriptions, authors, counts, publish times, content types, images, and pagination markers when returned by SocialDataX.]
\n\n## Skill Version(s):
\n0.1.11 (source: server release evidence)
\n\n## Ethical Considerations:
\nUsers 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.
\n\nArchive v0.1.9: 3 files, 4496 bytes\n\nFiles: skill-card.md (2620b), SKILL.md (5944b), _meta.json (144b)\n\nFile v0.1.9:SKILL.md\n\n---\nname: \"socialdatax-douyin-search\"\ndescription: \"用于抖音数据分析、抖音热榜、抖音作品搜索、图文搜索、关键词检索、内容调研、竞品分析和趋势研究。覆盖 Douyin hot search and work search，来自 SocialDataX 社媒数据助手。\"\nmetadata: {\"openclaw\":{\"requires\":{\"env\":[\"SOCIALDATAX_API_KEY\"],\"bins\":[\"node\",\"npm\"]},\"primaryEnv\":\"SOCIALDATAX_API_KEY\",\"install\":[{\"kind\":\"node\",\"package\":\"socialdatax-skills\",\"bins\":[]}],\"emoji\":\"🔥\",\"homepage\":\"https://socialdatax.com/?from=clawhub\"}}\n---\n\n\n# 抖音数据分析 SocialDataX 作品搜索\n\nUse this skill when the user wants 抖音数据分析, 抖音热榜, Douyin work search, image/text post search, keyword discovery, content research, competitor analysis, or trend scanning.\n\nCurrent platform support:\n\n- Douyin / 抖音 hot-search through `douyin_get_hot_search_list`.\n- Douyin / 抖音 works, including video and image/text posts, through `douyin_search_videos`.\n\n## API Key\n\nUse `SOCIALDATAX_API_KEY` for data calls. The only official website for requesting or managing API access is . If a user asks where to get a key, provide only this URL; do not infer alternate domains.\n获取或管理 API Key：访问 ，按官网的 API Key 申请/管理入口操作。环境变量名固定使用 `SOCIALDATAX_API_KEY`；不要引导用户使用其他域名。\n\n## Preferred Direct CLI\n\nPrefer the direct CLI when the agent can run shell commands. It does not require MCP server configuration:\n\n```bash\nnpx -y socialdatax-skills@latest douyin hot-search --pretty\nnpx -y socialdatax-skills@latest douyin search --keyword \"\" --pretty\nnpx -y socialdatax-skills@latest douyin search --keyword \"\" --pages 3 --pretty\n```\n\nRequired arguments:\n\n- Douyin `hot-search`: no required arguments.\n- Douyin `search --keyword `: required only when using `douyin search`; use the user's actual intent, trim whitespace, and keep it focused.\n\nOptional arguments:\n\n- `--pretty`: output formatting only.\n- Douyin `--page-token `: opaque pagination token; omit it on the first search request. Continue only with the complete returned `next_page_token` from the same search pagination chain. Do not modify, truncate, redact, mask, omit, normalize, rebuild, generate, or replace the middle with ellipses.\n- Douyin `--sort-type `: optional sort value; omit it for the default sort.\n- Douyin `--publish-time-range `: optional publish-time filter; omit it for no publish-time filter.\n- Douyin `--duration-range `: optional duration filter; omit it for no duration filter.\n- Douyin `--content-type `: optional content type filter; omit it for all content types.\n- Douyin `--pages `: fetch and merge N search pages from the current starting point; continue with returned `next_page_token`.\n- `--max-items `: stop after collecting N search results.\n- `--since-days <1-365>`: keep only results whose public `publish_time` is within the last N days. Search remains bounded by `--pages` and does not promise complete platform coverage.\n\nUse `douyin hot-search` for the current Douyin main hot-search list. Do not ask the user for `--keyword` for this command.\nDouyin sort values:\n- `general`: default sorting.\n- `time_descending`: newest first.\n- `like_count_descending`: most liked first.\n\nDouyin publish-time filter values:\n- `all`: no publish-time filter.\n- `day`: published within one day.\n- `week`: published within one week.\n- `half_year`: published within half a year.\n\nDouyin duration filter values:\n- `all`: no duration filter.\n- `under_1_minute`: under 1 minute.\n- `one_to_five_minutes`: 1-5 minutes.\n- `over_5_minutes`: over 5 minutes.\n\nDouyin content type filter values:\n- `all`: all content types.\n- `video`: video works.\n- `image`: image/text posts.\n\nThe command prints JSON with `platform`, `tool`, `arguments`, and `data`. Search supports `--pages` and `--max-items`, but not `--all`, because search has no stable complete-result boundary. Multi-page output keeps merged results in `data.items` and adds `page_count`, `item_count`, and the next-page marker.\n\n## Safety Boundary\n\nThis skill is read-only. It does not read local browser data, does not perform login, posting, liking, commenting, or account changes. The local CLI and installer do not write API keys to local files.\n\n## MCP Tools\n\nMCP tools matching the direct CLI commands above:\n\n- `douyin_get_hot_search_list`\n- `douyin_search_videos`\n\nIf MCP tools are already available in the current agent, use one of these tools:\n- `douyin_get_hot_search_list`: use for the current Douyin main hot search list.\n- `douyin_search_videos`: use for Douyin keyword search with optional semantic filters.\n\nDo not pass `page` to `douyin_search_videos`; omit `page_token` on the first request. Continue Douyin pagination only when `next_page_token` is not empty. Pass the complete returned `next_page_token` back unchanged as `page_token` for the same keyword and filter chain. Do not stop only because one page has empty `items`.\n\n## Output Guidance\n\nSummarize hot-search items as observed ranking signals. Keep the current hot-search list separate from keyword search results when both are used.\nSummarize visible evidence separately from interpretation. Include useful content IDs, URLs, titles or descriptions, authors, counts, and publish time when the user needs traceability.\nFor Douyin search results, include `content_type` when the user needs traceability.\nFor Douyin image/text search results, use returned `images` and treat `video.media_type=\"audio\"` as an audio player resource rather than a video post.\n\nFile v0.1.9:_meta.json\n\n{\n \"ownerId\": \"kn79gym47c788rbwr4amw8arfh859t3b\",\n \"slug\": \"socialdatax-douyin-search\",\n \"version\": \"0.1.9\",\n \"publishedAt\": 1783000358886\n}\n\nFile v0.1.9:skill-card.md\n\n## Description:
\n用于抖音数据分析、抖音热榜、抖音作品搜索、图文搜索、关键词检索、内容调研、竞品分析和趋势研究。覆盖 Douyin hot search and work search，来自 SocialDataX 社媒数据助手。
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[devinchen2014](https://clawhub.ai/user/devinchen2014)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nExternal analysts, developers, and social media researchers use this skill to retrieve Douyin hot-search data and keyword-based work search results for content research, competitor analysis, and trend scanning.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: The skill requires SOCIALDATAX_API_KEY for SocialDataX data calls, so a broad or shared key could expose more access than intended.
\nMitigation: Use a scoped, revocable API key, provide it through the environment only when needed, and avoid writing the key to local files or shared logs.
\nRisk: Douyin hot-search and keyword search outputs are observed platform data and can be incomplete, time-sensitive, or easy to overinterpret.
\nMitigation: Separate visible evidence from interpretation, preserve useful content IDs, URLs, authors, counts, and publish times, and avoid treating rankings as complete coverage.
\nRisk: Changing or truncating pagination tokens can break result continuity or fetch a different result chain.
\nMitigation: Pass returned next_page_token values back unchanged for the same keyword and filter chain, and omit pagination only on the first request.
\n\n\n## Reference(s):
\n- [SocialDataX homepage](https://socialdatax.com/?from=clawhub)
\n- [ClawHub skill listing](https://clawhub.ai/devinchen2014/skills/socialdatax-douyin-search)
\n\n\n## Skill Output:
\n**Output Type(s):** [Text, Markdown, Shell commands, JSON, Guidance]
\n**Output Format:** [Markdown guidance with shell commands and JSON data summaries]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Requires SOCIALDATAX_API_KEY plus node and npm when using the direct CLI; returns observed Douyin hot-search and work-search data from SocialDataX.]
\n\n## Skill Version(s):
\n0.1.9 (source: server release evidence)
\n\n## Ethical Considerations:
\nUsers 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.
\n\nArchive v0.1.8: 3 files, 4617 bytes\n\nFiles: skill-card.md (2592b), SKILL.md (8876b), _meta.json (144b)\n\nFile v0.1.8:SKILL.md\n\n---\nname: \"socialdatax-douyin-search\"\ndescription: \"用于抖音数据分析、抖音热榜、抖音作品搜索、图文搜索、关键词检索、内容调研、竞品分析和趋势研究。覆盖 Douyin hot search and work search，来自 SocialDataX 社媒数据助手。\"\nmetadata: {\"openclaw\":{\"requires\":{\"env\":[\"SOCIALDATAX_API_KEY\"],\"bins\":[\"node\",\"npm\"]},\"primaryEnv\":\"SOCIALDATAX_API_KEY\",\"install\":[{\"kind\":\"node\",\"package\":\"socialdatax-skills\",\"bins\":[]}],\"emoji\":\"🔥\",\"homepage\":\"https://socialdatax.52choujiang.com/?from=clawhub\"}}\n---\n\n\n# 抖音数据分析 SocialDataX 作品搜索\n\nUse this skill when the user wants 抖音数据分析, 抖音热榜, Douyin work search, image/text post search, keyword discovery, content research, competitor analysis, or trend scanning.\n\nCurrent platform support:\n\n- Douyin / 抖音 hot-search through `douyin_get_hot_search_list`.\n- Weibo / 微博 hot-search through `weibo_get_hot_search_list`.\n- WeChat Channels / 视频号 hot-search through `wechat_get_hot_search_list`.\n- Douyin / 抖音 works, including video and image/text posts, through `douyin_search_videos`.\n- Weibo / 微博 posts through `weibo_search_posts`.\n- WeChat Channels / 视频号 videos through `wechat_search_videos`.\n\n## API Key\n\nUse `SOCIALDATAX_API_KEY` for data calls. The only official website for requesting or managing API access is . If a user asks where to get a key, provide only this URL; do not infer alternate domains.\n获取或管理 API Key：访问 ，按官网的 API Key 申请/管理入口操作。环境变量名固定使用 `SOCIALDATAX_API_KEY`；不要引导用户使用其他域名。\n\n## Preferred Direct CLI\n\nPrefer the direct CLI when the agent can run shell commands. It does not require MCP server configuration:\n\n```bash\nnpx -y socialdatax-skills@latest douyin hot-search --pretty\nnpx -y socialdatax-skills@latest douyin search --keyword \"\" --pretty\nnpx -y socialdatax-skills@latest douyin search --keyword \"\" --pages 3 --pretty\n```\n\nRequired arguments:\n\n- Douyin `hot-search`: no required arguments.\n- Weibo `hot-search`: no required arguments.\n- WeChat Channels / 视频号 `hot-search`: no required arguments.\n- Douyin `search --keyword `: required only when using `douyin search`; use the user's actual intent, trim whitespace, and keep it focused.\n- Weibo `search --keyword `: required only when using `weibo search`; use the user's actual intent, trim whitespace, and keep it focused.\n- WeChat Channels / 视频号 `search --keyword `: required only when using `wechat search`; use the user's actual intent, trim whitespace, and keep it focused.\n\nOptional arguments:\n\n- `--pretty`: output formatting only.\n- Douyin `--page-token `: opaque pagination token; omit it on the first search request. Continue only with the complete returned `next_page_token` from the same search pagination chain. Do not modify, truncate, redact, mask, omit, normalize, rebuild, generate, or replace the middle with ellipses.\n- Douyin `--sort-type `: optional sort value; omit it for the default sort.\n- Douyin `--publish-time-range `: optional publish-time filter; omit it for no publish-time filter.\n- Douyin `--duration-range `: optional duration filter; omit it for no duration filter.\n- Douyin `--content-type `: optional content type filter; omit it for all content types.\n- Douyin `--pages `: fetch and merge N search pages from the current starting point; continue with returned `next_page_token`.\n- `--max-items `: stop after collecting N search results.\n- Weibo `--page-token `: opaque pagination token; omit it on the first search request. Continue only with the complete returned `next_page_token` from the same search pagination chain. Do not modify, truncate, redact, mask, omit, normalize, rebuild, generate, or replace the middle with ellipses.\n- WeChat Channels / 视频号 `--page-token `: opaque pagination token; omit it on the first search request. Continue only with the complete returned `next_page_token` from the same search pagination chain. Do not modify, truncate, redact, mask, omit, normalize, rebuild, generate, or replace the middle with ellipses.\n- WeChat Channels / 视频号 `--sort-type `: optional sort value; omit it for the default sort.\n- WeChat Channels / 视频号 `--duration-range `: optional duration filter; omit it for no duration filter.\n- Weibo `--pages `: fetch and merge N search pages from the current starting point; continue with returned `next_page_token`.\n- WeChat Channels / 视频号 `--pages `: fetch and merge N search pages from the current starting point; continue with returned `next_page_token`.\n\nUse `douyin hot-search` for the current Douyin main hot-search list. Do not ask the user for `--keyword` for this command.\nUse `weibo hot-search` for the current Weibo / 微博 hot-search list. Do not ask the user for `--keyword` for this command.\nUse `wechat hot-search` for the current WeChat Channels / 视频号 hot-search list. Do not ask the user for `--keyword` for this command.\nDouyin sort values:\n- `general`: default sorting.\n- `time_descending`: newest first.\n- `like_count_descending`: most liked first.\n\nDouyin publish-time filter values:\n- `all`: no publish-time filter.\n- `day`: published within one day.\n- `week`: published within one week.\n- `half_year`: published within half a year.\n\nDouyin duration filter values:\n- `all`: no duration filter.\n- `under_1_minute`: under 1 minute.\n- `one_to_five_minutes`: 1-5 minutes.\n- `over_5_minutes`: over 5 minutes.\n\nDouyin content type filter values:\n- `all`: all content types.\n- `video`: video works.\n- `image`: image/text posts.\n\nThe command prints JSON with `platform`, `tool`, `arguments`, and `data`. Search supports `--pages` and `--max-items`, but not `--all`, because search has no stable complete-result boundary. Multi-page output keeps merged results in `data.items` and adds `page_count`, `item_count`, and the next-page marker.\nWeChat Channels / 视频号 sort values:\n- `all`: default sorting.\n- `latest`: newest first.\n- `popular`: most popular first.\n\nWeChat Channels / 视频号 duration filter values:\n- `all`: no duration filter.\n- `under_5_min`: under 5 minutes.\n- `between_5_and_20_min`: 5-20 minutes.\n- `over_20_min`: over 20 minutes.\n\nWeibo and WeChat Channels search pagination:\n- Continue only when `next_page_token` is not empty.\n- Pass the complete returned `next_page_token` back unchanged as `page_token` for the same search pagination chain. Do not modify, truncate, redact, mask, omit, normalize, rebuild, generate, or replace the middle with ellipses.\n\n## Safety Boundary\n\nThis 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.\n\n## MCP Tools\n\nMCP tools matching the direct CLI commands above:\n\n- `douyin_get_hot_search_list`\n- `douyin_search_videos`\n\nIf MCP tools are already available in the current agent, use one of these tools:\n- `douyin_get_hot_search_list`: use for the current Douyin main hot search list.\n- `douyin_search_videos`: use for Douyin keyword search with optional semantic filters.\n\nDo not pass `page` to `douyin_search_videos`; omit `page_token` on the first request. Continue Douyin pagination only when `next_page_token` is not empty. Pass the complete returned `next_page_token` back unchanged as `page_token` for the same keyword and filter chain. Do not stop only because one page has empty `items`.\n\n## Output Guidance\n\nSummarize hot-search items as observed ranking signals. Keep the current hot-search list separate from keyword search results when both are used.\nSummarize visible evidence separately from interpretation. Include useful content IDs, URLs, titles or descriptions, authors, counts, and publish time when the user needs traceability.\nFor Douyin search results, include `content_type` when the user needs traceability.\nFor Douyin image/text search results, use returned `images` and treat `video.media_type=\"audio\"` as an audio player resource rather than a video post.\nFor Weibo search results, include `post_id`, `post_url`, author facts, interaction counts, and publish time when the user needs traceability.\nFor WeChat Channels / 视频号 search results, include `encrypted_object_id`, author facts, interaction counts, publish time, and duration when the user needs traceability.\n\nFile v0.1.8:_meta.json\n\n{\n \"ownerId\": \"kn79gym47c788rbwr4amw8arfh859t3b\",\n \"slug\": \"socialdatax-douyin-search\",\n \"version\": \"0.1.8\",\n \"publishedAt\": 1781858928555\n}\n\nFile v0.1.8:skill-card.md\n\n## Description:
\nHelps agents retrieve and summarize Douyin hot-search and keyword search results for content research, competitor analysis, and trend scanning through SocialDataX.
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[devinchen2014](https://clawhub.ai/user/devinchen2014)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nExternal analysts, marketers, and developers use this skill to inspect Douyin hot-search rankings and search public Douyin works for content research, trend monitoring, and competitor analysis.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: Server security guidance cautions that the skill may run CLI commands and may read deployment performance insights, including production insights if directed.
\nMitigation: Install only when that access is intended, prefer pinned or already installed CLI tools when supply-chain control matters, and scope production access deliberately.
\nRisk: The direct CLI examples use npx to run the socialdatax-skills package.
\nMitigation: Use a pinned or preinstalled package version when supply-chain control matters.
\nRisk: The skill requires SOCIALDATAX_API_KEY for data calls.
\nMitigation: Provide the key through environment variables only and avoid storing it in prompts, files, or shared logs.
\nRisk: Search results and hot-search rankings are external data and may change over time.
\nMitigation: Keep observed facts separate from interpretation and include returned identifiers, URLs, timestamps, and counts when traceability matters.
\n\n\n## Reference(s):
\n- [ClawHub Skill Page](https://clawhub.ai/devinchen2014/socialdatax-douyin-search)
\n- [SocialDataX API Access Homepage](https://socialdatax.52choujiang.com/?from=clawhub)
\n\n\n## Skill Output:
\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance]
\n**Output Format:** [Markdown guidance with shell commands and JSON API results]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Requires SOCIALDATAX_API_KEY plus node and npm; search pagination uses returned next_page_token values unchanged.]
\n\n## Skill Version(s):
\n0.1.8 (source: server release evidence)
\n\n## Ethical Considerations:
\nUsers 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.
\n\nArchive v0.1.7: 3 files, 3811 bytes\n\nFiles: skill-card.md (2122b), SKILL.md (4790b), _meta.json (144b)\n\nFile v0.1.7:SKILL.md\n\n---\nname: \"socialdatax-douyin-search\"\ndescription: \"用于抖音数据分析、抖音热榜、抖音作品搜索、图文搜索、关键词检索、内容调研、竞品分析和趋势研究。覆盖 Douyin hot search and work search，来自 SocialDataX 社媒数据助手。\"\nmetadata: {\"openclaw\":{\"requires\":{\"env\":[\"SOCIALDATAX_API_KEY\"],\"bins\":[\"node\",\"npm\"]},\"primaryEnv\":\"SOCIALDATAX_API_KEY\",\"install\":[{\"kind\":\"node\",\"package\":\"socialdatax-skills\",\"bins\":[]}],\"emoji\":\"🔥\",\"homepage\":\"https://socialdatax.com/?from=clawhub\"}}\n---\n\n\n# 抖音数据分析 SocialDataX 作品搜索\n\nUse this skill when the user wants 抖音数据分析, 抖音热榜, Douyin work search, image/text post search, keyword discovery, content research, competitor analysis, or trend scanning.\n\nCurrent platform support:\n\n- Douyin / 抖音 hot-search through `douyin_get_hot_search_list`.\n- Douyin / 抖音 works, including video and image/text posts, through `douyin_search_videos`.\n\n## API Key\n\nUse `SOCIALDATAX_API_KEY` for data calls. The only official website for requesting or managing API access is . If a user asks where to get a key, provide only this URL; do not infer alternate domains.\n获取或管理 API Key：访问 ，按官网的 API Key 申请/管理入口操作。环境变量名固定使用 `SOCIALDATAX_API_KEY`；不要引导用户使用其他域名。\n\n## Preferred Direct CLI\n\nPrefer the direct CLI when the agent can run shell commands. It does not require MCP server configuration:\n\n```bash\nnpx -y socialdatax-skills@latest douyin hot-search --pretty\nnpx -y socialdatax-skills@latest douyin search --keyword \"\" --pretty\n```\n\nRequired arguments:\n\n- Douyin `hot-search`: no required arguments.\n- Douyin `search --keyword `: required only when using `douyin search`; use the user's actual intent, trim whitespace, and keep it focused.\n\nOptional arguments:\n\n- `--pretty`: output formatting only.\n- Douyin `--page-token `: opaque pagination token returned by the previous page.\n- Douyin `--sort-type `: optional sort value; omit it for the default sort.\n- Douyin `--publish-time-range `: optional publish-time filter; omit it for no publish-time filter.\n- Douyin `--duration-range `: optional duration filter; omit it for no duration filter.\n- Douyin `--content-type `: optional content type filter; omit it for all content types.\n\nUse `douyin hot-search` for the current Douyin main hot-search list. Do not ask the user for `--keyword` for this command.\nDouyin sort values:\n- `general`: default sorting.\n- `time_descending`: newest first.\n- `like_count_descending`: most liked first.\n\nDouyin publish-time filter values:\n- `all`: no publish-time filter.\n- `day`: published within one day.\n- `week`: published within one week.\n- `half_year`: published within half a year.\n\nDouyin duration filter values:\n- `all`: no duration filter.\n- `under_1_minute`: under 1 minute.\n- `one_to_five_minutes`: 1-5 minutes.\n- `over_5_minutes`: over 5 minutes.\n\nDouyin content type filter values:\n- `all`: all content types.\n- `video`: video works.\n- `image`: image/text posts.\n\nThe command prints JSON with `platform`, `tool`, `arguments`, and `data`.\n\n## Safety Boundary\n\nThis 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.\n\n## MCP Tools\n\nMCP tools matching the direct CLI commands above:\n\n- `douyin_get_hot_search_list`\n- `douyin_search_videos`\n\nIf MCP tools are already available in the current agent, use one of these tools:\n- `douyin_get_hot_search_list`: use for the current Douyin main hot search list.\n- `douyin_search_videos`: use for Douyin keyword search with optional semantic filters.\n\nContinue Douyin pagination only when `next_page_token` is not empty. Do not stop only because one page has empty `items`.\n\n## Output Guidance\n\nSummarize hot-search items as observed ranking signals. Keep the current hot-search list separate from keyword search results when both are used.\nSummarize visible evidence separately from interpretation. Include useful content IDs, URLs, titles or descriptions, authors, counts, and publish time when the user needs traceability.\nFor Douyin search results, include `content_type` when the user needs traceability.\nFor Douyin image/text search results, use returned `images` and treat `video.media_type=\"audio\"` as an audio player resource rather than a video post.\n\nFile v0.1.7:_meta.json\n\n{\n \"ownerId\": \"kn79gym47c788rbwr4amw8arfh859t3b\",\n \"slug\": \"socialdatax-douyin-search\",\n \"version\": \"0.1.7\",\n \"publishedAt\": 1780473938295\n}\n\nFile v0.1.7:skill-card.md\n\n## Description:
\n用于抖音数据分析、抖音热榜、抖音作品搜索、图文搜索、关键词检索、内容调研、竞品分析和趋势研究。覆盖 Douyin hot search and work search，来自 SocialDataX 社媒数据助手。
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[devinchen2014](https://clawhub.ai/user/devinchen2014)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nExternal users, developers, and analysts use this skill to retrieve Douyin hot-search data and search Douyin works for keyword discovery, content research, competitor analysis, and trend scanning through SocialDataX.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: The skill requires a SocialDataX API key for data calls.
\nMitigation: Use a dedicated API key with only the access needed for read-only Douyin data lookups.
\nRisk: The direct CLI path runs the npm package socialdatax-skills.
\nMitigation: Before installing or running it, confirm you trust SocialDataX and the socialdatax-skills package.
\n\n\n## Reference(s):
\n- [SocialDataX Homepage](https://socialdatax.com/?from=clawhub)
\n- [ClawHub Skill Page](https://clawhub.ai/devinchen2014/socialdatax-douyin-search)
\n- [Publisher Profile](https://clawhub.ai/user/devinchen2014)
\n\n\n## Skill Output:
\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance]
\n**Output Format:** [Markdown guidance with inline shell commands; invoked tools and CLI commands return JSON data for summarization.]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Requires SOCIALDATAX_API_KEY plus node and npm when using the direct CLI.]
\n\n## Skill Version(s):
\n0.1.7 (source: server release evidence)
\n\n## Ethical Considerations:
\nUsers 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.
","readmeExcerpt":"Skill: 抖音数据分析 SocialDataX 作品搜索 Owner: devinchen2014 Summary: 用于抖音数据分析、抖音热榜、抖音作品搜索、图文搜索、关键词检索、内容调研、竞品分析和趋势研究。覆盖 Douyin hot search and work search，来自 SocialDataX 社媒数据助手。 Tags: latest:0.1.17 Version history: v0.1.17 | 2026-08-22T15:07:19.298Z | user 同步当前 SocialDataX 使用说明与参数文案。 v0.1.16 | 2026-08-05T03:22:59.777Z | user 同步 SocialDataX 多平台公开能力口径 v0.1.15 | 2026-07-20T11:44:41.092Z | user Refresh API Key guidance to the Soci","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"npx -y socialdatax-skills@latest douyin hot-search \\\n --pretty --source-client socialdatax-skills --source-platform clawhub \\\n --source-skill socialdatax-douyin-search\n\nnpx -y socialdatax-skills@latest douyin search \\\n --keyword \"\" --pretty --source-client socialdatax-skills \\\n --source-platform clawhub --source-skill socialdatax-douyin-search\n\nnpx -y socialdatax-skills@latest douyin search \\\n --keyword \"\" --pages 3 --pretty --source-client socialdatax-skills \\\n --source-platform clawhub --source-skill socialdatax-douyin-search"},{"language":"bash","snippet":"npx -y socialdatax-skills@latest douyin hot-search \\\n --pretty --source-client socialdatax-skills --source-platform clawhub \\\n --source-skill socialdatax-douyin-search\n\nnpx -y socialdatax-skills@latest douyin search \\\n --keyword \"\" --pretty --source-client socialdatax-skills \\\n --source-platform clawhub --source-skill socialdatax-douyin-search\n\nnpx -y socialdatax-skills@latest douyin search \\\n --keyword \"\" --pages 3 --pretty --source-client socialdatax-skills \\\n --source-platform clawhub --source-skill socialdatax-douyin-search"},{"language":"bash","snippet":"npx -y socialdatax-skills@latest douyin hot-search \\\n --pretty --source-client socialdatax-skills --source-platform clawhub \\\n --source-skill socialdatax-douyin-search\n\nnpx -y socialdatax-skills@latest douyin search \\\n --keyword \"\" --pretty --source-client socialdatax-skills \\\n --source-platform clawhub --source-skill socialdatax-douyin-search\n\nnpx -y socialdatax-skills@latest douyin search \\\n --keyword \"\" --pages 3 --pretty --source-client socialdatax-skills \\\n --source-platform clawhub --source-skill socialdatax-douyin-search"},{"language":"bash","snippet":"npx -y socialdatax-skills@latest douyin hot-search \\\n --pretty --source-client socialdatax-skills --source-platform clawhub \\\n --source-skill socialdatax-douyin-search\n\nnpx -y socialdatax-skills@latest douyin search \\\n --keyword \"\" --pretty --source-client socialdatax-skills \\\n --source-platform clawhub --source-skill socialdatax-douyin-search\n\nnpx -y socialdatax-skills@latest douyin search \\\n --keyword \"\" --pages 3 --pretty --source-client socialdatax-skills \\\n --source-platform clawhub --source-skill socialdatax-douyin-search"},{"language":"bash","snippet":"npx -y socialdatax-skills@latest douyin hot-search \\\n --pretty --source-client socialdatax-skills --source-platform clawhub \\\n --source-skill socialdatax-douyin-search\n\nnpx -y socialdatax-skills@latest douyin search \\\n --keyword \"\" --pretty --source-client socialdatax-skills \\\n --source-platform clawhub --source-skill socialdatax-douyin-search\n\nnpx -y socialdatax-skills@latest douyin search \\\n --keyword \"\" --pages 3 --pretty --source-client socialdatax-skills \\\n --source-platform clawhub --source-skill socialdatax-douyin-search"},{"language":"bash","snippet":"npx -y socialdatax-skills@latest douyin hot-search \\\n --pretty --source-client socialdatax-skills --source-platform clawhub \\\n --source-skill socialdatax-douyin-search\n\nnpx -y socialdatax-skills@latest douyin search \\\n --keyword \"\" --pretty --source-client socialdatax-skills \\\n --source-platform clawhub --source-skill socialdatax-douyin-search\n\nnpx -y socialdatax-skills@latest douyin search \\\n --keyword \"\" --pages 3 --pretty --source-client socialdatax-skills \\\n --source-platform clawhub --source-skill socialdatax-douyin-search"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: \"socialdatax-douyin-search\"\ndescription: \"用于抖音数据分析、抖音热榜、抖音作品搜索、图文搜索、关键词检索、内容调研、竞品分析和趋势研究。覆盖 Douyin hot search and work search，来自 SocialDataX 社媒数据助手。\"\nsource_client: \"socialdatax-skills\"\nsource_platform: \"clawhub\"\nsource_skill: \"socialdatax-douyin-search\"\nmetadata: {\"openclaw\":{\"requires\":{\"env\":[\"SOCIALDATAX_API_KEY\"],\"bins\":[\"node\",\"npm\"]},\"primaryEnv\":\"SOCIALDATAX_API_KEY\",\"install\":[{\"kind\":\"node\",\"package\":\"socialdatax-skills\",\"bins\":[]}],\"emoji\":\"🔥\",\"homepage\":\"https://socialdatax.com/ai?from=clawhub\"}}\n---\n\n\n# 抖音数据分析 SocialDataX 作品搜索\n\nUse this skill when the user wants 抖音数据分析, 抖音热榜, Douyin work search, image/text post search, keyword discovery, content research, competitor analysis, or trend scanning.\n\nCurrent platform support:\n\n- Douyin / 抖音 hot-search through `douyin_get_hot_search_list`.\n- Douyin / 抖音 works, including video and image/text posts, through `douyin_search_videos`.\n\n## API Key\n\nUse `SOCIALDATAX_API_KEY` for data calls. The only official website for requesting or managing API access is . If a user asks where to get a key, provide only this URL; do not infer alternate domains.\n获取或管理 API Key：访问 ，按官网的 API Key 申请/管理入口操作。环境变量名固定使用 `SOCIALDATAX_API_KEY`；不要引导用户使用其他域名。\n\n## Preferred Direct CLI\n\nPrefer the direct CLI when the agent can run shell commands. It does not require MCP server configuration:\n\n```bash\nnpx -y socialdatax-skills@latest douyin hot-search \\\n --pretty --source-client socialdatax-skills --source-platform clawhub \\\n --source-skill socialdatax-douyin-search\n\nnpx -y socialdatax-skills@latest douyin search \\\n --keyword \"\" --pretty --source-client socialdatax-skills \\\n --source-platform clawhub --source-skill socialdatax-douyin-search\n\nnpx -y socialdatax-skills@latest douyin search \\\n --keyword \"\" --pages 3 --pretty --source-client socialdatax-skills \\\n --source-platform clawhub --source-skill socialdatax-douyin-search\n```\n\nRequired arguments:\n\n- Douyin `hot-search`: no required arguments.\n- Douyin `search --keyword `: required only when using `douyin search`; use the user's actual intent, trim whitespace, and keep it focused.\n\nOptional arguments:\n\n- `--pretty`: output formatting only.\n- Douyin `--page-token `: opaque pagination token; omit it on the first search request. Continue only with the complete returned `next_page_token` from the same search pagination chain. Do not modify, truncate, redact, mask, omit, normalize, rebuild, generate, or replace the middle with ellipses.\n- Douyin `--sort-type `: optional sort value; omit it for the default sort.\n- Douyin `--publish-time-range `: optional publish-time filter; omit it for no publish-time filter.\n- Douyin `--duration-range