social-post

社交帖子（YouTube、Facebook、Mastodon）

使用 Publora MCP 服务在 YouTube、Facebook Pages 和 Mastodon 上创建并安排帖子。本技能涵盖通过标准发布流程操作、无需处理平台特定复杂情况的平台。

前提条件

**套餐：**免费 Starter 套餐即可使用。当前限制和价格：publora.com/pricing。

开始使用

1. 在 publora.com/register 创建账户（免费）
2. 在 Publora Dashboard 中通过 OAuth 连接平台：
   • YouTube：Google OAuth（需要 YouTube 频道）
   • Facebook：Facebook OAuth（仅限 Pages，不支持个人主页）
   • Mastodon：OAuth（mastodon.social 实例）
3. 仅当你的 Agent 无法通过 OAuth 登录，或你要使用下文的 REST API 后备方案时，才在 app.publora.com/dashboard/api 获取 API 密钥
4. 将你的 Agent 连接到 https://mcp.publora.com/mcp 上的 MCP 服务：
   • **升级不带 /mcp 的手动连接：**Claude 会将 https://mcp.publora.com 视为与捆绑连接不同的服务。在当前作用域中，将现有连接改为 https://mcp.publora.com/mcp，并保留其身份验证信息和所选账户；如果系统提示，请重新登录。或者，确认捆绑连接使用的是预期账户，然后仅移除旧的手动条目。不要添加第二个条目，也不要自动删除凭据。
   • Publora 工具已可用（publora-skills 插件或 Claude 中的 Publora 连接器）：无需进行任何设置。Claude 会在首次运行工具时提示你登录 Publora。
   • 支持 OAuth 的 Agent（Claude Code、Cursor，以及 Claude 和 ChatGPT 应用）：通过 URL 添加服务并登录，无需 API 密钥。在 Claude Code 中，添加服务后运行 /mcp 登录：

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

• **不支持 OAuth 的 Agent：**将 API 密钥作为 Authorization: Bearer sk_YOUR_API_KEY 发送：

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 和 claude.ai 连接器各自需要不同的配置文件或流程；准确路径和代码片段请参阅客户端设置。

REST API 后备方案

如果 MCP 不可用，可直接使用 REST API：

基础 URL： https://api.publora.com/api/v1

身份验证：x-publora-key 标头

# 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"
  }'

平台 ID 格式：

• YouTube：youtube-{channel_id}（例如，youtube-UCxxx）
• Facebook：facebook-{page_id}（例如，facebook-112233445566）
• Mastodon：mastodon-{id}（例如，mastodon-456）

📖 文档：docs.publora.com

---

YouTube

仅支持视频的平台——每条帖子都必须包含视频文件。

平台限制

功能	限制
视频标题	100 个字符
视频说明	5,000 个字符
视频时长	12 小时
视频大小	256 GB
视频格式	MP4、MOV、AVI、WebM

平台设置（通过 REST API）

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

设置	值	默认值
privacy	"public"、"unlisted"、"private"	"public"
title	字符串	根据内容的前 70 个字符生成

注意：MCP 的 create_post 和 update_post 工具以及 REST API 均接受 platformSettings。其架构严格：平台或键名拼写错误时会返回验证错误，而不会被静默忽略。

YouTube 示例

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 限制

1. 必须包含视频：YouTube 不支持纯文本或图片帖子
2. 仅限单个视频：每条帖子只能包含一个视频
3. 处理时间：上传后，视频处理需要几秒到几分钟
4. 令牌刷新：YouTube 令牌约 6 个月后过期，如有需要请重新连接

---

Facebook

仅限 Pages——帖子会发布到 Facebook Pages，而非个人主页。

平台限制

功能	限制
帖子文本	2,200 个字符（前端）/ 63,206 个字符（API）
图片	每条帖子最多 10 张
图片大小	10 MB
视频时长	45 分钟
视频大小	2 GB

多主页支持

如果你管理多个 Facebook 主页，每个主页都有自己的平台 ID：

• facebook-112233445566（主页 1）
• facebook-778899001122（主页 2）

