🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί Tiktok Publisher
πŸ¦€ ClawHub

Tiktok Publisher

by @snoopyrain

Publish videos and photo carousels to TikTok. Use when the user says 'post to TikTok', 'upload TikTok video', 'create TikTok post', 'publish TikTok carousel'...

Versionv1.0.1
Downloads323
Installs2
#video#social-media#legal
TERMINAL
clawhub install tiktok-publisher

πŸ“– About This Skill

name: tiktok-publisher description: "Publish videos and photo carousels to TikTok. Use when the user says 'post to TikTok', 'upload TikTok video', 'create TikTok post', 'publish TikTok carousel', or wants to upload videos or photo slideshows to TikTok with privacy settings and draft mode." version: 1.0.0 metadata: openclaw: emoji: "🎡" homepage: https://boring-doc.aiagent-me.com/getting-started/mcp.html requires: config: - MCP Connector link from boring.aiagent-me.com (contains embedded auth token)

Boring TikTok Publisher

Publish videos and photo carousels to TikTok. Powered by Boring.

Security & Data Handling

  • MCP link is a credential: Your MCP Server URL (https://boring.aiagent-me.com/mcp/t/xxxxx...) contains an embedded authentication token. Treat it like a password β€” do not share it publicly.
  • Token scope: The embedded token grants publish access to your connected social media accounts. It can create posts, upload media, and manage scheduled posts on the platforms you have connected. It cannot access your social media passwords or modify account settings.
  • Token storage: The token is stored server-side in Boring's database (MongoDB on DigitalOcean). It is never written to your local filesystem. You can regenerate or revoke it anytime at boring.aiagent-me.com/settings.
  • Data flow: Analytics queries are sent from Boring's server (Google Cloud, us-central1) to the platform's API on your behalf. Only performance metrics are retrieved β€” no content is uploaded or modified.
  • No local credentials: No local API keys, environment variables, or secrets are needed. All auth is embedded in the MCP link.
  • Third-party service: This skill relies on Boring, an open-source social media management tool. Source code: github.com/snoopyrain.

    • Prerequisites

    1. Sign up at boring.aiagent-me.com with Google 2. Connect TikTok account via OAuth 3. Get your MCP link: Go to Settings β†’ copy your MCP Server URL (contains your auth token β€” treat it like a password) 4. Add to Claude: Paste the MCP link as a Connector β€” no install, no API key needed

    Workflow

    Step 1: List Accounts

    Call boring_list_accounts and filter for tiktok platform.

    Step 2: Determine Content Type

    TikTok supports:

    | Type | Media | Specs | |------|-------|-------| | Video | 1 video | MP4 recommended, max 4GB, max 10 minutes | | Photo Carousel | 2-35 images | PNG auto-converts to JPEG |

  • Caption: Optional, max 2,200 characters
  • Media is required β€” TikTok does not support text-only posts

    • Step 3: Prepare Media

    Upload files to get public URLs:

  • Local files: boring_upload_file with file_path
  • External URLs: boring_upload_from_url
  • Google Drive: Pass directly

    • Step 4: Publish

    Call boring_publish_post:

    Video post: 

    boring_publish_post(
  account_id="",
  platform="tiktok",
  text="Caption for the video #fyp #trending",
  media_urls=["https://...video.mp4"]
)

    Photo carousel: 

    boring_publish_post(
  account_id="",
  platform="tiktok",
  text="Swipe through these photos!",
  media_urls=["https://...1.jpg", "https://...2.jpg", "https://...3.jpg"]
)

    Draft Mode

    Use draft: true to send the video to the creator's TikTok inbox instead of publishing directly. The creator must manually publish it in the TikTok app.

    boring_publish_post(
  account_id="",
  platform="tiktok",
  text="Review this before posting",
  media_urls=["https://...video.mp4"],
  draft=true
)

    This is useful when:

  • The user wants to preview before going live
  • Adding TikTok-specific effects or music in the app
  • Content needs final approval

    • Step 5: Report

    Show:

  • Post ID and success status
  • If draft: inform user to check their TikTok inbox to finalize

    • TikTok-Specific Notes

  • Media required: TikTok needs either a video or photos
  • Privacy: Default is PUBLIC_TO_EVERYONE. Other options: MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATOR, SELF_ONLY
  • Video limits: Max 4GB, max 10 minutes
  • Photo carousel: Up to 35 images (PNG auto-converts to JPEG)
  • Draft mode: Sends to creator's inbox for manual publish
  • Token: 24-hour access token with auto-refresh (refresh token lasts 1 year)
  • Permissions: video.upload, video.publish

    • Error Handling

    | Error | Solution | |-------|----------| | MediaRequired | TikTok requires video or photos | | MediaTooLarge | Video max 4GB | | VideoProcessingFailed | Check video format β€” MP4 recommended | | TokenExpired | Reconnect at boring.aiagent-me.com | | PublishingFailed | Check TikTok account status and permissions |

    Documentation

    Full API docs: boring-doc.aiagent-me.com

    βš™οΈ Configuration

    1. Sign up at boring.aiagent-me.com with Google 2. Connect TikTok account via OAuth 3. Get your MCP link: Go to Settings β†’ copy your MCP Server URL (contains your auth token β€” treat it like a password) 4. Add to Claude: Paste the MCP link as a Connector β€” no install, no API key needed