social-post
Use when the user wants to post or schedule to YouTube, a Facebook Page or Mastodon through Publora. YouTube needs a video on every post, Facebook publishes to Pages only, Mastodon caps at 500 characters. Not for the platforms that have their own skill.
publora · 已有 AI 审核记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add publora/skills --skill social-post技能说明
name: social-post description: Use when the user wants to post or schedule to YouTube, a Facebook Page or Mastodon through Publora. YouTube needs a video on every post, Facebook publishes to Pages only, Mastodon caps at 500 characters. Not for the platforms that have their own skill.
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.
Getting Started
- Create account at publora.com/register (free)
- Connect platforms via OAuth in Publora Dashboard:
- YouTube: Google OAuth (requires YouTube channel)
- Facebook: Facebook OAuth (Pages only, not personal profiles)
- Mastodon: OAuth (mastodon.social instance)
- Get API key at app.publora.com/dashboard/api
- Connect your agent to the MCP server at
https://mcp.publora.com, authenticating withAuthorization: Bearer sk_YOUR_API_KEY. In Claude Code:
claude mcp add publora --transport http https://mcp.publora.com \
--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 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
# 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
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 | 512 MB (Publora limit) |
| Video formats | MP4, MOV, AVI, MKV, WebM |
Platform Settings (via REST API)
{
"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 not available via MCP - use REST API for these settings.
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
- Video required: YouTube does not support text-only or image posts
- Single video only: One video per post
- Processing time: Videos take seconds to minutes to process after upload
- Token refresh: YouTube tokens expire after ~6 months, reconnect if needed
Pages only - posts go to Facebook Pages, not personal profiles.
Platform Limits
| Feature | Limit |
|---|---|
| Post text | 2,200 characters (frontend) / 63,206 (API) |
| Images | Up to 10 per post |
| Image size | 10 MB |
| Video duration | 45 minutes |
| Video size | 512 MB (Publora limit) |
Multi-Page Support
If you manage multiple Facebook Pages, each gets its own platform ID:
facebook-112233445566(Page 1)facebook-778899001122(Page 2)
You can post to multiple pages in a single request.
Facebook Examples
Post this announcement to my Facebook Page:
"We're thrilled to announce our new product launch! Visit our website to learn more."
Post this to both my Facebook Pages:
"Holiday notice: Our offices will be closed on Monday."
Share these event photos on Facebook:
"Highlights from our company retreat! Great team, great memories."
Facebook Restrictions
- Pages only: Cannot post to personal profiles via API
- WebP auto-converted: WebP images become JPEG automatically
- 59-day token: Tokens auto-refresh, but may need reconnection if it fails
- No mixed media: A post can have images OR video, not both
Mastodon
Fediverse platform - posts federate across the decentralized network.
Platform Limits
| Feature | Limit |
|---|---|
| Post text | 500 characters |
| Images | Up to 4 per post |
| Image size | 16 MB |
| Video size | ~99 MB |
| Image formats | JPEG, PNG, GIF, WebP |
| Video formats | MP4, WebM, MOV |
Mastodon Examples
Post this to Mastodon:
"Hello fediverse! We just shipped a major update to our open-source project. #opensource"
Share this screenshot on Mastodon:
"New feature: dark mode is here! #ui #darkmode"
Mastodon Restrictions
- mastodon.social only: Currently connects only to mastodon.social instance
- Public visibility: All posts are public by default
- No auto-threading: Unlike X/Twitter, Mastodon doesn't split long content
- 500-char strict: Content over 500 characters will be rejected