你可以在单个请求中向多个主页发布内容。

Facebook 示例

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 限制

1. 仅限主页：无法通过 API 向个人主页发布内容
2. 自动转换 WebP：WebP 图片会自动转换为 JPEG
3. 59 天令牌：令牌会自动刷新，但如果刷新失败，可能需要重新连接
4. 不支持混合媒体：帖子可以包含图片或视频，但不能同时包含两者

---

Mastodon

联邦宇宙平台——帖子会在去中心化网络中联邦传播。

平台限制

功能	限制
帖子文本	500 个字符
图片	每条帖子最多 4 张
图片大小	16 MB
视频大小	~99 MB
图片格式	JPEG、PNG、GIF、WebP
视频格式	MP4、WebM、MOV

Mastodon 示例

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 限制

1. 仅限 mastodon.social：目前仅连接到 mastodon.social 实例
2. 公开可见：默认情况下，所有帖子均为公开内容
3. 不自动拆分长帖：与 X/Twitter 和 Threads 不同，Mastodon 不会拆分长内容
4. 严格限制 500 个字符：超过 500 个字符的内容会被拒绝

---

可用工具（所有平台）

create_post

在任意平台上创建新帖子。

参数：

• platforms：平台 ID 数组（例如 ["youtube-UCxxx", "facebook-123", "mastodon-456"]）
• content：帖子文本
• scheduledTime：ISO 8601 UTC 日期时间。可选：省略此参数时，帖子会创建为草稿。发送未来时间可安排发布。若时间早于当前时间 5 分钟或以上，请求将被 SCHEDULED_TIME_IN_PAST 拒绝；如需立即发布，请使用当前时间加 1 分钟。
• mediaUrls：最多 10 个公开的 https 图片或视频 URL。Publora 会在服务器端下载这些文件，并在验证前将其附加到帖子，因此可以通过一次调用完成媒体处理和排期。这是“先创建草稿，再调用 get_upload_url，然后调用 complete_media”流程的一步式替代方案。每小时最多接收 60 个 URL。

get_upload_url

获取用于上传媒体的预签名 URL。

参数：

• postGroupId：要附加媒体的帖子 ID
• fileName：文件名
• contentType：MIME 类型
• type："image" 或 "video"

complete_media

在预签名 PUT 请求成功后，完成通过 get_upload_url 上传的文件。此步骤为可选，因为排期时也会完成待处理媒体，但提前调用可在发布前显示格式和探测错误。对于通过 mediaUrls 附加的媒体，无需调用。

参数：

• mediaId：get_upload_url 返回的 ID

list_connections

列出已连接的账户及其平台 ID。请先调用此工具，并原样复制这些 ID；它们无法猜测。

list_posts / get_post / update_post / delete_post

管理排期和草稿帖子。update_post 还可以修改草稿或排期帖子的 content 和 platforms，因此，修正错别字或更改发布平台不再需要先删除再重建。delete_media 和 prune_media_reference 可用于清理已上传的文件。

---

跨平台发布

同时向多个平台发布内容：

Post this video to YouTube and this text to Facebook and Mastodon:
"Announcing our new feature - watch the demo!"

Publora 会自动处理各平台的特定要求：

• YouTube 会收到视频及其标题/说明
• Facebook 会收到文本和视频
• Mastodon 会收到文本（受 500 个字符限制）

在跨平台发布或安排批量发布之前，请调用 account_context，检查剩余帖子配额和最晚可安排日期。

---

故障排除

平台	错误	解决方案
YouTube	"Video required"	附加视频文件
YouTube	"Account disconnected"	通过控制面板重新连接
Facebook	"Page not found"	验证页面连接
Facebook	"Token expired"	在控制面板中重新连接页面
Mastodon	"Content too long"	缩短至 500 个字符以内
Mastodon	"Too many images"	将图片数量减少至 4 张或更少
全部	速率限制错误	等待后重试

此处曾显示的 512 MB 上限适用于控制面板的 /media/process-video 多部分端点。API 和 MCP 上传使用预签名方式，并遵循上述平台上限。