Communitygithub.com

ASoudy/AGS

透過 Rube MCP (Composio) 自動化 TikTok 任務:上傳/發佈影片、發文、管理內容及檢視使用者個人檔案/統計資料。請務必先搜尋工具以取得最新架構。

AGS 是什麼?

這個技能提供了一個完整的 TikTok 自動化解決方案,透過 Composio 的 TikTok 工具組及 Rube MCP 進行操作。開發者可以上傳並發佈影片、張貼照片、列出已發佈的影片,以及檢視已驗證使用者的個人檔案和統計資料。其核心工作流程包含多步驟操作,例如先上傳影片,再輪詢處理狀態,最後進行發佈;同時也支援照片發佈、影片列表管理以及個人檔案檢視等任務。技能強調必須在執行任何工作流程前,先呼叫 `RUBE_SEARCH_TOOLS` 來取得最新的工具架構,並透過 `RUBE_MANAGE_CONNECTIONS` 建立並驗證活躍的 TikTok 連線(OAuth)。文件中也詳細說明了常見的陷阱,包括內容格式要求(如 MP4/WebM 影片、JPEG/PNG 照片)、認證範圍與權杖過期、API 速率限制、以及回應解析的注意事項。此技能主要用於 Claude Code 或 Cursor 等 AI 代理工具,可與 Rube MCP 伺服器整合,實現可重複的 TikTok 內容管理與發佈工作流程。

相容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/ASoudy/AGS/tree/HEAD/AGAS/plugins/antigravity-awesome-skills-claude/skills/tiktok-automation

在你喜歡的 AI 中提問

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

說明文件

透過 Rube MCP 實現 TikTok 自動化

透過 Composio 的 TikTok 工具組及 Rube MCP,自動化 TikTok 內容創作與個人檔案操作。

先決條件

  • 必須已連線 Rube MCP(RUBE_SEARCH_TOOLS 可用)
  • 透過 RUBE_MANAGE_CONNECTIONS 建立活躍的 TikTok 連線,工具組為 tiktok
  • 務必先呼叫 RUBE_SEARCH_TOOLS 以取得最新的工具架構

設定

取得 Rube MCP:在用戶端設定中將 https://rube.app/mcp 新增為 MCP 伺服器。不需要 API 金鑰,只需新增端點即可使用。

  1. 確認 Rube MCP 可用:檢查 RUBE_SEARCH_TOOLS 是否有回應
  2. 使用工具組 tiktok 呼叫 RUBE_MANAGE_CONNECTIONS
  3. 若連線狀態不是 ACTIVE,請依傳回的身份驗證連結完成 TikTok OAuth
  4. 在執行任何工作流程前,確認連線狀態顯示為 ACTIVE

核心工作流程

1. 上傳並發佈影片

使用時機:使用者想要上傳影片並發佈到 TikTok

工具順序:

  1. TIKTOK_UPLOAD_VIDEO 或 TIKTOK_UPLOAD_VIDEOS - 上傳影片檔案 [必要]
  2. TIKTOK_FETCH_PUBLISH_STATUS - 檢查上傳/處理狀態 [必要]
  3. TIKTOK_PUBLISH_VIDEO - 發佈已上傳的影片 [必要]

上傳的關鍵參數:

  • video:影片檔案物件,包含 s3key、mimetype、name
  • title:影片標題/說明

發佈的關鍵參數:

  • publish_id:上傳步驟回傳的 ID
  • title:影片說明文字
  • privacy_level:'PUBLIC_TO_EVERYONE'、'MUTUAL_FOLLOW_FRIENDS'、'FOLLOWER_OF_CREATOR'、'SELF_ONLY'
  • disable_duet:停用 Duet 功能
  • disable_stitch:停用 Stitch 功能
  • disable_comment:停用留言功能

常見陷阱:

  • 影片上傳與發佈是兩個獨立步驟;先上傳,再發佈
  • 上傳後,請輪詢 FETCH_PUBLISH_STATUS 直到處理完成,再進行發佈
  • 影片須符合 TikTok 要求:MP4/WebM 格式、最長 10 分鐘、最大 4GB
  • 說明/標題有字元限制;請查閱最新的 TikTok 規範
  • 隱私層級字串區分大小寫,必須完全相符
  • 處理時間可能因影片大小而異,約 30-120 秒

2. 張貼照片

使用時機:使用者想要在 TikTok 上張貼照片

工具順序:

  1. TIKTOK_POST_PHOTO - 上傳並張貼照片 [必要]
  2. TIKTOK_FETCH_PUBLISH_STATUS - 檢查處理狀態 [選用]

關鍵參數:

  • photo:照片檔案物件,包含 s3key、mimetype、name
  • title:照片說明文字
  • privacy_level:貼文的隱私設定

常見陷阱:

  • 照片貼文是 TikTok 較新的功能;可用性可能因帳戶類型而異
  • 支援格式:JPEG、PNG、WebP
  • 圖片大小與尺寸限制適用;請查閱最新的 TikTok 規範

3. 列出與管理影片

使用時機:使用者想要檢視已發佈的影片

工具順序:

  1. TIKTOK_LIST_VIDEOS - 列出使用者已發佈的影片 [必要]

關鍵參數:

  • max_count:每頁回傳的影片數量
  • cursor:下一頁的分頁游標

常見陷阱:

  • 僅回傳已驗證使用者自己的影片
  • 回應包含影片中繼資料:id、title、create_time、share_url、duration 等
  • 分頁採用游標機制;請檢查回應中的 has_more 與 cursor
  • 剛發佈的影片可能不會立即出現在列表中

4. 檢視使用者個人檔案與統計資料

