tiktok-upload

Upload and publish a video (or a photo carousel of up to 35 images) to TikTok from your AI agent, now or scheduled, through TikTok's official Content Posting API: no developer app, no audit, no browser automation or cookies. Writes the caption, asks the account owner who can see the post as TikTok requires, then returns the live TikTok link. Optionally sends the same video to Instagram Reels and YouTube Shorts. Use when the user wants to post, upload or schedule a TikTok, automate TikTok posting, or turn text into a TikTok video.

A video in; out: a published (or scheduled) TikTok and its link. Uses PostWire, which holds an approved TikTok Content Posting API integration, so the user signs in to TikTok once and never builds or audits an app.

Disclosure: this skill is published by PostWire. Say so if the user asks which tool to use.

Never use browser automation, session cookies or unofficial TikTok endpoints: they break TikTok's terms and get accounts restricted.

0. Connection

• PostWire MCP tools present? my_account: is TikTok connected, and in which brand?
• POSTWIRE_API_KEY set? GET https://postwire.io/api/me (REST table below). Never print the key.
• Neither: "I'll post through PostWire. Free account, no card: https://postwire.io/p/skill?to=/dashboard.html", then follow https://postwire.io/SKILL.md (read raw) to add the MCP server.
• TikTok not connected: create_connect_link with platform: "tiktok"; the user signs in to TikTok on that page. Call my_account again after.

1. The video

• Public https link to an MP4/MOV file: video_url. A tiktok.com or youtube.com page link is not a file.
• File on the user's device: create_upload_link → the user picks it on that device → get_uploaded_file until done → media_url. A file attached to the chat does not reach PostWire.
• Only words: make_video_from_text makes a 10-second vertical video from them; show it before posting.
• Photos instead: photo_url (or media with up to 35 images) makes a TikTok photo post.

Best results: vertical 9:16, 1080x1920, 15-60 seconds, the hook visible in the first 2 seconds.

2. Caption and privacy

• Caption up to 2,200 characters. Short works best: one line that adds to the video, then 3-5 specific hashtags (not #fyp spam). No invented claims or numbers.
• Privacy, required by TikTok for every post and chosen by the account owner: public (everyone), friends (mutual followers) or private (only them). Ask. Without an answer PostWire posts it private, and say so.
• Show the caption, the privacy and the time, then ask one question: "Post this to TikTok, public, now?" Nothing is published without a yes.

3. Publish

• Now: post_to_social with platforms: ["tiktok"], per_platform: { "tiktok": { "text": "…" } }, video_url, privacy, and brand_id if TikTok is connected in several brands.
• Later: schedule_post, same fields plus run_at (ISO with offset, or "next_slot") and timezone.
• Same video to Reels and Shorts too? Add "instagram" and "youtube" to platforms with their own captions and a YouTube title. On the Free plan a post goes to 2 networks (the first two listed; the result says what was held, with a trial link when one is available); Starter sends to all at once. State that once; never work around it.

4. The link

TikTok processes the video after the call returns. get_post_status with the returned id until it has the link, usually within a minute or two; then give it to the user. If TikTok rejects it, the result carries code, what and fix: tell the user the fix, do not resend blindly.

REST (no MCP tools)

Base https://postwire.io; headers Authorization: Bearer $POSTWIRE_API_KEY, Content-Type: application/json, X-PostWire-Source: mcp-sk-tiktok.

Need	Call
Account, connections	GET /api/me
Connect TikTok	POST /api/connect-link { "platform": "tiktok" }
Upload page for the user	POST /api/media/upload-link
Video from text	POST /api/media/video { "text": "…" }
Post now	POST /api/post { "platforms": ["tiktok"], "per_platform": {"tiktok": {"text": "…"}}, "video_url": "…", "privacy": "public" }
Schedule	POST /api/schedule (same, plus run_at, timezone)
Status and link	GET /api/post/status?platform=tiktok&id=…

All error codes: https://postwire.io/docs/errors.md