clawbus-tiktok-publish

Publish TikTok videos through the MyBrandMetrics API from a local file or a remote video URL.

Use this skill when the user asks to connect TikTok, publish or upload a TikTok video, check a TikTok publishing result, or create a one-time scheduled TikTok posting task.

Website: https://www.clawbus.com/
MyBrandMetrics API: https://mybrandmetrics.com/

Core Capabilities

Requirements

• A Google account.
• Access to MyBrandMetrics.
• A MyBrandMetrics API key for TikTok publishing.
• A video source, either a direct remote URL or a local file path.
• A post title.
• A privacy level, usually SELF_ONLY for testing or PUBLIC for live posting.

Setup Flow

1. Open https://mybrandmetrics.com/ and sign in with Google.
2. In MyBrandMetrics, open Data sources.
3. Choose connect tiktok feed.
4. Complete the TikTok authorization flow if prompted.
5. Install the clawbus-tiktok-publish skill.
6. Start publishing or checking TikTok publish status with this skill.

Authentication

TikTok authorization is handled through MyBrandMetrics.

1. Sign in to MyBrandMetrics with Google.
2. Connect TikTok as a data source.
3. Make sure the TikTok connection is active before publishing.

For direct script usage, advanced users can provide a MyBrandMetrics API key through the workspace config.json file:

{
  "tiktok": {
    "api_key": "YOUR_API_KEY"
  }
}

The scripts also accept authorization_token as a fallback key name, and they can read TIKTOK_API_KEY or TIKTOK_AUTHORIZATION_TOKEN from environment variables.

Example:

Post this video to TikTok: https://example.com/video.mp4 with the caption "Test".

The chat request should include:

• the video URL or file reference;
• the caption or title;
• whether the post should be a test or public post;
• whether the user wants to wait for publish completion.

After ClawBus finishes the posting flow, check the chat response and confirm the TikTok upload succeeded.

Use The Scripts Directly

Use scripts/publish_tiktok.py.

Remote URL:

python3 scripts/publish_tiktok.py \
  --source "https://example.com/video.mp4" \
  --title "My TikTok Title" \
  --privacy-level "SELF_ONLY"

Local file:

python3 scripts/publish_tiktok.py \
  --source "/path/to/video.mp4" \
  --title "Launch clip" \
  --privacy-level "PUBLIC" \
  --wait-for-published

With explicit polling controls:

python3 scripts/publish_tiktok.py \
  --source "https://example.com/video.mp4" \
  --title "Campaign preview" \
  --privacy-level "SELF_ONLY" \
  --wait-for-published \
  --poll-interval 5000 \
  --poll-timeout 300000

Check Publish Status

Use scripts/check_status.py when you already have a publish_id.

python3 scripts/check_status.py --publish-id "PUBLISH_ID"

One-Time Scheduled Posting

ClawBus can also create a one-time scheduled TikTok posting task.

Prepare:

• videos or images uploaded to Google Drive or another reachable location;
• a Google Sheet with post title, publish date, publish time, and video URL;
• sharing access granted only to the trusted account or service that needs to read the table.

Example request:

Please help me create a one-time scheduled task. The task involves publishing videos or images to a TikTok account using the clawbus-tiktok-publish skill, based on the title, date, time, and video URL data found in this table: GOOGLE_SHEET_URL

Before scheduling, review every row in the sheet and confirm the account, publish time, title, and video URL. When the publishing task reports success, open TikTok and confirm the post is live.

Parameters

Before publishing, confirm the TikTok account, video source, title or caption, and privacy setting. For test posts, use SELF_ONLY first.