social-post

Files (1)

• SKILL.md

SKILL.md (first lines)

# Social Post (YouTube, Facebook, Mastodon)

Create and schedule posts to YouTube, Facebook Pages, and Mastodon using the Publora MCP server. This skill covers platforms that work through standard posting without platform-specific complexity.

## Prerequisites

**Plans:** Works on the free Starter plan. Current limits and pricing: [publora.com/pricing](https://publora.com/pricing).

### Getting Started

1. **Create account** at [publora.com/register](https://publora.com/register) (free)
2. **Connect platforms** via OAuth in [Publora Dashboard](https://app.publora.com/dashboard):
   - **YouTube**: Google OAuth (requires YouTube channel)
   - **Facebook**: Facebook OAuth (Pages only, not personal profiles)
   - **Mastodon**: OAuth (mastodon.social instance)
3. **Get an API key** at [app.publora.com/dashboard/api](https://app.publora.com/dashboard/api), only if your agent cannot sign in with OAuth or you will use the REST API fallback below
4. **Connect your agent** to the MCP server at `https://mcp.publora.com/mcp`:
   - **Upgrading a manual connection without `/mcp`:** Claude treats `https://mcp.publora.com` as a different server from the bundled one. Change that existing connection to `https://mcp.publora.com/mcp` in its current scope, preserving its authentication and chosen account; sign in again if requested. Alternatively, verify the bundled connection uses the intended account, then remove only the old manual entry. Do not add a second entry or delete credentials automatically.
   - **Publora tools already available** (the `publora-skills` plugin or the Publora connector in Claude): nothing to set up. Claude asks you to sign in to Publora the first time a tool runs.
   - **Agents that support OAuth** (Claude Code, Cursor, and the Claude and ChatGPT apps): add the server by URL and sign in, no API key needed. In Claude Code, add it and then run `/mcp` to sign in:

```bash
claude mcp add --transport http --scope user publora https://mcp.publora.com/mcp
```

   - **Agents without OAuth:** send the API key as `Authorization: Bearer sk_YOUR_API_KEY`:

```bash
claude mcp add --transport http --scope user publora https://mcp.publora.com/mcp \
  --header "Authorization: Bearer sk_YOUR_API_KEY"
```

   Claude Desktop, Cursor, Codex, OpenClaw and the claude.ai connector each need a different config file or flow: see [client setup](https://docs.publora.com/mcp/client-setup) for the exact path and snippet.

### REST API Fallback

If MCP is unavailable, use the REST API directly:

**Base URL:** `https://api.publora.com/api/v1`

**Authentication:** `x-publora-key` header

```bash
# Get connected platforms
curl -X GET "https://api.publora.com/api/v1/platform-connections" \
  -H "x-publora-key: sk_your_api_key"

# Create a post
curl -X POST "https://api.publora.com/api/v1/create-post" \
  -H "x-publora-key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "platforms": ["youtube-UCxxx", "facebook-123456", "mastodon-789"],
    "content": "Your post content",
    "scheduledTime": "2026-03-25T10:00:00Z"
  }'
```

**Platform ID Formats:**
- YouTube: `youtube-{channel_id}` (e.g., `youtube-UCxxx`)
- Facebook: `facebook-{page_id}` (e.g., `facebook-112233445566`)
- Mastodon: `mastodon-{id}` (e.g., `mastodon-456`)

📖 **Docs:** [docs.publora.com](https://docs.publora.com)

---

## YouTube

**Video-only platform** - every post requires a video file.

### Platform Limits

| Feature | Limit |
|---------|-------|
| Video title | 100 characters |
| Video description | 5,000 characters |
| Video duration | 12 hours |
| Video size | 256 GB |
| Video formats | MP4, MOV, AVI, WebM |

### Platform Settings (via REST API)

```json
{
  "platformSettings": {
    "youtube": {
      "privacy": "public",
      "title": "My Video Title"
    }
  }
}
```

| Setting | Values | Default |
|---------|--------|---------|
| `privacy` | `"public"`, `"unlisted"`, `"private"` | `"public"` |
| `title` | string | Derived from first 70 chars of content |

Note: `platformSettings` is accepted by the MCP `create_post` and `update_post` tools as well as over REST. The schema is **strict**: a mistyped platform or key is rejected with a validation error rather than silently dropped.

### YouTube Examples

```
Upload this tutorial video to YouTube:
"How to Build a REST API in 10 Minutes - Complete guide for beginners"
```

```
Upload this as an unlisted video (for internal sharing):
"Internal demo - Q1 dashboard features"
```

### YouTube Restrictions

1. **Video required**: YouTube does not support text-only or image posts
2. **Single video only**: One video per post
3. **Processing time**: Videos take seconds to minutes to process after upload
4. **Token refresh**: YouTube tokens expire after ~6 months, reconnect if needed

From publora/skills, MIT.

More from publora/skills