video-search — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited video-search (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
跨平台（TikTok、YouTube、Instagram）短视频搜索，支持基于 Hashtag、视频标题、播放量、互动率、发布日期等多维度筛选，结果即时返回。不传 platform 时可跨平台搜索。
与达人搜索的区别：视频搜索直接返回视频维度的数据（含视频指标 + 发布达人信息），适合“找某个话题下的爆款视频”“按播放量筛选热门视频”等场景。如需搜索达人本人信息，使用 creator-search 子 skill。| 脚本 | 相对路径 | 状态 |
|---|---|---|
| search_videos.mjs | ../../scripts/search_videos.mjs | 可用 |
| search_brand_video_insights.mjs | ../../scripts/search_brand_video_insights.mjs | 可用 |
调用格式：
node {baseDir}/scripts/search_videos.mjs '{"platform":"tiktok","hashtag":["beauty","skincare"],"video_views_cnt_gte":100000,"page":1,"size":10}'品牌视频洞察检索（复用关键词监控的 hashtag 扩展逻辑，只查已有视频库，不自动触发实时采集）：
node {baseDir}/scripts/search_brand_video_insights.mjs '{"brand_name":"Fenty Beauty","platforms":["tiktok"],"limit":20}'当调用 search_brand_video_insights.mjs 时，不要直接把原始 JSON 丢给用户。必须按下面结构展示：
keyword_expansion.used_hashtags，让用户知道品牌名被扩展成了哪些检索词。summary：命中视频数、平台分布、热门标签、高频达人。items，推荐字段为：#、平台、视频标题、匹配词、播放量、点赞、评论、互动率、达人、发布时间、视频链接。items 为空，只说明已有视频库未命中，不要静默切换普通视频搜索、网页搜索或实时采集；需要继续采集时先询问用户确认。推荐展示模板：
已在已有视频库中检索 {brand_name} 相关视频，未触发实时采集。
扩展检索词：{used_hashtags}
命中概览：
- 命中视频：{video_count} 条
- 平台分布：{platform_distribution}
- 热门标签：{top_hashtags}
- 高频达人：{top_creators}
| # | 平台 | 视频标题 | 匹配词 | 播放量 | 点赞 | 评论 | 互动率 | 达人 | 发布时间 | 视频 |
|---|---|---|---|---:|---:|---:|---:|---|---|---|所有参数均为可选（POST JSON Body 发送到后端），无必填参数，不传则返回最近 15 天的全平台热门视频。
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
platform | string | - | 平台：tiktok / youtube / instagram，不传则查所有平台 |
hashtag | array[string] | - | Hashtag 列表（精确匹配，最多 5 个，全部满足） |
video_title | string | - | 视频标题关键词（模糊匹配，最长 200 字符） |
video_views_cnt_gte | integer | - | 最小播放量 |
video_views_cnt_lte | integer | - | 最大播放量 |
video_interaction_rate_gte | number | - | 最小互动率（百分比，如 5.5 表示 5.5%） |
video_interaction_rate_lte | number | - | 最大互动率（百分比，如 20 表示 20%） |
video_publish_date_gte | string | 最近 15 天 | 发布日期起始（YYYY-MM-DD） |
video_publish_date_lte | string | 今天 | 发布日期截止（YYYY-MM-DD） |
union_user_ids | string | - | 达人 ID 列表（逗号分隔，按达人筛选视频） |
page | integer | 1 | 页码（1-10） |
size | integer | 10 | 每页数量（1-10，固定上限 10） |
platform 必须转换为小写：tiktok / youtube / instagram。hashtag 必须是 JSON 字符串数组，如 ["beauty"]，不要传单个字符串。5，不能传 0.05。YYYY-MM-DD。video_publish_date_gte 和 video_publish_date_lte 都不传时，默认最近 15 天。service_level 参数：视频搜索不使用分级计费。keyword / industry / gender / country_code 等达人筛选参数：这些属于 creator-search。sort_field / sort_order：视频搜索暂不支持自定义排序。| 字段 | 类型 | 说明 |
|---|---|---|
platform | string | 平台：tiktok / youtube / instagram |
videoId | string | 视频唯一标识 |
videoTitle | string | 视频标题 |
videoUrl | string | 视频页面 URL |
coverUrl | string | 视频封面 URL |
viewsCount | string | 播放量（字符串，避免大数精度问题） |
likesCount | string | 点赞数 |
commentsCount | string | 评论数 |
sharesCount | string | 分享数 |
interactionRate | string | 互动率（百分比字符串，如 "3.25"） |
publishDate | string | 发布日期 |
duration | string | 视频时长 |
hashtags | array[string] | Hashtag 列表 |
creator | object | 发布达人信息 |
creator.uid | string | 达人唯一标识 |
creator.username | string | 用户名 |
creator.nickname | string | 昵称 |
creator.avatar | string | 头像 URL |
{"platform":"tiktok","hashtag":["beauty"],"page":1,"size":10}{"video_views_cnt_gte":1000000,"page":1,"size":10}{"platform":"youtube","video_title":"skincare routine","video_interaction_rate_gte":5,"page":1,"size":10}{"union_user_ids":"7480117868423119918,7158794701745964074","page":1,"size":10}| # | 平台 | 视频标题 | 播放量 | 点赞 | 评论 | 互动率 | 达人 | 发布日期 | 视频链接 |[查看][linkN] 引用式，表格下方定义完整 URL。视频搜索按次计费，与搜索结果条数无关。具体积分单价由后端 @openapi_billing() 决定（通常为数 credits/次）。
| Code | 说明 | 处理方式 |
|---|---|---|
| 40001 | 无效平台参数 | 检查 platform 值（仅限 tiktok/youtube/instagram） |
| 40101 | API Key 无效 | 检查 CV_API_KEY |
| 50001 | 服务端错误 | 重试或联系支持，附带 request_id |
~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.