Communitygithub.com

Upload-Post/viraloop

适用于 OpenClaw AI 智能体的技能,用于自动生成 TikTok 和 Instagram 轮播内容。通过分析任何网站 URL 提取品牌、竞品和核心价值主张,生成病毒式幻灯片,并通过 upload-post API 自动发布并配以热门音乐,内置分析反馈循环。

viraloop 是什么?

Viraloop 是一款专为开发者设计的 AI 技能,集成了 OpenClaw 智能体,可自动生成并发布适用于 TikTok 和 Instagram 的 6 页轮播图片。它通过分析任意网站 URL,自动提取品牌信息(如 Logo、色彩、排版)和竞品数据,并利用 Gemini 的视觉模型生成风格统一、内容结构(勾子-问题-解决方案-行动号召)优化的幻灯片。技能内置了自动发布功能(通过 upload-post.com API,支持免费套餐),并自动添加 TikTok 热门音乐。发布后,Viraloop 会通过 API 获取 TikTok 和 Instagram 的播放量、点赞等数据,并将其存入 learnings.json 文件,形成反馈循环,帮助用户不断优化钩子、发布时间和视觉风格。支持 Gemini(免费层)和 upload-post.com(无需信用卡),仅需配置 GEMINI_API_KEY、UPLOADPOST_TOKEN 和 UPLOADPOST_USER 三个环境变量即可启动。

兼容平台✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add Upload-Post/viraloop

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

viraloop 是做什么的?

分析任意网站,生成一套 6 页、视觉风格统一的轮播图,用于 TikTok 和 Instagram。直接发布到你的信息流(无需草稿),并自动配以热门音乐。Gemini 和 upload-post.com 都有免费套餐 — 无需信用卡即可开始。

理念:每日迭代循环

增长的关键在于 持续输出 + 学习:

  1. 每天发布 1 个轮播 - 持之以恒胜过病毒式爆红
  2. 追踪一切 - 每篇帖子都会生成数据
  3. 从数据中学习 - 什么钩子有效?什么时间段?什么视觉效果?
  4. 迭代改进 - 每个轮播都比上一个更好
第 1 天:发布 → 分析 → 学习
第 2 天:发布(改进版) → 分析 → 学习
第 3 天:发布(更优版) → 分析 → 学习
...
第 30 天:你拥有 30 个数据点和一套经过优化的策略

该技能维护一个 learnings.json 文件,累积所有帖子的洞察信息:

  • 效果最好的钩子
  • 最佳发布时间
  • 有效的视觉风格
  • 高转化率的行动号召(CTA)

这不是一次性的工具。这是一个增长引擎。

快速开始

# 1. 全面的商业研究
node {baseDir}/scripts/analyze-web.js https://your-website.com

# 2. 生成 3 个钩子变体(SHOCK, CURIOSITY, CONTRADICTION)
GEMINI_API_KEY="your-key" bash {baseDir}/scripts/generate-hooks.sh

# 3. 用视觉检查钩子,选一个最好的

# 4. 使用选定的钩子类型生成幻灯片
GEMINI_API_KEY="your-key" bash {baseDir}/scripts/generate-slides.sh [shock|curiosity|contradiction]

# 5. 检查幻灯片(智能体会验证文本和质量)
# 智能体使用视觉模型检查每张幻灯片

# 6. 发布到 TikTok + Instagram
UPLOADPOST_TOKEN="your-token" bash {baseDir}/scripts/publish-carousel.sh

# 7. 检查分析数据(24-48 小时后)
UPLOADPOST_TOKEN="your-token" bash {baseDir}/scripts/check-analytics.sh 7

# 8. 从数据中学习,用于下一个轮播
node {baseDir}/scripts/learn-from-analytics.js

钩子分类(视觉新颖系统)

打破 1000 次观看瓶颈的关键在于 第一张幻灯片的视觉新颖性。我们生成 3 种钩子类型:

类型目标视觉效果
震惊 (SHOCK)用不可能/荒谬的画面阻止用户滑动超现实、混乱、“等一下,什么?”
好奇 (CURIOSITY)制造信息缺口神秘、秘密被揭露
矛盾 (CONTRADICTION)展示不可能的组合放松 + 紧张,“这种事情怎么可能发生?”

反库存滤镜

所有钩子都包含反库存提示,以避免:

  • 通用库存照片美学
  • 震惊女孩的刻板印象
  • 典型网红姿势
  • 过度使用的笔记本电脑+咖啡场景
  • 商务握手场景

