Skill: clawbus/tiktok-publish (version 1.1.18)

--- name: TikTok Publisher description: > Post to TikTok, upload TikTok videos, and publish TikTok video content through the MyBrandMetrics API. Use for TikTok posting, uploading TikTok videos, publishing TikTok videos, scheduling TikTok posts, or checking TikTok publishing status. Supports local video files, remote video URLs, post titles, privacy levels, publish status checks, chat-based posting, and one-time scheduled posting tasks from a Google Sheet. --- # TikTok Publisher Post to TikTok, upload TikTok videos, and publish TikTok video content through the MyBrandMetrics API from a local file or a remote video URL. Use this skill to post to TikTok, upload TikTok videos, publish TikTok videos, schedule TikTok posts, check TikTok publishing status, or create a one-time scheduled TikTok posting task. Website: [https://www.clawbus.com/](https://www.clawbus.com/) MyBrandMetrics API: [https://mybrandmetrics.com/](https://mybrandmetrics.com/) ## Why This Is Better This flow is simpler than a typical TikTok API or developer-app setup: - Sign in to MyBrandMetrics with Google instead of creating a TikTok developer app. - No TikTok client ID, client secret, redirect URI, or callback server to manage. - No manual token storage or refresh flow to build yourself. - No separate publish backend to run just to queue uploads and check status. - MyBrandMetrics handles the connection layer, while this skill focuses on publishing, polling, and status checks. ## Core Capabilities | Capability | Details | | --- | --- | | Remote URL publishing | Submit a direct `https://` video URL to TikTok through MyBrandMetrics. | | Local file publishing | Upload a local video file with multipart form data. | | Post metadata | Set the TikTok post title and privacy level. | | Chat-based posting | Use natural-language prompts in chat after the skill is installed. | | One-time scheduled tasks | Create a scheduled publishing task from a Google Sheet containing title, date, time, and video URL rows. | ## Setup Flow 1. Open [https://mybrandmetrics.com/](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. Get the MyBrandMetrics API key. 6. Add the API key to `/root/.openclaw/workspace/config.json`: ```json { "tiktok": { "api_key": "YOUR_API_KEY" } } ``` 7. Install the `tiktok-publish` skill. 8. Start publishing or checking TikTok publish status with this skill. ## Positioning Notes - Use this skill when the user wants TikTok publishing without building their own TikTok developer integration. - Keep the message simple: one Google-based sign-in to MyBrandMetrics, one connected TikTok feed, and the publish workflow is ready. - This is a publishing workflow, not a generic MCP or developer console setup. ## Workflow Use this workflow to post to TikTok, upload a TikTok video, publish a TikTok video, schedule TikTok posts, or check a TikTok publishing job. 1. **Confirm the publishing goal.** Choose whether to publish from a remote video URL, upload a local video file, check an existing publish job, or prepare a scheduled posting workflow. 2. **Confirm the TikTok setup.** Sign in to MyBrandMetrics with Google, connect TikTok as a data source, and get a MyBrandMetrics API key. 3. **Prepare credentials.** Add the MyBrandMetrics API key to the workspace config: ```json { "tiktok": { "api_key": "YOUR_API_KEY" } } ``` 4. **Collect post details.** Prepare the TikTok video source, post title, privacy level, and publishing preference. Useful defaults: - choose `SELF_ONLY` for test posts; - choose `PUBLIC` when the post is ready to go live; - use a concise title or caption; - use a remote video URL or local video file that is ready to publish. 5. **Publish the TikTok video.** Use the skill to publish from a remote URL or local file. The workflow can also wait for the publishing job to finish when needed. 6. **Check publish status.** If a publish identifier is returned, use it to check the TikTok publish status later. After the job succeeds, confirm the result in the connected TikTok account. ### Drafts, Carousels, And Scheduling The current script supports video publishing from a remote URL or local file. Known workflow notes: - Draft-style flows may appear as a TikTok notification that the video is ready to edit, rather than as a normal profile draft. - Image carousel publishing may require phone-friendly image dimensions such as 1080x1920. Oversized generated images can fail TikTok image checks. - Scheduled posting should be treated as an automation workflow: confirm the sheet columns, publish date, publish time, video URL, title, privacy level, and account before creating the task. ### Common Errors | Error | Likely cause | Fix | | --- | --- | --- | | `401 invalid token format` | API key was sent in the wrong auth format or the key is invalid. | Use the MyBrandMetrics API key configuration supported by this skill. Do not use a bearer-token format. | | `picture_size_check_failed` | Image dimensions do not meet TikTok requirements. | Resize images to a phone-friendly format such as 1080x1920 and retry. | | `duration_check` | Video is too short. | Use a video that is at least 3 seconds long. | | `invalid_params` | Title, caption, media, or request parameters are invalid. | Simplify the title, reduce hashtags, and recheck the source URL or local path. | 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 to wait for publish completion. After the posting flow finishes, check the response and confirm the TikTok upload succeeded. ## Use The Scripts Directly Use `scripts/publish_tiktok.py`. Remote URL: ```bash python3 scripts/publish_tiktok.py \ --source "https://example.com/video.mp4" \ --title "My TikTok Title" \ --privacy-level "SELF_ONLY" ``` Local file: ```bash python3 scripts/publish_tiktok.py \ --source "/path/to/video.mp4" \ --title "Launch clip" \ --privacy-level "PUBLIC" \ --wait-for-published ``` With explicit polling controls: ```bash 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`. ```bash 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: ```text Please help me create a one-time scheduled task. The task involves publishing videos or images to a TikTok account using the 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 | Parameter | Required | Purpose | | --- | --- | --- | | `--source` | Yes | Direct video URL or local video file path. | | `--title` | Yes | TikTok post title. | | `--privacy-level` | No | `SELF_ONLY` by default; use `PUBLIC` only when ready to post live. | | `--wait-for-published` | No | Poll until the publish job completes. | | `--poll-interval` | No | Polling interval in milliseconds. | | `--poll-timeout` | No | Polling timeout in milliseconds. | | `--config` | No | Path to workspace `config.json`. | Before publishing, confirm the TikTok account, video source, title or caption, and privacy setting. For test posts, use `SELF_ONLY` first.


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (MEDIUM)