SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场virlo

virlo

营销与增长

查看项目

更新于 10-16 06:56

技能介绍

Virlo 是内容表现数据管道中的原始信号采集层。它根据你设置的关键词扫描 TikTok、Instagram 和 YouTube 上的细分领域内容，并按计划（每日、每周等）自动运行，输出匹配关键词的视频、创作者异常值以及 Meta 广告（需启用）。可以把它理解为一个针对任意细分领域的原始表现扫描器：设置一次，持续收集情报。

用途

当你需要原始的表现情报而非最终解读时，使用 Virlo。典型场景包括：查看当前什么内容表现好、展示某细分领域的头部视频、发现爆款创作者/异常值、拉取原始 Virlo 数据、查看与细分领域相关的广告、设置或管理 Comet。

如果真正目标是：将表现数据与 Reddit/X 讨论结合、判断什么重要及原因、生成每周细分领域简报、将融合信号集输入 The Forge，则应使用 Content Radar，而非 Virlo。Virlo 不决定什么重要，它只负责获取信号，供其他技能解读。

主要能力

  • Comet（自定义细分配置）：保存的细分领域配置，包含名称、关键词（最多 20 个短语）、平台（tiktok、instagram、youtube 或全部）、抓取频率（daily/weekly/monthly 或 cron 表达式，最高每天一次）、最低播放量过滤、时间范围（today、this_week、this_month、this_year）。创建后 Virlo 按计划自动运行并存储结果。
  • 视频采集：获取匹配关键词的视频，可按平台、播放量、日期过滤，支持排序和数量限制。
  • 创作者异常值：当某创作者的单个视频表现远超其基线时标记为异常值。异常值比率 = 爆款视频播放量 ÷ 创作者平均播放量，比率越高表示突破信号越强。
  • Meta 广告：当配置启用 meta_ads_enabled 时，采集与关键词相关的广告。

使用方式

脚本位置：~/clawd/skills/virlo/scripts/virlo.sh

创建细分配置：

./virlo.sh create \
  --name "AI Marketing" \
  --keywords "ai marketing,vibe marketing,ai automation" \
  --platforms "tiktok,instagram,youtube" \
  --cadence "daily" \
  --min-views 1000 \
  --time-range "this_week"

可选标志：--meta-ads 启用 Meta 广告采集；--inactive 创建为暂停状态；--exclude "spam,ads" 排除关键词。

列出所有配置：

./virlo.sh list
./virlo.sh list --all    # 包含非活跃配置

获取配置的视频：

./virlo.sh videos <comet-id>
./virlo.sh videos <comet-id> --limit 20 --min-views 5000 --platform tiktok
./virlo.sh videos <comet-id> --order-by views --sort desc

获取创作者异常值：

./virlo.sh outliers <comet-id>
./virlo.sh outliers <comet-id> --limit 20 --order-by outlier_ratio
./virlo.sh outliers <comet-id> --platform tiktok

获取 Meta 广告（需配置启用 meta_ads_enabled）：

./virlo.sh ads <comet-id>
./virlo.sh ads <comet-id> --limit 20

获取单个配置详情：

./virlo.sh get <comet-id>

删除配置：

./virlo.sh delete <comet-id>

API 端点参考

  • POST /v1/comet：创建新的细分配置
  • GET /v1/comet：列出所有配置
  • GET /v1/comet/:id：获取单个配置详情
  • DELETE /v1/comet/:id：删除配置
  • GET /v1/comet/:id/videos：获取采集的视频
  • GET /v1/comet/:id/creators/outliers：获取爆款创作者
  • GET /v1/comet/:id/ads：获取 Meta 广告

所有端点使用 Bearer 认证：Authorization: Bearer $VIRLO_API_KEY

适用场景

  • 需要原始表现数据来发现当前热门内容
  • 追踪特定细分领域的爆款创作者和突破信号
  • 监控与关键词相关的 Meta 广告
  • 作为内容雷达、The Forge、Monday Drop 等下游技能的数据来源

限制与注意事项

  • virlo.sh setup 在 macOS/Linux 上会将 VIRLO_API_KEY 保存到检测到的 shell 配置文件中；在 Windows 上会打印 PowerShell 和命令提示符命令以持久化密钥。
  • Windows 上需从 Git Bash 或 WSL 运行本地 shell 脚本。
  • 频率选项：daily、weekly、monthly 或任意 cron 表达式（最高每天一次）。
  • 时间范围选项：today、this_week、this_month、this_year。
  • 平台选项：tiktok、instagram、youtube。
  • 视频在首次计划运行后才会被采集，新配置不会立即有数据。
  • 异常值比率 = 爆款视频播放量 ÷ 创作者平均播放量（越高表示突破越大）。
  • Meta 广告仅在配置中 meta_ads_enabled: true 时出现。
  • 创建后需将 comet ID 存储在 ~/clawd/skills/virlo/comets.json。
  • 关于收费、价格、平台支持范围等更多信息暂未提供。