Communitygithub.com

Upload-Post/viraloop

適用於 OpenClaw AI 代理的技能,可自動化 TikTok 和 Instagram 輪播內容增長。分析任何網站 URL 以提取品牌、競爭對手和價值主張,然後透過 upload-post API 生成病毒式投影片,並自動發布和加入熱門音樂。內建分析反饋循環。

viraloop 是什麼?

Viraloop 是一個專為 AI 代理設計的自動化內容增長技能,能將任何網站 URL 轉化為一套 6 張投影片的輪播,適用於 TikTok 和 Instagram。它會執行完整的業務研究,包括品牌分析、內容提取、競爭對手偵測和敘事建構,以生成視覺連貫且具有高度分享性的內容。此技能支援 Gemini(免費方案)進行圖像生成,並透過 upload-post.com API(也有免費方案,無需信用卡)直接發佈到使用者的社群媒體動態,而非僅儲存為草稿。其核心操作強調每日迭代:發布 → 分析 → 學習,並透過 `learnings.json` 持續累積洞察,如最佳鉤子、最佳發文時間與視覺風格。Viraloop 採用三種鉤子類別(震撼、好奇、矛盾)來突破觀看次數瓶頸,並包含一個反饋循環,可從發布內容的數據中學習,迭代優化每一次的輪播內容。它主要支援 Gemini 與 upload-post API,並提供 CLI 腳本處理研究、生成、審查、發布、分析與學習等完整流程。

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

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

viraloop 是做什麼的?

分析任何網站,並為 TikTok/Instagram 生成一套 6 張投影片、視覺連貫的輪播圖。直接發佈到您的動態(無需草稿),並自動加入熱門音樂。兩種 API(Gemini + upload-post.com)都有免費方案,無需信用卡即可開始使用。

理念:每日迭代循環

增長的關鍵在於 持續 + 學習:

  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. 追蹤哪種鉤子 TYPE 在一段時間內表現最好

圖像模型

使用 gemini-3.1-flash-image-preview 生成投影片。

  • 本地腳本:{baseDir}/scripts/generate_image.py
  • 支援圖像到圖像,以保持投影片間的視覺連貫性

步驟 1:完整研究(analyze-web.js)

執行完整的業務調查:

1. 品牌分析

  • 品牌名稱(來自網域名稱或標題)
  • 標誌(URL 或 SVG)
  • CSS 顏色(背景、主要、連結、標題)
  • 字體排版(正文字體、標題字體)
  • 網站圖示

2. 內容分析

  • 標題與副標語
  • 所有標題(頁面結構)
  • 功能/優勢(標題 + 描述)
  • 定價/方案
  • 推薦見證
  • 統計/指標
  • 行動呼籲(CTA)
  • Meta 標籤(標題、描述、og:image)

3. 內部頁面

  • 導覽定價、功能、關於我們、推薦見證頁面
  • 從每個頁面提取額外內容

4. 競爭對手偵測

  • 在內容中搜尋已知的競爭對手名稱
  • 20+ 已知 SaaS 競爭對手清單(Buffer、Hootsuite、Later 等)
  • 偵測「vs」、「替代方案」、「比較」部分
  • 無需外部搜尋——全部來自網站本身

5. 敘事建構

  • 偵測業務類型(SaaS、電子商務、應用程式)
  • 偵測利基市場(社交媒體工具、開發者工具等)
  • 根據客戶痛點生成鉤子
  • 從功能定義痛點
  • 建立轉型敘事(之前 → 之後)

6. 視覺上下文

  • 品牌顏色(CSS 格式)
  • 用於提示的顏色描述
  • 投影片的字體排版
  • 基於利基市場的圖像主題
  • 用於連貫性的風格指南

輸出: /tmp/carousel/analysis.json

步驟 2:生成投影片(generate-slides.sh)

使用圖像到圖像技術生成 6 張視覺連貫的投影片:

投影片類型內容
1鉤子能吸引人的問題/痛點。建立所有視覺風格。
2問題加劇痛點。「你上傳到 TikTok... 然後 Instagram...」
3加劇競爭對手正在進步。緊迫感。
4解決方案展示產品及其價值主張。
5功能主要優勢。
6行動呼籲「個人檔案連結 👆」+ 行動呼籲。

視覺連貫性

  • 投影片 1 生成基礎風格(顏色、字體、氛圍)
  • 投影片 2-6 使用投影片 1 作為參考進行圖像到圖像生成
  • 保持相同的色板、字體和美學

每張投影片的提示

每張投影片都有:

  • 文字: 主要訊息
  • 場景: 背景的詳細視覺描述
  • 風格: 基於品牌分析

輸出:

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

步驟 3:使用視覺功能審查

生成後,代理程式 MUST 審查每張投影片:

  • ✓ 文字清晰易讀且正確
  • ✓ 單詞沒有被截斷
  • ✓ 拼寫正確
  • ✓ 投影片之間視覺連貫
  • ✓ 可接受的圖像品質

如果有錯誤,重新生成該特定投影片。

圖像格式

  • 解析度: 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 秒
  • 生成的說明文字包含與利基市場相關的主題標籤
  • 務必審查投影片文字——有時會被截斷
  • TikTok 上的 auto_add_music 會提高參與度
  • 在 24-48 小時後檢查分析資料以獲取有意義的數據
  • 學習經驗會隨著每組已發布的輪播累積和改進
  • TikTok 標題最多 90 個字元(會自動截斷並加入主題標籤)

相關技能