find-tencent-ads-video

# 腾讯广告妙思视频检索 快速检索腾讯广告妙思平台的广告创意视频，支持自然语言搜索，返回视频详情页链接。 ## 快速开始 ```bash # 直接在 WorkBuddy 中询问 "帮我检索奶粉广告视频" "防晒衣广告视频爆款参考" "找一些汽车类的广告创意" "搜索美妆广告案例" "零食广告视频" ``` ## 功能特点 - ✅ 支持自然语言搜索 - ✅ 自动获取详情页链接 - ✅ **智能去重**：自动过滤已推荐过的链接，确保不重复推荐 - ✅ **智能扩展**：当搜索结果不足时，自动扩展同义词搜索（如"防晒衣"→"防晒"、"遮阳帽"等） - ✅ **自动翻页**：当页面素材不足时，自动下拉刷新加载更多 - ✅ 默认返回 10 条结果 ## 智能去重 系统会自动记录已推荐给用户的广告链接，每次检索时会自动过滤掉这些链接，确保用户不会收到重复的推荐。 ### 查看去重记录 ```bash # 查看当前已推荐的链接数量 node ~/.openclaw/skills/find-tencent-ads-video-skills/scripts/track-urls.js list # 清空去重记录（谨慎使用） node ~/.openclaw/skills/find-tencent-ads-video-skills/scripts/track-urls.js clear ``` ## 智能关键词扩展 当搜索结果不足用户所需数量时，系统会自动扩展搜索关键词： **示例：** - 用户搜索"防晒衣" → 自动扩展为：防晒衣、防晒、防晒衫、防晒服、冰袖、遮阳帽... - 用户搜索"美妆" → 自动扩展为：美妆、化妆品、护肤品、彩妆... ### 扩展规则 1. **精确匹配**：查找预定义的同义词表 2. **模糊匹配**：检查关键词是否包含某个词根 3. **通用扩展**：根据关键词最后一个字进行简单扩展（如"衣"→"衫"、"服"） ## 自动翻页加载 当页面显示素材量不够时，系统会自动下拉页面刷新，触发懒加载获取更多内容： 1. 检测页面是否有"查看更多"按钮 2. 自动滚动到页面底部 3. 等待新内容加载 4. 重复直到获取足够结果或无更多内容 ### 查看同义词表 ```bash # 查看所有同义词映射 cat ~/.openclaw/skills/find-tencent-ads-video-skills/scripts/synonyms.js ``` ## 使用场景 - 检索特定品类的广告视频（奶粉、汽车、美妆、零食等） - 获取广告灵感和创意素材 - 查看视频详情页和完整信息 ## 工作流程 1. 理解用户自然语言请求，提取核心搜索关键词 2. 检查去重记录，过滤已推荐的链接 3. 使用 OpenClaw 内置浏览器工具访问 https://admuse.qq.com 并执行搜索 4. 逐个点击搜索结果，获取视频详情页链接 5. 将新推荐的链接保存到去重记录 6. 格式化展示结果 ## 技术要求 本技能依赖 OpenClaw 内置的浏览器工具（browser），无需额外安装 agent-browser。 ## 检索示例 ``` 用户：帮我检索8条美妆广告 助手会： 1. 打开腾讯广告妙思平台 2. 输入关键词"美妆"搜索 3. 过滤掉之前已推荐过的链接 4. 逐个点击结果获取详情页链接 5. 返回格式化的结果列表 6. 保存新链接到去重记录 ``` ## 返回结果格式 直接展示给用户的结果（简洁版）： ``` 搜到啦 🎉 找到 X条 关键词 相关广告视频： 1. 视频标题 - 曝光量：xxx | 时长：xx:xx - 详情页：https://admuse.qq.com/#/idea/detail/video/xxx 2. 视频标题 - 曝光量：xxx | 时长：xx:xx - 详情页：https://admuse.qq.com/#/idea/detail/video/xxx ...（以此类推） ⚠️ 微信用户注意：收到信息后需转发一次，链接才能变为可点击状态。 ``` ### 字段说明 | 字段 | 说明 | 示例 | |------|------|------| | title | 视频标题 | "优质莫代尔睡衣，柔软亲肤..." | | exposure | 曝光量 | "10W+", "5W", "3W+" | | duration | 视频时长 | "00:30", "01:45" | | detailUrl | 视频详情页链接 | https://admuse.qq.com/#/idea/detail/video/xxx | ### 注意事项 - 曝光量和时长在列表页即可获取，稳定可靠 - 点击率和3s完播率在当前平台版本中不稳定，暂不展示 ## 配置 - **超时时间**: 30秒 - **最大结果数**: 默认 10 条（用户可自定义数量） - **去重记录文件**: `~/.openclaw/skills/find-tencent-ads-video-skills/references/recommended.json` - **目标网站**: https://admuse.qq.com ## 登录要求 **重要**: 获取视频详情页链接需要登录状态 - 如果未登录，仍可以搜索和查看结果标题 - 但无法获取视频详情页的完整链接 - 建议先在浏览器中登录腾讯广告妙思平台 - 技能会自动使用已登录的浏览器状态 ## 微信特别说明 ⚠️ **微信用户注意**：用户如果在微信收到信息，需要将信息转发一次后链接才可以变为可点击跳转的状态。 ## 限制 - 依赖网站可访问性和结构稳定性 - **需要登录状态才能获取详情页链接** - 每次最多返回 10 条结果 - 自动过滤已推荐的链接 ## 故障排除 **无法获取详情页链接** - 确认已登录腾讯广告妙思平台 - 检查登录状态是否有效 - 未登录状态下仍可查看搜索结果标题 **搜索结果变少** - 可能是之前的链接已经占据了搜索结果的前几位 - 可以使用 `track-urls.js clear` 清空记录后重试 **无法访问网站** - 检查网络连接 - 确认网站是否可访问 - 验证账号权限 **搜索无结果** - 尝试更换搜索关键词 - 检查关键词是否过于宽泛或具体 - 确认网站是否有相关内容