钩子测试工作流

  1. 使用 generate-hooks.sh 生成 3 个变体
  2. 用视觉检查,对每个的新颖性评分 1-5
  3. 删除任何看起来眼熟的内容
  4. 使用最好的钩子制作轮播
  5. 追踪哪种钩子类型长期表现最好

图像模型

使用 gemini-3.1-flash-image-preview 生成幻灯片。

  • 本地脚本:{baseDir}/scripts/generate_image.py
  • 支持图像到图像的参照,确保幻灯片之间视觉连贯

步骤 1:全面研究(analyze-web.js)

执行完整的商业调查:

1. 品牌分析

  • 品牌名称(来自域名或标题)
  • Logo(URL 或 SVG)
  • CSS 颜色(背景色、主色、链接色、标题色)
  • 排版(正文字体、标题字体)
  • Favicon

2. 内容分析

  • 主标题和标语
  • 所有标题(页面结构)
  • 特性/优势(标题 + 描述)
  • 定价/方案
  • 用户评价
  • 统计/指标
  • 行动号召(CTA)
  • 元标签(标题、描述、og:image)

3. 内部页面

  • 浏览定价、特性、关于我们、评价页面
  • 从每个页面提取额外内容

4. 竞品检测

  • 搜索页面内容中已知的竞品提及
  • 列表包含 20+ 个知名 SaaS 竞品(Buffer、Hootsuite、Later 等)
  • 检测“vs”、“alternative”、“compare”部分
  • 不需要外部搜索 — 全部来自网站本身

5. 故事讲述

  • 检测业务类型(SaaS、电商、应用)
  • 检测细分市场(社交媒体工具、开发者工具等)
  • 根据客户痛点生成钩子
  • 从特性定义痛点
  • 创建转变叙事(之前 → 之后)

6. 视觉上下文

  • 以 CSS 格式呈现的品牌颜色
  • 用于提示的颜色描述
  • 幻灯片排版
  • 根据细分市场确定的图像主题
  • 风格指南,确保连贯性

输出: /tmp/carousel/analysis.json

步骤 2:生成幻灯片(generate-slides.sh)

使用“图像到图像”参照生成 6 张视觉连贯的幻灯片:

幻灯片类型内容
1钩子吸引人的问题/痛点。确定所有视觉风格。
2问题强化痛点。“你上传到 TikTok... 然后 Instagram...”
3激化竞争正在推进。紧迫感。
4解决方案呈现产品及其价值主张。
5特性主要优势。
6行动号召“Link in bio 👆” + 行动号召。

视觉连贯性

  • 第 1 张幻灯片生成基础风格(颜色、排版、氛围)
  • 第 2-6 张幻灯片使用第 1 张作为“图像到图像”的参考
  • 保持相同的调色板、字体和美学风格

每张幻灯片的提示

每张幻灯片包含:

  • 文本: 主要信息
  • 场景: 背景的详细视觉描述
  • 风格: 基于品牌分析

输出:

  • /tmp/carousel/slide-{1-6}.jpg
  • /tmp/carousel/caption.txt

步骤 3:用视觉检查

生成后,智能体必须检查每张幻灯片:

  • ✓ 文本清晰可读且正确
  • ✓ 单词没有被截断
  • ✓ 拼写正确
  • ✓ 幻灯片之间视觉连贯
  • ✓ 可接受的图像质量

如果有错误,重新生成对应的幻灯片。

图像格式

  • 分辨率: 768x1376(9:16 垂直比例)
  • 格式: JPG(TikTok 不接受 PNG)
  • 文本: 大号、粗体、带阴影以提高可读性
  • 背景: 与业务相关的场景,而非纯色

步骤 4:发布到 TikTok + Instagram(publish-carousel.sh)

使用 Upload-Post API 将轮播发布到 TikTok 和 Instagram。

UPLOADPOST_TOKEN="your-token" bash {baseDir}/scripts/publish-carousel.sh

端点: POST /api/upload_photos

发送的参数:

  • platform[]=tiktok + platform[]=instagram
  • auto_add_music=true - 在 TikTok 上自动添加音乐
  • tiktok_title - 短标题(最多 90 字符)+ 话题标签
  • title - Instagram 的完整说明
  • privacy_level=PUBLIC_TO_EVERYONE
  • media_type=IMAGE - Instagram 上的照片轮播
  • async_upload=true - 后台处理
  • photos[] - 6 张 JPG 幻灯片

