X/Twitter 帖子
使用 Publora MCP 服务器创建和安排 X (Twitter) 帖子。支持文本帖子、图片（最多 4 张）、视频，以及用于长内容的自动线程拆分。
前提条件
计划： 需要付费计划（X API 费用转嫁）。当前限制和定价：publora.com/pricing。
重要： 由于 Twitter API 费用，免费入门计划不提供 X/Twitter。
入门指南
- 创建账户 在 publora.com/register
- 选择 Pro 或 Premium 计划（X/Twitter 需要付费计划）
- 连接 X/Twitter 在 Publora 控制面板 中通过 OAuth 连接
- 获取 API 密钥 在 app.publora.com/dashboard/api
- 将你的代理连接到 MCP 服务器，地址为
https://mcp.publora.com，使用Authorization: Bearer sk_YOUR_API_KEY进行身份验证。在 Claude Code 中：
claude mcp add publora --transport http https://mcp.publora.com \
--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 标头
# 获取已连接的平台
curl -X GET "https://api.publora.com/api/v1/platform-connections" \
-H "x-publora-key: sk_your_api_key"
# 创建帖子
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": "你的推文内容",
"scheduledTime": "2026-03-25T10:00:00Z"
}'
平台 ID 格式： twitter-{id}（例如，twitter-123456789）
📖 文档： docs.publora.com
平台限制
| 功能 | API 限制 | 备注 |
|---|---|---|
| 字符数 | 280 | 表情符号计为 2 个字符 |
| 图片 | 最多 4 张 | 自动转换为 PNG（最大宽度 1000px） |
| 视频时长 | 2 分 20 秒（140 秒） | Publora 将 X 视频验证为 140 秒 |
| 视频大小 | 512 MB | MP4、MOV 格式 |
| 线程拆分 | 自动 | 超过 280 个字符的内容使用 (1/N) 标记拆分 |
字符计数
X 有特定的字符计数规则，Publora 会自动处理：
- 标准字符 = 1
- 表情符号 = 2 个字符
- URL 按字面长度计算
- 线程标记为每条推文保留 10 个字符
自动线程拆分
当内容超过 280 个字符时，Publora 会自动创建一个连接的线程：
- 内容在段落分隔处拆分，然后是句子边界，再然后是单词边界
- 每个部分使用
(1/N)、(2/N)格式编号 - 推文通过 X 的
reply_to_id参数连接
手动线程分隔
在单独的行上使用 --- 强制进行线程分隔：
这是我在线程中的第一条推文。
---
这是我在线程中的第二条推文。
---
这是我在线程中的第三条推文！
可用工具
create_post
创建新的 X/Twitter 帖子或线程。
参数：
platforms：包含你的 X 连接 ID 的数组（例如，["twitter-12345678"]）content：帖子文本（如果超过 280 个字符则自动拆分为线程）scheduledTime：ISO 8601 UTC 日期时间。可选：省略它会将帖子创建为草稿。发送未来的时间以安排发布。如果时间是过去五分钟或更久，将拒绝并返回SCHEDULED_TIME_IN_PAST，因此对于立即发布，请使用当前时间加一分钟。mediaUrls：最多 10 个公共 https 图片或视频 URL。Publora 在服务器端下载它们并在验证之前附加，因此媒体和安排在单次调用中完成。这是草稿后get_upload_url然后complete_media流程的一次性替代方案。摄入速率限制为每小时 60 个 URL。
get_upload_url
获取用于媒体上传的预签名 URL。
参数：
postGroupId：要附加媒体的帖子 IDfileName：文件名（例如，“image.png”、“video.mp4”）contentType：image/png、image/jpeg、video/mp4type："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 清理上传的文件。
示例
简单推文
将此发布到 X：
"刚刚发布了我们的新 API 文档。看看吧！"
带图片的推文
将此发布到 Twitter，附带新控制面板的截图：
"改版之前和之后。你觉得怎么样？"
注意：最多允许 4 张图片。所有图片自动转换为 PNG。
长格式线程
创建一个 Twitter 线程：
"线程：构建我们创业公司的 5 个教训
---
1. 尽早发布，快速迭代。我们用有缺陷的 MVP 启动了，并根据真实反馈进行了改进。
---
2. 每天与用户交谈。我们最好的功能来自客户对话。
---
3. 专注胜过功能。我们砍掉了 3 个产品，专注于那个有效的产品。"
已安排的推文
安排这条在明天上午 9 点发布：
"周一动力：在你准备好之前开始。"
重要限制
-
需要 Pro 计划：由于 Twitter API 费用，免费入门计划不提供 X/Twitter。
-
140 秒视频限制：Publora 将 X 视频验证为 2 分 20 秒（140 秒）。更长的视频会验证失败。
-
图片自动转换：所有图片在上传前都会转换为 PNG（最大宽度 1000px）。动画 GIF 会失去动画效果。
-
图片和视频不混合：一条推文可以有图片或视频，不能同时存在。
-
仅第一条推文的媒体：在线程中，图片/视频仅附加到第一条推文。
最佳实践
内容
- 第一行钩子：大多数互动发生在第一条推文上
- 最佳线程长度：3-7 条推文以获得最佳互动
- 表情符号意识：记住表情符号计为 2 个字符
时机
- 最佳时间：目标时区的上午 8-10 点、中午 12-1 点、下午 5-6 点
- 频率：每天 3-5 条推文以增长
- 线程：在早上发布以获得最大可见性
互动
- 在一小时内回复评论
- 引用推文你自己的线程以增加可见性
- 使用相关的标签（每条推文 1-2 个）
故障排查
| 错误 | 原因 | 解决方案 |
|---|---|---|
| "X/Twitter requires Pro plan" | 使用入门计划 | 在 publora.com/settings 升级到 Pro |
| "Content too long" | 超过 280 个字符且线程拆分失败 | 添加手动 --- 分隔符 |
| "Video too long" | 超过 140 秒 | 将视频裁剪到 2 分 20 秒以下 |
| "Too many images" | 超过 4 张图片 | 减少到 4 张或更少 |
| "Rate limit exceeded" | X API 限制已到 | 等待并重试 |