x-post

X/Twitter 帖子

使用 Publora MCP 服务创建并安排发布到 X（Twitter）的帖子。支持文本帖子、图片（最多 4 张）、视频，以及自动将长内容拆分为帖子串。

前提条件

套餐： 需要付费套餐（X API 费用将转由用户承担）。当前限制和定价：publora.com/pricing。

重要提示： 由于 Twitter API 费用，免费 Starter 套餐不支持 X/Twitter。

开始使用

1. 创建账户：publora.com/register
2. 选择 Pro 或 Premium 套餐（X/Twitter 需要付费套餐）
3. 在 Publora Dashboard 中通过 OAuth 连接 X/Twitter
4. 在 app.publora.com/dashboard/api 获取 API 密钥，仅当 Agent 无法通过 OAuth 登录，或你要使用下方的 REST API 备用方案时才需要
5. 将你的 Agent 连接到 MCP 服务 https://mcp.publora.com/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": ["twitter-123456789"],
    "content": "Your tweet content",
    "scheduledTime": "2026-03-25T10:00:00Z"
  }'

平台 ID 格式： twitter-{id}（例如，twitter-123456789）

📖 文档： docs.publora.com

平台限制

功能	API 限制	备注
字符数	280	Emoji 按 2 个字符计
图片	最多 4 张	自动转换为 PNG（最大宽度 1000px）
视频时长	2 min 20 s（140 s）	Publora 会验证 X 视频时长是否不超过 140 s
视频大小	512 MB	MP4、MOV 格式
帖子串	自动	超过 280 个字符的内容会拆分，并添加 (1/N) 标记

字符计数

X 有特定的字符计数规则，Publora 会自动处理：

• 普通字符 = 1
• Emoji = 2 个字符
• URL 按字面长度计数
• 每条帖子预留 10 个字符用于帖子串标记

自动拆分帖子串

当内容超过 280 个字符时，Publora 会自动创建相互关联的帖子串：

1. 先按段落换行处拆分，再按句子边界拆分，最后按单词边界拆分
2. 每部分按 (1/N)、(2/N) 格式编号
3. 通过 X 的 reply_to_id 参数连接各条帖子

手动拆分帖子串

单独一行使用 --- 可强制拆分帖子串：

This is my first tweet in the thread.

---

This is my second tweet in the thread.

---

And this is my third tweet!

可用工具

create_post

创建新的 X/Twitter 帖子或帖子串。

参数：

• platforms：包含你的 X 连接 ID 的数组（例如，["twitter-12345678"]）
• content：帖子文本（超过 280 个字符时会自动拆分成帖子串）
• scheduledTime：ISO 8601 UTC 日期时间。可选：省略此参数，帖子会创建为草稿。发送未来的时间可安排发布。早于当前时间 5 分钟或更久的时间会被拒绝，并返回 SCHEDULED_TIME_IN_PAST，因此若要立即发布，请使用当前时间加一分钟。
• mediaUrls：最多 10 个公开的 https 图片或视频 URL。Publora 会在服务端下载并附加这些媒体，然后进行验证，因此媒体处理和定时发布可在一次调用中完成。这是“先创建草稿，再调用 get_upload_url，然后调用 complete_media”流程的一步式替代方案。摄取速率限制为每小时 60 个 URL。

get_upload_url

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

参数：

• postGroupId：要附加媒体的帖子 ID
• fileName：文件名（例如，"image.png"、"video.mp4"）
• contentType：image/png、image/jpeg、video/mp4
• type："image" 或 "video"

complete_media

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

参数：

• mediaId：get_upload_url 返回的 ID

list_connections

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

list_posts / get_post / update_post / delete_post

管理定时发布和草稿帖子。update_post 也可修改草稿或定时发布帖子的 content 和 platforms，因此修正拼写错误或更改发布目标时，不再需要删除后重新创建。delete_media 和 prune_media_reference 可清理已上传的文件。

示例

简单推文

Post this to X:
"Just shipped our new API documentation. Check it out!"

带图片的推文

Post this to Twitter with screenshots of the new dashboard:
"Before and after our redesign. What do you think?"

注意：最多允许 4 张图片。所有图片都会自动转换为 PNG。

长篇帖子串

Create a Twitter thread:
"Thread: 5 lessons from building our startup

---

1. Ship early, iterate fast. We launched with a buggy MVP and improved based on real feedback.

---

2. Talk to users daily. Our best features came from customer conversations.

---

3. Focus beats features. We killed 3 products to focus on the one that worked."

定时推文

Schedule this for tomorrow at 9 AM:
"Monday motivation: Start before you're ready."

重要限制

1. 需要 Pro 计划：由于 Twitter API 成本，X/Twitter 不包含在免费的 Starter 计划中。

2. 视频时长限制为 140 秒：Publora 会将 X 视频时长限制验证为 2 分 20 秒（140 秒）。更长的视频无法通过验证。

3. 图片自动转换：所有图片都会在上传前转换为 PNG（最大宽度为 1000px）。动画 GIF 会失去动画效果。

4. 图片和视频不能混用：一条推文只能包含图片或视频，不能同时包含两者。

5. 媒体仅附加到首条推文：在帖子串中，图片/视频只会附加到首条推文。

最佳实践

内容

1. 首行设置吸引点：大多数互动都发生在首条推文上
2. 最佳帖子串长度：3-7 条推文可获得最佳互动效果
3. 注意 Emoji：请记住，Emoji 按 2 个字符计算

时间

• 最佳时段：目标时区的上午 8-10 点、中午 12-1 点、下午 5-6 点
• 发布频率：每天发布 3-5 条推文以实现增长
• 帖子串：在早上发布，以获得最大曝光

互动

• 在首小时内回复评论
• 引用转推自己的帖子串以提高曝光
• 使用相关主题标签（每条推文 1-2 个）

故障排除

错误	原因	解决方案
"X/Twitter requires Pro plan"	使用的是 Starter 计划	前往 publora.com/settings 升级到 Pro
"Content too long"	超过 280 个字符且拆分帖子串失败	手动添加 --- 分隔符
"Video too long"	超过 140 秒	将视频剪短至 2 分 20 秒以内
"Too many images"	图片超过 4 张	将图片减少至 4 张或更少
"Rate limit exceeded"	达到 X API 速率限制	等待后重试