Find Tencent Ads Video Skills

理解用户意图并在腾讯广告妙思平台检索广告视频，返回标题、曝光量、时长和详情页链接

Security Scan

The skill's code, instructions, and requested resources match its stated purpose (searching admuse.qq.com for video ads); there are small implementation inconsistencies and privacy considerations (use of a logged-in browser session) but no signs of unrelated or malicious behavior.

Purpose & Capability

Name/description (search Tencent Ads '妙思' for video ads) align with what the package provides: Node scripts to expand keywords, track recommended URLs, and produce an auto-scroll script for the built-in browser. The only required binary is node which is reasonable. Minor mismatch: search-ads.js points to a DATA_FILE under '.. /data/recommended.json' while other scripts and the manifest use '.. /references/recommended.json' (this is a likely bug but not malicious).

Instruction Scope

SKILL.md explicitly instructs the agent to use the OpenClaw built-in browser and an already-logged-in browser session to fetch detail page links. The scripts read and write a local recommended.json to track deduplication and provide CLI helpers to list/clear/add entries. There are no instructions to read unrelated system files, call unknown external endpoints, or exfiltrate secrets. Note: relying on a logged-in browser session means the browser automation will have access to whatever that session permits (cookies, pages) — a privacy consideration rather than an inherent inconsistency.

Install Mechanism

No install spec; this is instruction-plus-scripts only. No downloads from remote URLs or extracted archives. The scripts are local Node files and do file I/O under the skill's directory or the user's home (~/.openclaw).

Credentials

The skill requests no environment variables or external credentials. The only sensitive dependency is use of the user's logged-in browser state (cookies/sessions) to obtain detail links from admuse.qq.com — expected for this functionality but worth noting because it gives the agent access to any site session present in that browser profile.

Persistence & Privilege

always:false and autonomous invocation not disabled (normal). The skill writes and maintains its own small state file (recommended.json) under the skill directory / ~/.openclaw and does not attempt to modify other skills or global agent configuration. It does not request permanent elevated privileges.

Assessment

This skill appears to do what it claims: search admuse.qq.com using the platform's browser automation and keep a local deduplication file. Before installing, consider: 1) Privacy: the skill will use your logged-in browser session — use a dedicated browser profile or ensure you are logged into only the intended account to avoid accidental access to other services. 2) Local files: it reads/writes a recommended.json under the skill directory (~/.openclaw/... or references/) — back up or inspect this file if you care about local state. 3) Minor bug: search-ads.js references a different data path (../data/recommended.json) while other scripts use ../references/recommended.json; the skill may fail until paths are aligned. 4) Confirm that your OpenClaw/OpenClass browser tool restricts navigation to expected domains (admuse.qq.com) if you worry about autonomous navigation. 5) If unsure, review the scripts (they are short and local) or run them in a test/isolate profile first.

腾讯广告妙思视频检索

快速检索腾讯广告妙思平台的广告创意视频，支持自然语言搜索，返回视频详情页链接。

快速开始

# 直接在 WorkBuddy 中询问
"帮我检索奶粉广告视频"
"防晒衣广告视频爆款参考"
"找一些汽车类的广告创意"
"搜索美妆广告案例"
"零食广告视频"

功能特点

• ✅ 支持自然语言搜索
• ✅ 自动获取详情页链接
• ✅ 智能去重：自动过滤已推荐过的链接，确保不重复推荐
• ✅ 智能扩展：当搜索结果不足时，自动扩展同义词搜索（如"防晒衣"→"防晒"、"遮阳帽"等）
• ✅ 自动翻页：当页面素材不足时，自动下拉刷新加载更多
• ✅ 默认返回 10 条结果

智能去重

系统会自动记录已推荐给用户的广告链接，每次检索时会自动过滤掉这些链接，确保用户不会收到重复的推荐。

查看去重记录

# 查看当前已推荐的链接数量
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. 重复直到获取足够结果或无更多内容

查看同义词表

# 查看所有同义词映射
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 清空记录后重试

无法访问网站

• 检查网络连接
• 确认网站是否可访问
• 验证账号权限

搜索无结果

• 尝试更换搜索关键词
• 检查关键词是否过于宽泛或具体
• 确认网站是否有相关内容