YouTube upload

A video in; out: an uploaded (or scheduled) YouTube video and its link, through PostWire's approved YouTube integration. The user signs in to Google once; nobody creates a Google Cloud project, an OAuth client or asks for quota.

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

Never use browser automation or ask for the user's Google password.

0. Connection

• PostWire MCP tools present? my_account: is YouTube 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 upload 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.
• YouTube not connected: create_connect_link with platform: "youtube"; the user signs in to Google on that page and picks the channel. Call my_account again after.

1. The video

• Public https link to an MP4/MOV file: video_url. A youtube.com or tiktok.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 (a Short); show it before uploading.

A vertical video of 3 minutes or less shows as a Short; anything else is a regular video.

2. Title, description, privacy

• title: up to 100 characters; name the payoff with the words people would search ("How to…", the product, the result). No clickbait the video does not deliver.
• Description (text): its first line repeats the promise of the title; then 2-4 lines on what is in the video, links if any, and 3-5 hashtags at the end (#Shorts is optional for a Short).
• privacy: public, unlisted (only people with the link) or private. Ask. Without it the channel's default applies.
• No invented numbers, results or quotes.

Show the title (with its length), the description and the privacy, then one question: "Upload this to YouTube, public, now?" Nothing is uploaded without a yes.

3. Upload

• Now: post_to_social with platforms: ["youtube"], per_platform: { "youtube": { "text": "…", "title": "…" } }, title, video_url, privacy, and brand_id if YouTube is connected in several brands.
• Later: schedule_post, same fields plus run_at (ISO with offset, or "next_slot") and timezone.
• Same video to TikTok and Reels? Add "tiktok" and "instagram" to platforms, each with its own caption (TikTok privacy is asked of the owner). On the Free plan one 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. State it once; never work around it.

Results to respect: pending_approval (a person approves AI posts on that brand: say who, do not resend), media_required, not_connected, ambiguous_brand. Every error carries code, what and fix.

4. The link

Give the link from the result. If it is still processing, get_post_status with the returned id until it has it.

REST (no MCP tools)

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

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