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 | ✅ 可用 |
调用格式:
node {baseDir}/scripts/search_videos.mjs '{"platform":"tiktok","hashtag":["beauty","skincare"],"video_views_cnt_gte":100000,"page":1,"size":10}'所有参数均为可选(POST JSON Body 发送到后端),无必填参数,不传则返回最近 15 天的全平台热门视频。
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
platform | string | — | 平台:tiktok / youtube / instagram,不传则查所有平台 |
hashtag | array[string] | — | Hashtag 列表(精确匹配,最多 3 个,全部满足) |
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-searchsort_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.