| metadata | {"openclaw":{"enabled":true,"type":"command","tags":["douyin","search","crawler","data-mining","social-media"],"schemaVersion":"1.1","runtime":"nodejs@16+","entrypoint":"scripts/search.js","requires":{"bins":["node"],"env":["GUAIKEI_API_TOKEN"],"permissions":["read:api-results","write:local_logs"]},"outputFormat":{"default":"json","terminal":["json","markdown"],"jsonFields":[{"name":"status","type":"string","required":true,"description":"请求状态: success|empty|error"},{"name":"keyword","type":"string","required":true,"description":"清洗后的搜索关键词"},{"name":"results","type":"array","required":true,"description":"搜索结果列表（视频/图文）","items":{"type":"object","description":"单条抖音内容数据","properties":[{"name":"desc","type":"string","description":"内容标题/描述"},{"name":"author_nickname","type":"string","description":"发布人昵称"},{"name":"author_avatar","type":"string","description":"发布人头像URL"},{"name":"comment_count","type":"number","description":"评论数"},{"name":"digg_count","type":"number","description":"点赞数"},{"name":"share_count","type":"number","description":"分享数"},{"name":"collect_count","type":"number","description":"收藏数"},{"name":"dynamic_cover","type":"array","description":"动态封面URL列表","items":{"type":"string","description":"封面图片URL"}},{"name":"play_addr","type":"string","description":"视频播放URL"},{"name":"images","type":"array","description":"图文内容URL列表","items":{"type":"string","description":"图片URL"}},{"name":"tags","type":"array","description":"内容标签列表","items":{"type":"string","description":"标签文本"}},{"name":"url","type":"string","description":"抖音内容原生链接"},{"name":"author_url","type":"string","description":"发布人主页链接"},{"name":"create_time_str","type":"string","description":"发布时间（本地化字符串）"}]}},{"name":"total","type":"number","description":"搜索结果总数"},{"name":"timestamp","type":"string","required":true,"description":"搜索执行时间（本地化字符串）"},{"name":"sort","type":"number","required":true,"description":"排序依据: 0-综合|1-最多点赞|2-最新发布"},{"name":"time","type":"number","required":true,"description":"发布时间筛选: 0-全部|1-1天内|7-7天内|180-半年内"},{"name":"limit","type":"number","required":true,"description":"请求返回结果数量"},{"name":"output_format","type":"string","required":true,"enum":["json","markdown"],"description":"输出格式"},{"name":"message","type":"string","required":true,"description":"提示信息或错误信息"},{"name":"error_code","type":"string","description":"错误代码"}]},"arguments":[{"name":"keyword","type":"string","required":true,"minLength":2,"maxLength":50,"description":"抖音搜索关键词(支持中文、英文、数字)"},{"name":"sort","type":"number","required":false,"default":0,"enum":[0,1,2],"description":"排序依据：0-综合排序(默认)、1-最多点赞、2-最新发布"},{"name":"time","type":"number","required":false,"default":0,"enum":[0,1,7,180],"description":"发布时间筛选：0-全部(默认)、1-一天内、7-七天内、180-半年内"},{"name":"limit","type":"number","required":false,"default":10,"minimum":1,"maximum":60,"description":"返回结果数量，默认10条，最大60条"},{"name":"output","type":"string","required":false,"default":"json","enum":["json","markdown"],"description":"输出格式：json(默认)、markdown"}],"examples":[{"name":"基础搜索","command":"node scripts/search.js AI","description":"搜索关键词\"AI\"的抖音内容，返回10条综合排序结果，JSON格式输出","outputFormat":"json"},{"name":"带空格的关键词搜索","command":"node scripts/search.js \"AI 教程\"","description":"搜索关键词\"AI 教程\"的抖音内容，返回10条综合排序结果","outputFormat":"json"},{"name":"按最多点赞排序搜索","command":"node scripts/search.js AI --sort 1","description":"搜索关键词\"AI\"，返回10条最多点赞的抖音内容","outputFormat":"json"},{"name":"筛选近1天发布的内容","command":"node scripts/search.js AI --time 1","description":"搜索关键词\"AI\"，返回近1天内发布的10条抖音内容","outputFormat":"json"},{"name":"自定义返回结果数量","command":"node scripts/search.js AI --limit 20","description":"搜索关键词\"AI\"，返回20条综合排序的抖音内容","outputFormat":"json"},{"name":"Markdown格式输出","command":"node scripts/search.js AI --output markdown","description":"搜索关键词\"AI\"，返回10条结果并以Markdown格式输出","outputFormat":"markdown"},{"name":"复杂多参数搜索","command":"node scripts/search.js --keyword \"AI 教程\" --sort 2 --time 180 --limit 20","description":"搜索关键词\"AI 教程\"，返回半年内最新发布的20条抖音内容","outputFormat":"json"}],"capabilities":["实时搜索抖音公开内容（视频/图文）","提取内容标题、发布人、播放链接、互动数据（点赞/评论/收藏/分享）","支持多关键词组合搜索（空格分隔）","自定义排序（综合/最多点赞/最新发布）、发布时间范围（1天/7天/半年）","自定义返回结果数量（1-60条）、输出格式（JSON/Markdown）","结构化JSON输出（完全适配OpenClaw生态解析规范）","内置超时控制+自动重试机制（创建任务3次重试、查询结果60次轮询）","自动关键词清洗（过滤特殊字符）、参数合法性校验","搜索结果本地文件持久化（保存至last-search.json）","支持音乐信息、封面/图文URL提取"],"limitations":["仅支持公开API返回的抖音数据，无权限获取私密内容","仅提供视频/图片CDN链接，不支持直接下载（链接可能过期）","结果返回可能因网络波动延迟，建议间隔>2秒调用","关键词长度限制：2-50字符，禁止包含<>'&及HTTP链接","返回结果数量限制：1-60 条","API调用频率限制：2次/秒（超频率可能触发限流）"],"safety":["内置敏感/违规关键词检测拦截机制","仅采集公开数据，不存储/泄露用户隐私信息","完全符合OpenClaw安全规范与数据采集合规要求","环境变量TOKEN校验，默认TOKEN仅用于体验（效率/频率受限）"],"performance":["平均响应时间：< 30 秒（网络良好）","成功调用成功率：>95%","支持并发调用（需私有TOKEN授权）","创建任务超时时间：10秒/次，查询结果超时时间：5秒/次"]}} |
