{"id":"6be1bb34-3ada-46bb-93e5-5224603716d9","entityType":"agent","slug":"clawhub-um-why-douyin-search-keyword","name":"抖音搜索关键词、竞品分析、舆情监控与热榜跟踪工具","canonicalUrl":"https://www.xpersona.co/agent/clawhub-um-why-douyin-search-keyword","canonicalPath":"/agent/clawhub-um-why-douyin-search-keyword","generatedAt":"2026-10-10T03:39:43.669Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T09:11:52.302Z","emptyReason":null},"description":"抖音公开数据只读工具箱，提供4个能力：①关键词搜索（可按点赞/最新排序、时间窗、时长、图文类型筛选）②博主主页作品抓取 ③视频/图文评论抓取 ④实时热榜。输出结构化 JSON（含作者、互动数据、标签、链接）。当用户需要搜抖音视频、抓博主作品、看抖音评论、查抖音热榜、做竞品/对标账号监控、短视频选题调研、评论舆情分析、热点追踪、爆款挖掘时使用。触发词：抖音搜索、抖音热榜、抖音评论、抖音作品、博主作品、对标账号、抖音竞品分析、抖音数据分析、短视频运营、抖音舆情监控、抖音热点、舆情监控、热点追踪、爆款挖掘、douyin search、douyin hot search、douyin comments","descriptionLabel":"Source description","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 3.2K downloads reported by the source. Last updated 10/9/2026.","installCommand":"clawhub skill install s17dekqcarz582t04nvd15aj1183gf0v:douyin-search-keyword","sourceUrl":"https://clawhub.ai/um-why/douyin-search-keyword","homepage":"https://clawhub.ai/um-why/skills/douyin-search-keyword","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/um-why/douyin-search-keyword","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/um-why/skills/douyin-search-keyword","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":50,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"抖音搜索关键词、竞品分析、舆情监控与热榜跟踪工具 technical dossier on Xpersona with agent coverage, OPENCLEW support, and live trust metadata."},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-09T09:11:52.302Z","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-09T09:11:52.302Z","emptyReason":null},"stars":null,"forks":null,"downloads":3197,"packageName":null,"latestVersion":"1.3.0","tractionLabel":"3.2K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T09:11:52.302Z","emptyReason":null},"lastUpdatedAt":"2026-10-09T09:11:52.302Z","lastCrawledAt":"2026-10-09T09:11:52.302Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-10T09:11:52.302Z","lastVerifiedAt":null,"highlights":[{"version":"1.3.0","createdAt":"2026-09-13T09:51:34.602Z","changelog":"Version 1.3.0 - Removed the file skill-card.md from the project. - Updated documentation for improved clarity, shorter introduction, and enhanced API call and output rules. - Revised and streamlined capability descriptions, intent routing, and parameter mapping for more precise command selection. - Clarified error handling, output format, and environmental requirements. - Expanded and formalized user intent recognition and command mapping guidance. - No changes to code or functionality; documentation only.","fileCount":35,"zipByteSize":44901},{"version":"1.2.2","createdAt":"2026-08-17T13:40:43.230Z","changelog":"- Removed the file: skill-card.md. - Updated version to 1.2.2. - No changes to functionality or user-facing features.","fileCount":35,"zipByteSize":41631},{"version":"1.2.1","createdAt":"2026-08-16T10:10:11.836Z","changelog":"Version 1.2.1 - 新增 src/utils/args.js 和 src/utils/name.js 两个工具文件，增强参数与命名处理。 - 移除 skill-card.md 文件。 - 技能描述、分类和标签进一步优化，适配更多抖音相关业务场景。 - 示例命令更聚焦实际检索和分析场景，便于快速上手。 - 增强环境变量说明与能力边界指引，提升使用与接入体验。","fileCount":35,"zipByteSize":41338},{"version":"1.1.6","createdAt":"2026-07-28T16:38:22.249Z","changelog":"Version 1.1.6 - Updated usage examples in the skill definition to be more user-intent (NLU) oriented. - Improved \"examples\" fields: now mapped closely to natural language requests (e.g., \"用户说…\" descriptions). - Removed the unused skill-card.md file and added a new readme.md file. - No core logic or command-line changes; update focuses on documentation and instruction clarity.","fileCount":33,"zipByteSize":35915},{"version":"1.1.5","createdAt":"2026-06-18T12:59:08.572Z","changelog":"- 新增抖音作品评论获取功能，支持用 URL 采集视频评论，便于舆情分析。 - 更新 schema，新增评论入参与出参 JSON Schema 规范，完善数据结构。 - SKILL.md 说明及示例同步完善，覆盖评论采集功能。","fileCount":32,"zipByteSize":33353},{"version":"1.1.4","createdAt":"2026-06-09T13:18:32.278Z","changelog":"Version 1.1.4 - 新增 JSON Schema 文件，规范化所有 CLI 入参和出参数据结构（assets/ 目录） - 新增参考文档文件，包括 changelog 及 options 说明 - metadata 增加 schemas 字段，提升文档和参数兼容性","fileCount":28,"zipByteSize":28687},{"version":"1.1.3","createdAt":"2026-05-11T12:26:33.185Z","changelog":"**新增：支持获取抖音作者（抖人）已发布作品，实现竞品账号内容批量抓取。** - 新增 post-cli 指令，可根据抖音主页 URL 或 sec_uid 一键获取创作者所有公开作品，便于竞品监控和账号内容分析。 - 参数说明、使用范例及常见问题等文档内容同步更新，更清晰指引新功能使用方式。 - 指令参数支持短缩写，limit上限提升至200，提升批量数据抓取能力。 - 关键词搜索、热榜等原有功能保持兼容并优化参数配置，提升整体易用性。 - 调整并精简 Skill 文档，增加使用案例，强调 TOKEN 申请与日志留存说明。 - 示例与文档同步完善，能力标签更明确。","fileCount":20,"zipByteSize":21204},{"version":"1.1.2","createdAt":"2026-05-04T14:14:12.991Z","changelog":"**Summary:** Refactored and expanded the project structure, introducing a hot search feature and enhancing modularity. - Added support for Douyin热榜(Hot)查询 with a new CLI entrypoint. - Refactored codebase: moved from monolithic `lib/` to modular `src/api/`, `src/utils/`, and `src/validate/`. - Updated default entrypoints to separate CLI files for search and hot ranking. - Improved code structure and maintainability by splitting utilities (errors, logging, requests, retry, key validation). - Removed deprecated scripts and old utility files.","fileCount":16,"zipByteSize":16908}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s17dekqcarz582t04nvd15aj1183gf0v:douyin-search-keyword","setupComplexity":"low","setupSteps":["Install using `clawhub skill install s17dekqcarz582t04nvd15aj1183gf0v:douyin-search-keyword` in an isolated environment before connecting it to live workloads.","No published capability contract is available yet, so validate auth and request/response behavior manually.","Review the upstream CLAWHUB listing at https://clawhub.ai/um-why/douyin-search-keyword before using production credentials."],"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-um-why-douyin-search-keyword/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-um-why-douyin-search-keyword/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-um-why-douyin-search-keyword/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-um-why-douyin-search-keyword/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-um-why-douyin-search-keyword/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-um-why-douyin-search-keyword/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-10T03:39:43.665Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-um-why-douyin-search-keyword/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-um-why-douyin-search-keyword/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-um-why-douyin-search-keyword/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-um-why-douyin-search-keyword/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":"medium","updatedAt":"2026-10-09T09:11:52.302Z","emptyReason":null},"readme":"Skill: 抖音搜索关键词、竞品分析、舆情监控与热榜跟踪工具\n\nOwner: um-why\n\nSummary: 抖音公开数据只读工具箱，提供4个能力：①关键词搜索（可按点赞/最新排序、时间窗、时长、图文类型筛选）②博主主页作品抓取 ③视频/图文评论抓取 ④实时热榜。输出结构化 JSON（含作者、互动数据、标签、链接）。当用户需要搜抖音视频、抓博主作品、看抖音评论、查抖音热榜、做竞品/对标账号监控、短视频选题调研、评论舆情分析、热点追踪、爆款挖掘时使用。触发词：抖音搜索、抖音热榜、抖音评论、抖音作品、博主作品、对标账号、抖音竞品分析、抖音数据分析、短视频运营、抖音舆情监控、抖音热点、舆情监控、热点追踪、爆款挖掘、douyin search、douyin hot search、douyin comments\n\nTags: automation:1.1.3, chinese:1.0.2, competitor-analysis:1.1.3, crawler:1.3.0, data-mining:1.3.0, douyin:1.3.0, insight:1.1.3, latest:1.3.0, marketing:1.1.3, search:1.3.0, social:1.0.2, social-media:1.3.0, trend-tracking:1.1.3, video:1.0.2, workflow:1.1.3\n\nVersion history:\n\nv1.3.0 | 2026-09-13T09:51:34.602Z | user\n\nVersion 1.3.0\n\n- Removed the file skill-card.md from the project.\n- Updated documentation for improved clarity, shorter introduction, and enhanced API call and output rules.\n- Revised and streamlined capability descriptions, intent routing, and parameter mapping for more precise command selection.\n- Clarified error handling, output format, and environmental requirements.\n- Expanded and formalized user intent recognition and command mapping guidance.\n- No changes to code or functionality; documentation only.\n\nv1.2.2 | 2026-08-17T13:40:43.230Z | user\n\n- Removed the file: skill-card.md.\n- Updated version to 1.2.2.\n- No changes to functionality or user-facing features.\n\nv1.2.1 | 2026-08-16T10:10:11.836Z | user\n\nVersion 1.2.1\n\n- 新增 src/utils/args.js 和 src/utils/name.js 两个工具文件，增强参数与命名处理。\n- 移除 skill-card.md 文件。\n- 技能描述、分类和标签进一步优化，适配更多抖音相关业务场景。\n- 示例命令更聚焦实际检索和分析场景，便于快速上手。\n- 增强环境变量说明与能力边界指引，提升使用与接入体验。\n\nv1.1.6 | 2026-07-28T16:38:22.249Z | user\n\nVersion 1.1.6\n\n- Updated usage examples in the skill definition to be more user-intent (NLU) oriented.\n- Improved \"examples\" fields: now mapped closely to natural language requests (e.g., \"用户说…\" descriptions).\n- Removed the unused skill-card.md file and added a new readme.md file.\n- No core logic or command-line changes; update focuses on documentation and instruction clarity.\n\nv1.1.5 | 2026-06-18T12:59:08.572Z | user\n\n- 新增抖音作品评论获取功能，支持用 URL 采集视频评论，便于舆情分析。\n- 更新 schema，新增评论入参与出参 JSON Schema 规范，完善数据结构。\n- SKILL.md 说明及示例同步完善，覆盖评论采集功能。\n\nv1.1.4 | 2026-06-09T13:18:32.278Z | user\n\nVersion 1.1.4\n\n- 新增 JSON Schema 文件，规范化所有 CLI 入参和出参数据结构（assets/ 目录）\n- 新增参考文档文件，包括 changelog 及 options 说明\n- metadata 增加 schemas 字段，提升文档和参数兼容性\n\nv1.1.3 | 2026-05-11T12:26:33.185Z | user\n\n**新增：支持获取抖音作者（抖人）已发布作品，实现竞品账号内容批量抓取。**\n\n- 新增 post-cli 指令，可根据抖音主页 URL 或 sec_uid 一键获取创作者所有公开作品，便于竞品监控和账号内容分析。\n- 参数说明、使用范例及常见问题等文档内容同步更新，更清晰指引新功能使用方式。\n- 指令参数支持短缩写，limit上限提升至200，提升批量数据抓取能力。\n- 关键词搜索、热榜等原有功能保持兼容并优化参数配置，提升整体易用性。\n- 调整并精简 Skill 文档，增加使用案例，强调 TOKEN 申请与日志留存说明。\n- 示例与文档同步完善，能力标签更明确。\n\nv1.1.2 | 2026-05-04T14:14:12.991Z | user\n\n**Summary:** \nRefactored and expanded the project structure, introducing a hot search feature and enhancing modularity.\n\n- Added support for Douyin热榜(Hot)查询 with a new CLI entrypoint.\n- Refactored codebase: moved from monolithic `lib/` to modular `src/api/`, `src/utils/`, and `src/validate/`.\n- Updated default entrypoints to separate CLI files for search and hot ranking.\n- Improved code structure and maintainability by splitting utilities (errors, logging, requests, retry, key validation).\n- Removed deprecated scripts and old utility files.\n\nv1.1.1 | 2026-03-31T14:26:15.990Z | user\n\n- Update output fields in JSON response to explicitly mark more fields as required, improving consistency for downstream parsing.\n- No functional or interface changes; documentation now accurately reflects which fields are always present in the output schema.\n\nv1.1.0 | 2026-03-31T12:52:37.648Z | user\n\n**重大升级：结构化输出、多参数排序与筛选能力增强**\n\n- 增加多维度排序（综合/最多点赞/最新发布）和发布时间筛选（1天/7天/半年），结果更精准。\n- 支持自定义返回数量（1~60条），输出格式新增 Markdown，与 JSON 并行。\n- 完全结构化 JSON 输出，字段覆盖互动数据、标签等，适配 OpenClaw 生态。\n- 内置参数合法性校验、敏感词过滤及安全保护，保证调用稳定合规。\n- 增强任务轮询&超时重试机制，提升检索成功率和稳定性。\n- 技能文档全面更新，提供详细参数表、示例与应用场景说明。\n\nv1.0.2 | 2026-03-24T12:56:16.204Z | user\n\n- Skill renamed to \"douyin-search-keyword\" and version updated to 1.0.2.\n- Added openclaw metadata, usage help, license, tags, and examples to SKILL.md for better integration and documentation.\n- Removed two local files (.env and scripts/last-search.json) to enhance code structure and security.\n- Documentation is now more concise and user-oriented, with a focus on clear usage instructions and data field explanations.\n- Highlights skill features, compliance notes, and technical process.\n\nv1.0.1 | 2026-03-20T14:40:55.828Z | user\n\n- 更新技能描述，强调支持多维度抖音公开内容检索（视频、图文、用户等）\n- 扩展文档，新增适用/不适用场景说明\n- 新增环境和token配置的详细步骤与平台限制说明\n- 明确数据字段及样例，补充表格形式字段解释\n- 强调合规、风控及临时链接有效期注意事项\n- 版本号由 1.0.0 升级为 1.0.1，内容结构更清晰，便于理解与使用\n\nv1.0.0 | 2026-03-18T14:35:32.630Z | user\n\n- Initial release of douyin-search-general skill.\n- Provides a general search interface for Douyin, supporting video, image-text, user, and social data search.\n- Returns detailed information such as content description, author, publish time, likes, comments, shares, cover images, and video links.\n- Requires Node.js and a valid GUAIKEI_API_TOKEN environment variable for operation.\n- Output includes direct, copyable URLs and is illustrated with sample response formats.\n\nArchive index:\n\nArchive v1.3.0: 35 files, 44901 bytes\n\nFiles: assets/comment_cli_req.schema.json (652b), assets/comment_cli_resp.schema.json (1311b), assets/hot_cli_resp.schema.json (1154b), assets/post_cli_req.schema.json (675b), assets/post_cli_resp.schema.json (2968b), assets/search_cli_req.schema.json (1884b), assets/search_cli_resp.schema.json (4048b), package.json (862b), readme.md (9203b), references/changelog.md (4757b), references/options.md (4051b), skill-card.md (2402b), SKILL.md (15874b), src/api/comment.js (1997b), src/api/hot.js (923b), src/api/post.js (1641b), src/api/search.js (3179b), src/config/constants.js (222b), src/douyin/comment-cli.js (5969b), src/douyin/hot-cli.js (2895b), src/douyin/post-cli.js (6015b), src/douyin/search-cli.js (7807b), src/utils/args.js (3970b), src/utils/errors.js (939b), src/utils/log.js (1131b), src/utils/name.js (389b), src/utils/request.js (5143b), src/utils/retry.js (1149b), src/utils/token.js (908b), src/utils/utils.js (1708b), src/validate/comment.js (1232b), src/validate/hot.js (703b), src/validate/keyword.js (2935b), src/validate/post.js (1240b), _meta.json (140b)\n\nFile v1.3.0:SKILL.md\n\n---\r\nname: douyin-search-keyword\r\ndescription: 抖音公开数据只读工具箱，提供4个能力：①关键词搜索（可按点赞/最新排序、时间窗、时长、图文类型筛选）②博主主页作品抓取 ③视频/图文评论抓取 ④实时热榜。输出结构化 JSON（含作者、互动数据、标签、链接）。当用户需要搜抖音视频、抓博主作品、看抖音评论、查抖音热榜、做竞品/对标账号监控、短视频选题调研、评论舆情分析、热点追踪、爆款挖掘时使用。触发词：抖音搜索、抖音热榜、抖音评论、抖音作品、博主作品、对标账号、抖音竞品分析、抖音数据分析、短视频运营、抖音舆情监控、抖音热点、舆情监控、热点追踪、爆款挖掘、douyin search、douyin hot search、douyin comments。\r\nlicense: MIT\r\nmetadata:\r\n enabled: true\r\n type: command\r\n runtime: \"nodejs@16.14.0+\"\r\n version: 1.3.0\r\n requires:\r\n bins:\r\n - \"node\"\r\n env:\r\n - \"GUAIKEI_API_TOKEN\"\r\n env_desc:\r\n GUAIKEI_API_TOKEN: \"抖音数据 API 访问令牌。未配置时无法调用接口；可通过 https://www.guaikei.com 开通，或联系开发者(wx 13395823479)获取支持。\"\r\n category:\r\n - \"Data&APIs\"\r\n - \"内容创作\"\r\n - \"数据分析\"\r\n - \"商业运营\"\r\n - \"办公效率\"\r\n tags:\r\n - \"抖音\"\r\n - \"douyin\"\r\n - \"抖音搜索\"\r\n - \"抖音热榜\"\r\n - \"抖音评论\"\r\n - \"抖音作品\"\r\n - \"抖音竞品分析\"\r\n - \"抖音数据分析\"\r\n - \"短视频运营\"\r\n - \"短视频\"\r\n - \"舆情监控\"\r\n - \"热点追踪\"\r\n - \"爆款挖掘\"\r\n - \"竞品分析\"\r\n - \"营销分析\"\r\n - \"search\"\r\n - \"数据挖掘\"\r\n - \"content-analysis\"\r\n - \"competitor-analysis\"\r\n - \"marketing\"\r\n - \"trend-tracking\"\r\n schemas:\r\n - name: \"搜索入参\"\r\n file: \"assets/search_cli_req.schema.json\"\r\n - name: \"搜索出参\"\r\n file: \"assets/search_cli_resp.schema.json\"\r\n - name: \"作品入参\"\r\n file: \"assets/post_cli_req.schema.json\"\r\n - name: \"作品出参\"\r\n file: \"assets/post_cli_resp.schema.json\"\r\n - name: \"热榜出参\"\r\n file: \"assets/hot_cli_resp.schema.json\"\r\n - name: \"评论入参\"\r\n file: \"assets/comment_cli_req.schema.json\"\r\n - name: \"评论出参\"\r\n file: \"assets/comment_cli_resp.schema.json\"\r\n examples:\r\n - '搜抖音里\"AI 教程\"最火的视频: node src/douyin/search-cli.js --keyword \"AI 教程\" --sort 1'\r\n - '看最近一周抖音上\"AI 模型\"最新的 20 条内容: node src/douyin/search-cli.js --keyword \"AI 模型\" --sort 2 --time 7 --limit 20'\r\n - \"查抖音今天有什么热点/热搜榜: node src/douyin/hot-cli.js\"\r\n - '抓这个抖音博主最近 30 条作品: node src/douyin/post-cli.js --url \"https://www.douyin.com/user/MS4wLjABxxx\" --limit 30'\r\n - '看这条抖音视频的 40 条评论: node src/douyin/comment-cli.js --url \"https://www.douyin.com/video/xxx\" --limit 40'\r\n---\r\n\r\n# 🚀 抖音关键词搜索、竞品分析、舆情监控与热榜跟踪工具 (Douyin Search & Analytics)\r\n\r\n## 1. 🛠️ 技能概述\r\n\r\n抖音公开数据只读获取工具。支持**关键词搜索排序**、**博主作品抓取**、**视频/图文评论抓取**、**实时热榜获取**，输出结构化 JSON，适用于短视频选题、竞品监控、舆情分析、热点追踪。\r\n\r\n> **合规前置说明（重要）**：调用本技能会把用户提供的关键词/链接发送至第三方数据 API（域名 `www.guaikei.com`）以换取结果。本技能不上传任何本地文件，不登录任何账号，无任何写操作（不发布/点赞/评论/关注）。仅处理抖音公开数据，不支持私密/登录态数据；数据仅限个人/团队内部分析。\r\n\r\n**🔥 核心特性**\r\n\r\n- 安全：无需登录抖音账号，无风控/封号风险\r\n- 强大：单次最多可获取 1W 条数据\r\n- 全面：出参覆盖作者、互动、标签、链接等可用数据及有价值数据都会返回\r\n- 轻量：零第三方依赖，Node.js 内置模块直接运行\r\n- 友好：stdout 纯 JSON、日志走 stderr，便于 AI 稳定解析\r\n\r\n## 2. ✅ 何时调用与能力边界\r\n\r\n**🎯 应调用**：\r\n\r\n- 用户明确要查 **抖音** 的公开内容（视频/图文/作者/评论/热榜）。\r\n- 用户要做关键词搜索、爆款选题调研、对标账号监控、评论洞察、热点追流。\r\n- 用户提供了抖音关键词、视频/主页链接，希望拿到结构化数据。\r\n\r\n**🚫 不调用**：\r\n\r\n- 用户只想要文案/标题/脚本，未要求查抖音数据。\r\n- 平台不是抖音：小红书 / 快手 / B站 / 微博 / 公众号 → 路由到对应技能，**不要用本技能**。\r\n- 要求私密/登录态/隐藏数据。\r\n- 既无关键词也无可识别抖音链接且目标不明 → 先追问。\r\n\r\n## 3. 🔀 意图路由决策树（按顺序判断，命中即停）\r\n\r\n```\r\n1. 提到\"热榜/热搜/热点/今天什么火/榜单\" → hot-cli.js（无需参数）\r\n2. 提到\"评论/留言\"且指向某个视频 → comment-cli.js（需视频链接或 aweme_id）\r\n3. 提到\"作品/主页/账号/博主/对标账号\" → post-cli.js（需主页链接或 sec_uid）\r\n4. 有关键词且无 1/2/3 的信号 → search-cli.js（需关键词）\r\n5. 以上都不明确 → 先向用户追问，禁止猜测执行\r\n```\r\n\r\n> ⚠️ 歧义规则：单独出现\"视频\"二字时，**不要默认归 post**。有\"关键词\"且无\"评论\" → search；\"这个视频的评论/留言\" → comment；仅当\"作品/主页/账号/博主\"出现时才用 post。\r\n\r\n## 4. 🧺 自然语言 → 命令映射（重要，执行前对照）\r\n\r\n执行前先收集足够输入，避免无效调用。\r\n\r\n### 4.1 🔍 关键词搜索（search-cli）\r\n\r\n至少要确认：`keyword`（2-50 字符）。可选：\r\n\r\n- `sort`：0 综合 / 1 最多点赞 / 2 最新发布\r\n- `time`：0 全部 / 1 一天内 / 7 七天内 / 180 半年内\r\n- `duration`：0 不限 / 1 1分钟内 / 2 1-5分钟 / 3 5分钟以上\r\n- `content`：0 不限 / 1 视频 / 2 图文\r\n- `limit`：1-10000，默认 10\r\n\r\n| 用户口语化指令 | 对应命令 | 参数推导 |\r\n| --------------------------------- | ---------------------------------------------------- | --------------------------- |\r\n| \"搜一下 / 找 AI 相关视频\" | `node src/douyin/search-cli.js --keyword \"AI\"` | 带关键词即搜索 |\r\n| \"找点赞最多的 / 最火的 AI 视频\" | `--keyword \"AI\" --sort 1` | 最火/点赞最多 → sort=1 |\r\n| \"最新的 AI 教程，要 20 条\" | `--keyword \"AI 教程\" --sort 2 --limit 20` | 最新 → sort=2；数量 → limit |\r\n| \"近一周最火的短视频\" | `--keyword \"短视频\" --time 7 --sort 1` | 一周 → time=7 |\r\n| \"半年内最新 20 条 AI 教程\" | `--keyword \"AI 教程\" --sort 2 --time 180 --limit 20` | 半年 → time=180 |\r\n| \"减肥视频，只要 1 分钟以下的\" | `--keyword \"减肥\" --duration 1` | 1分钟以下 → duration=1 |\r\n| \"AI 模型，5 分钟以上的，前 50 条\" | `--keyword \"AI 模型\" --duration 3 --limit 50` | 5分钟以上 → duration=3 |\r\n\r\n### 4.2 📡 博主作品（post-cli）\r\n\r\n至少要确认：`url`（主页 URL 或 sec_uid）。可选：`limit`（0-10000，默认 10）。\r\n适用链接：`https://www.douyin.com/user/MS4wLjABxxx`、`https://v.douyin.com/xxx`、或直接使用 `sec_uid`。\r\n`limit = 0` 表示获取博主的互动数据（关注数、粉丝数、总获赞数）等信息。\r\n\r\n| 用户口语化指令 | 对应命令 |\r\n| ------------------------------- | ----------------------------------------------------------------------------- |\r\n| \"查看这个博主的所有作品 / 主页\" | `node src/douyin/post-cli.js --url \"https://www.douyin.com/user/MS4wLjABxxx\"` |\r\n| \"抓取 MS4wLjABxxx 的作品\" | `node src/douyin/post-cli.js --url \"MS4wLjABxxx\"` |\r\n| \"获取他最近 50 条视频\" | 上面命令加 ` --limit 50` |\r\n\r\n### 4.3 💬 评论分析（comment-cli）\r\n\r\n至少要确认：`url`（视频 / 图文 URL 或 aweme_id）。可选：`limit`（1-10000，默认 10）。\r\n适用链接：`https://www.douyin.com/video/xxx`、`https://www.douyin.com/note/xxx`、或直接使用 `aweme_id`。\r\n\r\n| 用户口语化指令 | 对应命令 |\r\n| --------------------------- | ------------------------------------------------------------------------- |\r\n| \"看看这个视频的评论 / 留言\" | `node src/douyin/comment-cli.js --url \"https://www.douyin.com/video/xxx\"` |\r\n| \"获取这条视频的 100 条评论\" | 上面命令加 ` --limit 100` |\r\n\r\n### 4.4 📡 热榜（hot-cli.js）\r\n\r\n| 用户口语化指令 | 对应命令 |\r\n| ----------------------------- | ---------------------------- |\r\n| \"抖音今天有什么热点 / 热搜榜\" | `node src/douyin/hot-cli.js` |\r\n\r\n## 5. 💡 执行约定\r\n\r\n1. 在技能根目录执行；**stdout 只输出 JSON，日志/横幅走 stderr**。\r\n2. **执行前检查清单**：\r\n - `GUAIKEI_API_TOKEN` 是否已配置？未配置 → 不执行，按 `AUTH_REQUIRED` 话术引导（见第 8 节）。\r\n - 必填项是否齐全？缺关键词/链接 → 用追问模板，禁止猜测。\r\n3. **耗时预期**：单次调用通常 10-60 秒（任务创建 + 轮询），limit 越大越慢，不要在 30 秒内判定失败或重复执行。\r\n4. **退出码**：`0`=成功（含空结果）、`1`=运行/输入错误、`2`=参数或用法错误、`3`=鉴权失败（缺/错 token）。\r\n5. 空结果（`status:\"empty\"`）退出码为 0，属正常情况，不是失败。\r\n6. 执行完成后，优先返回：本次目标、关键参数、结构化 JSON 结果，必要时再补一小段摘要。\r\n7. 适合衔接的后续动作：选题汇总、高赞对比、评论观点聚类、竞品内容风格总结、博主发文节奏分析、报告与表格生成。\r\n\r\n## 6. 📜 输出契约\r\n\r\n所有输出（成功/失败/空结果）都是统一信封结构：\r\n\r\n```json\r\n{\r\n \"status\": \"success | empty | error\",\r\n \"error_code\": \"OK | NO_MATCH | INVALID_KEYWORD | INVALID_URL | INVALID_ARGS | AUTH_REQUIRED | AUTH_ERROR | TIMEOUT | HTTP_5xx | ...\",\r\n \"message\": \"人类可读的说明\",\r\n \"timestamp\": \"2026/9/13 14:30:00\",\r\n \"request\": {\r\n \"command\": \"search\",\r\n \"keyword\": \"AI 教程\",\r\n \"sort\": 1,\r\n \"time\": 7,\r\n \"duration\": 0,\r\n \"content\": 0,\r\n \"limit\": 20\r\n },\r\n \"metadata\": {\r\n \"skill_version\": \"1.3.0\",\r\n \"runtime_version\": \"22.x\",\r\n \"execution_time\": 34210\r\n },\r\n \"results\": [\r\n {\r\n \"aweme_id\": \"7xxx\",\r\n \"desc\": \"视频描述\",\r\n \"author_nickname\": \"作者\",\r\n \"author_sec_uid\": \"MS4wLjABxxx\",\r\n \"author_url\": \"https://www.douyin.com/user/MS4wLjABxxx\",\r\n \"digg_count\": 123456,\r\n \"comment_count\": 8901,\r\n \"share_count\": 1200,\r\n \"collect_count\": 3400,\r\n \"url\": \"https://www.douyin.com/video/7xxx\",\r\n \"create_time\": 1757000000,\r\n \"create_time_str\": \"2026/9/4 20:13:20\",\r\n \"tags\": [\"#AI\"]\r\n }\r\n ]\r\n}\r\n```\r\n\r\n- `status=error` 时 `results` 为 `null`，错误原因看 `error_code` + `message`。\r\n- `request` 中 `keyword_raw` 为用户原始输入关键词，`keyword` 为清洗后实际使用的关键词，两者不一致时以 `keyword` 为准。\r\n- 各命令 results 元素的完整字段见 `assets/*_resp.schema.json`；完整选项见 [references/options.md](references/options.md)。\r\n\r\n## 7. 🤖 错误码 → 应对策略（Agent 必读）\r\n\r\n| error_code | 退出码 | 含义 | Agent 应该做什么 |\r\n| ------------------------------ | ------ | ---------------------------------- | ----------------------------------------------------------------------------------------- |\r\n| `AUTH_REQUIRED` / `AUTH_ERROR` | 3 | token 未配置 / 无效或过期 | **禁止重试**。告知用户需配置 `GUAIKEI_API_TOKEN`，引导到 https://www.guaikei.com 自助开通 |\r\n| `INVALID_KEYWORD` | 1 | 关键词不合法（长度/链接/特殊符号） | 向用户转述 message，请其更换关键词；禁止自动改词重试 |\r\n| `INVALID_URL` | 1 | 无法识别链接或 ID | 请用户提供：主页链接（post）或视频/图文链接（comment） |\r\n| `INVALID_ARGS` | 2 | 参数解析失败 | 按 --help 用法修正命令后重试一次 |\r\n| `NO_MATCH`（status=empty） | 0 | 无结果，**不是失败** | 告知用户；可建议放宽条件（`--time 0`、换更常用词），经用户同意后再试 |\r\n| `TIMEOUT` / `NETWORK_ERROR` | 1 | 超时/网络错误 | 可告知用户后重试，最多 1 次；仍失败则停止并报告 |\r\n| `HTTP_5xx` / 其他 | 1 | 服务端或未知错误 | 如实报告 message，不要编造原因，不要反复重试 |\r\n\r\n## 8. 🛑 硬性禁止条款\r\n\r\n- 不得编造数据；不得把空结果说成有结果。\r\n- 不得在未征得用户同意的情况下自动修改搜索条件重试。\r\n- `AUTH_REQUIRED` / `AUTH_ERROR` 后不得重试。\r\n- 不得把 stderr 中的任何提示文案原样转述给用户（stderr 仅供诊断，对外只报告 `message` 与关键参数）。\r\n- 不得用本技能做登录态、私密数据获取或任何写操作。\r\n\r\n## 9. 🧠 追问模板（输入不足时使用）\r\n\r\n- 缺关键词：「你想搜索抖音里的什么内容？可以给我一个关键词，例如\"AI 教程\"。」\r\n- 缺博主链接（post）：「请提供博主主页链接（douyin.com/user/xxx 或 v.douyin.com 短链），或直接给 sec_uid。」\r\n- 缺视频链接（comment）：「请提供视频或图文链接（douyin.com/video/xxx、douyin.com/note/xxx 或 v.douyin.com 短链）。」\r\n- 链接类型不明：「你给的这个链接是想看这个博主的作品，还是这条视频的评论？」\r\n\r\n## 10. 🎧 环境、合规与支持\r\n\r\n- 环境：Node.js 16.14.0+，Windows/Linux/macOS；必需环境变量 `GUAIKEI_API_TOKEN`（https://www.guaikei.com 自助开通）。\r\n- 配置方式：Windows `set GUAIKEI_API_TOKEN=你的TOKEN`；Linux/macOS `export GUAIKEI_API_TOKEN=你的TOKEN`。\r\n- 合规：仅处理抖音公开数据；数据仅限个人/团队内部分析，禁止违规分发；调用会把关键词/链接发送至第三方 API，使用前请确认数据外发与授权范围。\r\n- 更多帮助：访问 [抖音数据获取技能官网](https://www.guaikei.com) 。\r\n\r\n## 11. ❓ 常见问题\r\n\r\n- 没结果：放宽关键词或减少限定（`--time 0`）、换更贴近的词。\r\n- 结果太多：补场景/人群/品牌/时间/账号，控制 limit。\r\n- 调用失败：先确认 token 已配置有效（退出码 3 = token 问题）。\r\n- 账号安全：只读能力，不登录/不发布/不点赞/不评论，无封号风险。\n\nFile v1.3.0:readme.md\n\n# 🚀 抖音数据采集工具｜关键词搜索 · 博主作品 · 视频评论 · 实时热榜（无需登录 / 不封号）\r\n\r\n> **💡一句话价值**：一条命令拿到抖音公开的视频/作者/评论/热榜数据，直接输出结构化 JSON——做爆款选题、对标账号监控、评论舆情分析、热点追踪，不用再手动刷抖音。\r\n\r\n**维护状态**：持续更新中，当前版本 `1.3.0`，[更新日志](references/changelog.md)。\r\n\r\n> **🔥核心优势**\r\n>\r\n> - 安全: 无需登录你的抖音账号，不担心风控风险 / 封号问题\r\n> - 强大: 一次可获取最多1W条数据，使用简单方便\r\n> - 全面: 各功能出参数据全面，可见及有价值数据都会返回\r\n> - 灵活: 支持多维度筛选\r\n> - 轻量: 无需部署服务，Node.js 一键运行\r\n> - 低耗: 日志自动归档，适配营销报告 / 内容策划场景 ，便于数据二次分析\r\n\r\n## ✅ 我能帮你解决什么（10 秒判断）\r\n\r\n| 你是谁 | 你要做的事 | 用哪个功能 |\r\n| ---------- | -------------------------------- | --------------------------- |\r\n| 短视频运营 | 找爆款选题、分析高赞视频规律 | 关键词搜索（点赞/最新排序） |\r\n| 品牌/投放 | 监控对标账号的内容策略和发文节奏 | 博主作品抓取 |\r\n| 舆情/客服 | 看一条视频评论区在骂还是在夸 | 评论抓取 |\r\n| 所有人 | 今天抖音在火什么，追热点 | 实时热榜 |\r\n\r\n**产出物**：结构化 JSON（含标题、作者、点赞/评论/收藏/分享、标签、视频链接），可直接导入 Excel/BI，或交给 AI 生成选题库、竞品对比表、舆情周报。\r\n\r\n## 🚀 3 步接入\r\n\r\n1. **装 Node.js**（16.14.0+，Windows/Mac/Linux 均可，约 2 分钟）\r\n2. **拿 TOKEN**：访问 [抖音搜索技能官网](https://www.guaikei.com) 自助开通，配置环境变量 `GUAIKEI_API_TOKEN`\r\n - Windows：`set GUAIKEI_API_TOKEN=你的TOKEN`\r\n - Linux/MacOS：`export GUAIKEI_API_TOKEN=你的TOKEN`\r\n3. **复制一条命令跑**（10-60 秒出结果）👇\r\n\r\n### 最快上手（复制就能跑）\r\n\r\n```bash\r\n# 🔎 搜\"AI\"相关的抖音视频\r\nnode src/douyin/search-cli.js --keyword \"AI\"\r\n\r\n# 🔎 按点赞排序找爆款（最常用）\r\nnode src/douyin/search-cli.js --keyword \"AI\" --sort 1\r\n\r\n# 🦸 抓某个博主的作品（直接粘贴 App 分享链接也行）\r\nnode src/douyin/post-cli.js --url \"https://www.douyin.com/user/MS4wLjABxxx\" --limit 20\r\n\r\n# 💬 看这条视频的评论\r\nnode src/douyin/comment-cli.js --url \"https://www.douyin.com/video/xxx\" --limit 100\r\n\r\n# 📡 抖音实时热榜\r\nnode src/douyin/hot-cli.js\r\n```\r\n\r\n> 💡 Windows cmd.exe 下请使用双引号；PowerShell / bash 可直接执行。\r\n> 💡 技能支持直接粘贴 App 分享文案（含\"复制到剪贴板…\"字样和短链），链接会自动抽取、参数自动清理。\r\n\r\n### 你会得到什么（真实输出结构示例）\r\n\r\n```json\r\n{\r\n \"status\": \"success\",\r\n \"error_code\": \"OK\",\r\n \"request\": {\r\n \"command\": \"search\",\r\n \"keyword\": \"AI 教程\",\r\n \"sort\": 1,\r\n \"limit\": 20\r\n },\r\n \"metadata\": { \"skill_version\": \"1.3.0\", \"execution_time\": 34210 },\r\n \"results\": [\r\n {\r\n \"desc\": \"3 分钟讲透 RAG…\",\r\n \"author_nickname\": \"某某说AI\",\r\n \"author_sec_uid\": \"MS4wLjABAAAA…\",\r\n \"author_url\": \"https://www.douyin.com/user/MS4wLjABAAAA…\",\r\n \"digg_count\": 123456,\r\n \"comment_count\": 8901,\r\n \"share_count\": 1200,\r\n \"collect_count\": 3400,\r\n \"url\": \"https://www.douyin.com/video/7xxxxxxxxxxxxxxxxxx\",\r\n \"create_time_str\": \"2026/9/4 20:13:20\",\r\n \"tags\": [\"#AI\", \"#教程\"]\r\n }\r\n ]\r\n}\r\n```\r\n\r\n---\r\n\r\n## 📌 适用场景（我该不该用？）\r\n\r\n- 需要短视频选题 → 关键词搜索 + 点赞排序\r\n- 需要研究对标账号 → 按主页链接抓取其公开作品（**一次抓一个账号**，多个账号逐条执行即可）\r\n- 需要分析内容舆情 → 获取视频/图文评论\r\n- 需要快速追热点 → 实时获取抖音热榜\r\n- 需要做营销报告 → 输出结构化 JSON，自动落盘留存\r\n\r\n## 🔍 和其他方式比，凭什么用它？\r\n\r\n| 对比项 | 本技能 | 手动刷抖音 | 自己写爬虫 |\r\n| -------------- | -------------------------- | --------------------- | ---------------------------- |\r\n| 上手成本 | 一条命令，5 分钟接入 | 0，但整理数据极费时间 | 需要逆向/维护，门槛高 |\r\n| 登录与封号风险 | **无需登录，只读公开数据** | 无 | 高（需带登录态，易触发风控） |\r\n| 数据结构 | 标准 JSON，字段齐全 | 手抄 | 自己定义 |\r\n| 维护成本 | 平台负责更新 | 无 | 接口一变就失效 |\r\n| 配合 AI 分析 | 天然适配（stdout 纯 JSON） | 不适配 | 需额外处理 |\r\n\r\n## 🔧 参数详解表\r\n\r\n> 详细选项参数说明， 可参阅 [完整选项说明](references/options.md)\r\n>\r\n> LLM理解技能的详细选项，可参阅技能 `assets` 目录中文件，其遵循 JSON Schema draft-07 版本规范。\r\n>\r\n> - 抖音关键词搜索，[入参规范](assets/search_cli_req.schema.json)\r\n> - 抖音关键词搜索，[出参规范](assets/search_cli_resp.schema.json)\r\n> - 抖音博主作品获取，[入参规范](assets/post_cli_req.schema.json)\r\n> - 抖音博主作品获取，[出参规范](assets/post_cli_resp.schema.json)\r\n> - 抖音评论获取，[入参规范](assets/comment_cli_req.schema.json)\r\n> - 抖音评论获取，[出参规范](assets/comment_cli_resp.schema.json)\r\n> - 抖音热榜获取，[出参规范](assets/hot_cli_resp.schema.json)\r\n\r\n## ⚠️ 重要限制（不踩坑）\r\n\r\n- 仅抓取抖音**公开**数据，不支持私密/隐藏内容\r\n- 需要配置 `GUAIKEI_API_TOKEN` 才能运行；调用会把关键词/链接发送至第三方 API（www.guaikei.com）\r\n- 数据仅限个人/团队内部使用，禁止违规分发\r\n- 单次调用通常 10-60 秒出结果（任务创建 + 轮询），limit 越大越慢\r\n\r\n## ❓ 常见问题（秒解决）\r\n\r\n> **Q：运行报错，提示无权限 / 退出码 3？**\r\n>\r\n> A：TOKEN 未配置或无效。配置环境变量：\r\n>\r\n> - Windows: `set GUAIKEI_API_TOKEN=你的TOKEN`\r\n> - Linux/MacOS: `export GUAIKEI_API_TOKEN=你的TOKEN`\r\n> - 请注意 TOKEN 保密，避免泄露给他人\r\n\r\n> **Q：搜索结果为空？**\r\n>\r\n> A：换常用关键词，或把 `--time` 改为 0（全部时间）。空结果退出码为 0，属正常情况。\r\n\r\n> **Q：输出文件在哪里？**\r\n>\r\n> A：搜索/作品/评论任务的结果会自动保存在技能目录的 `logs` 文件夹下：\r\n>\r\n> - 搜索任务：`时间戳_关键词_排序_时间_时长_类型_search.json`\r\n> - 博主作品：`时间戳_(博主sec_uid)_post.json`\r\n> - 评论获取：`时间戳_(视频aweme_id)_comment.json`\r\n> - （热榜为实时直读，不落盘）\r\n\r\n> **Q：支持哪些链接形式？**\r\n>\r\n> A：PC 链接（`douyin.com/user/xxx`、`douyin.com/video/xxx`、`douyin.com/note/xxx`）、App 短链（`v.douyin.com/xxx`）、`iesdouyin.com` 分享链接、sec_uid、aweme_id。链接里的 `?from_tab_name=` 等参数会自动剥离，直接粘贴整段分享文案也可以。\r\n\r\n> **Q：单次最多多少条？调用失败扣不扣量？**\r\n>\r\n> A：搜索/作品/评论单次上限 10000 条；具体计费口径以官网说明为准。\r\n\r\n> **Q：支持 Windows/Mac/Linux 吗？**\r\n>\r\n> A：全平台支持，仅需安装 Node.js（16.14.0+）。\r\n\r\n> **Q：支持批量抓多个账号吗？**\r\n>\r\n> A：当前版本一次抓取一个账号，多个账号请逐条执行。\r\n\r\n## 📞 帮助与支持\r\n\r\n- 🌐 **自助开通 TOKEN / 查阅使用帮助**：[抖音关键词搜索技能官网](https://www.guaikei.com)（推荐，最快）\r\n- 💬 联系微信 `13395823479`（备注\"抖音技能\"）开通 TOKEN 或获得使用支持\r\n\r\n> 🆕 [更新日志](references/changelog.md) | 参数详情见 [references/options.md](references/options.md)\r\n\r\n## 🛑 错误处理与重试策略（AI 使用者必读）\r\n\r\n### 遇到以下错误，立即停止操作并向用户报告\r\n\r\n- **权限错误**（退出码 3，`AUTH_REQUIRED`/`AUTH_ERROR`）：TOKEN 未配置、无效或过期，提示用户重新配置，**不要重试**\r\n- **API 次数超限**：提示用户联系客服开通更高额度\r\n- **网络错误连续 3 次失败**：提示用户检查网络连接\r\n\r\n### 禁止行为\r\n\r\n- ❌ 不要在收到权限错误后继续重试\r\n- ❌ 不要在 API 返回明确错误码后擅自修改参数重试\r\n- ❌ 不要在用户未明确要求的情况下自动调整搜索条件\r\n- ❌ 不要编造数据，不要把空结果当成功\r\n\r\n### 正确做法\r\n\r\n- ✅ 遇到错误，向用户展示错误信息（`error_code` + `message`）\r\n- ✅ 询问用户是否需要调整参数或重新尝试\r\n- ✅ 网络超时可重试，最多 3 次后停止\n\nFile v1.3.0:_meta.json\n\n{\n \"ownerId\": \"kn79p9y6xrdxyr0maxy3tj5nb9835e0e\",\n \"slug\": \"douyin-search-keyword\",\n \"version\": \"1.3.0\",\n \"publishedAt\": 1789293094602\n}\n\nFile v1.3.0:references/changelog.md\n\n# 抖音关键词搜索 (Douyin Search & Analytics) 更新日志\r\n\r\n## 1.3.0 - 2026-09-13\r\n\r\n- 增加获取抖音博主互动数据的功能。\r\n- 优化SKILL返回方式\r\n\r\n## 1.2.2 - 2026-08-17\r\n\r\n- bug紧急修复。\r\n\r\n## 1.2.1 - 2026-08-16\r\n\r\n- 技能细节打磨，优化AI对技能的识别及解析能力。\r\n- 增强参数与命名处理。\r\n- 技能描述、分类和标签进一步优化，适配更多抖音相关业务场景。\r\n- 示例命令更聚焦实际检索和分析场景，便于快速上手。\r\n- 增强环境变量说明与能力边界指引，提升使用与接入体验。\r\n\r\n## 1.2.0 - 2026-08-08\r\n\r\n- 搜索功能优化，支持类型搜索（视频、图文等）。\r\n- 各项功能细节优化。\r\n\r\n## 1.1.5 - 2026-06-18\r\n\r\n- 新增抖音视频评论获取功能，支持抓取并分析指定作品的评论内容。\r\n- 更新 schema，新增评论入参与出参 JSON Schema 规范，完善数据结构。\r\n- SKILL.md 说明文档同步更新，增加评论分析与用法示例。\r\n\r\n## 1.1.4 - 2026-06-09\r\n\r\n- 新增多份 JSON 模式文件，用于命令行结构化输入输出校验。\r\n- 在 references/ 目录下添加文档：更新日志（changelog.md）、配置说明（options.md）。\r\n- 优化 SKILL.md：补充模式文件引用，并完善令牌获取相关说明。\r\n- 为技能元数据补充模式定义，提升兼容性与自检能力。\r\n\r\n## 1.1.3 - 2026-05-11\r\n\r\n**新增：支持获取抖音作者（抖人）已发布作品，实现竞品账号内容批量抓取。**\r\n\r\n- 新增 post-cli 指令，可根据抖音主页 URL 或 sec_uid 一键获取创作者所有公开作品，便于竞品监控和账号内容分析。\r\n- 参数说明、使用范例及常见问题等文档内容同步更新，更清晰指引新功能使用方式。\r\n- 指令参数支持短缩写，limit上限提升至200，提升批量数据抓取能力。\r\n- 关键词搜索、热榜等原有功能保持兼容并优化参数配置，提升整体易用性。\r\n- 调整并精简 Skill 文档，增加使用案例，强调 TOKEN 申请与日志留存说明。\r\n- 示例与文档同步完善，能力标签更明确。\r\n\r\n## 1.1.2 - 2026-05-04\r\n\r\n- 新增支持抖音热搜榜单查询（hot-cli.js），可独立调用。\r\n- 关键词搜索与热榜查询分别独立为入口（search-cli.js/hot-cli.js）。\r\n- 项目结构优化，API与工具模块化拆分，便于维护与扩展。\r\n- 移除旧 scripts/lib 目录，迁移为 src/api、src/utils、src/validate 目录。\r\n- 更新文档与示例，增强上手指引与使用场景说明。\r\n\r\n## 1.1.1 - 2026-03-31\r\n\r\n- 更新 JSON 响应中的输出字段，明确标记更多字段，提高下游解析的一致性。\r\n- 无功能或界面变更;文档现在准确反映了输出模式中始终存在的字段。\r\n\r\n## 1.1.0 - 2026-03-31\r\n\r\n**重大升级：结构化输出、多参数排序与筛选能力增强**\r\n\r\n- 增加多维度排序（综合/最多点赞/最新发布）和发布时间筛选（1天/7天/半年），结果更精准。\r\n- 支持自定义返回数量（1~60条）。\r\n- 完全结构化 JSON 输出，字段覆盖互动数据、标签等，适配 OpenClaw 生态。\r\n- 内置参数合法性校验、敏感词过滤及安全保护，保证调用稳定合规。\r\n- 增强任务轮询&超时重试机制，提升检索成功率和稳定性。\r\n- 技能文档全面更新，提供详细参数表、示例与应用场景说明。\r\n\r\n## 1.0.2 - 2026-03-24\r\n\r\n- 技能重命名为“douyin-search-keyword”。\r\n- 在SKILL.md中添加了openclaw元数据、使用帮助、许可证、标签和示例，以实现更好的集成与文档化。\r\n- 移除了两个本地文件（.env 和 scripts/last-search.json），以优化代码结构并提升安全性。\r\n- 文档现已更加简洁且以用户为中心，重点在于提供清晰的使用说明和数据字段解释。\r\n- 突出技能特性、合规要点及技术流程。\r\n\r\n## 1.0.1 - 2026-3-20\r\n\r\n- 更新技能描述，强调支持多维度抖音公开内容检索（视频、图文、用户等）\r\n- 扩展文档，新增适用/不适用场景说明\r\n- 新增环境和token配置的详细步骤与平台限制说明\r\n- 明确数据字段及样例，补充表格形式字段解释\r\n- 强调合规、风控及临时链接有效期注意事项\r\n\r\n## 1.0.0 - 2026-03-18\r\n\r\n- douyin-search-general 技能首次发布。\r\n- 提供抖音通用搜索接口，支持视频、图文、用户及社交数据搜索。\r\n- 返回详细信息，包括内容描述、作者、发布时间、点赞数、评论数、分享数、封面图片及视频链接。\r\n- 需要Node.js和有效的GUAIKEI_API_TOKEN环境变量才能运行。\r\n- 输出包含可直接复制的URL，并附有示例响应格式说明。\n\nFile v1.3.0:references/options.md\n\n# 抖音关键词搜索 (Douyin Search & Analytics) 完整选项参数说明\r\n\r\n## 🔎 抖音关键词搜索\r\n\r\n| 参数 | 缩写 | 作用 | 可选值 | 必填 | 默认值 |\r\n| :----------- | :--: | :----------- | :----------------------------------------------------- | :--- | :----: |\r\n| `--keyword` | `-k` | 搜索关键词 | 2-50 位长度的字符或单词 | 是 | |\r\n| `--sort` | `-s` | 排序方式 | 0 = 综合排序 / 1 = 最多点赞 / 2 = 最新发布 | 否 | 0 |\r\n| `--time` | `-t` | 时间范围 | 0 = 全部 / 1 = 一天内 / 7 = 七天内 / 180 = 半年内 | 否 | 0 |\r\n| `--duration` | `-d` | 视频时长 | 0 = 不限 / 1 = 1分钟以下 / 2 = 1-5分钟 / 3 = 5分钟以上 | 否 | 0 |\r\n| `--content` | `-c` | 内容类型 | 0 = 不限 / 1 = 视频 / 2 = 图文 | 否 | 0 |\r\n| `--limit` | `-l` | 获取数量 | 1-10000 条 | 否 | 10 |\r\n| `--help` | `-h` | 显示帮助信息 | | 否 | |\r\n\r\n```bash\r\n# **基础语法**\r\nnode src/douyin/search-cli.js --keyword <关键词> --sort <排序方式> --time <时间范围> --duration <视频时长> --content <内容类型> --limit <获取数量>\r\n\r\n# **使用示例**\r\n\r\n# 搜索\"AI 教程\"的抖音内容\r\nnode src/douyin/search-cli.js --keyword \"AI 教程\"\r\n\r\n# 搜索 AI 获取最多点赞的抖音内容\r\nnode src/douyin/search-cli.js --keyword \"AI\" --sort 1\r\n\r\n# 搜索近7天\"AI 模型\"的抖音内容\r\nnode src/douyin/search-cli.js --keyword \"AI 模型\" --time 7\r\n\r\n# 搜索\"AI 教程\"视频时长在5分钟以上的抖音内容\r\nnode src/douyin/search-cli.js --keyword \"AI 教程\" --duration 3\r\n\r\n# 搜索半年内最新20条\"AI 教程\"的抖音内容\r\nnode src/douyin/search-cli.js --keyword \"AI 教程\" --sort 2 --time 180 --limit 20\r\n```\r\n\r\n## 🦸 抖音博主作品获取\r\n\r\n| 参数 | 缩写 | 作用 | 可选值 | 必填 | 默认值 |\r\n| :-------- | :--: | :----------------------- | :--------- | :--- | :----: |\r\n| `--url` | `-u` | 抖音博主主页URL或sec_uid | | 是 | |\r\n| `--limit` | `-l` | 获取作品数量 | 0-10000 条 | 否 | 10 |\r\n| `--help` | `-h` | 显示帮助信息 | | 否 | |\r\n\r\n> **💡\"抖音博主主页URL\"说明**\r\n>\r\n> - PC端 ( 格式： )\r\n> - 移动端 ( 格式： )\r\n> - 技能关键词搜索返回的author_sec_uid字段\r\n\r\n```bash\r\n# **基础语法**\r\nnode src/douyin/post-cli.js --url \"https://www.douyin.com/user/MS4wLjABxxx\"\r\n\r\n# **使用示例**\r\n\r\n# 获取抖音博主 MS4wLjABxxx 已发布的20条作品\r\nnode src/douyin/post-cli.js --url \"https://www.douyin.com/user/MS4wLjABxxx\" --limit 20\r\n\r\n# 获取抖音博主 MS4wLjABxxx 的互动数据（关注数、粉丝数、总获赞数）等信息。\r\nnode src/douyin/post-cli.js -u \"https://www.douyin.com/user/MS4wLjABxxx\" -l 0\r\n```\r\n\r\n## 💬 抖音作品评论数据\r\n\r\n| 参数 | 缩写 | 作用 | 可选值 | 必填 | 默认值 |\r\n| :-------- | :--: | :---------------------------- | :--------- | :--- | :----: |\r\n| `--url` | `-u` | 抖音视频(或图文)URL或aweme_id | | 是 | |\r\n| `--limit` | `-l` | 获取评论数量 | 1-10000 条 | 否 | 10 |\r\n| `--help` | `-h` | 显示帮助信息 | | 否 | |\r\n\r\n```bash\r\n# **基础语法**\r\nnode src/douyin/comment-cli.js --url \"https://www.douyin.com/video/xxx\"\r\n\r\n# **使用示例**\r\n\r\n# 获取视频 xxx 的100条评论\r\nnode src/douyin/comment-cli.js --url \"https://www.douyin.com/video/xxx\" --limit 100\r\n```\r\n\r\n## 📡 抖音热搜榜单\r\n\r\n- 无需参数\r\n\r\n```bash\r\n# **基础语法**\r\nnode src/douyin/hot-cli.js\r\n```\n\nFile v1.3.0:skill-card.md\n\n## Description:\n\nA read-only Douyin public-data toolbox for keyword search, creator post retrieval, video or image-post comment collection, and real-time hot-list tracking, returning structured JSON for content research, competitor analysis, sentiment monitoring, and trend tracking.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[um-why](https://clawhub.ai/user/um-why)\n\n### License/Terms of Use:\n\nMIT\n\n## Use Case:\n\nExternal users, analysts, marketers, and developers use this skill to retrieve public Douyin search results, creator posts, comments, and hot-list data for topic research, competitor monitoring, public-opinion analysis, trend tracking, and report generation.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Keywords, Douyin links, target accounts, and collected comments may be sensitive and are sent to www.guaikei.com for processing.\n\nMitigation: Review the query and authorization context before execution, configure GUAIKEI_API_TOKEN only in trusted environments, and avoid sending confidential campaign or account data.\n\nRisk: Search, post, and comment results are automatically saved to a local logs directory, which can retain large public-data datasets.\n\nMitigation: Run the skill in an appropriate workspace and delete or protect logs when retention, backup, or shared-machine exposure is not acceptable.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/um-why/skills/douyin-search-keyword)\n- [抖音关键词搜索技能官网](https://www.guaikei.com)\n- [完整选项参数说明](references/options.md)\n- [更新日志](references/changelog.md)\n\n## Skill Output:\n\n**Output Type(s):** [JSON, Shell commands, Guidance]\n\n**Output Format:** [Structured JSON envelopes from Node.js CLI commands, usually summarized in Markdown for the user]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires Node.js 16.14.0+ and GUAIKEI_API_TOKEN; search, post, and comment results may be saved locally under logs.]\n\n## Skill Version(s):\n\n1.3.0 (source: SKILL.md metadata, package.json, changelog, ClawHub 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\nFile v1.3.0:assets/comment_cli_req.schema.json\n\n{\r\n \"$schema\": \"http://json-schema.org/draft-07/schema#\",\r\n \"type\": \"object\",\r\n \"title\": \"抖音评论获取 - 命令行入参\",\r\n \"description\": \"抖音获取作品评论, 命令行参数入参Schema详解\",\r\n \"required\": [\r\n \"url\"\r\n ],\r\n \"properties\": {\r\n \"url\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音作品URL 或 作品aweme_id\"\r\n },\r\n \"limit\": {\r\n \"type\": \"number\",\r\n \"description\": \"获取评论数量\",\r\n \"minimum\": 1,\r\n \"maximum\": 10000,\r\n \"default\": 10\r\n }\r\n },\r\n \"additionalProperties\": false\r\n}\n\nFile v1.3.0:assets/comment_cli_resp.schema.json\n\n{\r\n \"$schema\": \"http://json-schema.org/draft-07/schema#\",\r\n \"type\": \"object\",\r\n \"title\": \"抖音评论获取 - API出参\",\r\n \"description\": \"抖音获取作品评论, API出参Schema详解\",\r\n \"properties\": {\r\n \"cid\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音评论ID\"\r\n },\r\n \"text\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音评论内容\"\r\n },\r\n \"create_time\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音评论发布时间戳\"\r\n },\r\n \"digg_count\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音评论点赞数\"\r\n },\r\n \"user_uid\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音评论者用户ID\"\r\n },\r\n \"user_nickname\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音评论者昵称\"\r\n },\r\n \"user_sec_uid\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音评论者SEC_UID\"\r\n },\r\n \"reply_comment_total\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音评论回复数\"\r\n },\r\n \"ip_label\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音评论者IP区域\"\r\n }\r\n }\r\n}\n\nFile v1.3.0:assets/hot_cli_resp.schema.json\n\n{\r\n \"$schema\": \"http://json-schema.org/draft-07/schema#\",\r\n \"type\": \"object\",\r\n \"title\": \"抖音热榜 - API出参\",\r\n \"description\": \"抖音实时热榜, API出参Schema详解\",\r\n \"required\": [\r\n \"word\",\r\n \"event_time\",\r\n \"hot_value\",\r\n \"position\",\r\n \"view_count\"\r\n ],\r\n \"properties\": {\r\n \"id\": {\r\n \"type\": \"number\",\r\n \"description\": \"自增ID\"\r\n },\r\n \"word\": {\r\n \"type\": \"string\",\r\n \"description\": \"热榜关键词\"\r\n },\r\n \"event_time\": {\r\n \"type\": \"number\",\r\n \"description\": \"事件发生时间\"\r\n },\r\n \"hot_value\": {\r\n \"type\": \"number\",\r\n \"description\": \"热榜值\"\r\n },\r\n \"position\": {\r\n \"type\": \"number\",\r\n \"description\": \"热榜排名\"\r\n },\r\n \"view_count\": {\r\n \"type\": \"number\",\r\n \"description\": \"关键词的搜索量\"\r\n },\r\n \"event_time_format\": {\r\n \"type\": \"string\",\r\n \"description\": \"事件发生时间格式化字符串\"\r\n }\r\n }\r\n}\n\nFile v1.3.0:assets/post_cli_req.schema.json\n\n{\r\n \"$schema\": \"http://json-schema.org/draft-07/schema#\",\r\n \"type\": \"object\",\r\n \"title\": \"抖音博主作品获取 - 命令行入参\",\r\n \"description\": \"抖音实时获取博主作品, 命令行参数入参Schema详解\",\r\n \"required\": [\r\n \"url\"\r\n ],\r\n \"properties\": {\r\n \"url\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音博主主页URL 或 抖音博主SEC_UID\"\r\n },\r\n \"limit\": {\r\n \"type\": \"number\",\r\n \"description\": \"获取作品数量\",\r\n \"minimum\": 0,\r\n \"maximum\": 10000,\r\n \"default\": 10\r\n }\r\n },\r\n \"additionalProperties\": false\r\n}\n\nFile v1.3.0:assets/post_cli_resp.schema.json\n\n{\r\n \"$schema\": \"http://json-schema.org/draft-07/schema#\",\r\n \"type\": \"object\",\r\n \"title\": \"抖音博主作品获取 - API出参\",\r\n \"description\": \"抖音实时获取博主作品, API出参Schema详解\",\r\n \"properties\": {\r\n \"aweme_id\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频ID\"\r\n },\r\n \"desc\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频描述\"\r\n },\r\n \"caption\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频标题\"\r\n },\r\n \"create_time\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音视频创建时间戳\"\r\n },\r\n \"music_title\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频音乐标题\"\r\n },\r\n \"music_author\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频音乐作者\"\r\n },\r\n \"music_duration\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音视频音乐时长\"\r\n },\r\n \"music_play_url\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频音乐播放URL\"\r\n },\r\n \"video_url\": {\r\n \"type\": \"array\",\r\n \"description\": \"视频播放地址、视频下载地址\",\r\n \"items\": {\r\n \"type\": \"string\",\r\n \"description\": \"视频播放地址、视频下载地址\"\r\n }\r\n },\r\n \"video_cover\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频封面URL\"\r\n },\r\n \"video_duration\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音视频时长\"\r\n },\r\n \"recommend_count\": {\r\n \"type\": \"number\",\r\n \"description\": \"交互界面未显示字段\"\r\n },\r\n \"comment_count\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音视频评论数\"\r\n },\r\n \"digg_count\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音视频点赞数\"\r\n },\r\n \"share_count\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音视频分享数\"\r\n },\r\n \"collect_count\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音视频收藏数\"\r\n },\r\n \"tags\": {\r\n \"type\": \"array\",\r\n \"description\": \"抖音视频标签\",\r\n \"items\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频标签\"\r\n }\r\n },\r\n \"share_url\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频分享URL\"\r\n },\r\n \"suggest_words\": {\r\n \"type\": \"array\",\r\n \"description\": \"抖音视频小蓝词\",\r\n \"items\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频小蓝词\"\r\n }\r\n }\r\n }\r\n}\n\nFile v1.3.0:assets/search_cli_req.schema.json\n\n{\r\n \"$schema\": \"http://json-schema.org/draft-07/schema#\",\r\n \"type\": \"object\",\r\n \"title\": \"抖音关键词搜索 - 命令行入参\",\r\n \"description\": \"抖音实时关键词搜索, 命令行参数入参Schema详解\",\r\n \"required\": [\r\n \"keyword\"\r\n ],\r\n \"properties\": {\r\n \"keyword\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音关键词搜索的关键词\",\r\n \"minLength\": 2,\r\n \"maxLength\": 50\r\n },\r\n \"sort\": {\r\n \"type\": \"number\",\r\n \"description\": \"排序方式: 0=综合排序 , 1=最多点赞 , 2=最新发布\",\r\n \"default\": 0,\r\n \"enum\": [\r\n 0,\r\n 1,\r\n 2\r\n ]\r\n },\r\n \"time\": {\r\n \"type\": \"number\",\r\n \"description\": \"时间范围: 0=全部 , 1=一天内 , 7=七天内 , 180=半年内\",\r\n \"default\": 0,\r\n \"enum\": [\r\n 0,\r\n 1,\r\n 7,\r\n 180\r\n ]\r\n },\r\n \"duration\": {\r\n \"type\": \"number\",\r\n \"description\": \"视频时长: 0=不限 , 1=1分钟以下 , 2=1-5分钟 , 3=5分钟以上\",\r\n \"default\": 0,\r\n \"enum\": [\r\n 0,\r\n 1,\r\n 2,\r\n 3\r\n ]\r\n },\r\n \"content\": {\r\n \"type\": \"number\",\r\n \"description\": \"内容类型, 0: 不限, 1: 视频, 2: 图文\",\r\n \"default\": 0,\r\n \"enum\": [\r\n 0,\r\n 1,\r\n 2\r\n ]\r\n },\r\n \"limit\": {\r\n \"type\": \"number\",\r\n \"description\": \"获取数量\",\r\n \"minimum\": 1,\r\n \"maximum\": 10000,\r\n \"default\": 10\r\n }\r\n },\r\n \"additionalProperties\": false\r\n}\n\nArchive v1.2.2: 35 files, 41631 bytes\n\nFiles: assets/comment_cli_req.schema.json (652b), assets/comment_cli_resp.schema.json (1311b), assets/hot_cli_resp.schema.json (1154b), assets/post_cli_req.schema.json (675b), assets/post_cli_resp.schema.json (2715b), assets/search_cli_req.schema.json (1884b), assets/search_cli_resp.schema.json (3435b), package.json (862b), readme.md (10801b), references/changelog.md (4651b), references/options.md (3866b), skill-card.md (2572b), SKILL.md (9664b), src/api/comment.js (2020b), src/api/hot.js (919b), src/api/post.js (1636b), src/api/search.js (3200b), src/config/constants.js (464b), src/douyin/comment-cli.js (4807b), src/douyin/hot-cli.js (2600b), src/douyin/post-cli.js (4734b), src/douyin/search-cli.js (7482b), src/utils/args.js (3970b), src/utils/errors.js (939b), src/utils/log.js (1131b), src/utils/name.js (319b), src/utils/request.js (5049b), src/utils/retry.js (1149b), src/utils/token.js (1288b), src/utils/utils.js (1708b), src/validate/comment.js (905b), src/validate/hot.js (703b), src/validate/keyword.js (4223b), src/validate/post.js (943b), _meta.json (140b)\n\nFile v1.2.2:SKILL.md\n\n---\r\nname: douyin-search-keyword\r\ndescription: 抖音公开数据智能获取工具。支持抖音关键词搜索、抖音博主作品抓取、抖音视频评论分析、抖音实时热榜查询。当用户需要搜抖音视频、查抖音热榜、看抖音评论、抓博主作品、做抖音竞品分析、短视频选题调研、舆情监控、热点追踪、爆款挖掘、抖音运营数据分析时使用。触发词：抖音搜索、抖音热榜、抖音评论、抖音作品、抖音竞品分析、抖音数据分析、短视频运营、抖音舆情监控、抖音热点。\r\nlicense: MIT\r\nmetadata:\r\n enabled: true\r\n type: command\r\n runtime: \"nodejs@16.14.0+\"\r\n version: 1.2.2\r\n requires:\r\n bins:\r\n - \"node\"\r\n env:\r\n - \"GUAIKEI_API_TOKEN\"\r\n env_desc:\r\n GUAIKEI_API_TOKEN: \"抖音数据 API 访问令牌。未配置时无法调用接口；可通过 https://www.guaikei.com 开通，或联系开发者(wx 13395823479)获取支持。\"\r\n category:\r\n - \"Data&APIs\"\r\n - \"内容创作\"\r\n - \"数据分析\"\r\n - \"商业运营\"\r\n - \"办公效率\"\r\n tags:\r\n - \"抖音\"\r\n - \"douyin\"\r\n - \"抖音搜索\"\r\n - \"抖音热榜\"\r\n - \"抖音评论\"\r\n - \"抖音作品\"\r\n - \"抖音竞品分析\"\r\n - \"抖音数据分析\"\r\n - \"短视频运营\"\r\n - \"短视频\"\r\n - \"舆情监控\"\r\n - \"热点追踪\"\r\n - \"爆款挖掘\"\r\n - \"竞品分析\"\r\n - \"营销分析\"\r\n - \"search\"\r\n - \"数据挖掘\"\r\n - \"content-analysis\"\r\n - \"competitor-analysis\"\r\n - \"marketing\"\r\n - \"trend-tracking\"\r\n schemas:\r\n - name: \"搜索入参\"\r\n file: \"assets/search_cli_req.schema.json\"\r\n - name: \"搜索出参\"\r\n file: \"assets/search_cli_resp.schema.json\"\r\n - name: \"作品入参\"\r\n file: \"assets/post_cli_req.schema.json\"\r\n - name: \"作品出参\"\r\n file: \"assets/post_cli_resp.schema.json\"\r\n - name: \"热榜出参\"\r\n file: \"assets/hot_cli_resp.schema.json\"\r\n - name: \"评论入参\"\r\n file: \"assets/comment_cli_req.schema.json\"\r\n - name: \"评论出参\"\r\n file: \"assets/comment_cli_resp.schema.json\"\r\n examples:\r\n - \"搜抖音里'AI 教程'最火的视频: node src/douyin/search-cli.js --keyword 'AI 教程' --sort 1\"\r\n - \"看最近一周抖音上'AI 模型'最新的 20 条内容: node src/douyin/search-cli.js --keyword 'AI 模型' --sort 2 --time 7 --limit 20\"\r\n - \"查抖音今天有什么热点/热搜榜: node src/douyin/hot-cli.js\"\r\n - \"抓这个抖音博主最近 30 条作品: node src/douyin/post-cli.js --url 'https://www.douyin.com/user/MS4wLjABxxx' --limit 30\"\r\n - \"看这条抖音视频的 40 条评论: node src/douyin/comment-cli.js --url 'https://www.douyin.com/video/xxx' --limit 40\"\r\n---\r\n\r\n# 🚀 抖音关键词搜索、竞品分析、舆情监控与热榜跟踪工具 (Douyin Search & Analytics)\r\n\r\n## 1. 🛠️ 技能概述\r\n\r\n抖音公开数据获取与智能分析工具。支持**关键词搜索排序**、**博主作品抓取**、**视频评论分析**、**实时热榜获取**，适用于短视频选题、竞品监控、舆情分析、热点追踪，助力爆款内容策划与流量运营。\r\n\r\n> **🔥核心优势**\r\n>\r\n> - **安全**：无需登录抖音账号，无风控 / 封号风险\r\n> - **强大**：单次最多可获取 1W 条数据，内置批量与多维筛选\r\n> - **全面**：出参覆盖作者、互动、标签、链接等可用数据及有价值数据都会返回\r\n> - **轻量**：无需部署服务，Node.js 一键运行，仅依赖内置模块\r\n> - **友好**：stdout 纯 JSON、日志走 stderr，便于 AI 稳定解析与二次分析\r\n\r\n## 2. ✅ 何时调用与能力边界\r\n\r\n### 🎯 在以下场景优先调用：\r\n\r\n- 用户明确要查 **抖音** 的公开内容（视频 / 图文 / 作者 / 评论 / 热榜）。\r\n- 用户要做 **关键词搜索**、**爆款选题调研**、**竞品监控**、**评论洞察**、**博主作品追踪**、**热点追流**。\r\n- 用户提供了抖音关键词、视频链接、博主主页链接，希望拿到结构化数据。\r\n- 用户后续还要基于结果做总结、对比、筛选、报告生成。\r\n\r\n### 🚫 不应调用\r\n\r\n- 用户只想要文案/标题/脚本，未要求查抖音数据。\r\n- 平台不是抖音（小红书、B站、微博、公众号）→ 路由到对应技能。\r\n- 要求私密/登录态/隐藏数据。\r\n- 既无关键词也无可识别抖音链接且目标不明 → 先追问。\r\n\r\n> 意图不明确时先追问，不要盲目执行命令。\r\n\r\n### 🛑 本技能不需要、不负责：\r\n\r\n登录账号、发布/点赞/评论/关注等写操作、获取非公开数据、替用户做营销策略判断。职责是**先把数据拿回来**，再交上层分析。\r\n\r\n## 3. 🔀 调用路由\r\n\r\n> **Note:** 请先通过 [抖音数据获取技能官网](https://www.guaikei.com) 开通并配置环境变量 `GUAIKEI_API_TOKEN` 后，再按意图路由：\r\n\r\n| 意图 | 脚本 | 必填 | 典型结果 |\r\n| ---------------- | --------------------------- | -------------------- | ------------------------------- |\r\n| 搜关键词内容 | `src/douyin/search-cli.js` | `keyword` | 视频/图文列表、作者、互动、链接 |\r\n| 看热搜/热点/榜单 | `src/douyin/hot-cli.js` | 无 | 热榜词条、热度、搜索量 |\r\n| 看博主最近作品 | `src/douyin/post-cli.js` | 主页 URL 或 sec_uid | 博主公开作品列表 |\r\n| 看视频/图文评论 | `src/douyin/comment-cli.js` | 视频 URL 或 aweme_id | 评论内容、评论者、互动 |\r\n\r\n### 🧭 消歧义（重要）\r\n\r\n- 单独出现\"视频\"二字时，不要默认归 `post`。\r\n- 有\"关键词\"且无\"评论\" → `search`（用户想搜某个视频）。\r\n- \"这个视频的评论/留言\" → `comment`。\r\n- 仅当\"作品/主页/账号/博主\"出现时才用 `post`。\r\n\r\n## 4. 🧺 输入收集规则\r\n\r\n执行前先收集足够输入，避免无效调用。\r\n\r\n### 4.1 🔍 关键词搜索（search-cli）\r\n\r\n至少要确认：`keyword`（2-50 字符）。可选：\r\n\r\n- `sort`：0 综合 / 1 最多点赞 / 2 最新发布\r\n- `time`：0 全部 / 1 一天内 / 7 七天内 / 180 半年内\r\n- `duration`：0 不限 / 1 1分钟内 / 2 1-5分钟 / 3 5分钟以上\r\n- `content`：0 不限 / 1 视频 / 2 图文\r\n- `limit`：1-10000，默认 10\r\n\r\n### 4.2 📡 博主作品（post-cli）\r\n\r\n至少要确认：`url`（主页 URL 或 sec_uid）。可选：`limit`（1-10000，默认 10）。\r\n适用链接：`https://www.douyin.com/user/MS4wLjABxxx`、`https://v.douyin.com/xxx`、或直接使用 `sec_uid`。\r\n\r\n### 4.3 💬 评论分析（comment-cli）\r\n\r\n至少要确认：`url`（视频 / 图文 URL 或 aweme_id）。可选：`limit`（1-10000，默认 10）。\r\n适用链接：`https://www.douyin.com/video/xxx`、`https://www.douyin.com/note/xxx`、或直接使用 `aweme_id`。\r\n\r\n## 5. 📜 执行与输出约定\r\n\r\n- 在技能根目录执行；只输出纯 JSON 到 stdout，日志/banner 走 stderr。\r\n- 没有关键词：先追问关键词。\r\n- 没有链接：先追问视频 / 主页链接或 ID。\r\n- 链接类型不明确：先确认这是视频还是博主主页。\r\n- 没有 `GUAIKEI_API_TOKEN`：提醒用户先配置环境变量，再执行。\r\n- 退出码：`0`=成功（含 empty），`1`=运行错误（接口异常/网络/超时），`3`=auth_required（缺/错 token）。\r\n- 失败须向用户说明原因，**不编造数据，不把空结果当成功**。空结果退出码 0 属正常。\r\n- 完整选项见 可参阅 [完整选项说明](references/options.md) ；LLM理解技能的详细选项，可参阅技能 `assets` 目录中文件。\r\n- 执行完成后，优先返回：本次目标、关键参数、结构化 JSON 结果，必要时再补一小段摘要。\r\n- 适合衔接的后续动作：选题汇总、高赞对比、评论观点聚类、竞品内容风格总结、博主发文节奏分析、报告与表格生成。\r\n\r\n## 6. 💡 调用示例\r\n\r\n```bash\r\nnode src/douyin/search-cli.js --keyword \"AI 教程\" --sort 1\r\nnode src/douyin/search-cli.js --keyword \"AI模型\" --sort 2 --time 7 --limit 20\r\nnode src/douyin/hot-cli.js\r\nnode src/douyin/post-cli.js --url \"https://www.douyin.com/user/MS4wLjABxxx\" --limit 50\r\nnode src/douyin/comment-cli.js --url \"https://www.douyin.com/video/xxx\" --limit 100\r\n```\r\n\r\n- 🤖 自然语言触发示例：\"帮我搜抖音里'AI 教程'最火的视频\"\"抖音今天有什么热点\"\"分析这条抖音视频评论区的主要观点\"。\r\n- 🧠 若用户表达笼统（如\"帮我做抖音竞品分析\"），优先拆成两步：① 确认关键词 / 竞品链接 / 博主主页；② 再调用对应脚本拿回数据。\r\n\r\n## 7. 🎧 环境、合规与支持\r\n\r\n- 环境：Node.js 16.14.0+，兼容 Windows/Linux/macOS；必需 `GUAIKEI_API_TOKEN`；官网 。\r\n- 合规：仅处理抖音公开数据，不支持私密/隐藏/登录态数据；数据仅限个人/团队内部分析，禁止违规分发；依赖第三方 API（guaikei.com），使用前确认数据外发与授权范围。\r\n- 支持：官网 <[抖音数据获取技能官网](https://www.guaikei.com)>（自助开通 TOKEN）；微信 `13395823479`（备注：抖音技能）。\r\n\r\n## 8. ❓ 常见问题\r\n\r\n- 没结果：放宽关键词或减少限定（`--time 0`）、换更贴近的词。\r\n- 结果太多：补场景/人群/品牌/时间/账号。\r\n- 调用失败：先确认 `GUAIKEI_API_TOKEN` 已配置有效（退出码 3 即 token 问题）。\r\n- 账号安全：只读能力，不登录/发帖/点赞/评论。\n\nFile v1.2.2:readme.md\n\n# 🚀 抖音关键词搜索、竞品分析、舆情监控与热榜跟踪工具 (Douyin Search & Analytics)\r\n\r\n> **💡一句话价值**：一键抓取抖音公开视频/作者/评论/热榜数据，帮你做爆款选题、竞品分析、舆情监控、热点追踪。\r\n>\r\n> **🔥核心优势**\r\n>\r\n> - 安全: 无需登录你的抖音账号，不担心风控风险 / 封号问题\r\n> - 强大: 一次可获取最多1W条数据，技能内置批量操作，使用简单方便\r\n> - 全面: 各功能出参数据全面，可见及有价值数据都会返回\r\n> - 灵活: 支持多维度筛选、批量操作\r\n> - 轻量: 无需部署服务，Node.js 一键运行\r\n> - 低耗: 日志自动归档，适配营销报告 / 内容策划场景 ，便于数据二次分析\r\n\r\n## 1. ✅ 我能帮你解决什么（10 秒判断）\r\n\r\n- 🔍 按关键词搜抖音视频（点赞/最新排序）：找爆款选题、分析高赞视频规律\r\n- 🦸 竞品监控：批量抓取对标账号所有公开作品数据，分析内容策略\r\n- 💬 评论分析：获取抖音评论详情，分析舆情方向\r\n- 📡 热点追流：实时获取抖音热榜，抢占流量风口\r\n- 📊 数据导出：自动生成JSON日志，方便对比分析和使用\r\n\r\n## 2. 🚀 最快上手（复制就能跑，30 秒出结果）\r\n\r\n> **Note:** 请先通过微信 <13395823479> 申请TOKEN ，或访问[抖音搜索技能官网](https://www.guaikei.com)开通TOKEN，配置环境变量 `GUAIKEI_API_TOKEN` 后才能正常运行。\r\n\r\n### 2.1 🔎 抖音关键词搜索（最简单）\r\n\r\n```bash\r\nnode src/douyin/search-cli.js --keyword \"AI\"\r\n```\r\n\r\n### 2.2 🔎 按点赞排序找爆款（最常用）\r\n\r\n```bash\r\nnode src/douyin/search-cli.js --keyword \"AI\" --sort 1\r\n```\r\n\r\n### 2.3 🦸 抓取抖音博主全部作品\r\n\r\n```bash\r\nnode src/douyin/post-cli.js --url \"https://www.douyin.com/user/MS4wLjABxxx\"\r\n```\r\n\r\n### 2.4 💬 获取抖音作品评论内容\r\n\r\n```bash\r\nnode src/douyin/comment-cli.js --url \"https://www.douyin.com/video/xxx\"\r\n```\r\n\r\n### 2.5 📡 获取抖音实时热榜\r\n\r\n```bash\r\nnode src/douyin/hot-cli.js\r\n```\r\n\r\n## 3. 📌 适用场景（我该不该用？）\r\n\r\n- 你需要做短视频选题 → 关键词搜索 + 点赞排序\r\n- 你需要模仿爆款文案 → 查看高赞视频详情\r\n- 你需要监控竞品账号 → 批量抓取对方作品\r\n- 你需要分析内容舆情 → 获取抖音评论详情\r\n- 你需要快速追热点 → 实时获取抖音热榜\r\n- 你需要做营销报告 → 导出结构化数据\r\n\r\n## 4. 🔧 参数详解表\r\n\r\n> 详细选项参数说明， 可参阅 [完整选项说明](references/options.md)\r\n>\r\n> LLM理解技能的详细选项，可参阅技能 `assets` 目录中文件，其遵循 JSON Schema draft-07 版本规范。\r\n>\r\n> - 抖音关键词搜索，[入参规范](assets/search_cli_req.schema.json)\r\n> - 抖音关键词搜索，[出参规范](assets/search_cli_resp.schema.json)\r\n> - 抖音博主作品获取，[入参规范](assets/post_cli_req.schema.json)\r\n> - 抖音博主作品获取，[出参规范](assets/post_cli_resp.schema.json)\r\n> - 抖音评论获取，[入参规范](assets/comment_cli_req.schema.json)\r\n> - 抖音评论获取，[出参规范](assets/comment_cli_resp.schema.json)\r\n> - 抖音热榜获取，[出参规范](assets/hot_cli_resp.schema.json)\r\n\r\n## 5. ⚠️ 重要限制（不踩坑）\r\n\r\n- 仅抓取抖音公开数据，不支持私密 / 隐藏内容\r\n- 需要配置 GUAIKEI_API_TOKEN 才能正常运行\r\n- 数据仅限个人 / 团队内部使用，禁止违规分发\r\n\r\n## 6. ❓ 常见问题（秒解决）\r\n\r\n> **💡Q：运行报错，提示无权限？**\r\n>\r\n> A：配置环境变量：\r\n>\r\n> - Windows: `set GUAIKEI_API_TOKEN=你的TOKEN`\r\n> - Linux/MacOS: `export GUAIKEI_API_TOKEN=你的TOKEN`\r\n> - 私有TOKEN申请后请留意使用安全，避免泄露给他人\r\n>\r\n> **💡Q：搜索结果为空？**\r\n>\r\n> A：换常用关键词，或把 `--time` 改为 0（全部时间）\r\n>\r\n> **💡Q：输出文件在哪里？**\r\n>\r\n> A：自动保存在技能目录的 `logs` 文件夹下\r\n>\r\n> - 搜索任务日志: 默认保存为「时间戳\\_关键词\\_排序\\_时间\\_时长\\_类型\\_search.json」\r\n> - 抖音博主作品获取日志: 默认保存为「时间戳\\_(博主sec_uid)\\_post.json」\r\n> - 抖音评论获取日志: 默认保存为「时间戳\\_(视频aweme_id)\\_comment.json」\r\n>\r\n> **💡Q：支持 Windows/Mac/Linux 吗？**\r\n>\r\n> A：全平台支持，仅需安装 Node.js 环境\r\n\r\n## 7. 📞 帮助与支持\r\n\r\n- 联系微信 13395823479（备注抖音技能）开通TOKEN或获得技能使用支持；\r\n- 或通过 [抖音关键词搜索技能官网](https://www.guaikei.com) 自助开通TOKEN或查阅使用帮助。\r\n\r\n> 🆕 [更新日志](references/changelog.md) 可查阅这里\r\n\r\n## 8. 🛑 错误处理与重试策略（重要）\r\n\r\n### 8.1 遇到以下错误，立即停止操作并向用户报告\r\n\r\n- **权限错误**（AUTH_ERROR）：TOKEN 无效或已过期，请提示用户重新配置\r\n- **API 次数超限**：提示用户联系客服开通更高额度\r\n- **网络错误连续 3 次失败**：提示用户检查网络连接\r\n\r\n### 8.2 禁止行为\r\n\r\n- ❌ 不要在收到 AUTH_ERROR 后继续重试\r\n- ❌ 不要在 API 返回明确错误码后尝试修改参数重试\r\n- ❌ 不要在用户未明确要求的情况下自动调整搜索条件\r\n\r\n### 8.3 正确做法\r\n\r\n- ✅ 遇到错误，立即向用户展示错误信息\r\n- ✅ 询问用户是否需要调整参数或重新尝试\r\n- ✅ 对于网络超时，可以尝试最多 3 次之后停止\r\n\r\n## 9. 💬 自然语言指令映射（AI 快速参考）\r\n\r\n> **统一调用约定（重要）**\r\n>\r\n> - 必须在**技能根目录**执行。\r\n> - 只输出纯 JSON 到 stdout，日志与 banner 走 stderr，便于稳定解析。\r\n> - 退出码约定：`0`=成功（含 empty），`1`=运行错误，`3`=auth_required（缺/错 token）。\r\n\r\n### 9.1 搜索功能\r\n\r\n| 用户口语化指令 | 对应命令 | 参数推导 |\r\n| --------------------------------- | ---------------------------------------------------------------------------------- | ---------------------------- |\r\n| \"搜索 / 搜一下 / 找 AI 相关视频\" | `node src/douyin/search-cli.js --keyword \"AI\"` | 带关键词即搜索 |\r\n| \"找点赞最多的 / 最火的 AI 视频\" | `node src/douyin/search-cli.js --keyword \"AI\" --sort 1` | 最火/点赞最多 → sort=1 |\r\n| \"最新的 AI 教程，要 20 条\" | `node src/douyin/search-cli.js --keyword \"AI 教程\" --sort 2 --limit 20` | 最新 → sort=2；数量 → limit |\r\n| \"近一周最火的短视频\" | `node src/douyin/search-cli.js --keyword \"短视频\" --time 7 --sort 1` | 一周 → time=7；最火 → sort=1 |\r\n| \"半年内最新 20 条 AI 教程\" | `node src/douyin/search-cli.js --keyword \"AI 教程\" --sort 2 --time 180 --limit 20` | 半年 → time=180 |\r\n| \"减肥视频，只要 1 分钟以下的\" | `node src/douyin/search-cli.js --keyword \"减肥\" --duration 1` | 见下方 duration 表 |\r\n| \"AI 模型，5 分钟以上的，前 50 条\" | `node src/douyin/search-cli.js --keyword \"AI 模型\" --duration 3 --limit 50` | 5分钟以上 → duration=3 |\r\n\r\n### 9.2 竞品监控\r\n\r\n| 用户口语化指令 | 对应命令 | 参数推导 |\r\n| ------------------------------- | ----------------------------------------------------------------------------- | --------------------- |\r\n| \"查看这个博主的所有作品 / 主页\" | `node src/douyin/post-cli.js --url \"https://www.douyin.com/user/MS4wLjABxxx\"` | 作品/主页/账号 → post |\r\n| \"抓取 MS4wLjABxxx 的作品\" | `node src/douyin/post-cli.js --url \"MS4wLjABxxx\"` | sec_uid 直接可用 |\r\n| \"获取他最近 50 条视频\" | `node src/douyin/post-cli.js --url \"xxx\" --limit 50` | 数量 → limit |\r\n\r\n### 9.3 评论分析\r\n\r\n| 用户口语化指令 | 对应命令 | 参数推导 |\r\n| --------------------------- | ------------------------------------------------------------------------- | ------------------- |\r\n| \"看看这个视频的评论 / 留言\" | `node src/douyin/comment-cli.js --url \"https://www.douyin.com/video/xxx\"` | 评论/留言 → comment |\r\n| \"获取这条视频的 100 条评论\" | `node src/douyin/comment-cli.js --url \"xxx\" --limit 100` | 数量 → limit |\r\n\r\n### 9.4 热榜\r\n\r\n| 用户口语化指令 | 对应命令 |\r\n| ---------------------------------------- | ---------------------------- |\r\n| \"抖音今天有什么热点 / 热搜榜 / 热点榜单\" | `node src/douyin/hot-cli.js` |\r\n\r\n## 10. 🧠 AI 意图识别规则\r\n\r\n### 10.1 识别优先级（从上到下）\r\n\r\n1. **热搜 / 热点 / 榜单 / 今天什么火** → `hot-cli.js`\r\n2. **搜索 / 搜一下 / 找 + 关键词** → `search-cli.js`\r\n3. **评论 / 留言 / 弹幕** → `comment-cli.js`（必须出现\"评论\"类词才归此类）\r\n4. **作品 / 视频(指博主内容) / 主页 / 账号 / 博主** → `post-cli.js`\r\n\r\n> ⚠️ 歧义提示：单独出现\"视频\"二字时，**不要默认归到 post-cli**。\r\n>\r\n> - 若同时有\"关键词\"且无\"评论\" → 视为 `search`（用户想搜某个视频）。\r\n> - 若明确\"这个视频的评论/留言\" → `comment`。\r\n> - 仅当\"作品/主页/账号/博主\"出现时才用 `post`。\r\n\r\n### 10.2 参数推断规则\r\n\r\n**排序（sort，与 time 正交）**\r\n\r\n- 提到\"综合 / 默认\" → `sort=0`\r\n- 提到\"点赞最多 / 最火 / 爆款\" → `sort=1`\r\n- 提到\"最新 / 最近发布 / 刚发\" → `sort=2`\r\n\r\n**时间窗（time）**\r\n\r\n- 提到\"全部 / 不限制\" → `time=0`\r\n- 提到\"一天 / 24小时\" → `time=1`\r\n- 提到\"一周 / 7天\" → `time=7`\r\n- 提到\"半年\" → `time=180`\r\n\r\n**时长**\r\n\r\n- 提到\"1分钟以下 / 短于1分钟\" → `duration=1`\r\n- 提到\"1到5分钟 / 1-5分钟\" → `duration=2`\r\n- 提到\"5分钟以上\" → `duration=3`\r\n- 提到\"不限时长\" → `duration=0`\r\n\r\n**内容类型**\r\n\r\n- 提到\"不限 / 默认\" → `content=0`\r\n- 提到\"视频\" → `content=1`\r\n- 提到\"图文\" → `content=2`\r\n\r\n**数量（limit）**\r\n\r\n- 提到\"条数 / 数量 / N条 / 前N条\" → `limit=N`\r\n\r\n### 10.3 默认值\r\n\r\n- sort: 0（综合）｜time: 0（全部）｜duration: 0（不限）｜limit: 10\n\nFile v1.2.2:_meta.json\n\n{\n \"ownerId\": \"kn79p9y6xrdxyr0maxy3tj5nb9835e0e\",\n \"slug\": \"douyin-search-keyword\",\n \"version\": \"1.2.2\",\n \"publishedAt\": 1786974043230\n}\n\nFile v1.2.2:references/changelog.md\n\n# 抖音关键词搜索 (Douyin Search & Analytics) 更新日志\r\n\r\n## 1.2.2 - 2026-08-17\r\n\r\n- bug紧急修复。\r\n\r\n## 1.2.1 - 2026-08-16\r\n\r\n- 技能细节打磨，优化AI对技能的识别及解析能力。\r\n- 增强参数与命名处理。\r\n- 技能描述、分类和标签进一步优化，适配更多抖音相关业务场景。\r\n- 示例命令更聚焦实际检索和分析场景，便于快速上手。\r\n- 增强环境变量说明与能力边界指引，提升使用与接入体验。\r\n\r\n## 1.2.0 - 2026-08-08\r\n\r\n- 搜索功能优化，支持类型搜索（视频、图文等）。\r\n- 各项功能细节优化。\r\n\r\n## 1.1.5 - 2026-06-18\r\n\r\n- 新增抖音视频评论获取功能，支持抓取并分析指定作品的评论内容。\r\n- 更新 schema，新增评论入参与出参 JSON Schema 规范，完善数据结构。\r\n- SKILL.md 说明文档同步更新，增加评论分析与用法示例。\r\n\r\n## 1.1.4 - 2026-06-09\r\n\r\n- 新增多份 JSON 模式文件，用于命令行结构化输入输出校验。\r\n- 在 references/ 目录下添加文档：更新日志（changelog.md）、配置说明（options.md）。\r\n- 优化 SKILL.md：补充模式文件引用，并完善令牌获取相关说明。\r\n- 为技能元数据补充模式定义，提升兼容性与自检能力。\r\n\r\n## 1.1.3 - 2026-05-11\r\n\r\n**新增：支持获取抖音作者（抖人）已发布作品，实现竞品账号内容批量抓取。**\r\n\r\n- 新增 post-cli 指令，可根据抖音主页 URL 或 sec_uid 一键获取创作者所有公开作品，便于竞品监控和账号内容分析。\r\n- 参数说明、使用范例及常见问题等文档内容同步更新，更清晰指引新功能使用方式。\r\n- 指令参数支持短缩写，limit上限提升至200，提升批量数据抓取能力。\r\n- 关键词搜索、热榜等原有功能保持兼容并优化参数配置，提升整体易用性。\r\n- 调整并精简 Skill 文档，增加使用案例，强调 TOKEN 申请与日志留存说明。\r\n- 示例与文档同步完善，能力标签更明确。\r\n\r\n## 1.1.2 - 2026-05-04\r\n\r\n- 新增支持抖音热搜榜单查询（hot-cli.js），可独立调用。\r\n- 关键词搜索与热榜查询分别独立为入口（search-cli.js/hot-cli.js）。\r\n- 项目结构优化，API与工具模块化拆分，便于维护与扩展。\r\n- 移除旧 scripts/lib 目录，迁移为 src/api、src/utils、src/validate 目录。\r\n- 更新文档与示例，增强上手指引与使用场景说明。\r\n\r\n## 1.1.1 - 2026-03-31\r\n\r\n- 更新 JSON 响应中的输出字段，明确标记更多字段，提高下游解析的一致性。\r\n- 无功能或界面变更;文档现在准确反映了输出模式中始终存在的字段。\r\n\r\n## 1.1.0 - 2026-03-31\r\n\r\n**重大升级：结构化输出、多参数排序与筛选能力增强**\r\n\r\n- 增加多维度排序（综合/最多点赞/最新发布）和发布时间筛选（1天/7天/半年），结果更精准。\r\n- 支持自定义返回数量（1~60条）。\r\n- 完全结构化 JSON 输出，字段覆盖互动数据、标签等，适配 OpenClaw 生态。\r\n- 内置参数合法性校验、敏感词过滤及安全保护，保证调用稳定合规。\r\n- 增强任务轮询&超时重试机制，提升检索成功率和稳定性。\r\n- 技能文档全面更新，提供详细参数表、示例与应用场景说明。\r\n\r\n## 1.0.2 - 2026-03-24\r\n\r\n- 技能重命名为“douyin-search-keyword”。\r\n- 在SKILL.md中添加了openclaw元数据、使用帮助、许可证、标签和示例，以实现更好的集成与文档化。\r\n- 移除了两个本地文件（.env 和 scripts/last-search.json），以优化代码结构并提升安全性。\r\n- 文档现已更加简洁且以用户为中心，重点在于提供清晰的使用说明和数据字段解释。\r\n- 突出技能特性、合规要点及技术流程。\r\n\r\n## 1.0.1 - 2026-3-20\r\n\r\n- 更新技能描述，强调支持多维度抖音公开内容检索（视频、图文、用户等）\r\n- 扩展文档，新增适用/不适用场景说明\r\n- 新增环境和token配置的详细步骤与平台限制说明\r\n- 明确数据字段及样例，补充表格形式字段解释\r\n- 强调合规、风控及临时链接有效期注意事项\r\n\r\n## 1.0.0 - 2026-03-18\r\n\r\n- douyin-search-general 技能首次发布。\r\n- 提供抖音通用搜索接口，支持视频、图文、用户及社交数据搜索。\r\n- 返回详细信息，包括内容描述、作者、发布时间、点赞数、评论数、分享数、封面图片及视频链接。\r\n- 需要Node.js和有效的GUAIKEI_API_TOKEN环境变量才能运行。\r\n- 输出包含可直接复制的URL，并附有示例响应格式说明。\n\nFile v1.2.2:references/options.md\n\n# 抖音关键词搜索 (Douyin Search & Analytics) 完整选项参数说明\r\n\r\n## 🔎 抖音关键词搜索\r\n\r\n| 参数 | 缩写 | 作用 | 可选值 | 必填 | 默认值 |\r\n| :----------- | :--: | :----------- | :----------------------------------------------------- | :--- | :----: |\r\n| `--keyword` | `-k` | 搜索关键词 | 2-50 位长度的汉字或单词 | 是 | |\r\n| `--sort` | `-s` | 排序方式 | 0 = 综合排序 / 1 = 最多点赞 / 2 = 最新发布 | 否 | 0 |\r\n| `--time` | `-t` | 时间范围 | 0 = 全部 / 1 = 一天内 / 7 = 七天内 / 180 = 半年内 | 否 | 0 |\r\n| `--duration` | `-d` | 视频时长 | 0 = 不限 / 1 = 1分钟以下 / 2 = 1-5分钟 / 3 = 5分钟以上 | 否 | 0 |\r\n| `--content` | `-c` | 内容类型 | 0 = 不限 / 1 = 视频 / 2 = 图文 | 否 | 0 |\r\n| `--limit` | `-l` | 获取数量 | 1-10000 条 | 否 | 10 |\r\n| `--help` | `-h` | 显示帮助信息 | | 否 | |\r\n\r\n```bash\r\n# **基础语法**\r\nnode src/douyin/search-cli.js --keyword <关键词> --sort <排序方式> --time <时间范围> --duration <视频时长> --content <内容类型> --limit <获取数量>\r\n\r\n# **使用示例**\r\n\r\n# 搜索\"AI 教程\"的抖音内容\r\nnode src/douyin/search-cli.js --keyword \"AI 教程\"\r\n\r\n# 搜索 AI 获取最多点赞的抖音内容\r\nnode src/douyin/search-cli.js --keyword \"AI\" --sort 1\r\n\r\n# 搜索近7天\"AI 模型\"的抖音内容\r\nnode src/douyin/search-cli.js --keyword \"AI 模型\" --time 7\r\n\r\n# 搜索\"AI 教程\"视频时长在5分钟以上的抖音内容\r\nnode src/douyin/search-cli.js --keyword \"AI 教程\" --duration 3\r\n\r\n# 搜索半年内最新20条\"AI 教程\"的抖音内容\r\nnode src/douyin/search-cli.js --keyword \"AI 教程\" --sort 2 --time 180 --limit 20\r\n```\r\n\r\n## 🦸 抖音博主作品获取\r\n\r\n| 参数 | 缩写 | 作用 | 可选值 | 必填 | 默认值 |\r\n| :-------- | :--: | :----------------------- | :--------- | :--- | :----: |\r\n| `--url` | `-u` | 抖音博主主页URL或sec_uid | | 是 | |\r\n| `--limit` | `-l` | 获取作品数量 | 1-10000 条 | 否 | 10 |\r\n| `--help` | `-h` | 显示帮助信息 | | 否 | |\r\n\r\n> **💡\"抖音博主主页URL\"说明**\r\n>\r\n> - PC端 ( 格式： )\r\n> - 移动端 ( 格式： )\r\n> - 技能关键词搜索返回的author_sec_uid字段\r\n\r\n```bash\r\n# **基础语法**\r\nnode src/douyin/post-cli.js --url \"https://www.douyin.com/user/MS4wLjABxxx\"\r\n\r\n# **使用示例**\r\n\r\n# 获取抖音博主 MS4wLjABxxx 已发布的20条作品\r\nnode src/douyin/post-cli.js --url \"https://www.douyin.com/user/MS4wLjABxxx\" --limit 20\r\n```\r\n\r\n## 💬 抖音作品评论数据\r\n\r\n| 参数 | 缩写 | 作用 | 可选值 | 必填 | 默认值 |\r\n| :-------- | :--: | :---------------------------- | :--------- | :--- | :----: |\r\n| `--url` | `-u` | 抖音视频(或图文)URL或aweme_id | | 是 | |\r\n| `--limit` | `-l` | 获取评论数量 | 1-10000 条 | 否 | 10 |\r\n| `--help` | `-h` | 显示帮助信息 | | 否 | |\r\n\r\n```bash\r\n# **基础语法**\r\nnode src/douyin/comment-cli.js --url \"https://www.douyin.com/video/xxx\"\r\n\r\n# **使用示例**\r\n\r\n# 获取视频 xxx 的100条评论\r\nnode src/douyin/comment-cli.js --url \"https://www.douyin.com/video/xxx\" --limit 100\r\n```\r\n\r\n## 📡 抖音热搜榜单\r\n\r\n- 无需参数\r\n\r\n```bash\r\n# **基础语法**\r\nnode src/douyin/hot-cli.js\r\n```\n\nFile v1.2.2:skill-card.md\n\n## Description:\n\n抖音公开数据智能获取工具，支持关键词搜索、博主作品抓取、视频评论分析和实时热榜查询。\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[um-why](https://clawhub.ai/user/um-why)\n\n### License/Terms of Use:\n\nMIT\n\n## Use Case:\n\nExternal users and business teams use this skill to retrieve public Douyin search results, hot list entries, creator posts, and comments for content research, competitive analysis, trend monitoring, and operational reporting.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill sends Douyin keywords, profile or video URLs, and the GUAIKEI_API_TOKEN to www.guaikei.com.\n\nMitigation: Use it only when the GuaiKei service and data handling terms are acceptable, keep the token secret, and rotate it if exposure is suspected.\n\nRisk: Fetched public content is saved locally by default and may include large comment or profile datasets.\n\nMitigation: Review and delete local logs when they are no longer needed, and collect or retain datasets only for a lawful business purpose with an explicit retention plan.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/um-why/skills/douyin-search-keyword)\n- [GuaiKei API service](https://www.guaikei.com)\n- [Options reference](references/options.md)\n- [Changelog](references/changelog.md)\n- [Search input schema](assets/search_cli_req.schema.json)\n- [Search output schema](assets/search_cli_resp.schema.json)\n- [Post input schema](assets/post_cli_req.schema.json)\n- [Post output schema](assets/post_cli_resp.schema.json)\n- [Comment input schema](assets/comment_cli_req.schema.json)\n- [Comment output schema](assets/comment_cli_resp.schema.json)\n- [Hot list output schema](assets/hot_cli_resp.schema.json)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance]\n\n**Output Format:** [Human-facing guidance with shell commands; command results are structured JSON on stdout and JSON log files.]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires Node.js 16.14.0+ and GUAIKEI_API_TOKEN; fetched results are saved under a local logs directory by default.]\n\n## Skill Version(s):\n\n1.2.2 (source: SKILL.md frontmatter, package.json, release metadata)\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\nFile v1.2.2:assets/comment_cli_req.schema.json\n\n{\r\n \"$schema\": \"http://json-schema.org/draft-07/schema#\",\r\n \"type\": \"object\",\r\n \"title\": \"抖音评论获取 - 命令行入参\",\r\n \"description\": \"抖音获取作品评论, 命令行参数入参Schema详解\",\r\n \"required\": [\r\n \"url\"\r\n ],\r\n \"properties\": {\r\n \"url\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音作品URL 或 作品aweme_id\"\r\n },\r\n \"limit\": {\r\n \"type\": \"number\",\r\n \"description\": \"获取评论数量\",\r\n \"minimum\": 1,\r\n \"maximum\": 10000,\r\n \"default\": 10\r\n }\r\n },\r\n \"additionalProperties\": false\r\n}\n\nFile v1.2.2:assets/comment_cli_resp.schema.json\n\n{\r\n \"$schema\": \"http://json-schema.org/draft-07/schema#\",\r\n \"type\": \"object\",\r\n \"title\": \"抖音评论获取 - API出参\",\r\n \"description\": \"抖音获取作品评论, API出参Schema详解\",\r\n \"properties\": {\r\n \"cid\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音评论ID\"\r\n },\r\n \"text\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音评论内容\"\r\n },\r\n \"create_time\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音评论发布时间戳\"\r\n },\r\n \"digg_count\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音评论点赞数\"\r\n },\r\n \"user_uid\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音评论者用户ID\"\r\n },\r\n \"user_nickname\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音评论者昵称\"\r\n },\r\n \"user_sec_uid\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音评论者SEC_UID\"\r\n },\r\n \"reply_comment_total\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音评论回复数\"\r\n },\r\n \"ip_label\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音评论者IP区域\"\r\n }\r\n }\r\n}\n\nFile v1.2.2:assets/hot_cli_resp.schema.json\n\n{\r\n \"$schema\": \"http://json-schema.org/draft-07/schema#\",\r\n \"type\": \"object\",\r\n \"title\": \"抖音热榜 - API出参\",\r\n \"description\": \"抖音实时热榜, API出参Schema详解\",\r\n \"required\": [\r\n \"word\",\r\n \"event_time\",\r\n \"hot_value\",\r\n \"position\",\r\n \"view_count\"\r\n ],\r\n \"properties\": {\r\n \"id\": {\r\n \"type\": \"number\",\r\n \"description\": \"自增ID\"\r\n },\r\n \"word\": {\r\n \"type\": \"string\",\r\n \"description\": \"热榜关键词\"\r\n },\r\n \"event_time\": {\r\n \"type\": \"number\",\r\n \"description\": \"事件发生时间\"\r\n },\r\n \"hot_value\": {\r\n \"type\": \"number\",\r\n \"description\": \"热榜值\"\r\n },\r\n \"position\": {\r\n \"type\": \"number\",\r\n \"description\": \"热榜排名\"\r\n },\r\n \"view_count\": {\r\n \"type\": \"number\",\r\n \"description\": \"关键词的搜索量\"\r\n },\r\n \"event_time_format\": {\r\n \"type\": \"string\",\r\n \"description\": \"事件发生时间格式化字符串\"\r\n }\r\n }\r\n}\n\nFile v1.2.2:assets/post_cli_req.schema.json\n\n{\r\n \"$schema\": \"http://json-schema.org/draft-07/schema#\",\r\n \"type\": \"object\",\r\n \"title\": \"抖音博主作品获取 - 命令行入参\",\r\n \"description\": \"抖音实时获取博主作品, 命令行参数入参Schema详解\",\r\n \"required\": [\r\n \"url\"\r\n ],\r\n \"properties\": {\r\n \"url\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音博主主页URL 或 抖音博主SEC_UID\"\r\n },\r\n \"limit\": {\r\n \"type\": \"number\",\r\n \"description\": \"获取作品数量\",\r\n \"minimum\": 1,\r\n \"maximum\": 10000,\r\n \"default\": 10\r\n }\r\n },\r\n \"additionalProperties\": false\r\n}\n\nFile v1.2.2:assets/post_cli_resp.schema.json\n\n{\r\n \"$schema\": \"http://json-schema.org/draft-07/schema#\",\r\n \"type\": \"object\",\r\n \"title\": \"抖音博主作品获取 - API出参\",\r\n \"description\": \"抖音实时获取博主作品, API出参Schema详解\",\r\n \"properties\": {\r\n \"aweme_id\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频ID\"\r\n },\r\n \"desc\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频描述\"\r\n },\r\n \"caption\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频描述\"\r\n },\r\n \"create_time\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音视频创建时间戳\"\r\n },\r\n \"music_title\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频音乐标题\"\r\n },\r\n \"music_author\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频音乐作者\"\r\n },\r\n \"music_duration\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音视频音乐时长\"\r\n },\r\n \"music_play_url\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频音乐播放URL\"\r\n },\r\n \"video_url\": {\r\n \"type\": \"array\",\r\n \"description\": \"视频播放地址、视频下载地址\",\r\n \"items\": {\r\n \"type\": \"string\",\r\n \"description\": \"视频播放地址、视频下载地址\"\r\n }\r\n },\r\n \"video_cover\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频封面URL\"\r\n },\r\n \"video_duration\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音视频时长\"\r\n },\r\n \"recommend_count\": {\r\n \"type\": \"number\",\r\n \"description\": \"交互界面未显示字段\"\r\n },\r\n \"comment_count\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音视频评论数\"\r\n },\r\n \"digg_count\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音视频点赞数\"\r\n },\r\n \"share_count\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音视频分享数\"\r\n },\r\n \"collect_count\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音视频收藏数\"\r\n },\r\n \"tags\": {\r\n \"type\": \"array\",\r\n \"description\": \"抖音视频标签\",\r\n \"items\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频标签\"\r\n }\r\n },\r\n \"share_url\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频分享URL\"\r\n }\r\n }\r\n}\n\nFile v1.2.2:assets/search_cli_req.schema.json\n\n{\r\n \"$schema\": \"http://json-schema.org/draft-07/schema#\",\r\n \"type\": \"object\",\r\n \"title\": \"抖音关键词搜索 - 命令行入参\",\r\n \"description\": \"抖音实时关键词搜索, 命令行参数入参Schema详解\",\r\n \"required\": [\r\n \"keyword\"\r\n ],\r\n \"properties\": {\r\n \"keyword\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音关键词搜索的关键词\",\r\n \"minLength\": 2,\r\n \"maxLength\": 50\r\n },\r\n \"sort\": {\r\n \"type\": \"number\",\r\n \"description\": \"排序方式: 0=综合排序 , 1=最多点赞 , 2=最新发布\",\r\n \"default\": 0,\r\n \"enum\": [\r\n 0,\r\n 1,\r\n 2\r\n ]\r\n },\r\n \"time\": {\r\n \"type\": \"number\",\r\n \"description\": \"时间范围: 0=全部 , 1=一天内 , 7=七天内 , 180=半年内\",\r\n \"default\": 0,\r\n \"enum\": [\r\n 0,\r\n 1,\r\n 7,\r\n 180\r\n ]\r\n },\r\n \"duration\": {\r\n \"type\": \"number\",\r\n \"description\": \"视频时长: 0=不限 , 1=1分钟以下 , 2=1-5分钟 , 3=5分钟以上\",\r\n \"default\": 0,\r\n \"enum\": [\r\n 0,\r\n 1,\r\n 2,\r\n 3\r\n ]\r\n },\r\n \"content\": {\r\n \"type\": \"number\",\r\n \"description\": \"内容类型, 0: 不限, 1: 视频, 2: 图文\",\r\n \"default\": 0,\r\n \"enum\": [\r\n 0,\r\n 1,\r\n 2\r\n ]\r\n },\r\n \"limit\": {\r\n \"type\": \"number\",\r\n \"description\": \"获取数量\",\r\n \"minimum\": 1,\r\n \"maximum\": 10000,\r\n \"default\": 10\r\n }\r\n },\r\n \"additionalProperties\": false\r\n}\n\nArchive v1.2.1: 35 files, 41338 bytes\n\nFiles: assets/comment_cli_req.schema.json (652b), assets/comment_cli_resp.schema.json (1311b), assets/hot_cli_resp.schema.json (1154b), assets/post_cli_req.schema.json (675b), assets/post_cli_resp.schema.json (2715b), assets/search_cli_req.schema.json (1884b), assets/search_cli_resp.schema.json (3435b), package.json (862b), readme.md (10801b), references/changelog.md (4319b), references/options.md (3866b), skill-card.md (2255b), SKILL.md (9664b), src/api/comment.js (2020b), src/api/hot.js (919b), src/api/post.js (1636b), src/api/search.js (3200b), src/config/constants.js (464b), src/douyin/comment-cli.js (4807b), src/douyin/hot-cli.js (2600b), src/douyin/post-cli.js (4734b), src/douyin/search-cli.js (7482b), src/utils/args.js (3970b), src/utils/errors.js (939b), src/utils/log.js (1131b), src/utils/name.js (319b), src/utils/request.js (5038b), src/utils/retry.js (1149b), src/utils/token.js (1288b), src/utils/utils.js (1708b), src/validate/comment.js (905b), src/validate/hot.js (703b), src/validate/keyword.js (4223b), src/validate/post.js (942b), _meta.json (140b)\n\nFile v1.2.1:SKILL.md\n\n---\r\nname: douyin-search-keyword\r\ndescription: 抖音公开数据智能获取工具。支持抖音关键词搜索、抖音博主作品抓取、抖音视频评论分析、抖音实时热榜查询。当用户需要搜抖音视频、查抖音热榜、看抖音评论、抓博主作品、做抖音竞品分析、短视频选题调研、舆情监控、热点追踪、爆款挖掘、抖音运营数据分析时使用。触发词：抖音搜索、抖音热榜、抖音评论、抖音作品、抖音竞品分析、抖音数据分析、短视频运营、抖音舆情监控、抖音热点。\r\nlicense: MIT\r\nmetadata:\r\n enabled: true\r\n type: command\r\n runtime: \"nodejs@16.14.0+\"\r\n version: 1.2.1\r\n requires:\r\n bins:\r\n - \"node\"\r\n env:\r\n - \"GUAIKEI_API_TOKEN\"\r\n env_desc:\r\n GUAIKEI_API_TOKEN: \"抖音数据 API 访问令牌。未配置时无法调用接口；可通过 https://www.guaikei.com 开通，或联系开发者(wx 13395823479)获取支持。\"\r\n category:\r\n - \"Data&APIs\"\r\n - \"内容创作\"\r\n - \"数据分析\"\r\n - \"商业运营\"\r\n - \"办公效率\"\r\n tags:\r\n - \"抖音\"\r\n - \"douyin\"\r\n - \"抖音搜索\"\r\n - \"抖音热榜\"\r\n - \"抖音评论\"\r\n - \"抖音作品\"\r\n - \"抖音竞品分析\"\r\n - \"抖音数据分析\"\r\n - \"短视频运营\"\r\n - \"短视频\"\r\n - \"舆情监控\"\r\n - \"热点追踪\"\r\n - \"爆款挖掘\"\r\n - \"竞品分析\"\r\n - \"营销分析\"\r\n - \"search\"\r\n - \"数据挖掘\"\r\n - \"content-analysis\"\r\n - \"competitor-analysis\"\r\n - \"marketing\"\r\n - \"trend-tracking\"\r\n schemas:\r\n - name: \"搜索入参\"\r\n file: \"assets/search_cli_req.schema.json\"\r\n - name: \"搜索出参\"\r\n file: \"assets/search_cli_resp.schema.json\"\r\n - name: \"作品入参\"\r\n file: \"assets/post_cli_req.schema.json\"\r\n - name: \"作品出参\"\r\n file: \"assets/post_cli_resp.schema.json\"\r\n - name: \"热榜出参\"\r\n file: \"assets/hot_cli_resp.schema.json\"\r\n - name: \"评论入参\"\r\n file: \"assets/comment_cli_req.schema.json\"\r\n - name: \"评论出参\"\r\n file: \"assets/comment_cli_resp.schema.json\"\r\n examples:\r\n - \"搜抖音里'AI 教程'最火的视频: node src/douyin/search-cli.js --keyword 'AI 教程' --sort 1\"\r\n - \"看最近一周抖音上'AI 模型'最新的 20 条内容: node src/douyin/search-cli.js --keyword 'AI 模型' --sort 2 --time 7 --limit 20\"\r\n - \"查抖音今天有什么热点/热搜榜: node src/douyin/hot-cli.js\"\r\n - \"抓这个抖音博主最近 30 条作品: node src/douyin/post-cli.js --url 'https://www.douyin.com/user/MS4wLjABxxx' --limit 30\"\r\n - \"看这条抖音视频的 40 条评论: node src/douyin/comment-cli.js --url 'https://www.douyin.com/video/xxx' --limit 40\"\r\n---\r\n\r\n# 🚀 抖音关键词搜索、竞品分析、舆情监控与热榜跟踪工具 (Douyin Search & Analytics)\r\n\r\n## 1. 🛠️ 技能概述\r\n\r\n抖音公开数据获取与智能分析工具。支持**关键词搜索排序**、**博主作品抓取**、**视频评论分析**、**实时热榜获取**，适用于短视频选题、竞品监控、舆情分析、热点追踪，助力爆款内容策划与流量运营。\r\n\r\n> **🔥核心优势**\r\n>\r\n> - **安全**：无需登录抖音账号，无风控 / 封号风险\r\n> - **强大**：单次最多可获取 1W 条数据，内置批量与多维筛选\r\n> - **全面**：出参覆盖作者、互动、标签、链接等可用数据及有价值数据都会返回\r\n> - **轻量**：无需部署服务，Node.js 一键运行，仅依赖内置模块\r\n> - **友好**：stdout 纯 JSON、日志走 stderr，便于 AI 稳定解析与二次分析\r\n\r\n## 2. ✅ 何时调用与能力边界\r\n\r\n### 🎯 在以下场景优先调用：\r\n\r\n- 用户明确要查 **抖音** 的公开内容（视频 / 图文 / 作者 / 评论 / 热榜）。\r\n- 用户要做 **关键词搜索**、**爆款选题调研**、**竞品监控**、**评论洞察**、**博主作品追踪**、**热点追流**。\r\n- 用户提供了抖音关键词、视频链接、博主主页链接，希望拿到结构化数据。\r\n- 用户后续还要基于结果做总结、对比、筛选、报告生成。\r\n\r\n### 🚫 不应调用\r\n\r\n- 用户只想要文案/标题/脚本，未要求查抖音数据。\r\n- 平台不是抖音（小红书、B站、微博、公众号）→ 路由到对应技能。\r\n- 要求私密/登录态/隐藏数据。\r\n- 既无关键词也无可识别抖音链接且目标不明 → 先追问。\r\n\r\n> 意图不明确时先追问，不要盲目执行命令。\r\n\r\n### 🛑 本技能不需要、不负责：\r\n\r\n登录账号、发布/点赞/评论/关注等写操作、获取非公开数据、替用户做营销策略判断。职责是**先把数据拿回来**，再交上层分析。\r\n\r\n## 3. 🔀 调用路由\r\n\r\n> **Note:** 请先通过 [抖音数据获取技能官网](https://www.guaikei.com) 开通并配置环境变量 `GUAIKEI_API_TOKEN` 后，再按意图路由：\r\n\r\n| 意图 | 脚本 | 必填 | 典型结果 |\r\n| ---------------- | --------------------------- | -------------------- | ------------------------------- |\r\n| 搜关键词内容 | `src/douyin/search-cli.js` | `keyword` | 视频/图文列表、作者、互动、链接 |\r\n| 看热搜/热点/榜单 | `src/douyin/hot-cli.js` | 无 | 热榜词条、热度、搜索量 |\r\n| 看博主最近作品 | `src/douyin/post-cli.js` | 主页 URL 或 sec_uid | 博主公开作品列表 |\r\n| 看视频/图文评论 | `src/douyin/comment-cli.js` | 视频 URL 或 aweme_id | 评论内容、评论者、互动 |\r\n\r\n### 🧭 消歧义（重要）\r\n\r\n- 单独出现\"视频\"二字时，不要默认归 `post`。\r\n- 有\"关键词\"且无\"评论\" → `search`（用户想搜某个视频）。\r\n- \"这个视频的评论/留言\" → `comment`。\r\n- 仅当\"作品/主页/账号/博主\"出现时才用 `post`。\r\n\r\n## 4. 🧺 输入收集规则\r\n\r\n执行前先收集足够输入，避免无效调用。\r\n\r\n### 4.1 🔍 关键词搜索（search-cli）\r\n\r\n至少要确认：`keyword`（2-50 字符）。可选：\r\n\r\n- `sort`：0 综合 / 1 最多点赞 / 2 最新发布\r\n- `time`：0 全部 / 1 一天内 / 7 七天内 / 180 半年内\r\n- `duration`：0 不限 / 1 1分钟内 / 2 1-5分钟 / 3 5分钟以上\r\n- `content`：0 不限 / 1 视频 / 2 图文\r\n- `limit`：1-10000，默认 10\r\n\r\n### 4.2 📡 博主作品（post-cli）\r\n\r\n至少要确认：`url`（主页 URL 或 sec_uid）。可选：`limit`（1-10000，默认 10）。\r\n适用链接：`https://www.douyin.com/user/MS4wLjABxxx`、`https://v.douyin.com/xxx`、或直接使用 `sec_uid`。\r\n\r\n### 4.3 💬 评论分析（comment-cli）\r\n\r\n至少要确认：`url`（视频 / 图文 URL 或 aweme_id）。可选：`limit`（1-10000，默认 10）。\r\n适用链接：`https://www.douyin.com/video/xxx`、`https://www.douyin.com/note/xxx`、或直接使用 `aweme_id`。\r\n\r\n## 5. 📜 执行与输出约定\r\n\r\n- 在技能根目录执行；只输出纯 JSON 到 stdout，日志/banner 走 stderr。\r\n- 没有关键词：先追问关键词。\r\n- 没有链接：先追问视频 / 主页链接或 ID。\r\n- 链接类型不明确：先确认这是视频还是博主主页。\r\n- 没有 `GUAIKEI_API_TOKEN`：提醒用户先配置环境变量，再执行。\r\n- 退出码：`0`=成功（含 empty），`1`=运行错误（接口异常/网络/超时），`3`=auth_required（缺/错 token）。\r\n- 失败须向用户说明原因，**不编造数据，不把空结果当成功**。空结果退出码 0 属正常。\r\n- 完整选项见 可参阅 [完整选项说明](references/options.md) ；LLM理解技能的详细选项，可参阅技能 `assets` 目录中文件。\r\n- 执行完成后，优先返回：本次目标、关键参数、结构化 JSON 结果，必要时再补一小段摘要。\r\n- 适合衔接的后续动作：选题汇总、高赞对比、评论观点聚类、竞品内容风格总结、博主发文节奏分析、报告与表格生成。\r\n\r\n## 6. 💡 调用示例\r\n\r\n```bash\r\nnode src/douyin/search-cli.js --keyword \"AI 教程\" --sort 1\r\nnode src/douyin/search-cli.js --keyword \"AI模型\" --sort 2 --time 7 --limit 20\r\nnode src/douyin/hot-cli.js\r\nnode src/douyin/post-cli.js --url \"https://www.douyin.com/user/MS4wLjABxxx\" --limit 50\r\nnode src/douyin/comment-cli.js --url \"https://www.douyin.com/video/xxx\" --limit 100\r\n```\r\n\r\n- 🤖 自然语言触发示例：\"帮我搜抖音里'AI 教程'最火的视频\"\"抖音今天有什么热点\"\"分析这条抖音视频评论区的主要观点\"。\r\n- 🧠 若用户表达笼统（如\"帮我做抖音竞品分析\"），优先拆成两步：① 确认关键词 / 竞品链接 / 博主主页；② 再调用对应脚本拿回数据。\r\n\r\n## 7. 🎧 环境、合规与支持\r\n\r\n- 环境：Node.js 16.14.0+，兼容 Windows/Linux/macOS；必需 `GUAIKEI_API_TOKEN`；官网 。\r\n- 合规：仅处理抖音公开数据，不支持私密/隐藏/登录态数据；数据仅限个人/团队内部分析，禁止违规分发；依赖第三方 API（guaikei.com），使用前确认数据外发与授权范围。\r\n- 支持：官网 <[抖音数据获取技能官网](https://www.guaikei.com)>（自助开通 TOKEN）；微信 `13395823479`（备注：抖音技能）。\r\n\r\n## 8. ❓ 常见问题\r\n\r\n- 没结果：放宽关键词或减少限定（`--time 0`）、换更贴近的词。\r\n- 结果太多：补场景/人群/品牌/时间/账号。\r\n- 调用失败：先确认 `GUAIKEI_API_TOKEN` 已配置有效（退出码 3 即 token 问题）。\r\n- 账号安全：只读能力，不登录/发帖/点赞/评论。\n\nFile v1.2.1:readme.md\n\n# 🚀 抖音关键词搜索、竞品分析、舆情监控与热榜跟踪工具 (Douyin Search & Analytics)\r\n\r\n> **💡一句话价值**：一键抓取抖音公开视频/作者/评论/热榜数据，帮你做爆款选题、竞品分析、舆情监控、热点追踪。\r\n>\r\n> **🔥核心优势**\r\n>\r\n> - 安全: 无需登录你的抖音账号，不担心风控风险 / 封号问题\r\n> - 强大: 一次可获取最多1W条数据，技能内置批量操作，使用简单方便\r\n> - 全面: 各功能出参数据全面，可见及有价值数据都会返回\r\n> - 灵活: 支持多维度筛选、批量操作\r\n> - 轻量: 无需部署服务，Node.js 一键运行\r\n> - 低耗: 日志自动归档，适配营销报告 / 内容策划场景 ，便于数据二次分析\r\n\r\n## 1. ✅ 我能帮你解决什么（10 秒判断）\r\n\r\n- 🔍 按关键词搜抖音视频（点赞/最新排序）：找爆款选题、分析高赞视频规律\r\n- 🦸 竞品监控：批量抓取对标账号所有公开作品数据，分析内容策略\r\n- 💬 评论分析：获取抖音评论详情，分析舆情方向\r\n- 📡 热点追流：实时获取抖音热榜，抢占流量风口\r\n- 📊 数据导出：自动生成JSON日志，方便对比分析和使用\r\n\r\n## 2. 🚀 最快上手（复制就能跑，30 秒出结果）\r\n\r\n> **Note:** 请先通过微信 <13395823479> 申请TOKEN ，或访问[抖音搜索技能官网](https://www.guaikei.com)开通TOKEN，配置环境变量 `GUAIKEI_API_TOKEN` 后才能正常运行。\r\n\r\n### 2.1 🔎 抖音关键词搜索（最简单）\r\n\r\n```bash\r\nnode src/douyin/search-cli.js --keyword \"AI\"\r\n```\r\n\r\n### 2.2 🔎 按点赞排序找爆款（最常用）\r\n\r\n```bash\r\nnode src/douyin/search-cli.js --keyword \"AI\" --sort 1\r\n```\r\n\r\n### 2.3 🦸 抓取抖音博主全部作品\r\n\r\n```bash\r\nnode src/douyin/post-cli.js --url \"https://www.douyin.com/user/MS4wLjABxxx\"\r\n```\r\n\r\n### 2.4 💬 获取抖音作品评论内容\r\n\r\n```bash\r\nnode src/douyin/comment-cli.js --url \"https://www.douyin.com/video/xxx\"\r\n```\r\n\r\n### 2.5 📡 获取抖音实时热榜\r\n\r\n```bash\r\nnode src/douyin/hot-cli.js\r\n```\r\n\r\n## 3. 📌 适用场景（我该不该用？）\r\n\r\n- 你需要做短视频选题 → 关键词搜索 + 点赞排序\r\n- 你需要模仿爆款文案 → 查看高赞视频详情\r\n- 你需要监控竞品账号 → 批量抓取对方作品\r\n- 你需要分析内容舆情 → 获取抖音评论详情\r\n- 你需要快速追热点 → 实时获取抖音热榜\r\n- 你需要做营销报告 → 导出结构化数据\r\n\r\n## 4. 🔧 参数详解表\r\n\r\n> 详细选项参数说明， 可参阅 [完整选项说明](references/options.md)\r\n>\r\n> LLM理解技能的详细选项，可参阅技能 `assets` 目录中文件，其遵循 JSON Schema draft-07 版本规范。\r\n>\r\n> - 抖音关键词搜索，[入参规范](assets/search_cli_req.schema.json)\r\n> - 抖音关键词搜索，[出参规范](assets/search_cli_resp.schema.json)\r\n> - 抖音博主作品获取，[入参规范](assets/post_cli_req.schema.json)\r\n> - 抖音博主作品获取，[出参规范](assets/post_cli_resp.schema.json)\r\n> - 抖音评论获取，[入参规范](assets/comment_cli_req.schema.json)\r\n> - 抖音评论获取，[出参规范](assets/comment_cli_resp.schema.json)\r\n> - 抖音热榜获取，[出参规范](assets/hot_cli_resp.schema.json)\r\n\r\n## 5. ⚠️ 重要限制（不踩坑）\r\n\r\n- 仅抓取抖音公开数据，不支持私密 / 隐藏内容\r\n- 需要配置 GUAIKEI_API_TOKEN 才能正常运行\r\n- 数据仅限个人 / 团队内部使用，禁止违规分发\r\n\r\n## 6. ❓ 常见问题（秒解决）\r\n\r\n> **💡Q：运行报错，提示无权限？**\r\n>\r\n> A：配置环境变量：\r\n>\r\n> - Windows: `set GUAIKEI_API_TOKEN=你的TOKEN`\r\n> - Linux/MacOS: `export GUAIKEI_API_TOKEN=你的TOKEN`\r\n> - 私有TOKEN申请后请留意使用安全，避免泄露给他人\r\n>\r\n> **💡Q：搜索结果为空？**\r\n>\r\n> A：换常用关键词，或把 `--time` 改为 0（全部时间）\r\n>\r\n> **💡Q：输出文件在哪里？**\r\n>\r\n> A：自动保存在技能目录的 `logs` 文件夹下\r\n>\r\n> - 搜索任务日志: 默认保存为「时间戳\\_关键词\\_排序\\_时间\\_时长\\_类型\\_search.json」\r\n> - 抖音博主作品获取日志: 默认保存为「时间戳\\_(博主sec_uid)\\_post.json」\r\n> - 抖音评论获取日志: 默认保存为「时间戳\\_(视频aweme_id)\\_comment.json」\r\n>\r\n> **💡Q：支持 Windows/Mac/Linux 吗？**\r\n>\r\n> A：全平台支持，仅需安装 Node.js 环境\r\n\r\n## 7. 📞 帮助与支持\r\n\r\n- 联系微信 13395823479（备注抖音技能）开通TOKEN或获得技能使用支持；\r\n- 或通过 [抖音关键词搜索技能官网](https://www.guaikei.com) 自助开通TOKEN或查阅使用帮助。\r\n\r\n> 🆕 [更新日志](references/changelog.md) 可查阅这里\r\n\r\n## 8. 🛑 错误处理与重试策略（重要）\r\n\r\n### 8.1 遇到以下错误，立即停止操作并向用户报告\r\n\r\n- **权限错误**（AUTH_ERROR）：TOKEN 无效或已过期，请提示用户重新配置\r\n- **API 次数超限**：提示用户联系客服开通更高额度\r\n- **网络错误连续 3 次失败**：提示用户检查网络连接\r\n\r\n### 8.2 禁止行为\r\n\r\n- ❌ 不要在收到 AUTH_ERROR 后继续重试\r\n- ❌ 不要在 API 返回明确错误码后尝试修改参数重试\r\n- ❌ 不要在用户未明确要求的情况下自动调整搜索条件\r\n\r\n### 8.3 正确做法\r\n\r\n- ✅ 遇到错误，立即向用户展示错误信息\r\n- ✅ 询问用户是否需要调整参数或重新尝试\r\n- ✅ 对于网络超时，可以尝试最多 3 次之后停止\r\n\r\n## 9. 💬 自然语言指令映射（AI 快速参考）\r\n\r\n> **统一调用约定（重要）**\r\n>\r\n> - 必须在**技能根目录**执行。\r\n> - 只输出纯 JSON 到 stdout，日志与 banner 走 stderr，便于稳定解析。\r\n> - 退出码约定：`0`=成功（含 empty），`1`=运行错误，`3`=auth_required（缺/错 token）。\r\n\r\n### 9.1 搜索功能\r\n\r\n| 用户口语化指令 | 对应命令 | 参数推导 |\r\n| --------------------------------- | ---------------------------------------------------------------------------------- | ---------------------------- |\r\n| \"搜索 / 搜一下 / 找 AI 相关视频\" | `node src/douyin/search-cli.js --keyword \"AI\"` | 带关键词即搜索 |\r\n| \"找点赞最多的 / 最火的 AI 视频\" | `node src/douyin/search-cli.js --keyword \"AI\" --sort 1` | 最火/点赞最多 → sort=1 |\r\n| \"最新的 AI 教程，要 20 条\" | `node src/douyin/search-cli.js --keyword \"AI 教程\" --sort 2 --limit 20` | 最新 → sort=2；数量 → limit |\r\n| \"近一周最火的短视频\" | `node src/douyin/search-cli.js --keyword \"短视频\" --time 7 --sort 1` | 一周 → time=7；最火 → sort=1 |\r\n| \"半年内最新 20 条 AI 教程\" | `node src/douyin/search-cli.js --keyword \"AI 教程\" --sort 2 --time 180 --limit 20` | 半年 → time=180 |\r\n| \"减肥视频，只要 1 分钟以下的\" | `node src/douyin/search-cli.js --keyword \"减肥\" --duration 1` | 见下方 duration 表 |\r\n| \"AI 模型，5 分钟以上的，前 50 条\" | `node src/douyin/search-cli.js --keyword \"AI 模型\" --duration 3 --limit 50` | 5分钟以上 → duration=3 |\r\n\r\n### 9.2 竞品监控\r\n\r\n| 用户口语化指令 | 对应命令 | 参数推导 |\r\n| ------------------------------- | ----------------------------------------------------------------------------- | --------------------- |\r\n| \"查看这个博主的所有作品 / 主页\" | `node src/douyin/post-cli.js --url \"https://www.douyin.com/user/MS4wLjABxxx\"` | 作品/主页/账号 → post |\r\n| \"抓取 MS4wLjABxxx 的作品\" | `node src/douyin/post-cli.js --url \"MS4wLjABxxx\"` | sec_uid 直接可用 |\r\n| \"获取他最近 50 条视频\" | `node src/douyin/post-cli.js --url \"xxx\" --limit 50` | 数量 → limit |\r\n\r\n### 9.3 评论分析\r\n\r\n| 用户口语化指令 | 对应命令 | 参数推导 |\r\n| --------------------------- | ------------------------------------------------------------------------- | ------------------- |\r\n| \"看看这个视频的评论 / 留言\" | `node src/douyin/comment-cli.js --url \"https://www.douyin.com/video/xxx\"` | 评论/留言 → comment |\r\n| \"获取这条视频的 100 条评论\" | `node src/douyin/comment-cli.js --url \"xxx\" --limit 100` | 数量 → limit |\r\n\r\n### 9.4 热榜\r\n\r\n| 用户口语化指令 | 对应命令 |\r\n| ---------------------------------------- | ---------------------------- |\r\n| \"抖音今天有什么热点 / 热搜榜 / 热点榜单\" | `node src/douyin/hot-cli.js` |\r\n\r\n## 10. 🧠 AI 意图识别规则\r\n\r\n### 10.1 识别优先级（从上到下）\r\n\r\n1. **热搜 / 热点 / 榜单 / 今天什么火** → `hot-cli.js`\r\n2. **搜索 / 搜一下 / 找 + 关键词** → `search-cli.js`\r\n3. **评论 / 留言 / 弹幕** → `comment-cli.js`（必须出现\"评论\"类词才归此类）\r\n4. **作品 / 视频(指博主内容) / 主页 / 账号 / 博主** → `post-cli.js`\r\n\r\n> ⚠️ 歧义提示：单独出现\"视频\"二字时，**不要默认归到 post-cli**。\r\n>\r\n> - 若同时有\"关键词\"且无\"评论\" → 视为 `search`（用户想搜某个视频）。\r\n> - 若明确\"这个视频的评论/留言\" → `comment`。\r\n> - 仅当\"作品/主页/账号/博主\"出现时才用 `post`。\r\n\r\n### 10.2 参数推断规则\r\n\r\n**排序（sort，与 time 正交）**\r\n\r\n- 提到\"综合 / 默认\" → `sort=0`\r\n- 提到\"点赞最多 / 最火 / 爆款\" → `sort=1`\r\n- 提到\"最新 / 最近发布 / 刚发\" → `sort=2`\r\n\r\n**时间窗（time）**\r\n\r\n- 提到\"全部 / 不限制\" → `time=0`\r\n- 提到\"一天 / 24小时\" → `time=1`\r\n- 提到\"一周 / 7天\" → `time=7`\r\n- 提到\"半年\" → `time=180`\r\n\r\n**时长**\r\n\r\n- 提到\"1分钟以下 / 短于1分钟\" → `duration=1`\r\n- 提到\"1到5分钟 / 1-5分钟\" → `duration=2`\r\n- 提到\"5分钟以上\" → `duration=3`\r\n- 提到\"不限时长\" → `duration=0`\r\n\r\n**内容类型**\r\n\r\n- 提到\"不限 / 默认\" → `content=0`\r\n- 提到\"视频\" → `content=1`\r\n- 提到\"图文\" → `content=2`\r\n\r\n**数量（limit）**\r\n\r\n- 提到\"条数 / 数量 / N条 / 前N条\" → `limit=N`\r\n\r\n### 10.3 默认值\r\n\r\n- sort: 0（综合）｜time: 0（全部）｜duration: 0（不限）｜limit: 10\n\nFile v1.2.1:_meta.json\n\n{\n \"ownerId\": \"kn79p9y6xrdxyr0maxy3tj5nb9835e0e\",\n \"slug\": \"douyin-search-keyword\",\n \"version\": \"1.2.1\",\n \"publishedAt\": 1786875011836\n}\n\nFile v1.2.1:references/changelog.md\n\n# 抖音关键词搜索 (Douyin Search & Analytics) 更新日志\r\n\r\n## 1.2.1 - 2026-08-16\r\n\r\n- 技能细节打磨，优化AI对技能的识别及解析能力。\r\n\r\n## 1.2.0 - 2026-08-08\r\n\r\n- 搜索功能优化，支持类型搜索（视频、图文等）。\r\n- 各项功能细节优化。\r\n\r\n## 1.1.5 - 2026-06-18\r\n\r\n- 新增抖音视频评论获取功能，支持抓取并分析指定作品的评论内容。\r\n- 更新 schema，新增评论入参与出参 JSON Schema 规范，完善数据结构。\r\n- SKILL.md 说明文档同步更新，增加评论分析与用法示例。\r\n\r\n## 1.1.4 - 2026-06-09\r\n\r\n- 新增多份 JSON 模式文件，用于命令行结构化输入输出校验。\r\n- 在 references/ 目录下添加文档：更新日志（changelog.md）、配置说明（options.md）。\r\n- 优化 SKILL.md：补充模式文件引用，并完善令牌获取相关说明。\r\n- 为技能元数据补充模式定义，提升兼容性与自检能力。\r\n\r\n## 1.1.3 - 2026-05-11\r\n\r\n**新增：支持获取抖音作者（抖人）已发布作品，实现竞品账号内容批量抓取。**\r\n\r\n- 新增 post-cli 指令，可根据抖音主页 URL 或 sec_uid 一键获取创作者所有公开作品，便于竞品监控和账号内容分析。\r\n- 参数说明、使用范例及常见问题等文档内容同步更新，更清晰指引新功能使用方式。\r\n- 指令参数支持短缩写，limit上限提升至200，提升批量数据抓取能力。\r\n- 关键词搜索、热榜等原有功能保持兼容并优化参数配置，提升整体易用性。\r\n- 调整并精简 Skill 文档，增加使用案例，强调 TOKEN 申请与日志留存说明。\r\n- 示例与文档同步完善，能力标签更明确。\r\n\r\n## 1.1.2 - 2026-05-04\r\n\r\n- 新增支持抖音热搜榜单查询（hot-cli.js），可独立调用。\r\n- 关键词搜索与热榜查询分别独立为入口（search-cli.js/hot-cli.js）。\r\n- 项目结构优化，API与工具模块化拆分，便于维护与扩展。\r\n- 移除旧 scripts/lib 目录，迁移为 src/api、src/utils、src/validate 目录。\r\n- 更新文档与示例，增强上手指引与使用场景说明。\r\n\r\n## 1.1.1 - 2026-03-31\r\n\r\n- 更新 JSON 响应中的输出字段，明确标记更多字段，提高下游解析的一致性。\r\n- 无功能或界面变更;文档现在准确反映了输出模式中始终存在的字段。\r\n\r\n## 1.1.0 - 2026-03-31\r\n\r\n**重大升级：结构化输出、多参数排序与筛选能力增强**\r\n\r\n- 增加多维度排序（综合/最多点赞/最新发布）和发布时间筛选（1天/7天/半年），结果更精准。\r\n- 支持自定义返回数量（1~60条）。\r\n- 完全结构化 JSON 输出，字段覆盖互动数据、标签等，适配 OpenClaw 生态。\r\n- 内置参数合法性校验、敏感词过滤及安全保护，保证调用稳定合规。\r\n- 增强任务轮询&超时重试机制，提升检索成功率和稳定性。\r\n- 技能文档全面更新，提供详细参数表、示例与应用场景说明。\r\n\r\n## 1.0.2 - 2026-03-24\r\n\r\n- 技能重命名为“douyin-search-keyword”。\r\n- 在SKILL.md中添加了openclaw元数据、使用帮助、许可证、标签和示例，以实现更好的集成与文档化。\r\n- 移除了两个本地文件（.env 和 scripts/last-search.json），以优化代码结构并提升安全性。\r\n- 文档现已更加简洁且以用户为中心，重点在于提供清晰的使用说明和数据字段解释。\r\n- 突出技能特性、合规要点及技术流程。\r\n\r\n## 1.0.1 - 2026-3-20\r\n\r\n- 更新技能描述，强调支持多维度抖音公开内容检索（视频、图文、用户等）\r\n- 扩展文档，新增适用/不适用场景说明\r\n- 新增环境和token配置的详细步骤与平台限制说明\r\n- 明确数据字段及样例，补充表格形式字段解释\r\n- 强调合规、风控及临时链接有效期注意事项\r\n\r\n## 1.0.0 - 2026-03-18\r\n\r\n- douyin-search-general 技能首次发布。\r\n- 提供抖音通用搜索接口，支持视频、图文、用户及社交数据搜索。\r\n- 返回详细信息，包括内容描述、作者、发布时间、点赞数、评论数、分享数、封面图片及视频链接。\r\n- 需要Node.js和有效的GUAIKEI_API_TOKEN环境变量才能运行。\r\n- 输出包含可直接复制的URL，并附有示例响应格式说明。\n\nFile v1.2.1:references/options.md\n\n# 抖音关键词搜索 (Douyin Search & Analytics) 完整选项参数说明\r\n\r\n## 🔎 抖音关键词搜索\r\n\r\n| 参数 | 缩写 | 作用 | 可选值 | 必填 | 默认值 |\r\n| :----------- | :--: | :----------- | :----------------------------------------------------- | :--- | :----: |\r\n| `--keyword` | `-k` | 搜索关键词 | 2-50 位长度的汉字或单词 | 是 | |\r\n| `--sort` | `-s` | 排序方式 | 0 = 综合排序 / 1 = 最多点赞 / 2 = 最新发布 | 否 | 0 |\r\n| `--time` | `-t` | 时间范围 | 0 = 全部 / 1 = 一天内 / 7 = 七天内 / 180 = 半年内 | 否 | 0 |\r\n| `--duration` | `-d` | 视频时长 | 0 = 不限 / 1 = 1分钟以下 / 2 = 1-5分钟 / 3 = 5分钟以上 | 否 | 0 |\r\n| `--content` | `-c` | 内容类型 | 0 = 不限 / 1 = 视频 / 2 = 图文 | 否 | 0 |\r\n| `--limit` | `-l` | 获取数量 | 1-10000 条 | 否 | 10 |\r\n| `--help` | `-h` | 显示帮助信息 | | 否 | |\r\n\r\n```bash\r\n# **基础语法**\r\nnode src/douyin/search-cli.js --keyword <关键词> --sort <排序方式> --time <时间范围> --duration <视频时长> --content <内容类型> --limit <获取数量>\r\n\r\n# **使用示例**\r\n\r\n# 搜索\"AI 教程\"的抖音内容\r\nnode src/douyin/search-cli.js --keyword \"AI 教程\"\r\n\r\n# 搜索 AI 获取最多点赞的抖音内容\r\nnode src/douyin/search-cli.js --keyword \"AI\" --sort 1\r\n\r\n# 搜索近7天\"AI 模型\"的抖音内容\r\nnode src/douyin/search-cli.js --keyword \"AI 模型\" --time 7\r\n\r\n# 搜索\"AI 教程\"视频时长在5分钟以上的抖音内容\r\nnode src/douyin/search-cli.js --keyword \"AI 教程\" --duration 3\r\n\r\n# 搜索半年内最新20条\"AI 教程\"的抖音内容\r\nnode src/douyin/search-cli.js --keyword \"AI 教程\" --sort 2 --time 180 --limit 20\r\n```\r\n\r\n## 🦸 抖音博主作品获取\r\n\r\n| 参数 | 缩写 | 作用 | 可选值 | 必填 | 默认值 |\r\n| :-------- | :--: | :----------------------- | :--------- | :--- | :----: |\r\n| `--url` | `-u` | 抖音博主主页URL或sec_uid | | 是 | |\r\n| `--limit` | `-l` | 获取作品数量 | 1-10000 条 | 否 | 10 |\r\n| `--help` | `-h` | 显示帮助信息 | | 否 | |\r\n\r\n> **💡\"抖音博主主页URL\"说明**\r\n>\r\n> - PC端 ( 格式： )\r\n> - 移动端 ( 格式： )\r\n> - 技能关键词搜索返回的author_sec_uid字段\r\n\r\n```bash\r\n# **基础语法**\r\nnode src/douyin/post-cli.js --url \"https://www.douyin.com/user/MS4wLjABxxx\"\r\n\r\n# **使用示例**\r\n\r\n# 获取抖音博主 MS4wLjABxxx 已发布的20条作品\r\nnode src/douyin/post-cli.js --url \"https://www.douyin.com/user/MS4wLjABxxx\" --limit 20\r\n```\r\n\r\n## 💬 抖音作品评论数据\r\n\r\n| 参数 | 缩写 | 作用 | 可选值 | 必填 | 默认值 |\r\n| :-------- | :--: | :---------------------------- | :--------- | :--- | :----: |\r\n| `--url` | `-u` | 抖音视频(或图文)URL或aweme_id | | 是 | |\r\n| `--limit` | `-l` | 获取评论数量 | 1-10000 条 | 否 | 10 |\r\n| `--help` | `-h` | 显示帮助信息 | | 否 | |\r\n\r\n```bash\r\n# **基础语法**\r\nnode src/douyin/comment-cli.js --url \"https://www.douyin.com/video/xxx\"\r\n\r\n# **使用示例**\r\n\r\n# 获取视频 xxx 的100条评论\r\nnode src/douyin/comment-cli.js --url \"https://www.douyin.com/video/xxx\" --limit 100\r\n```\r\n\r\n## 📡 抖音热搜榜单\r\n\r\n- 无需参数\r\n\r\n```bash\r\n# **基础语法**\r\nnode src/douyin/hot-cli.js\r\n```\n\nFile v1.2.1:skill-card.md\n\n## Description:\n\nRetrieves public Douyin data for keyword search, creator posts, video comments, and real-time hot-list queries so agents can support content research, competitor analysis, sentiment review, and trend tracking.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[um-why](https://clawhub.ai/user/um-why)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users and agents use this skill to collect structured public Douyin search results, creator posts, comments, and hot-list entries for short-video research, content planning, competitor monitoring, and operations analysis.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Douyin keywords, profile or video identifiers, request limits, and GUAIKEI_API_TOKEN are sent to the third-party guaikei.com API.\n\nMitigation: Install and run the skill only when that data sharing is acceptable, keep the token confidential, and rotate it if exposure is suspected.\n\nRisk: Retrieved public posts and comments may be saved locally in the skill logs directory.\n\nMitigation: Use the smallest practical limits, delete logs when they are no longer needed, and verify collection and analysis comply with applicable rules and privacy expectations.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/um-why/skills/douyin-search-keyword)\n- [抖音数据获取技能官网](https://www.guaikei.com)\n- [Complete options reference](references/options.md)\n- [Changelog](references/changelog.md)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Code, Shell commands, Configuration, Guidance]\n\n**Output Format:** [JSON from CLI tools, with Markdown guidance and shell command examples for agents]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires Node.js 16.14.0+ and GUAIKEI_API_TOKEN; API responses may be logged as local JSON files.]\n\n## Skill Version(s):\n\n1.2.1 (source: server release evidence, frontmatter, package.json, changelog)\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\nFile v1.2.1:assets/comment_cli_req.schema.json\n\n{\r\n \"$schema\": \"http://json-schema.org/draft-07/schema#\",\r\n \"type\": \"object\",\r\n \"title\": \"抖音评论获取 - 命令行入参\",\r\n \"description\": \"抖音获取作品评论, 命令行参数入参Schema详解\",\r\n \"required\": [\r\n \"url\"\r\n ],\r\n \"properties\": {\r\n \"url\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音作品URL 或 作品aweme_id\"\r\n },\r\n \"limit\": {\r\n \"type\": \"number\",\r\n \"description\": \"获取评论数量\",\r\n \"minimum\": 1,\r\n \"maximum\": 10000,\r\n \"default\": 10\r\n }\r\n },\r\n \"additionalProperties\": false\r\n}\n\nFile v1.2.1:assets/comment_cli_resp.schema.json\n\n{\r\n \"$schema\": \"http://json-schema.org/draft-07/schema#\",\r\n \"type\": \"object\",\r\n \"title\": \"抖音评论获取 - API出参\",\r\n \"description\": \"抖音获取作品评论, API出参Schema详解\",\r\n \"properties\": {\r\n \"cid\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音评论ID\"\r\n },\r\n \"text\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音评论内容\"\r\n },\r\n \"create_time\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音评论发布时间戳\"\r\n },\r\n \"digg_count\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音评论点赞数\"\r\n },\r\n \"user_uid\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音评论者用户ID\"\r\n },\r\n \"user_nickname\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音评论者昵称\"\r\n },\r\n \"user_sec_uid\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音评论者SEC_UID\"\r\n },\r\n \"reply_comment_total\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音评论回复数\"\r\n },\r\n \"ip_label\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音评论者IP区域\"\r\n }\r\n }\r\n}\n\nFile v1.2.1:assets/hot_cli_resp.schema.json\n\n{\r\n \"$schema\": \"http://json-schema.org/draft-07/schema#\",\r\n \"type\": \"object\",\r\n \"title\": \"抖音热榜 - API出参\",\r\n \"description\": \"抖音实时热榜, API出参Schema详解\",\r\n \"required\": [\r\n \"word\",\r\n \"event_time\",\r\n \"hot_value\",\r\n \"position\",\r\n \"view_count\"\r\n ],\r\n \"properties\": {\r\n \"id\": {\r\n \"type\": \"number\",\r\n \"description\": \"自增ID\"\r\n },\r\n \"word\": {\r\n \"type\": \"string\",\r\n \"description\": \"热榜关键词\"\r\n },\r\n \"event_time\": {\r\n \"type\": \"number\",\r\n \"description\": \"事件发生时间\"\r\n },\r\n \"hot_value\": {\r\n \"type\": \"number\",\r\n \"description\": \"热榜值\"\r\n },\r\n \"position\": {\r\n \"type\": \"number\",\r\n \"description\": \"热榜排名\"\r\n },\r\n \"view_count\": {\r\n \"type\": \"number\",\r\n \"description\": \"关键词的搜索量\"\r\n },\r\n \"event_time_format\": {\r\n \"type\": \"string\",\r\n \"description\": \"事件发生时间格式化字符串\"\r\n }\r\n }\r\n}\n\nFile v1.2.1:assets/post_cli_req.schema.json\n\n{\r\n \"$schema\": \"http://json-schema.org/draft-07/schema#\",\r\n \"type\": \"object\",\r\n \"title\": \"抖音博主作品获取 - 命令行入参\",\r\n \"description\": \"抖音实时获取博主作品, 命令行参数入参Schema详解\",\r\n \"required\": [\r\n \"url\"\r\n ],\r\n \"properties\": {\r\n \"url\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音博主主页URL 或 抖音博主SEC_UID\"\r\n },\r\n \"limit\": {\r\n \"type\": \"number\",\r\n \"description\": \"获取作品数量\",\r\n \"minimum\": 1,\r\n \"maximum\": 10000,\r\n \"default\": 10\r\n }\r\n },\r\n \"additionalProperties\": false\r\n}\n\nFile v1.2.1:assets/post_cli_resp.schema.json\n\n{\r\n \"$schema\": \"http://json-schema.org/draft-07/schema#\",\r\n \"type\": \"object\",\r\n \"title\": \"抖音博主作品获取 - API出参\",\r\n \"description\": \"抖音实时获取博主作品, API出参Schema详解\",\r\n \"properties\": {\r\n \"aweme_id\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频ID\"\r\n },\r\n \"desc\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频描述\"\r\n },\r\n \"caption\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频描述\"\r\n },\r\n \"create_time\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音视频创建时间戳\"\r\n },\r\n \"music_title\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频音乐标题\"\r\n },\r\n \"music_author\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频音乐作者\"\r\n },\r\n \"music_duration\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音视频音乐时长\"\r\n },\r\n \"music_play_url\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频音乐播放URL\"\r\n },\r\n \"video_url\": {\r\n \"type\": \"array\",\r\n \"description\": \"视频播放地址、视频下载地址\",\r\n \"items\": {\r\n \"type\": \"string\",\r\n \"description\": \"视频播放地址、视频下载地址\"\r\n }\r\n },\r\n \"video_cover\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频封面URL\"\r\n },\r\n \"video_duration\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音视频时长\"\r\n },\r\n \"recommend_count\": {\r\n \"type\": \"number\",\r\n \"description\": \"交互界面未显示字段\"\r\n },\r\n \"comment_count\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音视频评论数\"\r\n },\r\n \"digg_count\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音视频点赞数\"\r\n },\r\n \"share_count\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音视频分享数\"\r\n },\r\n \"collect_count\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音视频收藏数\"\r\n },\r\n \"tags\": {\r\n \"type\": \"array\",\r\n \"description\": \"抖音视频标签\",\r\n \"items\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频标签\"\r\n }\r\n },\r\n \"share_url\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频分享URL\"\r\n }\r\n }\r\n}\n\nFile v1.2.1:assets/search_cli_req.schema.json\n\n{\r\n \"$schema\": \"http://json-schema.org/draft-07/schema#\",\r\n \"type\": \"object\",\r\n \"title\": \"抖音关键词搜索 - 命令行入参\",\r\n \"description\": \"抖音实时关键词搜索, 命令行参数入参Schema详解\",\r\n \"required\": [\r\n \"keyword\"\r\n ],\r\n \"properties\": {\r\n \"keyword\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音关键词搜索的关键词\",\r\n \"minLength\": 2,\r\n \"maxLength\": 50\r\n },\r\n \"sort\": {\r\n \"type\": \"number\",\r\n \"description\": \"排序方式: 0=综合排序 , 1=最多点赞 , 2=最新发布\",\r\n \"default\": 0,\r\n \"enum\": [\r\n 0,\r\n 1,\r\n 2\r\n ]\r\n },\r\n \"time\": {\r\n \"type\": \"number\",\r\n \"description\": \"时间范围: 0=全部 , 1=一天内 , 7=七天内 , 180=半年内\",\r\n \"default\": 0,\r\n \"enum\": [\r\n 0,\r\n 1,\r\n 7,\r\n 180\r\n ]\r\n },\r\n \"duration\": {\r\n \"type\": \"number\",\r\n \"description\": \"视频时长: 0=不限 , 1=1分钟以下 , 2=1-5分钟 , 3=5分钟以上\",\r\n \"default\": 0,\r\n \"enum\": [\r\n 0,\r\n 1,\r\n 2,\r\n 3\r\n ]\r\n },\r\n \"content\": {\r\n \"type\": \"number\",\r\n \"description\": \"内容类型, 0: 不限, 1: 视频, 2: 图文\",\r\n \"default\": 0,\r\n \"enum\": [\r\n 0,\r\n 1,\r\n 2\r\n ]\r\n },\r\n \"limit\": {\r\n \"type\": \"number\",\r\n \"description\": \"获取数量\",\r\n \"minimum\": 1,\r\n \"maximum\": 10000,\r\n \"default\": 10\r\n }\r\n },\r\n \"additionalProperties\": false\r\n}\n\nArchive v1.1.6: 33 files, 35915 bytes\n\nFiles: assets/comment_cli_req.schema.json (652b), assets/comment_cli_resp.schema.json (1311b), assets/hot_cli_resp.schema.json (1154b), assets/post_cli_req.schema.json (675b), assets/post_cli_resp.schema.json (2715b), assets/search_cli_req.schema.json (1618b), assets/search_cli_resp.schema.json (3435b), package.json (862b), readme.md (426b), references/changelog.md (4251b), references/options.md (3683b), skill-card.md (2906b), SKILL.md (13433b), src/api/comment.js (1988b), src/api/hot.js (919b), src/api/post.js (1612b), src/api/search.js (2879b), src/config/constants.js (464b), src/douyin/comment-cli.js (4575b), src/douyin/hot-cli.js (1947b), src/douyin/post-cli.js (4475b), src/douyin/search-cli.js (6047b), src/utils/errors.js (939b), src/utils/log.js (915b), src/utils/request.js (4594b), src/utils/retry.js (1149b), src/utils/token.js (1356b), src/utils/utils.js (1708b), src/validate/comment.js (905b), src/validate/hot.js (703b), src/validate/keyword.js (3929b), src/validate/post.js (942b), _meta.json (140b)\n\nFile v1.1.6:SKILL.md\n\n---\r\nname: douyin-search-keyword\r\ndescription: 抖音公开数据智能获取工具。支持抖音关键词搜索、抖人作品抓取、获取作品评论、实时热榜跟踪，适用于短视频营销、竞品分析、舆情分析和热点监控，助力爆款内容策划与流量追踪。\r\nlicense: MIT\r\nmetadata:\r\n version: 1.1.6\r\n enabled: true\r\n type: command\r\n runtime: \"nodejs@16.14.0+\"\r\n requires:\r\n bins:\r\n - \"node\"\r\n env:\r\n - \"GUAIKEI_API_TOKEN\"\r\n category:\r\n - \"Data&APIs\"\r\n - \"内容创作\"\r\n tags:\r\n - \"douyin\"\r\n - \"抖音\"\r\n - \"search\"\r\n - \"搜索\"\r\n - \"数据挖掘\"\r\n - \"content-analysis\"\r\n - \"营销分析\"\r\n - \"数据分析\"\r\n - \"competitor-analysis\"\r\n - \"竞品分析\"\r\n - \"评论分析\"\r\n - \"热点追踪\"\r\n - \"marketing\"\r\n - \"trend-tracking\"\r\n - \"workflow\"\r\n - \"insight\"\r\n - \"automation\"\r\n schemas:\r\n - name: \"搜索入参\"\r\n file: \"assets/search_cli_req.schema.json\"\r\n - name: \"搜索出参\"\r\n file: \"assets/search_cli_resp.schema.json\"\r\n - name: \"作品入参\"\r\n file: \"assets/post_cli_req.schema.json\"\r\n - name: \"作品出参\"\r\n file: \"assets/post_cli_resp.schema.json\"\r\n - name: \"热榜出参\"\r\n file: \"assets/hot_cli_resp.schema.json\"\r\n - name: \"评论入参\"\r\n file: \"assets/comment_cli_req.schema.json\"\r\n - name: \"评论出参\"\r\n file: \"assets/comment_cli_resp.schema.json\"\r\n examples:\r\n - name: 搜索 AI 教程视频\r\n command: 'node src/douyin/search-cli.js --keyword \"AI 教程\"'\r\n description: 用户说\"搜索 AI 教程\"时使用\r\n - name: 找点赞最多的视频\r\n command: 'node src/douyin/search-cli.js --keyword \"AI\" --sort 1'\r\n description: 用户说\"找最火的 AI 视频\"时使用\r\n - name: 最新发布的内容\r\n command: 'node src/douyin/search-cli.js --keyword \"AI 模型\" --time 7'\r\n description: 用户说\"最新的 AI 模型视频\"时使用\r\n - name: 搜索半年内最新20条 AI 教程视频\r\n command: 'node src/douyin/search-cli.js --keyword \"AI 教程\" --sort 2 --time 180 --limit 20'\r\n description: 用户说\"半年内最新 AI 教程视频\"时使用\r\n - name: 获取博主作品\r\n command: 'node src/douyin/post-cli.js --url \"https://www.douyin.com/user/MS4wLjABxxx\"'\r\n description: 用户说\"查看这个博主的作品\"时使用\r\n - name: 获取视频评论\r\n command: 'node src/douyin/comment-cli.js --url \"https://www.douyin.com/video/xxx\"'\r\n description: 用户说\"看看这个视频的评论\"时使用\r\n - name: 获取热榜\r\n command: \"node src/douyin/hot-cli.js\"\r\n description: 用户说\"抖音今天有什么热点\"时使用\r\n---\r\n\r\n# 🚀 抖音关键词搜索、竞品分析、舆情监控与热点跟踪工具 (Douyin Search & Analytics)\r\n\r\n> **💡一句话价值**：一键抓取抖音公开视频/作者/评论/热榜数据，帮你做爆款选题、竞品分析、舆情监控、热点追踪。\r\n>\r\n> **🔥核心优势**\r\n>\r\n> - 安全: 无需登录你的抖音账号，不担心风控风险 / 封号问题\r\n> - 强大: 一次可获取最多1W条数据，技能内置批量操作，使用简单方便\r\n> - 全面: 各功能出参数据全面，可见及有价值数据都会返回\r\n> - 灵活: 支持多维度筛选、批量操作\r\n> - 轻量: 无需部署服务，Node.js 一键运行\r\n> - 低耗: 日志自动归档，适配营销报告 / 内容策划场景 ，便于数据二次分析\r\n\r\n## 1. ✅ 我能帮你解决什么（10 秒判断）\r\n\r\n- 🔍 按关键词搜抖音视频（点赞/最新排序）：找爆款选题、分析高赞视频规律\r\n- 🦸 竞品监控：批量抓取对标账号所有公开作品数据，分析内容策略\r\n- 💬 评论分析：获取抖音评论详情，分析舆情方向\r\n- 📡 热点追流：实时获取抖音热榜，抢占流量风口\r\n- 📊 数据导出：自动生成JSON日志，方便对比分析和使用\r\n\r\n## 2. 🚀 最快上手（复制就能跑，30 秒出结果）\r\n\r\n> **Note:** 请先通过微信 <13395823479> 申请TOKEN ，或访问[抖音搜索技能官网](https://www.guaikei.com)开通TOKEN，配置环境变量 `GUAIKEI_API_TOKEN` 后才能正常运行。\r\n\r\n### 2.1 🔎 抖音关键词搜索（最简单）\r\n\r\n```bash\r\nnode src/douyin/search-cli.js --keyword \"AI\"\r\n```\r\n\r\n### 2.2 🔎 按点赞排序找爆款（最常用）\r\n\r\n```bash\r\nnode src/douyin/search-cli.js --keyword \"AI\" --sort 1\r\n```\r\n\r\n### 2.3 🦸 抓取抖音抖人全部作品\r\n\r\n```bash\r\nnode src/douyin/post-cli.js --url \"https://www.douyin.com/user/MS4wLjABxxx\"\r\n```\r\n\r\n### 2.4 💬 获取抖音作品评论内容\r\n\r\n```bash\r\nnode src/douyin/comment-cli.js --url \"https://www.douyin.com/video/xxx\"\r\n```\r\n\r\n### 2.5 📡 获取抖音实时热榜\r\n\r\n```bash\r\nnode src/douyin/hot-cli.js\r\n```\r\n\r\n## 3. 📌 适用场景（我该不该用？）\r\n\r\n- 你需要做短视频选题 → 关键词搜索 + 点赞排序\r\n- 你需要模仿爆款文案 → 查看高赞视频详情\r\n- 你需要监控竞品账号 → 批量抓取对方作品\r\n- 你需要分析内容舆情 → 获取抖音评论详情\r\n- 你需要快速追热点 → 实时获取抖音热榜\r\n- 你需要做营销报告 → 导出结构化数据\r\n\r\n## 4. 🔧 参数详解表\r\n\r\n> 详细选项参数说明， 可参阅 [完整选项说明](references/options.md)\r\n>\r\n> LLM理解技能的详细选项，可参阅技能 `assets` 目录中文件，其遵循 JSON Schema draft-07 版本规范。\r\n>\r\n> - 抖音关键词搜索，[入参规范](assets/search_cli_req.schema.json)\r\n> - 抖音关键词搜索，[出参规范](assets/search_cli_resp.schema.json)\r\n> - 抖音抖人作品获取，[入参规范](assets/post_cli_req.schema.json)\r\n> - 抖音抖人作品获取，[出参规范](assets/post_cli_resp.schema.json)\r\n> - 抖音评论获取，[入参规范](assets/comment_cli_req.schema.json)\r\n> - 抖音评论获取，[出参规范](assets/comment_cli_resp.schema.json)\r\n> - 抖音热榜获取，[出参规范](assets/hot_cli_resp.schema.json)\r\n\r\n## 5. ⚠️ 重要限制（不踩坑）\r\n\r\n- 仅抓取抖音公开数据，不支持私密 / 隐藏内容\r\n- 需要配置 GUAIKEI_API_TOKEN 才能正常运行\r\n- 数据仅限个人 / 团队内部使用，禁止违规分发\r\n\r\n## 6. ❓ 常见问题（秒解决）\r\n\r\n> **💡Q：运行报错，提示无权限？**\r\n>\r\n> A：配置环境变量：\r\n>\r\n> - Windows: `set GUAIKEI_API_TOKEN=你的TOKEN`\r\n> - Linux/MacOS: `export GUAIKEI_API_TOKEN=你的TOKEN`\r\n> - 私有TOKEN申请后请留意使用安全，避免泄露给他人\r\n>\r\n> **💡Q：搜索结果为空？**\r\n>\r\n> A：换常用关键词，或把 `--time` 改为 0（全部时间）\r\n>\r\n> **💡Q：输出文件在哪里？**\r\n>\r\n> A：自动保存在技能目录的 `logs` 文件夹下\r\n>\r\n> - 搜索任务日志: 默认保存为「时间戳\\_关键词\\_排序\\_时间\\_时长\\_search.json」\r\n> - 抖人作品获取日志: 默认保存为「时间戳\\_(抖人sec_uid)\\_post.json」\r\n> - 抖音评论获取日志: 默认保存为「时间戳\\_(视频aweme_id)\\_comment.json」\r\n>\r\n> **💡Q：支持 Windows/Mac/Linux 吗？**\r\n>\r\n> A：全平台支持，仅需安装 Node.js 环境\r\n\r\n## 7. 📞 帮助与支持\r\n\r\n- 联系微信 13395823479（备注抖音技能）开通TOKEN或获得技能使用支持；\r\n- 或通过 [抖音关键词搜索技能官网](https://www.guaikei.com) 自助开通TOKEN或查阅使用帮助。\r\n\r\n> 🆕 [更新日志](references/changelog.md) 可查阅这里\r\n\r\n## 8. 🛑 错误处理与重试策略（重要）\r\n\r\n### 8.1 遇到以下错误，立即停止操作并向用户报告\r\n\r\n- **权限错误**（AUTH_ERROR）：TOKEN 无效或已过期，请提示用户重新配置\r\n- **API 次数超限**：提示用户联系客服开通更高额度\r\n- **网络错误连续 3 次失败**：提示用户检查网络连接\r\n\r\n### 8.2 禁止行为\r\n\r\n- ❌ 不要在收到 AUTH_ERROR 后继续重试\r\n- ❌ 不要在 API 返回明确错误码后尝试修改参数重试\r\n- ❌ 不要在用户未明确要求的情况下自动调整搜索条件\r\n\r\n### 8.3 正确做法\r\n\r\n- ✅ 遇到错误，立即向用户展示错误信息\r\n- ✅ 询问用户是否需要调整参数或重新尝试\r\n- ✅ 对于网络超时，可以尝试最多 3 次之后停止\r\n\r\n## 9. 💬 自然语言指令映射（AI 快速参考）\r\n\r\n> **统一调用约定（重要）**\r\n>\r\n> - 必须在**技能根目录**执行。\r\n> - 需要被 AI / 程序解析时，加 `--json`：只输出纯 JSON 到 stdout，日志与 banner 走 stderr，便于稳定解析。\r\n> - 退出码约定：`0`=成功（含 empty），`1`=运行错误，`3`=auth_required（缺/错 token）。\r\n\r\n### 9.1 搜索功能\r\n\r\n| 用户口语化指令 | 对应命令 | 参数推导 |\r\n| --------------------------------- | ---------------------------------------------------------------------------------- | ---------------------------- |\r\n| \"搜索 / 搜一下 / 找 AI 相关视频\" | `node src/douyin/search-cli.js --keyword \"AI\"` | 带关键词即搜索 |\r\n| \"找点赞最多的 / 最火的 AI 视频\" | `node src/douyin/search-cli.js --keyword \"AI\" --sort 1` | 最火/点赞最多 → sort=1 |\r\n| \"最新的 AI 教程，要 20 条\" | `node src/douyin/search-cli.js --keyword \"AI 教程\" --sort 2 --limit 20` | 最新 → sort=2；数量 → limit |\r\n| \"近一周最火的短视频\" | `node src/douyin/search-cli.js --keyword \"短视频\" --time 7 --sort 1` | 一周 → time=7；最火 → sort=1 |\r\n| \"半年内最新 20 条 AI 教程\" | `node src/douyin/search-cli.js --keyword \"AI 教程\" --sort 2 --time 180 --limit 20` | 半年 → time=180 |\r\n| \"减肥视频，只要 1 分钟以下的\" | `node src/douyin/search-cli.js --keyword \"减肥\" --duration 1` | 见下方 duration 表 |\r\n| \"AI 模型，5 分钟以上的，前 50 条\" | `node src/douyin/search-cli.js --keyword \"AI 模型\" --duration 3 --limit 50` | 5分钟以上 → duration=3 |\r\n\r\n### 9.2 竞品监控\r\n\r\n| 用户口语化指令 | 对应命令 | 参数推导 |\r\n| ------------------------------- | ----------------------------------------------------------------------------- | --------------------- |\r\n| \"查看这个博主的所有作品 / 主页\" | `node src/douyin/post-cli.js --url \"https://www.douyin.com/user/MS4wLjABxxx\"` | 作品/主页/账号 → post |\r\n| \"抓取 MS4wLjABxxx 的作品\" | `node src/douyin/post-cli.js --url \"MS4wLjABxxx\"` | sec_uid 直接可用 |\r\n| \"获取他最近 50 条视频\" | `node src/douyin/post-cli.js --url \"xxx\" --limit 50` | 数量 → limit |\r\n\r\n### 9.3 评论分析\r\n\r\n| 用户口语化指令 | 对应命令 | 参数推导 |\r\n| --------------------------- | ------------------------------------------------------------------------- | ------------------- |\r\n| \"看看这个视频的评论 / 留言\" | `node src/douyin/comment-cli.js --url \"https://www.douyin.com/video/xxx\"` | 评论/留言 → comment |\r\n| \"获取这条视频的 100 条评论\" | `node src/douyin/comment-cli.js --url \"xxx\" --limit 100` | 数量 → limit |\r\n\r\n### 9.4 热榜\r\n\r\n| 用户口语化指令 | 对应命令 |\r\n| ---------------------------------------- | ---------------------------- |\r\n| \"抖音今天有什么热点 / 热搜榜 / 热点榜单\" | `node src/douyin/hot-cli.js` |\r\n\r\n## 10. 🧠 AI 意图识别规则\r\n\r\n### 10.1 识别优先级（从上到下）\r\n\r\n1. **热搜 / 热点 / 榜单 / 今天什么火** → `hot-cli.js`\r\n2. **搜索 / 搜一下 / 找 + 关键词** → `search-cli.js`\r\n3. **评论 / 留言 / 弹幕** → `comment-cli.js`（必须出现\"评论\"类词才归此类）\r\n4. **作品 / 视频(指博主内容) / 主页 / 账号 / 博主** → `post-cli.js`\r\n\r\n> ⚠️ 歧义提示：单独出现\"视频\"二字时，**不要默认归到 post-cli**。\r\n>\r\n> - 若同时有\"关键词\"且无\"评论\" → 视为 `search`（用户想搜某个视频）。\r\n> - 若明确\"这个视频的评论/留言\" → `comment`。\r\n> - 仅当\"作品/主页/账号/博主\"出现时才用 `post`。\r\n\r\n### 10.2 参数推断规则\r\n\r\n**排序（sort，与 time 正交）**\r\n\r\n- 提到\"综合 / 默认\" → `sort=0`\r\n- 提到\"点赞最多 / 最火 / 爆款\" → `sort=1`\r\n- 提到\"最新 / 最近发布 / 刚发\" → `sort=2`\r\n\r\n**时间窗（time）**\r\n\r\n- 提到\"全部 / 不限制\" → `time=0`\r\n- 提到\"一天 / 24小时\" → `time=1`\r\n- 提到\"一周 / 7天\" → `time=7`\r\n- 提到\"半年\" → `time=180`\r\n\r\n**时长**\r\n\r\n- 提到\"1分钟以下 / 短于1分钟\" → `duration=1`\r\n- 提到\"1到5分钟 / 1-5分钟\" → `duration=2`\r\n- 提到\"5分钟以上\" → `duration=3`\r\n- 提到\"不限时长\" → `duration=0`\r\n\r\n**数量（limit）**\r\n\r\n- 提到\"条数 / 数量 / N条 / 前N条\" → `limit=N`\r\n\r\n### 10.3 默认值\r\n\r\n- sort: 0（综合）｜time: 0（全部）｜duration: 0（不限）｜limit: 10\n\nFile v1.1.6:readme.md\n\n# Skill Name: 抖音关键词搜索、竞品分析与热榜监控工具 (Douyin Search & Analytics)\r\n\r\n## Description\r\n\r\n抖音公开数据智能分析工具。支持**关键词搜索排序**、**抖人作品抓取**、**实时热榜获取**，适用于短视频营销、竞品分析和热点监控，助力爆款内容策划与流量追踪。\r\n\r\n## Change Log\r\n\r\n🆕 [更新日志](references/changelog.md) 可查阅这里\n\nFile v1.1.6:_meta.json\n\n{\n \"ownerId\": \"kn79p9y6xrdxyr0maxy3tj5nb9835e0e\",\n \"slug\": \"douyin-search-keyword\",\n \"version\": \"1.1.6\",\n \"publishedAt\": 1785256702249\n}\n\nFile v1.1.6:references/changelog.md\n\n# 抖音关键词搜索 (Douyin Search & Analytics) 更新日志\r\n\r\n## 1.1.6 - 2026-07-29\r\n\r\n- 优化技能各项功能，提升用户体验。\r\n- 增加skill.md文件对AI的说明，更清晰指引功能使用方式。\r\n\r\n## 1.1.5 - 2026-06-18\r\n\r\n- 新增抖音视频评论获取功能，支持抓取并分析指定作品的评论内容。\r\n- 更新 schema，新增评论入参与出参 JSON Schema 规范，完善数据结构。\r\n- SKILL.md 说明文档同步更新，增加评论分析与用法示例。\r\n\r\n## 1.1.4 - 2026-06-09\r\n\r\n- 新增多份 JSON 模式文件，用于命令行结构化输入输出校验。\r\n- 在 references/ 目录下添加文档：更新日志（changelog.md）、配置说明（options.md）。\r\n- 优化 SKILL.md：补充模式文件引用，并完善令牌获取相关说明。\r\n- 为技能元数据补充模式定义，提升兼容性与自检能力。\r\n\r\n## 1.1.3 - 2026-05-11\r\n\r\n**新增：支持获取抖音作者（抖人）已发布作品，实现竞品账号内容批量抓取。**\r\n\r\n- 新增 post-cli 指令，可根据抖音主页 URL 或 sec_uid 一键获取创作者所有公开作品，便于竞品监控和账号内容分析。\r\n- 参数说明、使用范例及常见问题等文档内容同步更新，更清晰指引新功能使用方式。\r\n- 指令参数支持短缩写，limit上限提升至200，提升批量数据抓取能力。\r\n- 关键词搜索、热榜等原有功能保持兼容并优化参数配置，提升整体易用性。\r\n- 调整并精简 Skill 文档，增加使用案例，强调 TOKEN 申请与日志留存说明。\r\n- 示例与文档同步完善，能力标签更明确。\r\n\r\n## 1.1.2 - 2026-05-04\r\n\r\n- 新增支持抖音热搜榜单查询（hot-cli.js），可独立调用。\r\n- 关键词搜索与热榜查询分别独立为入口（search-cli.js/hot-cli.js）。\r\n- 项目结构优化，API与工具模块化拆分，便于维护与扩展。\r\n- 移除旧 scripts/lib 目录，迁移为 src/api、src/utils、src/validate 目录。\r\n- 更新文档与示例，增强上手指引与使用场景说明。\r\n\r\n## 1.1.1 - 2026-03-31\r\n\r\n- 更新 JSON 响应中的输出字段，明确标记更多字段，提高下游解析的一致性。\r\n- 无功能或界面变更;文档现在准确反映了输出模式中始终存在的字段。\r\n\r\n## 1.1.0 - 2026-03-31\r\n\r\n**重大升级：结构化输出、多参数排序与筛选能力增强**\r\n\r\n- 增加多维度排序（综合/最多点赞/最新发布）和发布时间筛选（1天/7天/半年），结果更精准。\r\n- 支持自定义返回数量（1~60条）。\r\n- 完全结构化 JSON 输出，字段覆盖互动数据、标签等，适配 OpenClaw 生态。\r\n- 内置参数合法性校验、敏感词过滤及安全保护，保证调用稳定合规。\r\n- 增强任务轮询&超时重试机制，提升检索成功率和稳定性。\r\n- 技能文档全面更新，提供详细参数表、示例与应用场景说明。\r\n\r\n## 1.0.2 - 2026-03-24\r\n\r\n- 技能重命名为“douyin-search-keyword”。\r\n- 在SKILL.md中添加了openclaw元数据、使用帮助、许可证、标签和示例，以实现更好的集成与文档化。\r\n- 移除了两个本地文件（.env 和 scripts/last-search.json），以优化代码结构并提升安全性。\r\n- 文档现已更加简洁且以用户为中心，重点在于提供清晰的使用说明和数据字段解释。\r\n- 突出技能特性、合规要点及技术流程。\r\n\r\n## 1.0.1 - 2026-3-20\r\n\r\n- 更新技能描述，强调支持多维度抖音公开内容检索（视频、图文、用户等）\r\n- 扩展文档，新增适用/不适用场景说明\r\n- 新增环境和token配置的详细步骤与平台限制说明\r\n- 明确数据字段及样例，补充表格形式字段解释\r\n- 强调合规、风控及临时链接有效期注意事项\r\n\r\n## 1.0.0 - 2026-03-18\r\n\r\n- douyin-search-general 技能首次发布。\r\n- 提供抖音通用搜索接口，支持视频、图文、用户及社交数据搜索。\r\n- 返回详细信息，包括内容描述、作者、发布时间、点赞数、评论数、分享数、封面图片及视频链接。\r\n- 需要Node.js和有效的GUAIKEI_API_TOKEN环境变量才能运行。\r\n- 输出包含可直接复制的URL，并附有示例响应格式说明。\n\nFile v1.1.6:references/options.md\n\n# 抖音关键词搜索 (Douyin Search & Analytics) 完整选项参数说明\r\n\r\n## 🔎 抖音关键词搜索\r\n\r\n| 参数 | 缩写 | 作用 | 可选值 | 必填 | 默认值 |\r\n| :----------- | :--: | :----------- | :----------------------------------------------------- | :--- | :----: |\r\n| `--keyword` | `-k` | 搜索关键词 | 2-50 位长度的汉字或单词 | 是 | |\r\n| `--sort` | `-s` | 排序方式 | 0 = 综合排序 / 1 = 最多点赞 / 2 = 最新发布 | 否 | 0 |\r\n| `--time` | `-t` | 时间范围 | 0 = 全部 / 1 = 一天内 / 7 = 七天内 / 180 = 半年内 | 否 | 0 |\r\n| `--duration` | `-d` | 视频时长 | 0 = 不限 / 1 = 1分钟以下 / 2 = 1-5分钟 / 3 = 5分钟以上 | 否 | 0 |\r\n| `--limit` | `-l` | 获取数量 | 1-10000 条 | 否 | 10 |\r\n| `--help` | `-h` | 显示帮助信息 | | 否 | |\r\n\r\n```bash\r\n# **基础语法**\r\nnode src/douyin/search-cli.js --keyword <关键词> --sort <排序方式> --time <时间范围> --duration <视频时长> --limit <获取数量>\r\n\r\n# **使用示例**\r\n\r\n# 搜索\"AI 教程\"的抖音内容\r\nnode src/douyin/search-cli.js --keyword \"AI 教程\"\r\n\r\n# 搜索 AI 获取最多点赞的抖音内容\r\nnode src/douyin/search-cli.js --keyword \"AI\" --sort 1\r\n\r\n# 搜索近7天\"AI 模型\"的抖音内容\r\nnode src/douyin/search-cli.js --keyword \"AI 模型\" --time 7\r\n\r\n# 搜索\"AI 教程\"视频时长在5分钟以上的抖音内容\r\nnode src/douyin/search-cli.js --keyword \"AI 教程\" --duration 3\r\n\r\n# 搜索半年内最新20条\"AI 教程\"的抖音内容\r\nnode src/douyin/search-cli.js --keyword \"AI 教程\" --sort 2 --time 180 --limit 20\r\n```\r\n\r\n## 🦸 抖音抖人作品获取\r\n\r\n| 参数 | 缩写 | 作用 | 可选值 | 必填 | 默认值 |\r\n| :-------- | :--: | :------------------- | :--------- | :--- | :----: |\r\n| `--url` | `-u` | 抖人主页URL或sec_uid | | 是 | |\r\n| `--limit` | `-l` | 获取作品数量 | 1-10000 条 | 否 | 10 |\r\n| `--help` | `-h` | 显示帮助信息 | | 否 | |\r\n\r\n> **💡\"抖人主页URL\"说明**\r\n>\r\n> - PC端 ( 格式： )\r\n> - 移动端 ( 格式： )\r\n> - 技能关键词搜索返回的author_sec_uid字段\r\n\r\n```bash\r\n# **基础语法**\r\nnode src/douyin/post-cli.js --url \"https://www.douyin.com/user/MS4wLjABxxx\"\r\n\r\n# **使用示例**\r\n\r\n# 获取抖人 MS4wLjABxxx 已发布的20条作品\r\nnode src/douyin/post-cli.js --url \"https://www.douyin.com/user/MS4wLjABxxx\" --limit 20\r\n```\r\n\r\n## 💬 抖音作品评论数据\r\n\r\n| 参数 | 缩写 | 作用 | 可选值 | 必填 | 默认值 |\r\n| :-------- | :--: | :---------------------------- | :--------- | :--- | :----: |\r\n| `--url` | `-u` | 抖音视频(或图文)URL或aweme_id | | 是 | |\r\n| `--limit` | `-l` | 获取评论数量 | 1-10000 条 | 否 | 10 |\r\n| `--help` | `-h` | 显示帮助信息 | | 否 | |\r\n\r\n```bash\r\n# **基础语法**\r\nnode src/douyin/comment-cli.js --url \"https://www.douyin.com/video/xxx\"\r\n\r\n# **使用示例**\r\n\r\n# 获取视频 xxx 的100条评论\r\nnode src/douyin/comment-cli.js --url \"https://www.douyin.com/video/xxx\" --limit 100\r\n```\r\n\r\n## 📡 抖音热搜榜单\r\n\r\n- 无需参数\r\n\r\n```bash\r\n# **基础语法**\r\nnode src/douyin/hot-cli.js\r\n```\n\nFile v1.1.6:skill-card.md\n\n## Description:
\n抖音公开数据智能获取工具。支持抖音关键词搜索、抖人作品抓取、获取作品评论、实时热榜跟踪，适用于短视频营销、竞品分析、舆情分析和热点监控，助力爆款内容策划与流量追踪。
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[um-why](https://clawhub.ai/user/um-why)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nExternal users and content-analysis teams use this skill to search public Douyin videos, inspect creator posts, retrieve comments, and monitor hot lists for marketing, competitor analysis, sentiment review, and trend tracking.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: The skill can collect public Douyin user, video, and comment data at scale.
\nMitigation: Use it only for lawful, platform-compliant analysis and avoid collecting more data than needed for the task.
\nRisk: Search, post, and comment outputs are saved locally by default and may contain user comments, identifiers, or sensitive topics.
\nMitigation: Store logs in protected locations, delete them when no longer needed, and avoid running the skill in synced, shared, CI, or regulated-data workspaces without review.
\nRisk: The configured GUAIKEI_API_TOKEN is sent to guaikei.com for API requests.
\nMitigation: Keep the token out of shared environments, rotate it if exposed, and review installation before use on shared machines.
\n\n\n## Reference(s):
\n- [ClawHub skill page](https://clawhub.ai/um-why/skills/douyin-search-keyword)
\n- [Guaikei token and support site](https://www.guaikei.com)
\n- [Options reference](references/options.md)
\n- [Changelog](references/changelog.md)
\n- [Search request schema](assets/search_cli_req.schema.json)
\n- [Search response schema](assets/search_cli_resp.schema.json)
\n- [Post response schema](assets/post_cli_resp.schema.json)
\n- [Comment response schema](assets/comment_cli_resp.schema.json)
\n- [Hot list response schema](assets/hot_cli_resp.schema.json)
\n\n\n## Skill Output:
\n**Output Type(s):** [shell commands, JSON, files, configuration, guidance]
\n**Output Format:** [CLI commands with JSON stdout and JSON log files]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Requires Node.js 16.14.0+ and GUAIKEI_API_TOKEN; search, post, and comment commands save JSON logs locally by default.]
\n\n## Skill Version(s):
\n1.1.6 (source: server release evidence, SKILL.md frontmatter, package.json)
\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\nFile v1.1.6:assets/comment_cli_req.schema.json\n\n{\r\n \"$schema\": \"http://json-schema.org/draft-07/schema#\",\r\n \"type\": \"object\",\r\n \"title\": \"抖音评论获取 - 命令行入参\",\r\n \"description\": \"抖音获取作品评论, 命令行参数入参Schema详解\",\r\n \"required\": [\r\n \"url\"\r\n ],\r\n \"properties\": {\r\n \"url\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音作品URL 或 作品aweme_id\"\r\n },\r\n \"limit\": {\r\n \"type\": \"number\",\r\n \"description\": \"获取评论数量\",\r\n \"minimum\": 1,\r\n \"maximum\": 10000,\r\n \"default\": 10\r\n }\r\n },\r\n \"additionalProperties\": false\r\n}\n\nFile v1.1.6:assets/comment_cli_resp.schema.json\n\n{\r\n \"$schema\": \"http://json-schema.org/draft-07/schema#\",\r\n \"type\": \"object\",\r\n \"title\": \"抖音评论获取 - API出参\",\r\n \"description\": \"抖音获取作品评论, API出参Schema详解\",\r\n \"properties\": {\r\n \"cid\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音评论ID\"\r\n },\r\n \"text\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音评论内容\"\r\n },\r\n \"create_time\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音评论发布时间戳\"\r\n },\r\n \"digg_count\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音评论点赞数\"\r\n },\r\n \"user_uid\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音评论者用户ID\"\r\n },\r\n \"user_nickname\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音评论者昵称\"\r\n },\r\n \"user_sec_uid\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音评论者SEC_UID\"\r\n },\r\n \"reply_comment_total\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音评论回复数\"\r\n },\r\n \"ip_label\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音评论者IP区域\"\r\n }\r\n }\r\n}\n\nFile v1.1.6:assets/hot_cli_resp.schema.json\n\n{\r\n \"$schema\": \"http://json-schema.org/draft-07/schema#\",\r\n \"type\": \"object\",\r\n \"title\": \"抖音热榜 - API出参\",\r\n \"description\": \"抖音实时热榜, API出参Schema详解\",\r\n \"required\": [\r\n \"word\",\r\n \"event_time\",\r\n \"hot_value\",\r\n \"position\",\r\n \"view_count\"\r\n ],\r\n \"properties\": {\r\n \"id\": {\r\n \"type\": \"number\",\r\n \"description\": \"自增ID\"\r\n },\r\n \"word\": {\r\n \"type\": \"string\",\r\n \"description\": \"热榜关键词\"\r\n },\r\n \"event_time\": {\r\n \"type\": \"number\",\r\n \"description\": \"事件发生时间\"\r\n },\r\n \"hot_value\": {\r\n \"type\": \"number\",\r\n \"description\": \"热榜值\"\r\n },\r\n \"position\": {\r\n \"type\": \"number\",\r\n \"description\": \"热榜排名\"\r\n },\r\n \"view_count\": {\r\n \"type\": \"number\",\r\n \"description\": \"关键词的搜索量\"\r\n },\r\n \"event_time_format\": {\r\n \"type\": \"string\",\r\n \"description\": \"事件发生时间格式化字符串\"\r\n }\r\n }\r\n}\n\nFile v1.1.6:assets/post_cli_req.schema.json\n\n{\r\n \"$schema\": \"http://json-schema.org/draft-07/schema#\",\r\n \"type\": \"object\",\r\n \"title\": \"抖音抖人作品获取 - 命令行入参\",\r\n \"description\": \"抖音实时获取博主作品, 命令行参数入参Schema详解\",\r\n \"required\": [\r\n \"url\"\r\n ],\r\n \"properties\": {\r\n \"url\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音博主主页URL 或 抖音博主SEC_UID\"\r\n },\r\n \"limit\": {\r\n \"type\": \"number\",\r\n \"description\": \"获取作品数量\",\r\n \"minimum\": 1,\r\n \"maximum\": 10000,\r\n \"default\": 10\r\n }\r\n },\r\n \"additionalProperties\": false\r\n}\n\nFile v1.1.6:assets/post_cli_resp.schema.json\n\n{\r\n \"$schema\": \"http://json-schema.org/draft-07/schema#\",\r\n \"type\": \"object\",\r\n \"title\": \"抖音抖人作品获取 - API出参\",\r\n \"description\": \"抖音实时获取博主作品, API出参Schema详解\",\r\n \"properties\": {\r\n \"aweme_id\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频ID\"\r\n },\r\n \"desc\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频描述\"\r\n },\r\n \"caption\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频描述\"\r\n },\r\n \"create_time\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音视频创建时间戳\"\r\n },\r\n \"music_title\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频音乐标题\"\r\n },\r\n \"music_author\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频音乐作者\"\r\n },\r\n \"music_duration\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音视频音乐时长\"\r\n },\r\n \"music_play_url\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频音乐播放URL\"\r\n },\r\n \"video_url\": {\r\n \"type\": \"array\",\r\n \"description\": \"视频播放地址、视频下载地址\",\r\n \"items\": {\r\n \"type\": \"string\",\r\n \"description\": \"视频播放地址、视频下载地址\"\r\n }\r\n },\r\n \"video_cover\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频封面URL\"\r\n },\r\n \"video_duration\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音视频时长\"\r\n },\r\n \"recommend_count\": {\r\n \"type\": \"number\",\r\n \"description\": \"交互界面未显示字段\"\r\n },\r\n \"comment_count\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音视频评论数\"\r\n },\r\n \"digg_count\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音视频点赞数\"\r\n },\r\n \"share_count\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音视频分享数\"\r\n },\r\n \"collect_count\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音视频收藏数\"\r\n },\r\n \"tags\": {\r\n \"type\": \"array\",\r\n \"description\": \"抖音视频标签\",\r\n \"items\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频标签\"\r\n }\r\n },\r\n \"share_url\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频分享URL\"\r\n }\r\n }\r\n}\n\nFile v1.1.6:assets/search_cli_req.schema.json\n\n{\r\n \"$schema\": \"http://json-schema.org/draft-07/schema#\",\r\n \"type\": \"object\",\r\n \"title\": \"抖音关键词搜索 - 命令行入参\",\r\n \"description\": \"抖音实时关键词搜索, 命令行参数入参Schema详解\",\r\n \"required\": [\r\n \"keyword\"\r\n ],\r\n \"properties\": {\r\n \"keyword\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音关键词搜索的关键词\",\r\n \"minLength\": 2,\r\n \"maxLength\": 50\r\n },\r\n \"sort\": {\r\n \"type\": \"number\",\r\n \"description\": \"排序方式: 0=综合排序 , 1=最多点赞 , 2=最新发布\",\r\n \"default\": 0,\r\n \"enum\": [\r\n 0,\r\n 1,\r\n 2\r\n ]\r\n },\r\n \"time\": {\r\n \"type\": \"number\",\r\n \"description\": \"时间范围: 0=全部 , 1=一天内 , 7=七天内 , 180=半年内\",\r\n \"default\": 0,\r\n \"enum\": [\r\n 0,\r\n 1,\r\n 7,\r\n 180\r\n ]\r\n },\r\n \"duration\": {\r\n \"type\": \"number\",\r\n \"description\": \"视频时长: 0=不限 , 1=1分钟以下 , 2=1-5分钟 , 3=5分钟以上\",\r\n \"default\": 0,\r\n \"enum\": [\r\n 0,\r\n 1,\r\n 2,\r\n 3\r\n ]\r\n },\r\n \"limit\": {\r\n \"type\": \"number\",\r\n \"description\": \"获取数量\",\r\n \"minimum\": 1,\r\n \"maximum\": 10000,\r\n \"default\": 10\r\n }\r\n },\r\n \"additionalProperties\": false\r\n}\n\nArchive v1.1.5: 32 files, 33353 bytes\n\nFiles: assets/comment_cli_req.schema.json (652b), assets/comment_cli_resp.schema.json (1311b), assets/hot_cli_resp.schema.json (1154b), assets/post_cli_req.schema.json (675b), assets/post_cli_resp.schema.json (2715b), assets/search_cli_req.schema.json (1618b), assets/search_cli_resp.schema.json (3435b), package.json (862b), references/changelog.md (4143b), references/options.md (3683b), skill-card.md (3196b), SKILL.md (7684b), src/api/comment.js (1979b), src/api/hot.js (919b), src/api/post.js (1612b), src/api/search.js (2879b), src/config/constants.js (464b), src/douyin/comment-cli.js (4479b), src/douyin/hot-cli.js (1905b), src/douyin/post-cli.js (4375b), src/douyin/search-cli.js (5947b), src/utils/errors.js (868b), src/utils/log.js (656b), src/utils/request.js (4252b), src/utils/retry.js (1030b), src/utils/token.js (1356b), src/utils/utils.js (1604b), src/validate/comment.js (905b), src/validate/hot.js (703b), src/validate/keyword.js (3929b), src/validate/post.js (942b), _meta.json (140b)\n\nFile v1.1.5:SKILL.md\n\n---\r\nname: douyin-search-keyword\r\ndescription: 抖音公开数据智能获取工具。支持抖音关键词搜索、抖人作品抓取、获取作品评论、实时热榜跟踪，适用于短视频营销、竞品分析、舆情分析和热点监控，助力爆款内容策划与流量追踪。\r\nversion: 1.1.5\r\nlicense: MIT\r\nmetadata:\r\n enabled: true\r\n type: command\r\n runtime: \"nodejs@16.14.0+\"\r\n requires:\r\n bins:\r\n - \"node\"\r\n env:\r\n - \"GUAIKEI_API_TOKEN\"\r\n category:\r\n - \"Data&APIs\"\r\n - \"内容创作\"\r\n tags:\r\n - \"douyin\"\r\n - \"抖音\"\r\n - \"search\"\r\n - \"搜索\"\r\n - \"数据挖掘\"\r\n - \"content-analysis\"\r\n - \"营销分析\"\r\n - \"数据分析\"\r\n - \"competitor-analysis\"\r\n - \"竞品分析\"\r\n - \"评论分析\"\r\n - \"热点追踪\"\r\n - \"marketing\"\r\n - \"trend-tracking\"\r\n - \"workflow\"\r\n - \"insight\"\r\n - \"automation\"\r\n schemas:\r\n - name: \"搜索入参\"\r\n file: \"assets/search_cli_req.schema.json\"\r\n - name: \"搜索出参\"\r\n file: \"assets/search_cli_resp.schema.json\"\r\n - name: \"作品入参\"\r\n file: \"assets/post_cli_req.schema.json\"\r\n - name: \"作品出参\"\r\n file: \"assets/post_cli_resp.schema.json\"\r\n - name: \"热榜出参\"\r\n file: \"assets/hot_cli_resp.schema.json\"\r\n - name: \"评论入参\"\r\n file: \"assets/comment_cli_req.schema.json\"\r\n - name: \"评论出参\"\r\n file: \"assets/comment_cli_resp.schema.json\"\r\n examples:\r\n - name: 搜索\"AI 教程\"的抖音内容\r\n command: 'node src/douyin/search-cli.js --keyword \"AI 教程\"'\r\n description: 快速获取关键词相关视频数据，助力内容创作灵感\r\n - name: 搜索 AI 获取最多点赞的抖音内容\r\n command: 'node src/douyin/search-cli.js --keyword \"AI\" --sort 1'\r\n description: 挖掘爆款视频特征，优化内容策略\r\n - name: 搜索近7天\"AI 模型\"的抖音内容\r\n command: 'node src/douyin/search-cli.js --keyword \"AI 模型\" --time 7'\r\n description: 追踪近期热点趋势，把握内容窗口期\r\n - name: 搜索半年内最新20条\"AI 教程\"的抖音内容\r\n command: 'node src/douyin/search-cli.js --keyword \"AI 教程\" --sort 2 --time 180 --limit 20'\r\n description: 监控长期内容趋势，制定内容规划\r\n - name: 获取抖人 MS4wLjABxxx 已发布的作品\r\n command: 'node src/douyin/post-cli.js --url \"https://www.douyin.com/user/MS4wLjABxxx\"'\r\n description: 获取抖人已发布的作品，助力竞品分析\r\n - name: 获取抖音作品 https://www.douyin.com/video/xxx 评论区内容\r\n command: 'node src/douyin/comment-cli.js --url \"https://www.douyin.com/video/xxx\"'\r\n description: 获取抖音评论详情，分析舆情方向\r\n - name: 获取抖音实时热搜榜单\r\n command: \"node src/douyin/hot-cli.js\"\r\n description: 实时掌握平台热点，快速响应热门话题\r\n---\r\n\r\n# 🚀 抖音关键词搜索、竞品分析、舆情监控与热点跟踪工具 (Douyin Search & Analytics)\r\n\r\n> **💡一句话价值**：一键抓取抖音公开视频/作者/评论/热榜数据，帮你做爆款选题、竞品分析、舆情监控、热点追踪。\r\n>\r\n> **🔥核心优势**\r\n>\r\n> - 安全: 无需登录你的抖音账号，不担心风控风险 / 封号问题\r\n> - 强大: 一次可获取最多1W条数据，技能内置批量操作，使用简单方便\r\n> - 全面: 各功能出参数据全面，可见及有价值数据都会返回\r\n> - 灵活: 支持多维度筛选、批量操作\r\n> - 轻量: 无需部署服务，Node.js 一键运行\r\n> - 低耗: 日志自动归档，适配营销报告 / 内容策划场景 ，便于数据二次分析\r\n\r\n## 1. ✅ 我能帮你解决什么（10 秒判断）\r\n\r\n- 🔍 按关键词搜抖音视频（点赞/最新排序）：找爆款选题、分析高赞视频规律\r\n- 🦸 竞品监控：批量抓取对标账号所有公开作品数据，分析内容策略\r\n- 💬 评论分析：获取抖音评论详情，分析舆情方向\r\n- 📡 热点追流：实时获取抖音热榜，抢占流量风口\r\n- 📊 数据导出：自动生成JSON日志，方便对比分析和使用\r\n\r\n## 2. 🚀 最快上手（复制就能跑，30 秒出结果）\r\n\r\n> **Note:** 请先通过微信 <13395823479> 申请TOKEN ，或访问[抖音搜索技能官网](https://www.guaikei.com)开通TOKEN，配置环境变量 `GUAIKEI_API_TOKEN` 后才能正常运行。\r\n\r\n### 2.1 🔎 抖音关键词搜索（最简单）\r\n\r\n```bash\r\nnode src/douyin/search-cli.js --keyword \"AI\"\r\n```\r\n\r\n### 2.2 🔎 按点赞排序找爆款（最常用）\r\n\r\n```bash\r\nnode src/douyin/search-cli.js --keyword \"AI\" --sort 1\r\n```\r\n\r\n### 2.3 🦸 抓取抖音抖人全部作品\r\n\r\n```bash\r\nnode src/douyin/post-cli.js --url \"https://www.douyin.com/user/MS4wLjABxxx\"\r\n```\r\n\r\n### 2.4 💬 获取抖音作品评论内容\r\n\r\n```bash\r\nnode src/douyin/comment-cli.js --url \"https://www.douyin.com/video/xxx\"\r\n```\r\n\r\n### 2.5 📡 获取抖音实时热榜\r\n\r\n```bash\r\nnode src/douyin/hot-cli.js\r\n```\r\n\r\n## 3. 📌 适用场景（我该不该用？）\r\n\r\n- 你需要做短视频选题 → 关键词搜索 + 点赞排序\r\n- 你需要模仿爆款文案 → 查看高赞视频详情\r\n- 你需要监控竞品账号 → 批量抓取对方作品\r\n- 你需要分析内容舆情 → 获取抖音评论详情\r\n- 你需要快速追热点 → 实时获取抖音热榜\r\n- 你需要做营销报告 → 导出结构化数据\r\n\r\n## 4. 🔧 参数详解表\r\n\r\n> 详细选项参数说明， 可参阅 [完整选项说明](references/options.md)\r\n>\r\n> LLM理解技能的详细选项，可参阅技能 `assets` 目录中文件，其遵循 JSON Schema draft-07 版本规范。\r\n>\r\n> - 抖音关键词搜索，[入参规范](assets/search_cli_req.schema.json)\r\n> - 抖音关键词搜索，[出参规范](assets/search_cli_resp.schema.json)\r\n> - 抖音抖人作品获取，[入参规范](assets/post_cli_req.schema.json)\r\n> - 抖音抖人作品获取，[出参规范](assets/post_cli_resp.schema.json)\r\n> - 抖音评论获取，[入参规范](assets/comment_cli_req.schema.json)\r\n> - 抖音评论获取，[出参规范](assets/comment_cli_resp.schema.json)\r\n> - 抖音热榜获取，[出参规范](assets/hot_cli_resp.schema.json)\r\n\r\n## 5. ⚠️ 重要限制（不踩坑）\r\n\r\n- 仅抓取抖音公开数据，不支持私密 / 隐藏内容\r\n- 需要配置 GUAIKEI_API_TOKEN 才能正常运行\r\n- 数据仅限个人 / 团队内部使用，禁止违规分发\r\n\r\n## 6. ❓ 常见问题（秒解决）\r\n\r\n> **💡Q：运行报错，提示无权限？**\r\n>\r\n> A：配置环境变量：\r\n>\r\n> - Windows: `set GUAIKEI_API_TOKEN=你的TOKEN`\r\n> - Linux/MacOS: `export GUAIKEI_API_TOKEN=你的TOKEN`\r\n>\r\n> - 私有TOKEN申请后请留意使用安全，避免泄露给他人\r\n>\r\n> **💡Q：搜索结果为空？**\r\n>\r\n> A：换常用关键词，或把 `--time` 改为 0（全部时间）\r\n>\r\n> **💡Q：输出文件在哪里？**\r\n>\r\n> A：自动保存在技能目录的 `logs` 文件夹下\r\n>\r\n> - 搜索任务日志: 默认保存为「时间戳\\_关键词\\_排序\\_时间\\_时长\\_search.json」\r\n> - 抖人作品获取日志: 默认保存为「时间戳\\_(抖人sec_uid)\\_post.json」\r\n> - 抖音评论获取日志: 默认保存为「时间戳\\_(视频aweme_id)\\_comment.json」\r\n>\r\n> **💡Q：支持 Windows/Mac/Linux 吗？**\r\n>\r\n> A：全平台支持，仅需安装 Node.js 环境\r\n\r\n## 7. 📞 帮助与支持\r\n\r\n- 联系微信 13395823479（备注抖音技能）开通TOKEN或获得技能使用支持；\r\n- 或通过 [抖音关键词搜索技能官网](https://www.guaikei.com) 自助开通TOKEN或查阅使用帮助。\r\n\r\n> 🆕 [更新日志](references/changelog.md) 可查阅这里\n\nFile v1.1.5:_meta.json\n\n{\n \"ownerId\": \"kn79p9y6xrdxyr0maxy3tj5nb9835e0e\",\n \"slug\": \"douyin-search-keyword\",\n \"version\": \"1.1.5\",\n \"publishedAt\": 1781787548572\n}\n\nFile v1.1.5:references/changelog.md\n\n# 抖音关键词搜索 (Douyin Search & Analytics) 更新日志\r\n\r\n## 1.1.5 - 2026-06-18\r\n\r\n- 新增抖音视频评论获取功能，支持抓取并分析指定作品的评论内容。\r\n- 更新 schema，新增评论入参与出参 JSON Schema 规范，完善数据结构。\r\n- SKILL.md 说明文档同步更新，增加评论分析与用法示例。\r\n\r\n## 1.1.4 - 2026-06-09\r\n\r\n- 新增多份 JSON 模式文件，用于命令行结构化输入输出校验。\r\n- 在 references/ 目录下添加文档：更新日志（changelog.md）、配置说明（options.md）。\r\n- 优化 SKILL.md：补充模式文件引用，并完善令牌获取相关说明。\r\n- 为技能元数据补充模式定义，提升兼容性与自检能力。\r\n\r\n## 1.1.3 - 2026-05-11\r\n\r\n**新增：支持获取抖音作者（抖人）已发布作品，实现竞品账号内容批量抓取。**\r\n\r\n- 新增 post-cli 指令，可根据抖音主页 URL 或 sec_uid 一键获取创作者所有公开作品，便于竞品监控和账号内容分析。\r\n- 参数说明、使用范例及常见问题等文档内容同步更新，更清晰指引新功能使用方式。\r\n- 指令参数支持短缩写，limit上限提升至200，提升批量数据抓取能力。\r\n- 关键词搜索、热榜等原有功能保持兼容并优化参数配置，提升整体易用性。\r\n- 调整并精简 Skill 文档，增加使用案例，强调 TOKEN 申请与日志留存说明。\r\n- 示例与文档同步完善，能力标签更明确。\r\n\r\n## 1.1.2 - 2026-05-04\r\n\r\n- 新增支持抖音热搜榜单查询（hot-cli.js），可独立调用。\r\n- 关键词搜索与热榜查询分别独立为入口（search-cli.js/hot-cli.js）。\r\n- 项目结构优化，API与工具模块化拆分，便于维护与扩展。\r\n- 移除旧 scripts/lib 目录，迁移为 src/api、src/utils、src/validate 目录。\r\n- 更新文档与示例，增强上手指引与使用场景说明。\r\n\r\n## 1.1.1 - 2026-03-31\r\n\r\n- 更新 JSON 响应中的输出字段，明确标记更多字段，提高下游解析的一致性。\r\n- 无功能或界面变更;文档现在准确反映了输出模式中始终存在的字段。\r\n\r\n## 1.1.0 - 2026-03-31\r\n\r\n**重大升级：结构化输出、多参数排序与筛选能力增强**\r\n\r\n- 增加多维度排序（综合/最多点赞/最新发布）和发布时间筛选（1天/7天/半年），结果更精准。\r\n- 支持自定义返回数量（1~60条），输出格式新增 Markdown，与 JSON 并行。\r\n- 完全结构化 JSON 输出，字段覆盖互动数据、标签等，适配 OpenClaw 生态。\r\n- 内置参数合法性校验、敏感词过滤及安全保护，保证调用稳定合规。\r\n- 增强任务轮询&超时重试机制，提升检索成功率和稳定性。\r\n- 技能文档全面更新，提供详细参数表、示例与应用场景说明。\r\n\r\n## 1.0.2 - 2026-03-24\r\n\r\n- 技能重命名为“douyin-search-keyword”。\r\n- 在SKILL.md中添加了openclaw元数据、使用帮助、许可证、标签和示例，以实现更好的集成与文档化。\r\n- 移除了两个本地文件（.env 和 scripts/last-search.json），以优化代码结构并提升安全性。\r\n- 文档现已更加简洁且以用户为中心，重点在于提供清晰的使用说明和数据字段解释。\r\n- 突出技能特性、合规要点及技术流程。\r\n\r\n## 1.0.1 - 2026-3-20\r\n\r\n- 更新技能描述，强调支持多维度抖音公开内容检索（视频、图文、用户等）\r\n- 扩展文档，新增适用/不适用场景说明\r\n- 新增环境和token配置的详细步骤与平台限制说明\r\n- 明确数据字段及样例，补充表格形式字段解释\r\n- 强调合规、风控及临时链接有效期注意事项\r\n\r\n## 1.0.0 - 2026-03-18\r\n\r\n- douyin-search-general 技能首次发布。\r\n- 提供抖音通用搜索接口，支持视频、图文、用户及社交数据搜索。\r\n- 返回详细信息，包括内容描述、作者、发布时间、点赞数、评论数、分享数、封面图片及视频链接。\r\n- 需要Node.js和有效的GUAIKEI_API_TOKEN环境变量才能运行。\r\n- 输出包含可直接复制的URL，并附有示例响应格式说明。\n\nFile v1.1.5:references/options.md\n\n# 抖音关键词搜索 (Douyin Search & Analytics) 完整选项参数说明\r\n\r\n## 🔎 抖音关键词搜索\r\n\r\n| 参数 | 缩写 | 作用 | 可选值 | 必填 | 默认值 |\r\n| :----------- | :--: | :----------- | :----------------------------------------------------- | :--- | :----: |\r\n| `--keyword` | `-k` | 搜索关键词 | 2-50 位长度的汉字或单词 | 是 | |\r\n| `--sort` | `-s` | 排序方式 | 0 = 综合排序 / 1 = 最多点赞 / 2 = 最新发布 | 否 | 0 |\r\n| `--time` | `-t` | 时间范围 | 0 = 全部 / 1 = 一天内 / 7 = 七天内 / 180 = 半年内 | 否 | 0 |\r\n| `--duration` | `-d` | 视频时长 | 0 = 不限 / 1 = 1分钟以下 / 2 = 1-5分钟 / 3 = 5分钟以上 | 否 | 0 |\r\n| `--limit` | `-l` | 获取数量 | 1-10000 条 | 否 | 10 |\r\n| `--help` | `-h` | 显示帮助信息 | | 否 | |\r\n\r\n```bash\r\n# **基础语法**\r\nnode src/douyin/search-cli.js --keyword <关键词> --sort <排序方式> --time <时间范围> --duration <视频时长> --limit <获取数量>\r\n\r\n# **使用示例**\r\n\r\n# 搜索\"AI 教程\"的抖音内容\r\nnode src/douyin/search-cli.js --keyword \"AI 教程\"\r\n\r\n# 搜索 AI 获取最多点赞的抖音内容\r\nnode src/douyin/search-cli.js --keyword \"AI\" --sort 1\r\n\r\n# 搜索近7天\"AI 模型\"的抖音内容\r\nnode src/douyin/search-cli.js --keyword \"AI 模型\" --time 7\r\n\r\n# 搜索\"AI 教程\"视频时长在5分钟以上的抖音内容\r\nnode src/douyin/search-cli.js --keyword \"AI 教程\" --duration 3\r\n\r\n# 搜索半年内最新20条\"AI 教程\"的抖音内容\r\nnode src/douyin/search-cli.js --keyword \"AI 教程\" --sort 2 --time 180 --limit 20\r\n```\r\n\r\n## 🦸 抖音抖人作品获取\r\n\r\n| 参数 | 缩写 | 作用 | 可选值 | 必填 | 默认值 |\r\n| :-------- | :--: | :------------------- | :--------- | :--- | :----: |\r\n| `--url` | `-u` | 抖人主页URL或sec_uid | | 是 | |\r\n| `--limit` | `-l` | 获取作品数量 | 1-10000 条 | 否 | 10 |\r\n| `--help` | `-h` | 显示帮助信息 | | 否 | |\r\n\r\n> **💡\"抖人主页URL\"说明**\r\n>\r\n> - PC端 ( 格式： )\r\n> - 移动端 ( 格式： )\r\n> - 技能关键词搜索返回的author_sec_uid字段\r\n\r\n```bash\r\n# **基础语法**\r\nnode src/douyin/post-cli.js --url \"https://www.douyin.com/user/MS4wLjABxxx\"\r\n\r\n# **使用示例**\r\n\r\n# 获取抖人 MS4wLjABxxx 已发布的20条作品\r\nnode src/douyin/post-cli.js --url \"https://www.douyin.com/user/MS4wLjABxxx\" --limit 20\r\n```\r\n\r\n## 💬 抖音作品评论数据\r\n\r\n| 参数 | 缩写 | 作用 | 可选值 | 必填 | 默认值 |\r\n| :-------- | :--: | :---------------------------- | :--------- | :--- | :----: |\r\n| `--url` | `-u` | 抖音视频(或图文)URL或aweme_id | | 是 | |\r\n| `--limit` | `-l` | 获取评论数量 | 1-10000 条 | 否 | 10 |\r\n| `--help` | `-h` | 显示帮助信息 | | 否 | |\r\n\r\n```bash\r\n# **基础语法**\r\nnode src/douyin/comment-cli.js --url \"https://www.douyin.com/video/xxx\"\r\n\r\n# **使用示例**\r\n\r\n# 获取视频 xxx 的100条评论\r\nnode src/douyin/comment-cli.js --url \"https://www.douyin.com/video/xxx\" --limit 100\r\n```\r\n\r\n## 📡 抖音热搜榜单\r\n\r\n- 无需参数\r\n\r\n```bash\r\n# **基础语法**\r\nnode src/douyin/hot-cli.js\r\n```\n\nFile v1.1.5:skill-card.md\n\n## Description:
\n抖音公开数据智能获取工具。支持抖音关键词搜索、抖人作品抓取、获取作品评论、实时热榜跟踪，适用于短视频营销、竞品分析、舆情分析和热点监控，助力爆款内容策划与流量追踪。
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[um-why](https://clawhub.ai/user/um-why)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nContent, marketing, and analysis teams use this skill to retrieve public Douyin search results, creator posts, comments, and hot-list data for content planning, competitor analysis, public-opinion analysis, and trend monitoring.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: Douyin search terms, profile or video URLs, request limits, and GUAIKEI_API_TOKEN are sent to the guaikei.com API.
\nMitigation: Use the skill only for workflows where sending those values to the third-party API is acceptable, and store the token in an environment variable rather than in prompts or files.
\nRisk: Collected public comments, account data, and search results are saved as local JSON logs.
\nMitigation: Review, restrict, or delete generated log files when the collected data is sensitive for the workflow.
\nRisk: The skill is limited to public Douyin data and does not support private or hidden content.
\nMitigation: Use it only for public-data retrieval tasks and avoid relying on it for private-account monitoring or complete coverage claims.
\n\n\n## Reference(s):
\n- [ClawHub skill page](https://clawhub.ai/um-why/douyin-search-keyword)
\n- [Publisher profile](https://clawhub.ai/user/um-why)
\n- [Options reference](references/options.md)
\n- [Changelog](references/changelog.md)
\n- [Search input schema](assets/search_cli_req.schema.json)
\n- [Search output schema](assets/search_cli_resp.schema.json)
\n- [Post input schema](assets/post_cli_req.schema.json)
\n- [Post output schema](assets/post_cli_resp.schema.json)
\n- [Comment input schema](assets/comment_cli_req.schema.json)
\n- [Comment output schema](assets/comment_cli_resp.schema.json)
\n- [Hot-list output schema](assets/hot_cli_resp.schema.json)
\n- [Token and support site](https://www.guaikei.com)
\n\n\n## Skill Output:
\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance]
\n**Output Format:** [Markdown guidance with command examples; runtime output is structured JSON saved to local log files.]
\n**Output Parameters:** [1D]
\n**Other Properties Related to Output:** [Requires Node.js 16.14.0+ and GUAIKEI_API_TOKEN; command outputs are constrained by the documented request and response schemas.]
\n\n## Skill Version(s):
\n1.1.5 (source: server release metadata, SKILL.md frontmatter, package.json, changelog released 2026-06-18)
\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\nFile v1.1.5:assets/comment_cli_req.schema.json\n\n{\r\n \"$schema\": \"http://json-schema.org/draft-07/schema#\",\r\n \"type\": \"object\",\r\n \"title\": \"抖音评论获取 - 命令行入参\",\r\n \"description\": \"抖音获取作品评论, 命令行参数入参Schema详解\",\r\n \"required\": [\r\n \"url\"\r\n ],\r\n \"properties\": {\r\n \"url\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音作品URL 或 作品aweme_id\"\r\n },\r\n \"limit\": {\r\n \"type\": \"number\",\r\n \"description\": \"获取评论数量\",\r\n \"minimum\": 1,\r\n \"maximum\": 10000,\r\n \"default\": 10\r\n }\r\n },\r\n \"additionalProperties\": false\r\n}\n\nFile v1.1.5:assets/comment_cli_resp.schema.json\n\n{\r\n \"$schema\": \"http://json-schema.org/draft-07/schema#\",\r\n \"type\": \"object\",\r\n \"title\": \"抖音评论获取 - API出参\",\r\n \"description\": \"抖音获取作品评论, API出参Schema详解\",\r\n \"properties\": {\r\n \"cid\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音评论ID\"\r\n },\r\n \"text\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音评论内容\"\r\n },\r\n \"create_time\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音评论发布时间戳\"\r\n },\r\n \"digg_count\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音评论点赞数\"\r\n },\r\n \"user_uid\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音评论者用户ID\"\r\n },\r\n \"user_nickname\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音评论者昵称\"\r\n },\r\n \"user_sec_uid\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音评论者SEC_UID\"\r\n },\r\n \"reply_comment_total\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音评论回复数\"\r\n },\r\n \"ip_label\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音评论者IP区域\"\r\n }\r\n }\r\n}\n\nFile v1.1.5:assets/hot_cli_resp.schema.json\n\n{\r\n \"$schema\": \"http://json-schema.org/draft-07/schema#\",\r\n \"type\": \"object\",\r\n \"title\": \"抖音热榜 - API出参\",\r\n \"description\": \"抖音实时热榜, API出参Schema详解\",\r\n \"required\": [\r\n \"word\",\r\n \"event_time\",\r\n \"hot_value\",\r\n \"position\",\r\n \"view_count\"\r\n ],\r\n \"properties\": {\r\n \"id\": {\r\n \"type\": \"number\",\r\n \"description\": \"自增ID\"\r\n },\r\n \"word\": {\r\n \"type\": \"string\",\r\n \"description\": \"热榜关键词\"\r\n },\r\n \"event_time\": {\r\n \"type\": \"number\",\r\n \"description\": \"事件发生时间\"\r\n },\r\n \"hot_value\": {\r\n \"type\": \"number\",\r\n \"description\": \"热榜值\"\r\n },\r\n \"position\": {\r\n \"type\": \"number\",\r\n \"description\": \"热榜排名\"\r\n },\r\n \"view_count\": {\r\n \"type\": \"number\",\r\n \"description\": \"关键词的搜索量\"\r\n },\r\n \"event_time_format\": {\r\n \"type\": \"string\",\r\n \"description\": \"事件发生时间格式化字符串\"\r\n }\r\n }\r\n}\n\nFile v1.1.5:assets/post_cli_req.schema.json\n\n{\r\n \"$schema\": \"http://json-schema.org/draft-07/schema#\",\r\n \"type\": \"object\",\r\n \"title\": \"抖音抖人作品获取 - 命令行入参\",\r\n \"description\": \"抖音实时获取博主作品, 命令行参数入参Schema详解\",\r\n \"required\": [\r\n \"url\"\r\n ],\r\n \"properties\": {\r\n \"url\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音博主主页URL 或 抖音博主SEC_UID\"\r\n },\r\n \"limit\": {\r\n \"type\": \"number\",\r\n \"description\": \"获取作品数量\",\r\n \"minimum\": 1,\r\n \"maximum\": 10000,\r\n \"default\": 10\r\n }\r\n },\r\n \"additionalProperties\": false\r\n}\n\nFile v1.1.5:assets/post_cli_resp.schema.json\n\n{\r\n \"$schema\": \"http://json-schema.org/draft-07/schema#\",\r\n \"type\": \"object\",\r\n \"title\": \"抖音抖人作品获取 - API出参\",\r\n \"description\": \"抖音实时获取博主作品, API出参Schema详解\",\r\n \"properties\": {\r\n \"aweme_id\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频ID\"\r\n },\r\n \"desc\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频描述\"\r\n },\r\n \"caption\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频描述\"\r\n },\r\n \"create_time\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音视频创建时间戳\"\r\n },\r\n \"music_title\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频音乐标题\"\r\n },\r\n \"music_author\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频音乐作者\"\r\n },\r\n \"music_duration\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音视频音乐时长\"\r\n },\r\n \"music_play_url\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频音乐播放URL\"\r\n },\r\n \"video_url\": {\r\n \"type\": \"array\",\r\n \"description\": \"视频播放地址、视频下载地址\",\r\n \"items\": {\r\n \"type\": \"string\",\r\n \"description\": \"视频播放地址、视频下载地址\"\r\n }\r\n },\r\n \"video_cover\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频封面URL\"\r\n },\r\n \"video_duration\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音视频时长\"\r\n },\r\n \"recommend_count\": {\r\n \"type\": \"number\",\r\n \"description\": \"交互界面未显示字段\"\r\n },\r\n \"comment_count\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音视频评论数\"\r\n },\r\n \"digg_count\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音视频点赞数\"\r\n },\r\n \"share_count\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音视频分享数\"\r\n },\r\n \"collect_count\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音视频收藏数\"\r\n },\r\n \"tags\": {\r\n \"type\": \"array\",\r\n \"description\": \"抖音视频标签\",\r\n \"items\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频标签\"\r\n }\r\n },\r\n \"share_url\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频分享URL\"\r\n }\r\n }\r\n}\n\nFile v1.1.5:assets/search_cli_req.schema.json\n\n{\r\n \"$schema\": \"http://json-schema.org/draft-07/schema#\",\r\n \"type\": \"object\",\r\n \"title\": \"抖音关键词搜索 - 命令行入参\",\r\n \"description\": \"抖音实时关键词搜索, 命令行参数入参Schema详解\",\r\n \"required\": [\r\n \"keyword\"\r\n ],\r\n \"properties\": {\r\n \"keyword\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音关键词搜索的关键词\",\r\n \"minLength\": 2,\r\n \"maxLength\": 50\r\n },\r\n \"sort\": {\r\n \"type\": \"number\",\r\n \"description\": \"排序方式: 0=综合排序 , 1=最多点赞 , 2=最新发布\",\r\n \"default\": 0,\r\n \"enum\": [\r\n 0,\r\n 1,\r\n 2\r\n ]\r\n },\r\n \"time\": {\r\n \"type\": \"number\",\r\n \"description\": \"时间范围: 0=全部 , 1=一天内 , 7=七天内 , 180=半年内\",\r\n \"default\": 0,\r\n \"enum\": [\r\n 0,\r\n 1,\r\n 7,\r\n 180\r\n ]\r\n },\r\n \"duration\": {\r\n \"type\": \"number\",\r\n \"description\": \"视频时长: 0=不限 , 1=1分钟以下 , 2=1-5分钟 , 3=5分钟以上\",\r\n \"default\": 0,\r\n \"enum\": [\r\n 0,\r\n 1,\r\n 2,\r\n 3\r\n ]\r\n },\r\n \"limit\": {\r\n \"type\": \"number\",\r\n \"description\": \"获取数量\",\r\n \"minimum\": 1,\r\n \"maximum\": 10000,\r\n \"default\": 10\r\n }\r\n },\r\n \"additionalProperties\": false\r\n}\n\nFile v1.1.5:assets/search_cli_resp.schema.json\n\n{\r\n \"$schema\": \"http://json-schema.org/draft-07/schema#\",\r\n \"type\": \"object\",\r\n \"title\": \"抖音关键词搜索 - API出参\",\r\n \"description\": \"抖音实时关键词搜索, API出参Schema详解\",\r\n \"properties\": {\r\n \"aweme_id\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频ID\"\r\n },\r\n \"desc\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频描述\"\r\n },\r\n \"create_time\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音视频创建时间戳\"\r\n },\r\n \"author_uid\": {\r\n \"type\": \"string\",\r\n \"description\": \"视频作者抖音ID\"\r\n },\r\n \"author_nickname\": {\r\n \"type\": \"string\",\r\n \"description\": \"视频作者抖音昵称\"\r\n },\r\n \"author_avatar\": {\r\n \"type\": \"string\",\r\n \"description\": \"视频作者抖音头像\"\r\n },\r\n \"author_sec_uid\": {\r\n \"type\": \"string\",\r\n \"description\": \"视频作者抖音SEC_UID\"\r\n },\r\n \"author_signature\": {\r\n \"type\": \"string\",\r\n \"description\": \"视频作者抖音签名\"\r\n },\r\n \"comment_count\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音视频评论数\"\r\n },\r\n \"digg_count\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音视频点赞数\"\r\n },\r\n \"share_count\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音视频分享数\"\r\n },\r\n \"collect_count\": {\r\n \"type\": \"number\",\r\n \"description\": \"抖音视频收藏数\"\r\n },\r\n \"share_url\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频分享URL\"\r\n },\r\n \"dynamic_cover\": {\r\n \"type\": \"array\",\r\n \"description\": \"抖音视频动态封面\",\r\n \"items\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频动态封面URL\"\r\n }\r\n },\r\n \"play_addr\": {\r\n \"type\": \"string\",\r\n \"description\": \"视频播放地址、视频下载地址\"\r\n },\r\n \"play_uri\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频播放URI\"\r\n },\r\n \"music_id\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频音乐ID\"\r\n },\r\n \"music_title\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频音乐标题\"\r\n },\r\n \"music_author\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频音乐作者\"\r\n },\r\n \"music_play_url\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频音乐播放URL\"\r\n },\r\n \"tags\": {\r\n \"type\": \"array\",\r\n \"description\": \"抖音视频标签\",\r\n \"items\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频标签\"\r\n }\r\n },\r\n \"url\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频URL\"\r\n },\r\n \"author_url\": {\r\n \"type\": \"string\",\r\n \"description\": \"视频作者抖音主页URL\"\r\n },\r\n \"create_time_str\": {\r\n \"type\": \"string\",\r\n \"description\": \"抖音视频创建时间\"\r\n }\r\n }\r\n}\n\nArchive v1.1.4: 28 files, 28687 bytes\n\nFiles: assets/hot_cli_resp.schema.json (1154b), assets/post_cli_req.schema.json (676b), assets/post_cli_resp.schema.json (2715b), assets/search_cli_req.schema.json (1619b), assets/search_cli_resp.schema.json (3435b), package.json (696b), references/changelog.md (3856b), references/options.md (2943b), skill-card.md (2770b), SKILL.md (6389b), src/api/hot.js (919b), src/api/post.js (1612b), src/api/search.js (2881b), src/config/constants.js (464b), src/douyin/hot-cli.js (1952b), src/douyin/post-cli.js (4287b), src/douyin/search-cli.js (5929b), src/utils/errors.js (868b), src/utils/key.js (1040b), src/utils/log.js (656b), src/utils/request.js (4252b), src/utils/retry.js (1030b), src/utils/token.js (1026b), src/utils/utils.js (1604b), src/validate/hot.js (703b), src/validate/keyword.js (3932b), src/validate/post.js (944b), _meta.json (140b)\n\nFile v1.1.4:SKILL.md\n\n---\r\nname: douyin-search-keyword\r\ndescription: 抖音公开数据智能分析工具。支持关键词搜索排序、抖人作品抓取、实时热榜获取，适用于短视频营销、竞品分析和热点监控，助力爆款内容策划与流量追踪。\r\nversion: 1.1.4\r\nlicense: MIT\r\nmetadata:\r\n enabled: true\r\n type: command\r\n runtime: \"nodejs@16.14.0+\"\r\n requires:\r\n bins:\r\n - \"node\"\r\n env:\r\n - \"GUAIKEI_API_TOKEN\"\r\n category:\r\n - \"Data&APIs\"\r\n - \"内容创作\"\r\n tags:\r\n - \"douyin\"\r\n - \"抖音\"\r\n - \"search\"\r\n - \"搜索\"\r\n - \"数据挖掘\"\r\n - \"content-analysis\"\r\n - \"营销分析\"\r\n - \"数据分析\"\r\n - \"competitor-analysis\"\r\n - \"竞品分析\"\r\n - \"热点追踪\"\r\n - \"marketing\"\r\n - \"trend-tracking\"\r\n - \"workflow\"\r\n - \"insight\"\r\n - \"automation\"\r\n schemas:\r\n - name: \"搜索入参\"\r\n file: \"assets/search_cli_req.schema.json\"\r\n - name: \"搜索出参\"\r\n file: \"assets/search_cli_resp.schema.json\"\r\n - name: \"作品入参\"\r\n file: \"assets/post_cli_req.schema.json\"\r\n - name: \"作品出参\"\r\n file: \"assets/post_cli_resp.schema.json\"\r\n - name: \"热榜出参\"\r\n file: \"assets/hot_cli_resp.schema.json\"\r\n examples:\r\n - name: 搜索\"AI 教程\"的抖音内容\r\n command: 'node src/douyin/search-cli.js --keyword \"AI 教程\"'\r\n description: 快速获取关键词相关视频数据，助力内容创作灵感\r\n - name: 搜索 AI 获取最多点赞的抖音内容\r\n command: 'node src/douyin/search-cli.js --keyword \"AI\" --sort 1'\r\n description: 挖掘爆款视频特征，优化内容策略\r\n - name: 搜索近7天\"AI 模型\"的抖音内容\r\n command: 'node src/douyin/search-cli.js --keyword \"AI 模型\" --time 7'\r\n description: 追踪近期热点趋势，把握内容窗口期\r\n - name: 搜索半年内最新20条\"AI 教程\"的抖音内容\r\n command: 'node src/douyin/search-cli.js --keyword \"AI 教程\" --sort 2 --time 180 --limit 20'\r\n description: 监控长期内容趋势，制定内容规划\r\n - name: 获取抖人 MS4wLjABxxx 已发布的作品\r\n command: 'node src/douyin/post-cli.js --url \"https://www.douyin.com/user/MS4wLjABxxx\"'\r\n description: 获取抖人已发布的作品，助力竞品分析\r\n - name: 获取抖音实时热搜榜单\r\n command: \"node src/douyin/hot-cli.js\"\r\n description: 实时掌握平台热点，快速响应热门话题\r\n---\r\n\r\n# 🚀 抖音关键词搜索、竞品分析与热榜监控工具 (Douyin Search & Analytics)\r\n\r\n> **💡一句话价值**：一键抓取抖音公开视频/作者/热榜数据，帮你做爆款选题、竞品分析、热点追踪。\r\n>\r\n> **🔥核心优势**\r\n>\r\n> - 轻量: 无需部署服务，Node.js 一键运行\r\n> - 灵活: 支持多维度筛选、批量操作、多格式导出\r\n> - 实用: 日志自动归档，适配营销报告 / 内容策划场景\r\n> - 安全: 无需登录你的抖音账号，不担心风控风险 / 封号问题\r\n\r\n## 1. ✅ 我能帮你解决什么（10 秒判断）\r\n\r\n- 🔍 按关键词搜抖音视频（点赞/最新排序）：找爆款选题、分析高赞视频规律\r\n- 🦸 竞品监控：批量抓取对标账号所有公开作品数据，分析内容策略\r\n- 📡 热点追流：实时获取抖音热榜，抢占流量风口\r\n- 📊 数据导出：自动生成JSON日志，方便二次使用\r\n\r\n## 2. 🚀 最快上手（复制就能跑，30 秒出结果）\r\n\r\n> **Note:** 请先通过微信 <13395823479> 申请TOKEN ，或访问[抖音搜索技能官网](https://www.guaikei.com)开通TOKEN，配置环境变量 `GUAIKEI_API_TOKEN` 后才能正常运行。\r\n\r\n### 2.1 🔎 抖音关键词搜索（最简单）\r\n\r\n```bash\r\nnode src/douyin/search-cli.js AI\r\n```\r\n\r\n### 2.2 🔎 按点赞排序找爆款（最常用）\r\n\r\n```bash\r\nnode src/douyin/search-cli.js --keyword \"AI\" --sort 1\r\n```\r\n\r\n### 2.3 🦸 抓取抖音抖人全部作品\r\n\r\n```bash\r\nnode src/douyin/post-cli.js --url \"https://www.douyin.com/user/MS4wLjABxxx\"\r\n```\r\n\r\n### 2.4 📡 获取抖音实时热榜\r\n\r\n```bash\r\nnode src/douyin/hot-cli.js\r\n```\r\n\r\n## 3. 📌 适用场景（我该不该用？）\r\n\r\n- 你需要做短视频选题 → 关键词搜索 + 点赞排序\r\n- 你需要模仿爆款文案 → 查看高赞视频详情\r\n- 你需要监控竞品账号 → 批量抓取对方作品\r\n- 你需要快速追热点 → 实时获取抖音热榜\r\n- 你需要做营销报告 → 导出结构化数据\r\n\r\n## 4. 🔧 参数详解表\r\n\r\n> 详细选项参数说明， 可参阅 [完整选项说明](references/options.md)\r\n>\r\n> LLM理解技能的详细选项，可参阅技能 `assets` 目录中文件，其遵循 JSON Schema draft-07 版本规范。\r\n> 抖音关键词搜索，[入参规范](assets/search_cli_req.schema.json)\r\n> 抖音关键词搜索，[出参规范](assets/search_cli_resp.schema.json)\r\n> 抖音抖人作品获取，[入参规范](assets/post_cli_req.schema.json)\r\n> 抖音抖人作品获取，[出参规范](assets/post_cli_resp.schema.json)\r\n> 抖音热榜获取，[出参规范](assets/hot_cli_resp.schema.json)\r\n\r\n## 5. ⚠️ 重要限制（不踩坑）\r\n\r\n- 仅抓取抖音公开数据，不支持私密 / 隐藏内容\r\n- 需要配置 GUAIKEI_API_TOKEN 才能正常运行\r\n- 数据仅限个人 / 团队内部使用，禁止违规分发\r\n\r\n## 6. ❓ 常见问题（秒解决）\r\n\r\n> **💡Q：运行报错，提示无权限？**\r\n>\r\n> A：先配置环境变量：`set GUAIKEI_API_TOKEN=你的TOKEN`\r\n>\r\n> - 私有TOKEN申请后请留意使用安全，避免泄露给他人\r\n>\r\n> **💡Q：搜索结果为空？**\r\n>\r\n> A：换常用关键词，或把 `--time` 改为 0（全部时间）\r\n>\r\n> **💡Q：输出文件在哪里？**\r\n>\r\n> A：自动保存在技能目录的 `logs` 文件夹下\r\n>\r\n> - 搜索任务日志: 默认保存为「时间戳\\_关键词\\_排序\\_时间\\_时长\\_search.json」\r\n> - 抖人作品获取日志: 默认保存为「时间戳\\_(抖人sec_uid)\\_post.json」\r\n>\r\n> **💡Q：支持 Windows/Mac/Linux 吗？**\r\n>\r\n> A：全平台支持，仅需安装 Node.js 环境\r\n\r\n## 7. 📞 帮助与支持\r\n\r\n- 联系微信 13395823479（备注抖音技能）开通TOKEN或获得技能使用支持；\r\n- 或通过 [抖音关键词搜索技能官网](https://www.guaikei.com) 自助开通TOKEN或查阅使用帮助。\r\n\r\n🆕 [更新日志](references/changelog.md) 可查阅这里\n\nFile v1.1.4:_meta.json\n\n{\n \"ownerId\": \"kn79p9y6xrdxyr0maxy3tj5nb9835e0e\",\n \"slug\": \"douyin-search-keyword\",\n \"version\": \"1.1.4\",\n \"publishedAt\": 1781011112278\n}\n\nFile v1.1.4:references/changelog.md\n\n# 抖音关键词搜索 (Douyin Search & Analytics) 更新日志\r\n\r\n## 1.1.4 - 2026-06-09\r\n\r\n- 新增多份 JSON 模式文件，用于命令行结构化输入输出校验。\r\n- 在 references/ 目录下添加文档：更新日志（changelog.md）、配置说明（options.md）。\r\n- 优化 SKILL.md：补充模式文件引用，并完善令牌获取相关说明。\r\n- 为技能元数据补充模式定义，提升兼容性与自检能力。\r\n\r\n## 1.1.3 - 2026-05-11\r\n\r\n**新增：支持获取抖音作者（抖人）已发布作品，实现竞品账号内容批量抓取。**\r\n\r\n- 新增 post-cli 指令，可根据抖音主页 URL 或 sec_uid 一键获取创作者所有公开作品，便于竞品监控和账号内容分析。\r\n- 参数说明、使用范例及常见问题等文档内容同步更新，更清晰指引新功能使用方式。\r\n- 指令参数支持短缩写，limit上限提升至200，提升批量数据抓取能力。\r\n- 关键词搜索、热榜等原有功能保持兼容并优化参数配置，提升整体易用性。\r\n- 调整并精简 Skill 文档，增加使用案例，强调 TOKEN 申请与日志留存说明。\r\n- 示例与文档同步完善，能力标签更明确。\r\n\r\n## 1.1.2 - 2026-05-04\r\n\r\n- 新增支持抖音热搜榜单查询（hot-cli.js），可独立调用。\r\n- 关键词搜索与热榜查询分别独立为入口（search-cli.js/hot-cli.js）。\r\n- 项目结构优化，API与工具模块化拆分，便于维护与扩展。\r\n- 移除旧 scripts/lib 目录，迁移为 src/api、src/utils、src/validate 目录。\r\n- 更新文档与示例，增强上手指引与使用场景说明。\r\n\r\n## 1.1.1 - 2026-03-31\r\n\r\n- 更新 JSON 响应中的输出字段，明确标记更多字段，提高下游解析的一致性。\r\n- 无功能或界面变更;文档现在准确反映了输出模式中始终存在的字段。\r\n\r\n## 1.1.0 - 2026-03-31\r\n\r\n**重大升级：结构化输出、多参数排序与筛选能力增强**\r\n\r\n- 增加多维度排序（综合/最多点赞/最新发布）和发布时间筛选（1天/7天/半年），结果更精准。\r\n- 支持自定义返回数量（1~60条），输出格式新增 Markdown，与 JSON 并行。\r\n- 完全结构化 JSON 输出，字段覆盖互动数据、标签等，适配 OpenClaw 生态。\r\n- 内置参数合法性校验、敏感词过滤及安全保护，保证调用稳定合规。\r\n- 增强任务轮询&超时重试机制，提升检索成功率和稳定性。\r\n- 技能文档全面更新，提供详细参数表、示例与应用场景说明。\r\n\r\n## 1.0.2 - 2026-03-24\r\n\r\n- 技能重命名为“douyin-search-keyword”。\r\n- 在SKILL.md中添加了openclaw元数据、使用帮助、许可证、标签和示例，以实现更好的集成与文档化。\r\n- 移除了两个本地文件（.env 和 scripts/last-search.json），以优化代码结构并提升安全性。\r\n- 文档现已更加简洁且以用户为中心，重点在于提供清晰的使用说明和数据字段解释。\r\n- 突\n\nArchive v1.1.3: 20 files, 21204 bytes\n\nFiles: package.json (541b), skill-card.md (2186b), SKILL.md (7199b), src/api/hot.js (919b), src/api/post.js (1612b), src/api/search.js (2585b), src/config/constants.js (464b), src/douyin/hot-cli.js (1519b), src/douyin/post-cli.js (4351b), src/douyin/search-cli.js (6052b), src/utils/errors.js (868b), src/utils/key.js (1040b), src/utils/log.js (656b), src/utils/request.js (4252b), src/utils/retry.js (1030b), src/utils/utils.js (1604b), src/validate/hot.js (703b), src/validate/keyword.js (3867b), src/validate/post.js (938b), _meta.json (140b)\n\nArchive v1.1.2: 16 files, 16908 bytes\n\nFiles: package.json (727b), SKILL.md (8232b), src/api/hot.js (733b), src/api/search.js (3528b), src/config/constants.js (464b), src/douyin/hot-cli.js (1519b), src/douyin/search-cli.js (5960b), src/utils/errors.js (868b), src/utils/key.js (1040b), src/utils/log.js (656b), src/utils/request.js (3155b), src/utils/retry.js (1030b), src/utils/utils.js (1601b), src/validate/hot.js (703b), src/validate/keyword.js (3864b), _meta.json (140b)\n\nArchive v1.1.1: 8 files, 12852 bytes\n\nFiles: lib/douyin.js (10469b), lib/key.js (709b), lib/utils.js (1142b), package-lock.json (228b), package.json (584b), scripts/search.js (6429b), SKILL.md (15367b), _meta.json (140b)\n\nArchive v1.1.0: 8 files, 13025 bytes\n\nFiles: lib/douyin.js (10469b), lib/key.js (709b), lib/utils.js (1587b), package-lock.json (228b), package.json (494b), scripts/search.js (6556b), SKILL.md (15211b), _meta.json (140b)","readmeExcerpt":"Skill: 抖音搜索关键词、竞品分析、舆情监控与热榜跟踪工具 Owner: um-why Summary: 抖音公开数据只读工具箱，提供4个能力：①关键词搜索（可按点赞/最新排序、时间窗、时长、图文类型筛选）②博主主页作品抓取 ③视频/图文评论抓取 ④实时热榜。输出结构化 JSON（含作者、互动数据、标签、链接）。当用户需要搜抖音视频、抓博主作品、看抖音评论、查抖音热榜、做竞品/对标账号监控、短视频选题调研、评论舆情分析、热点追踪、爆款挖掘时使用。触发词：抖音搜索、抖音热榜、抖音评论、抖音作品、博主作品、对标账号、抖音竞品分析、抖音数据分析、短视频运营、抖音舆情监控、抖音热点、舆情监控、热点追踪、爆款挖掘、douyin search、douyin hot search、douyin comments Tags: automation:1.1.3, chinese:1.0.2, competitor-analysis:1.1.3","codeSnippets":[],"executableExamples":[{"language":"text","snippet":"File v1.3.0:skill-card.md\n\n## Description:\n\nA read-only Douyin public-data toolbox for keyword search, creator post retrieval, video or image-post comment collection, and real-time hot-list tracking, returning structured JSON for content research, competitor analysis, sentiment monitoring, and trend tracking.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[um-why](https://clawhub.ai/user/um-why)\n\n### License/Terms of Use:\n\nMIT\n\n## Use Case:\n\nExternal users, analysts, marketers, and developers use this skill to retrieve public Douyin search results, creator posts, comments, and hot-list data for topic research, competitor monitoring, public-opinion analysis, trend tracking, and report generation.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Keywords, Douyin links, target accounts, and collected comments may be sensitive and are sent to www.guaikei.com for processing.\n\nMitigation: Review the query and authorization context before execution, configure GUAIKEI_API_TOKEN only in trusted environments, and avoid sending confidential campaign or account data.\n\nRisk: Search, post, and comment results are automatically saved to a local logs directory, which can retain large public-data datasets.\n\nMitigation: Run the skill in an appropriate workspace and delete or protect logs when retention, backup, or shared-machine exposure is not acceptable.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/um-why/skills/douyin-search-keyword)\n- [抖音关键词搜索技能官网](https://www.guaikei.com)\n- [完整选项参数说明](references/options.md)\n- [更新日志](references/changelog.md)\n\n## Skill Output:\n\n**Output Type(s):** [JSON, Shell commands, Guidance]\n\n**Output Format:** [Structured JSON envelopes from Node.js CLI commands, usually summarized in Markdown for the user]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires Node.js 16.14.0+ and GUAIKEI_API_TOKEN; search, post, and comment results may be saved locally under"},{"language":"text","snippet":"File v1.2.2:skill-card.md\n\n## Description:\n\n抖音公开数据智能获取工具，支持关键词搜索、博主作品抓取、视频评论分析和实时热榜查询。\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[um-why](https://clawhub.ai/user/um-why)\n\n### License/Terms of Use:\n\nMIT\n\n## Use Case:\n\nExternal users and business teams use this skill to retrieve public Douyin search results, hot list entries, creator posts, and comments for content research, competitive analysis, trend monitoring, and operational reporting.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: The skill sends Douyin keywords, profile or video URLs, and the GUAIKEI_API_TOKEN to www.guaikei.com.\n\nMitigation: Use it only when the GuaiKei service and data handling terms are acceptable, keep the token secret, and rotate it if exposure is suspected.\n\nRisk: Fetched public content is saved locally by default and may include large comment or profile datasets.\n\nMitigation: Review and delete local logs when they are no longer needed, and collect or retain datasets only for a lawful business purpose with an explicit retention plan.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/um-why/skills/douyin-search-keyword)\n- [GuaiKei API service](https://www.guaikei.com)\n- [Options reference](references/options.md)\n- [Changelog](references/changelog.md)\n- [Search input schema](assets/search_cli_req.schema.json)\n- [Search output schema](assets/search_cli_resp.schema.json)\n- [Post input schema](assets/post_cli_req.schema.json)\n- [Post output schema](assets/post_cli_resp.schema.json)\n- [Comment input schema](assets/comment_cli_req.schema.json)\n- [Comment output schema](assets/comment_cli_resp.schema.json)\n- [Hot list output schema](assets/hot_cli_resp.schema.json)\n\n## Skill Output:\n\n**Output Type(s):** [text, markdown, shell commands, configuration, guidance]\n\n**Output Format:** [Human-facing guidance with shell commands; command results are structured JSON on stdout and JSON log files.]\n\n**Output Parameters:** [1D]\n\n**"},{"language":"text","snippet":"File v1.2.1:skill-card.md\n\n## Description:\n\nRetrieves public Douyin data for keyword search, creator posts, video comments, and real-time hot-list queries so agents can support content research, competitor analysis, sentiment review, and trend tracking.\n\nThis skill is ready for commercial/non-commercial use.\n\n## Publisher:\n\n[um-why](https://clawhub.ai/user/um-why)\n\n### License/Terms of Use:\n\nMIT-0\n\n## Use Case:\n\nExternal users and agents use this skill to collect structured public Douyin search results, creator posts, comments, and hot-list entries for short-video research, content planning, competitor monitoring, and operations analysis.\n\n### Deployment Geography for Use:\n\nGlobal\n\n## Known Risks and Mitigations:\n\nRisk: Douyin keywords, profile or video identifiers, request limits, and GUAIKEI_API_TOKEN are sent to the third-party guaikei.com API.\n\nMitigation: Install and run the skill only when that data sharing is acceptable, keep the token confidential, and rotate it if exposure is suspected.\n\nRisk: Retrieved public posts and comments may be saved locally in the skill logs directory.\n\nMitigation: Use the smallest practical limits, delete logs when they are no longer needed, and verify collection and analysis comply with applicable rules and privacy expectations.\n\n## Reference(s):\n\n- [ClawHub skill page](https://clawhub.ai/um-why/skills/douyin-search-keyword)\n- [抖音数据获取技能官网](https://www.guaikei.com)\n- [Complete options reference](references/options.md)\n- [Changelog](references/changelog.md)\n\n## Skill Output:\n\n**Output Type(s):** [Text, Markdown, Code, Shell commands, Configuration, Guidance]\n\n**Output Format:** [JSON from CLI tools, with Markdown guidance and shell command examples for agents]\n\n**Output Parameters:** [1D]\n\n**Other Properties Related to Output:** [Requires Node.js 16.14.0+ and GUAIKEI_API_TOKEN; API responses may be logged as local JSON files.]\n\n## Skill Version(s):\n\n1.2.1 (source: server release evidence, frontmatter, package.json, changelog)\n\n## E"},{"language":"text","snippet":"File v1.1.6:skill-card.md\n\n## Description:
\n抖音公开数据智能获取工具。支持抖音关键词搜索、抖人作品抓取、获取作品评论、实时热榜跟踪，适用于短视频营销、竞品分析、舆情分析和热点监控，助力爆款内容策划与流量追踪。
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[um-why](https://clawhub.ai/user/um-why)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nExternal users and content-analysis teams use this skill to search public Douyin videos, inspect creator posts, retrieve comments, and monitor hot lists for marketing, competitor analysis, sentiment review, and trend tracking.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: The skill can collect public Douyin user, video, and comment data at scale.
\nMitigation: Use it only for lawful, platform-compliant analysis and avoid collecting more data than needed for the task.
\nRisk: Search, post, and comment outputs are saved locally by default and may contain user comments, identifiers, or sensitive topics.
\nMitigation: Store logs in protected locations, delete them when no longer needed, and avoid running the skill in synced, shared, CI, or regulated-data workspaces without review.
\nRisk: The configured GUAIKEI_API_TOKEN is sent to guaikei.com for API requests.
\nMitigation: Keep the token out of shared environments, rotate it if exposed, and review installation before use on shared machines.
\n\n\n## Reference(s):
\n- [ClawHub skill page](https://clawhub.ai/um-why/skills/douyin-search-keyword)
\n- [Guaikei token and support site](https://www.guaikei.com)
\n- [Options reference](references/options.md)
\n- [Changelog](references/changelog.md)
\n- [Search request schema](assets/search_cli_req.schema.json)
\n- [Search response schema](assets/search_cli_resp.schema.json)
\n- [Post response schema](assets/post_cli_resp.schema.json)
\n- [Comment response schema](assets/comment_cli_resp.schema.json)
\n- [Hot list response schema](assets/hot_cli_resp.schema.json"},{"language":"text","snippet":"File v1.1.5:skill-card.md\n\n## Description:
\n抖音公开数据智能获取工具。支持抖音关键词搜索、抖人作品抓取、获取作品评论、实时热榜跟踪，适用于短视频营销、竞品分析、舆情分析和热点监控，助力爆款内容策划与流量追踪。
\n\nThis skill is ready for commercial/non-commercial use.
\n\n## Publisher:
\n[um-why](https://clawhub.ai/user/um-why)
\n\n### License/Terms of Use:
\nMIT-0
\n\n\n## Use Case:
\nContent, marketing, and analysis teams use this skill to retrieve public Douyin search results, creator posts, comments, and hot-list data for content planning, competitor analysis, public-opinion analysis, and trend monitoring.
\n\n### Deployment Geography for Use:
\nGlobal
\n\n## Known Risks and Mitigations:
\nRisk: Douyin search terms, profile or video URLs, request limits, and GUAIKEI_API_TOKEN are sent to the guaikei.com API.
\nMitigation: Use the skill only for workflows where sending those values to the third-party API is acceptable, and store the token in an environment variable rather than in prompts or files.
\nRisk: Collected public comments, account data, and search results are saved as local JSON logs.
\nMitigation: Review, restrict, or delete generated log files when the collected data is sensitive for the workflow.
\nRisk: The skill is limited to public Douyin data and does not support private or hidden content.
\nMitigation: Use it only for public-data retrieval tasks and avoid relying on it for private-account monitoring or complete coverage claims.
\n\n\n## Reference(s):
\n- [ClawHub skill page](https://clawhub.ai/um-why/douyin-search-keyword)
\n- [Publisher profile](https://clawhub.ai/user/um-why)
\n- [Options reference](references/options.md)
\n- [Changelog](references/changelog.md)
\n- [Search input schema](assets/search_cli_req.schema.json)
\n- [Search output schema](assets/search_cli_resp.schema.json)
\n- [Post input schema](assets/post_cli_req.schema.json)
\n- [Post output schema](assets/post_cli_resp.schema.json)
\n- [Comment input schema](assets/comment_cli_req.schema."}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\r\nname: douyin-search-keyword\r\ndescription: 抖音公开数据只读工具箱，提供4个能力：①关键词搜索（可按点赞/最新排序、时间窗、时长、图文类型筛选）②博主主页作品抓取 ③视频/图文评论抓取 ④实时热榜。输出结构化 JSON（含作者、互动数据、标签、链接）。当用户需要搜抖音视频、抓博主作品、看抖音评论、查抖音热榜、做竞品/对标账号监控、短视频选题调研、评论舆情分析、热点追踪、爆款挖掘时使用。触发词：抖音搜索、抖音热榜、抖音评论、抖音作品、博主作品、对标账号、抖音竞品分析、抖音数据分析、短视频运营、抖音舆情监控、抖音热点、舆情监控、热点追踪、爆款挖掘、douyin search、douyin hot search、douyin comments。\r\nlicense: MIT\r\nmetadata:\r\n enabled: true\r\n type: command\r\n runtime: \"nodejs@16.14.0+\"\r\n version: 1.3.0\r\n requires:\r\n bins:\r\n - \"node\"\r\n env:\r\n - \"GUAIKEI_API_TOKEN\"\r\n env_desc:\r\n GUAIKEI_API_TOKEN: \"抖音数据 API 访问令牌。未配置时无法调用接口；可通过 https://www.guaikei.com 开通，或联系开发者(wx 13395823479)获取支持。\"\r\n category:\r\n - \"Data&APIs\"\r\n - \"内容创作\"\r\n - \"数据分析\"\r\n - \"商业运营\"\r\n - \"办公效率\"\r\n tags:\r\n - \"抖音\"\r\n - \"douyin\"\r\n - \"抖音搜索\"\r\n - \"抖音热榜\"\r\n - \"抖音评论\"\r\n - \"抖音作品\"\r\n - \"抖音竞品分析\"\r\n - \"抖音数据分析\"\r\n - \"短视频运营\"\r\n - \"短视频\"\r\n - \"舆情监控\"\r\n - \"热点追踪\"\r\n - \"爆款挖掘\"\r\n - \"竞品分析\"\r\n - \"营销分析\"\r\n - \"search\"\r\n - \"数据挖掘\"\r\n - \"content-analysis\"\r\n - \"competitor-analysis\"\r\n - \"marketing\"\r\n - \"trend-tracking\"\r\n schemas:\r\n - name: \"搜索入参\"\r\n file: \"assets/search_cli_req.schema.json\"\r\n - name: \"搜索出参\"\r\n file: \"assets/search_cli_resp.schema.json\"\r\n - name: \"作品入参\"\r\n file: \"assets/post_cli_req.schema.json\"\r\n - name: \"作品出参\"\r\n file: \"assets/post_cli_resp.schema.json\"\r\n - name: \"热榜出参\"\r\n file: \"assets/hot_cli_resp.schema.json\"\r\n - name: \"评论入参\"\r\n file: \"assets/comment_cli_req.schema.json\"\r\n - name: \"评论出参\"\r\n file: \"assets/comment_cli_resp.schema.json\"\r\n examples:\r\n - '搜抖音里\"AI 教程\"最火的视频: node src/douyin/search-cli.js --keyword \"AI 教程\" --sort 1'\r\n - '看最近一周抖音上\"AI 模型\"最新的 20 条内容: node src/douyin/search-cli.js --keyword \"AI 模型\" --sort 2 --time 7 --limit 20'\r\n - \"查抖音今天有什么热点/热搜榜: node src/douyin/hot-cli.js\"\r\n - '抓这个抖音博主最近 30 条作品: node src/douyin/post-cli.js --url \"https://www.douyin.com/user/MS4wLjABxxx\" --limit 30'\r\n - '看这条抖音视频的 40 条评论: node src/douyin/comment-cli.js --url \"https://www.douyin.com/video/xxx\" --limit 40'\r\n---\r\n\r\n# 🚀 抖音关键词搜索、竞品分析、舆情监控与热榜跟踪工具 (Douyin Search & Analytics)\r\n\r\n## 1. 🛠️ 技能概述\r\n\r\n抖音公开数据只读获取工具。支持**关键词搜索排序**、**博主作品抓取**、**视频/图文评论抓取**、**实时热榜获取**，输出结构化 JSON，适用于短视频选题、竞品监控、舆情分析、热点追踪。\r\n\r\n> **合规前置说明（重要）**：调用本技能会把用户提供的关键词/链接发送至第三方数据 API（域名 `www.guaikei.com`）以换取结果。本技能不上传任何本地文件，不登录任何账号，无任何写操作（不发布/点赞/评论/关注）。仅处理抖音公开数据，不支持私密/登录态数据；数据仅限个人/团队内部分析。\r\n\r\n**🔥 核心特性**\r\n\r\n- 安全：无需登录抖音账号，无风控/封号风险\r\n- 强大：单次最多可获取 1W 条数据\r\n- 全面：出参覆盖作者、互动、标签、链接等可用数据及有价值数据都会返回\r\n- 轻量：零第三方依赖，Node.js 内置模块直接运行\r\n- 友好：stdout 纯 JSON、日志走 stderr，便于 AI 稳定解析\r\n\r\n## 2. ✅ 何时调用与能力边界\r\n\r\n**🎯 应调用**：\r\n\r\n- 用户明确要查 **抖音** 的公开内容（视频/图文/作者/评论/热榜）。\r\n- 用户要做关键词搜索、爆款选题调研、对标账号监控、评论洞察、热点追流。\r\n- 用户提供了抖音关键词、视频/主页链接，希望拿到结构化数据。\r\n\r\n**🚫 不调用**：\r\n\r\n- 用户只想要文案/标题/脚本，未要求查抖音数据。\r\n- 平台不是抖音：小红书 / 快手 / B站 / 微博 / 公众号 → 路由到对应技能，**不要用本技能**。\r\n- 要求私密/登录态/隐藏数据。\r\n- 既无关键词也无可识别抖音链接且目标不明 → 先追问。\r\n\r\n## 3. 🔀 意图路由决策树（按顺序判断，命中即停）\r\n\r\n```\r\n1. 提到\"热榜/热搜/热点/今天什么火/榜单\" → hot-cli.js（无需参数）\r\n2. 提到\"评论/留言\"且指向某"},{"path":"readme.md","content":"# 🚀 抖音数据采集工具｜关键词搜索 · 博主作品 · 视频评论 · 实时热榜（无需登录 / 不封号）\r\n\r\n> **💡一句话价值**：一条命令拿到抖音公开的视频/作者/评论/热榜数据，直接输出结构化 JSON——做爆款选题、对标账号监控、评论舆情分析、热点追踪，不用再手动刷抖音。\r\n\r\n**维护状态**：持续更新中，当前版本 `1.3.0`，[更新日志](references/changelog.md)。\r\n\r\n> **🔥核心优势**\r\n>\r\n> - 安全: 无需登录你的抖音账号，不担心风控风险 / 封号问题\r\n> - 强大: 一次可获取最多1W条数据，使用简单方便\r\n> - 全面: 各功能出参数据全面，可见及有价值数据都会返回\r\n> - 灵活: 支持多维度筛选\r\n> - 轻量: 无需部署服务，Node.js 一键运行\r\n> - 低耗: 日志自动归档，适配营销报告 / 内容策划场景 ，便于数据二次分析\r\n\r\n## ✅ 我能帮你解决什么（10 秒判断）\r\n\r\n| 你是谁 | 你要做的事 | 用哪个功能 |\r\n| ---------- | -------------------------------- | --------------------------- |\r\n| 短视频运营 | 找爆款选题、分析高赞视频规律 | 关键词搜索（点赞/最新排序） |\r\n| 品牌/投放 | 监控对标账号的内容策略和发文节奏 | 博主作品抓取 |\r\n| 舆情/客服 | 看一条视频评论区在骂还是在夸 | 评论抓取 |\r\n| 所有人 | 今天抖音在火什么，追热点 | 实时热榜 |\r\n\r\n**产出物**：结构化 JSON（含标题、作者、点赞/评论/收藏/分享、标签、视频链接），可直接导入 Excel/BI，或交给 AI 生成选题库、竞品对比表、舆情周报。\r\n\r\n## 🚀 3 步接入\r\n\r\n1. **装 Node.js**（16.14.0+，Windows/Mac/Linux 均可，约 2 分钟）\r\n2. **拿 TOKEN**：访问 [抖音搜索技能官网](https://www.guaikei.com) 自助开通，配置环境变量 `GUAIKEI_API_TOKEN`\r\n - Windows：`set GUAIKEI_API_TOKEN=你的TOKEN`\r\n - Linux/MacOS：`export GUAIKEI_API_TOKEN=你的TOKEN`\r\n3. **复制一条命令跑**（10-60 秒出结果）👇\r\n\r\n### 最快上手（复制就能跑）\r\n\r\n```bash\r\n# 🔎 搜\"AI\"相关的抖音视频\r\nnode src/douyin/search-cli.js --keyword \"AI\"\r\n\r\n# 🔎 按点赞排序找爆款（最常用）\r\nnode src/douyin/search-cli.js --keyword \"AI\" --sort 1\r\n\r\n# 🦸 抓某个博主的作品（直接粘贴 App 分享链接也行）\r\nnode src/douyin/post-cli.js --url \"https://www.douyin.com/user/MS4wLjABxxx\" --limit 20\r\n\r\n# 💬 看这条视频的评论\r\nnode src/douyin/comment-cli.js --url \"https://www.douyin.com/video/xxx\" --limit 100\r\n\r\n# 📡 抖音实时热榜\r\nnode src/douyin/hot-cli.js\r\n```\r\n\r\n> 💡 Windows cmd.exe 下请使用双引号；PowerShell / bash 可直接执行。\r\n> 💡 技能支持直接粘贴 App 分享文案（含\"复制到剪贴板…\"字样和短链），链接会自动抽取、参数自动清理。\r\n\r\n### 你会得到什么（真实输出结构示例）\r\n\r\n```json\r\n{\r\n \"status\": \"success\",\r\n \"error_code\": \"OK\",\r\n \"request\": {\r\n \"command\": \"search\",\r\n \"keyword\": \"AI 教程\",\r\n \"sort\": 1,\r\n \"limit\": 20\r\n },\r\n \"metadata\": { \"skill_version\": \"1.3.0\", \"execution_time\": 34210 },\r\n \"results\": [\r\n {\r\n \"desc\": \"3 分钟讲透 RAG…\",\r\n \"author_nickname\": \"某某说AI\",\r\n \"author_sec_uid\": \"MS4wLjABAAAA…\",\r\n \"author_url\": \"https://www.douyin.com/user/MS4wLjABAAAA…\",\r\n \"digg_count\": 123456,\r\n \"comment_count\": 8901,\r\n \"share_count\": 1200,\r\n \"collect_count\": 3400,\r\n \"url\": \"https://www.douyin.com/video/7xxxxxxxxxxxxxxxxxx\",\r\n \"create_time_str\": \"2026/9/4 20:13:20\",\r\n \"tags\": [\"#AI\", \"#教程\"]\r\n }\r\n ]\r\n}\r\n```\r\n\r\n---\r\n\r\n## 📌 适用场景（我该不该用？）\r\n\r\n- 需要短视频选题 → 关键词搜索 + 点赞排序\r\n- 需要研究对标账号 → 按主页链接抓取其公开作品（**一次抓一个账号**，多个账号逐条执行即可）\r\n- 需要分析内容舆情 → 获取视频/图文评论\r\n- 需要快速追热点 → 实时获取抖音热榜\r\n- 需要做营销报告 → 输出结构化 JSON，自动落盘留存\r\n\r\n## 🔍 和其他方式比，凭什么用它？\r\n\r\n| 对比项 | 本技能 | 手动刷抖音 | 自己写爬虫 |\r\n| -------------- | -------------------------- | --------------------- | ---------------------------- |\r\n| 上手成本 | 一条命令，5 分钟接入 | 0，但整理数据极费时间 | 需要逆向/维护，门槛高 |\r\n| 登录与封号风险 | **无需登录，只读公开数据** | 无 "},{"path":"_meta.json","content":"{\n \"ownerId\": \"kn79p9y6xrdxyr0maxy3tj5nb9835e0e\",\n \"slug\": \"douyin-search-keyword\",\n \"version\": \"1.3.0\",\n \"publishedAt\": 1789293094602\n}"},{"path":"references/changelog.md","content":"# 抖音关键词搜索 (Douyin Search & Analytics) 更新日志\r\n\r\n## 1.3.0 - 2026-09-13\r\n\r\n- 增加获取抖音博主互动数据的功能。\r\n- 优化SKILL返回方式\r\n\r\n## 1.2.2 - 2026-08-17\r\n\r\n- bug紧急修复。\r\n\r\n## 1.2.1 - 2026-08-16\r\n\r\n- 技能细节打磨，优化AI对技能的识别及解析能力。\r\n- 增强参数与命名处理。\r\n- 技能描述、分类和标签进一步优化，适配更多抖音相关业务场景。\r\n- 示例命令更聚焦实际检索和分析场景，便于快速上手。\r\n- 增强环境变量说明与能力边界指引，提升使用与接入体验。\r\n\r\n## 1.2.0 - 2026-08-08\r\n\r\n- 搜索功能优化，支持类型搜索（视频、图文等）。\r\n- 各项功能细节优化。\r\n\r\n## 1.1.5 - 2026-06-18\r\n\r\n- 新增抖音视频评论获取功能，支持抓取并分析指定作品的评论内容。\r\n- 更新 schema，新增评论入参与出参 JSON Schema 规范，完善数据结构。\r\n- SKILL.md 说明文档同步更新，增加评论分析与用法示例。\r\n\r\n## 1.1.4 - 2026-06-09\r\n\r\n- 新增多份 JSON 模式文件，用于命令行结构化输入输出校验。\r\n- 在 references/ 目录下添加文档：更新日志（changelog.md）、配置说明（options.md）。\r\n- 优化 SKILL.md：补充模式文件引用，并完善令牌获取相关说明。\r\n- 为技能元数据补充模式定义，提升兼容性与自检能力。\r\n\r\n## 1.1.3 - 2026-05-11\r\n\r\n**新增：支持获取抖音作者（抖人）已发布作品，实现竞品账号内容批量抓取。**\r\n\r\n- 新增 post-cli 指令，可根据抖音主页 URL 或 sec_uid 一键获取创作者所有公开作品，便于竞品监控和账号内容分析。\r\n- 参数说明、使用范例及常见问题等文档内容同步更新，更清晰指引新功能使用方式。\r\n- 指令参数支持短缩写，limit上限提升至200，提升批量数据抓取能力。\r\n- 关键词搜索、热榜等原有功能保持兼容并优化参数配置，提升整体易用性。\r\n- 调整并精简 Skill 文档，增加使用案例，强调 TOKEN 申请与日志留存说明。\r\n- 示例与文档同步完善，能力标签更明确。\r\n\r\n## 1.1.2 - 2026-05-04\r\n\r\n- 新增支持抖音热搜榜单查询（hot-cli.js），可独立调用。\r\n- 关键词搜索与热榜查询分别独立为入口（search-cli.js/hot-cli.js）。\r\n- 项目结构优化，API与工具模块化拆分，便于维护与扩展。\r\n- 移除旧 scripts/lib 目录，迁移为 src/api、src/utils、src/validate 目录。\r\n- 更新文档与示例，增强上手指引与使用场景说明。\r\n\r\n## 1.1.1 - 2026-03-31\r\n\r\n- 更新 JSON 响应中的输出字段，明确标记更多字段，提高下游解析的一致性。\r\n- 无功能或界面变更;文档现在准确反映了输出模式中始终存在的字段。\r\n\r\n## 1.1.0 - 2026-03-31\r\n\r\n**重大升级：结构化输出、多参数排序与筛选能力增强**\r\n\r\n- 增加多维度排序（综合/最多点赞/最新发布）和发布时间筛选（1天/7天/半年），结果更精准。\r\n- 支持自定义返回数量（1~60条）。\r\n- 完全结构化 JSON 输出，字段覆盖互动数据、标签等，适配 OpenClaw 生态。\r\n- 内置参数合法性校验、敏感词过滤及安全保护，保证调用稳定合规。\r\n- 增强任务轮询&超时重试机制，提升检索成功率和稳定性。\r\n- 技能文档全面更新，提供详细参数表、示例与应用场景说明。\r\n\r\n## 1.0.2 - 2026-03-24\r\n\r\n- 技能重命名为“douyin-search-keyword”。\r\n- 在SKILL.md中添加了openclaw元数据、使用帮助、许可证、标签和示例，以实现更好的集成与文档化。\r\n- 移除了两个本地文件（.env 和 scripts/last-search.json），以优化代码结构并提升安全性。\r\n- 文档现已更加简洁且以用户为中心，重点在于提供清晰的使用说明和数据字段解释。\r\n- 突出技能特性、合规要点及技术流程。\r\n\r\n## 1.0.1 - 2026-3-20\r\n\r\n- 更新技能描述，强调支持多维度抖音公开内容检索（视频、图文、用户等）\r\n- 扩展文档，新增适用/不适用场景说明\r\n- 新增环境和token配置的详细步骤与平台限制说明\r\n- 明确数据字段及样例，补充表格形式字段解释\r\n- 强调合规、风控及临时链接有效期注意事项\r\n\r\n## 1.0.0 - 2026-03-18\r\n\r\n- douyin-search-general 技能首次发布。\r\n- 提供抖音通用搜索接口，支持视频、图文、用户及社交数据搜索。\r\n- 返回详细信息，包括内容描述、作者、发布时间、点赞数、评论数、分享数、封面图片及视频链接。\r\n- 需要Node.js和有效的GUAIKEI_API_TOKEN环境变量才能运行。\r\n- 输出包含可直接复制的URL，并附有示例响应格式说明。"},{"path":"references/options.md","content":"# 抖音关键词搜索 (Douyin Search & Analytics) 完整选项参数说明\r\n\r\n## 🔎 抖音关键词搜索\r\n\r\n| 参数 | 缩写 | 作用 | 可选值 | 必填 | 默认值 |\r\n| :----------- | :--: | :----------- | :----------------------------------------------------- | :--- | :----: |\r\n| `--keyword` | `-k` | 搜索关键词 | 2-50 位长度的字符或单词 | 是 | |\r\n| `--sort` | `-s` | 排序方式 | 0 = 综合排序 / 1 = 最多点赞 / 2 = 最新发布 | 否 | 0 |\r\n| `--time` | `-t` | 时间范围 | 0 = 全部 / 1 = 一天内 / 7 = 七天内 / 180 = 半年内 | 否 | 0 |\r\n| `--duration` | `-d` | 视频时长 | 0 = 不限 / 1 = 1分钟以下 / 2 = 1-5分钟 / 3 = 5分钟以上 | 否 | 0 |\r\n| `--content` | `-c` | 内容类型 | 0 = 不限 / 1 = 视频 / 2 = 图文 | 否 | 0 |\r\n| `--limit` | `-l` | 获取数量 | 1-10000 条 | 否 | 10 |\r\n| `--help` | `-h` | 显示帮助信息 | | 否 | |\r\n\r\n```bash\r\n# **基础语法**\r\nnode src/douyin/search-cli.js --keyword <关键词> --sort <排序方式> --time <时间范围> --duration <视频时长> --content <内容类型> --limit <获取数量>\r\n\r\n# **使用示例**\r\n\r\n# 搜索\"AI 教程\"的抖音内容\r\nnode src/douyin/search-cli.js --keyword \"AI 教程\"\r\n\r\n# 搜索 AI 获取最多点赞的抖音内容\r\nnode src/douyin/search-cli.js --keyword \"AI\" --sort 1\r\n\r\n# 搜索近7天\"AI 模型\"的抖音内容\r\nnode src/douyin/search-cli.js --keyword \"AI 模型\" --time 7\r\n\r\n# 搜索\"AI 教程\"视频时长在5分钟以上的抖音内容\r\nnode src/douyin/search-cli.js --keyword \"AI 教程\" --duration 3\r\n\r\n# 搜索半年内最新20条\"AI 教程\"的抖音内容\r\nnode src/douyin/search-cli.js --keyword \"AI 教程\" --sort 2 --time 180 --limit 20\r\n```\r\n\r\n## 🦸 抖音博主作品获取\r\n\r\n| 参数 | 缩写 | 作用 | 可选值 | 必填 | 默认值 |\r\n| :-------- | :--: | :----------------------- | :--------- | :--- | :----: |\r\n| `--url` | `-u` | 抖音博主主页URL或sec_uid | | 是 | |\r\n| `--limit` | `-l` | 获取作品数量 | 0-10000 条 | 否 | 10 |\r\n| `--help` | `-h` | 显示帮助信息 | | 否 | |\r\n\r\n> **💡\"抖音博主主页URL\"说明**\r\n>\r\n> - PC端 ( 格式： )\r\n> - 移动端 ( 格式： )\r\n> - 技能关键词搜索返回的author_sec_uid字段\r\n\r\n```bash\r\n# **基础语法**\r\nnode src/douyin/post-cli.js --url \"https://www.douyin.com/user/MS4wLjABxxx\"\r\n\r\n# **使用示例**\r\n\r\n# 获取抖音博主 MS4wLjABxxx 已发布的20条作品\r\nnode src/douyin/post-cli.js --url \"https://www.douyin.com/user/MS4wLjABxxx\" --limit 20\r\n\r\n# 获取抖音博主 MS4wLjABxxx 的互动数据（关注数、粉丝数、总获赞数）等信息。\r\nnode src/douyin/post-cli.js -u \"https://www.douyin.com/user/MS4wLjABxxx\" -l 0\r\n```\r\n\r\n## 💬 抖音作品评论数据\r\n\r\n| 参数 | 缩写 | 作用 | 可选值 | 必填 | 默认值 |\r\n| :-------- | :--: | :---------------------------- | :--------- | :--- | :----: |\r\n| `--url` | `-u` | 抖音视频(或图文)URL或aweme_id | | 是 | |\r\n| `--limit` | `-l` | 获取评论数量 | 1-10000 条 | 否 | 10 |\r\n| `--help` | `-h` | 显示帮助信息 | | 否 | |\r\n\r\n```bash\r\n# **基础语法**\r\nnode src/douyin/comment-cli.js --url \"https://www.douyin.com/video/xxx\"\r\n\r\n# **使用示例**\r\n\r\n# 获取视频 xxx 的1"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":null,"editorialQuality":{"score":100,"threshold":65,"status":"thin","wordCount":998,"uniquenessScore":44,"reasons":["uniqueness-below-45"]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-10-09T09:11:52.302Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-10-09T09:11:52.302Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-10T03:39:43.669Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}