使用時機:使用者想要檢查自己的 TikTok 個人檔案資訊或帳戶統計資料

工具順序:

  1. TIKTOK_GET_USER_PROFILE - 取得完整的個人檔案資訊 [必要]
  2. TIKTOK_GET_USER_STATS - 取得帳戶統計資料 [選用]
  3. TIKTOK_GET_USER_BASIC_INFO - 取得基本使用者資訊 [替代]

關鍵參數:(無必要參數;為已驗證使用者回傳資料)

常見陷阱:

  • 個人檔案資料僅限於已驗證使用者;無法檢視其他使用者的個人檔案
  • 統計資料包括追蹤者人數、追蹤中人數、影片數量、收到的讚數
  • GET_USER_PROFILE 回傳的詳細資訊比 GET_USER_BASIC_INFO 更多
  • 統計資料可能有些微延遲;非即時

5. 檢查發佈狀態

使用時機:使用者想要檢查內容上傳或發佈操作的狀態

工具順序:

  1. TIKTOK_FETCH_PUBLISH_STATUS - 輪詢狀態更新 [必要]

關鍵參數:

  • publish_id:來自先前上傳/發佈操作的發佈 ID

常見陷阱:

  • 狀態值包括 processing、success 與 failure 狀態
  • 以合理的間隔(5-10 秒)輪詢,以避免速率限制
  • 發佈失敗的回應中會包含錯誤詳細資訊
  • 內容審查可能在處理後導致延遲或拒絕

常見模式

影片發佈流程

1. 透過 TIKTOK_UPLOAD_VIDEO 上傳影片 -> 取得 publish_id
2. 使用 publish_id 輪詢 TIKTOK_FETCH_PUBLISH_STATUS 直到完成
3. 若狀態為 ready,使用最終設定呼叫 TIKTOK_PUBLISH_VIDEO
4. 可選擇再次輪詢狀態以確認發佈

分頁

  • 使用前一次回應的 cursor 取得下一頁
  • 檢查 has_more 布林值以判斷是否還有更多結果
  • max_count 控制頁面大小

已知陷阱

內容要求:

  • 影片:MP4/WebM,最大 4GB,最長 10 分鐘
  • 照片:JPEG/PNG/WebP
  • 說明:字元限制因地區而異
  • 內容必須符合 TikTok 社群規範

身份驗證:

  • OAuth 權杖有範圍限制;請確保已授權 video.upload 與 video.publish
  • 權杖會過期;若操作因 401 錯誤失敗,請重新進行身份驗證

速率限制:

  • TikTok API 對每個應用程式有嚴格的速率限制
  • 在收到 429 回應時實施指數退避
  • 上傳操作有每日限制

回應解析:

  • 回應資料可能巢狀於 data 或 data.data 下
  • 使用防禦性解析並搭配備援模式
  • 發佈 ID 為字串;請完全依照回傳值使用

快速參考

任務工具代號關鍵參數
上傳影片TIKTOK_UPLOAD_VIDEOvideo、title
上傳多個影片TIKTOK_UPLOAD_VIDEOSvideos
發佈影片TIKTOK_PUBLISH_VIDEOpublish_id、title、privacy_level
張貼照片TIKTOK_POST_PHOTOphoto、title、privacy_level
列出影片TIKTOK_LIST_VIDEOSmax_count、cursor
取得個人檔案TIKTOK_GET_USER_PROFILE(無)
取得使用者統計TIKTOK_GET_USER_STATS(無)
取得基本資訊TIKTOK_GET_USER_BASIC_INFO(無)
檢查發佈狀態TIKTOK_FETCH_PUBLISH_STATUSpublish_id

使用時機

此技能適用於執行概述中描述的工作流程或操作。

限制

  • 僅在任務明確符合上述範圍時使用此技能。
  • 請勿將輸出視為特定環境驗證、測試或專家審查的替代方案。
  • 若缺少必要的輸入、權限、安全邊界或成功標準,請停止並要求澄清。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ASoudy/AGS

Advanced JavaScript animation library skill for creating complex, high-performance web animations.

ASoudy/AGS

Astropy is the core Python package for astronomy, providing essential functionality for astronomical research and data analysis.

ASoudy/AGS

Build content-focused websites with Astro — zero JS by default, islands architecture, multi-framework components, and Markdown/MDX support.

ASoudy/AGS

One sentence - what this skill does and when to invoke it

ASoudy/AGS

Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.

ASoudy/AGS

Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.

ASoudy/AGS

Pull a YouTube video transcript into a queryable markdown vault with yt-dlp subtitle discovery, VTT cleanup, metadata frontmatter, and capture-seed stubs.

ASoudy/AGS

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

ASoudy/AGS

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

ASoudy/AGS

AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

ASoudy/AGS

CRITICAL: Use for Makepad animation system. Triggers on: makepad animation, makepad animator, makepad hover, makepad state, makepad transition, "from: { all: Forward", makepad pressed, makepad 动画, makepad 状态, makepad 过渡, makepad 悬停效果

ASoudy/AGS

Comprehensive patterns for Next.js 14+ App Router architecture, Server Components, and modern full-stack React development.

ASoudy/AGS

Next.js App Router principles. Server Components, data fetching, routing patterns.

ASoudy/AGS

Expert integration of Supabase Auth with Next.js App Router

ASoudy/AGS

React and Next.js 14+ application development with App Router, Server Components, TypeScript, Tailwind CSS, and modern frontend patterns.

ASoudy/AGS

Best practices for Remotion - Video creation in React

ASoudy/AGS

Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays

ASoudy/AGS

Seek and analyze video content using Memories.ai Large Visual Memory Model for persistent video intelligence

ASoudy/AGS

Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer.

ASoudy/AGS

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

相關技能