douyin-searchlisted

# 抖音作品查询 ## 📝 简介 根据关键词搜索抖音热门爆款作品，支持按日期范围筛选，返回点赞、评论、分享、收藏、发布时间等互动数据，结果以结构化表格展示。 ## ✨ 功能特性 | 功能模块 | 能力描述 | 核心价值 | |---------|---------|---------| | 爆款搜索 | 关键词搜索抖音爆款作品 | 精准发现高热度内容 | | 日期筛选 | 支持按日期范围筛选 | 定位特定时间段的热门内容 | | 智能拓展 | 泛化词自动拓展为 10 个细分词 | 避免泛化词搜索结果偏差 | | 可点击链接 | 作品标题以超链接格式输出 | 一键跳转查看原作品 | | 订阅推送 | 支持关键词每日推送 | 定时获取最新爆款动态 | ## 🔑 鉴权 - 获取 API Key：前往 [红狐hub](https://redfox.hk/settings/api-keys?source=github) - 配置方式1：写入 `~/.openclaw/openclaw.json` → `{ "env": { "REDFOX_API_KEY": "ak_xxxx..." } }` - 配置方式2：终端执行 `export REDFOX_API_KEY="ak_xxxx..."` ## ⚙️ 工作流程 ### Step 1: 🔍 用户意图理解 **⚠️ 核心规则：优先提取细分方向词，而非泛化的大类词** | 用户输入 | 处理方式 | |---------|--------| | 无赛道关键词（"最近热门作品"） | 关键词传空字符串 `""`，查询全站热门 | | 有细分词（"职场穿搭"、"减脂餐"） | 直接搜索，无需拓展 | | 有泛化词（"穿搭"、"美食"） | 执行拓展策略（Step 2） | 细分词判断原则：有场景/人群/风格/意图修饰 → 细分词；纯大类无修饰 → 泛化词。 **提取精确关键词**：从用户描述中提取细分领域词，而非泛化词。例：用户说“帮我找电影领域热门话题”且自称“小众电影、港台文化” → 搜索“小众电影、港台电影、电影乐评”，❌ 而非只搜“电影”。 **过滤触发钩子词**：用户输入中的「热门文章」「热门作品」「爆款」「热门内容」「查询」「搜索」等词是调用 Skill 的触发钩子，不属于搜索关键词，必须剥离。例：用户说“查询AI热门文章” → 关键词为「AI」，❌ 而非「AI热门文章」。 ### Step 2: 🔄 泛化词拓展策略 **⚠️ 必须等待用户明确回复后再调用脚本！** | 步骤 | 操作 | |------|------| | 1. 生成细分词 | 生成10个适中大小的细分词（趋势词、人群词、场景词、意图词各2-3个），禁止调用脚本 | | 2. 等待用户回复 | 用户未回复时禁止调用脚本 | | 3. 执行 | 回复「拓展」→ 10词以英文逗号连接，仅调用一次脚本；回复「不拓展」→ 搜索原关键词 | 输出示例： ```text 我识别到「中产」是较大的分类，推荐以下细分方向： 老钱,轻奢,品质生活,松弛感,高级感穿搭,体面,法式穿搭,律师,医生,品质家居 回复「拓展」将同时搜索这10个词，回复「不拓展」将继续搜索「中产」 ``` ### Step 3: 📡 调用 API 接口 **3.1 时间解析规则** | 用户输入 | 解析方式 | 示例 | |---------|---------|------| | 绝对日期 | 解析为 `YYYY-MM-DD