⚠️ 重要 - Instagram: 发布后,用户必须前往 Instagram 手动添加热门音乐:

  1. 打开 Instagram → 个人主页 → 该帖子
  2. 编辑 → 添加音乐
  3. 搜索热门/病毒式歌曲

输出: 将 request_id 保存在 post-info.json 中,用于追踪。

步骤 5:分析表现(check-analytics.sh)

获取 TikTok 和 Instagram 的分析数据,了解什么有效。

UPLOADPOST_TOKEN="your-token" bash {baseDir}/scripts/check-analytics.sh 7

使用的端点:

  1. 个人主页分析:

    GET /api/analytics/{user}?platforms=tiktok
    

    → 粉丝数、点赞数、评论数、分享数、展示量

  2. 总展示量:

    GET /api/uploadposts/total-impressions/{user}?platform=tiktok&breakdown=true
    

    → 每天的观看量

  3. 每篇帖子的分析:

    GET /api/uploadposts/post-analytics/{request_id}
    

    → 该特定轮播的观看量、点赞数、评论数(TikTok + Instagram)

文档:https://docs.upload-post.com/api/get-analytics

步骤 6:学习与改进(learn-from-analytics.js)

分析数据并将学到的经验保存下来,用于未来的轮播。

node {baseDir}/scripts/learn-from-analytics.js

生成:

  • learnings.json - 累积的知识库
  • 最佳钩子(产生最多观看量的)
  • 最优发布时间
  • 下一个轮播的改进建议

完整流程

# 1. 研究业务
node {baseDir}/scripts/analyze-web.js https://my-product.com

# 2. 生成幻灯片
GEMINI_API_KEY="..." bash {baseDir}/scripts/generate-slides.sh

# 3. 用视觉检查(智能体验证文本)
# 智能体检查每张幻灯片图像

# 4. 发布
UPLOADPOST_TOKEN="..." UPLOADPOST_USER="myuser" bash {baseDir}/scripts/publish-carousel.sh

# 5. (几小时/天后)分析
UPLOADPOST_TOKEN="..." UPLOADPOST_USER="myuser" bash {baseDir}/scripts/check-analytics.sh 7

# 6. 为下一个轮播学习
node {baseDir}/scripts/learn-from-analytics.js

文件列表

{baseDir}/
├── SKILL.md                      # 本文档
└── scripts/
    ├── analyze-web.js            # 全面的商业研究
    ├── generate-slides.sh        # 生成 6 张连贯的幻灯片
    ├── generate_image.py         # Gemini 3.1 flash 图像生成
    ├── review-slides.js          # 准备幻灯片供检查
    ├── publish-carousel.sh       # 通过 Upload-Post API 发布
    ├── check-analytics.sh        # 获取分析数据(TikTok + Instagram)
    ├── learn-from-analytics.js   # 从数据中学习
    └── search-competitors.js     # 可选的外部搜索

环境变量

变量描述
GEMINI_API_KEY用于图像生成的 Google API 密钥
UPLOADPOST_TOKEN用于发布和分析的 Upload-Post 令牌
UPLOADPOST_USERUpload-Post 用户名(必填)

按细分市场的钩子示例

细分市场钩子示例
社交媒体工具“还在一个一个平台地往社交媒体发帖吗?😩”
通用 SaaS“还在手动操作?”
电商“TikTok 不断推荐的产品”
应用“我希望早点发现的应用”
开发者工具“这个 API 将改变你的代码”

为什么选择 Viraloop?

Viraloop其他技能
发布直接到信息流仅草稿
音乐自动热门音乐手动
平台TikTok + Instagram单一平台
研究自动 URL 分析手动描述
图像连贯图像到图像参照独立幻灯片
图像生成Gemini(免费层)付费提供商
发帖upload-post.com(免费,无需信用卡)付费或自托管
文本叠加AI 原生(Gemini 渲染)外部脚本
提示结构化模板自由形式
设置3 个环境变量复杂多工具设置

注意事项

  • 分析从网站内容本身提取竞品(20+ 已知 SaaS)
  • “图像到图像”保持连贯性,但每张幻灯片需要约 20 秒
  • 生成的说明包含细分市场相关的话题标签
  • 始终检查幻灯片文本 — 有时会被截断
  • auto_add_music 在 TikTok 上能提高互动率
  • 建议在 24-48 小时后检查分析数据以获得有意义的信息
  • 学习成果会随着每个发布的轮播累积和改善
  • TikTok 标题最多 90 字符(与话题标签一起自动截断)

相关技能