x-post

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

X/Twitter Post

X/Twitter 帖子发布

Create and schedule posts to X (Twitter) using the Publora MCP server. Supports text posts, images (up to 4), videos, and automatic thread splitting for long-form content.

使用Publora MCP服务器创建并调度X（Twitter）帖子。支持文字帖子、图片（最多4张）、视频，以及针对长内容的自动分线程功能。

Prerequisites

前提条件

Plans: Pro ($2.99/account/month), Premium ($9.99/account/month)

Important: X/Twitter is NOT available on the free Starter plan due to Twitter API costs.

套餐： Pro（2.99美元/账户/月）、Premium（9.99美元/账户/月）

重要提示： 由于Twitter API成本原因，免费的Starter套餐不支持X/Twitter功能。

Getting Started

快速开始

Create account at publora.com/register
Choose Pro or Premium plan (X/Twitter requires paid plan)
Connect X/Twitter via OAuth in Publora Dashboard
Get API key at publora.com/settings/api
Configure MCP in Claude Desktop (
```
~/.claude/claude_desktop_config.json
```
):

json

{
  "mcpServers": {
    "publora": {
      "type": "http",
      "url": "https://mcp.publora.com",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

在publora.com/register创建账户
选择Pro或Premium套餐（X/Twitter需要付费套餐）
在Publora控制台通过OAuth关联X/Twitter
在publora.com/settings/api获取API密钥
在Claude Desktop中配置MCP（
```
~/.claude/claude_desktop_config.json
```
）：

json

{
  "mcpServers": {
    "publora": {
      "type": "http",
      "url": "https://mcp.publora.com",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

REST API Fallback

REST API备用方案

If MCP is unavailable, use the REST API directly:

Base URL:

https://api.publora.com/api/v1

Authentication:

x-publora-key

header

bash

undefined

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

基础URL：

https://api.publora.com/api/v1

身份验证：

x-publora-key

请求头

bash

undefined

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


**Platform ID Format:** `twitter-{id}` (e.g., `twitter-123456789`)

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


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

📖 **文档：** [docs.publora.com](https://docs.publora.com)

Plan Limits

套餐限制

Plan	Posts/month	Price
Starter	Not available	Free
Pro	100/account	$2.99/account/month
Premium	500/account	$9.99/account/month

套餐	每月帖子数量	价格
Starter	不支持	免费
Pro	100/账户	2.99美元/账户/月
Premium	500/账户	9.99美元/账户/月

Platform Limits

平台限制

Feature	API Limit	Notes
Characters	280	Emojis count as 2 characters
Images	Up to 4	Auto-converted to PNG (max 1000px width)
Video duration	2 minutes	API limit (native app allows 2:20)
Video size	512 MB	MP4, MOV formats
Threading	Automatic	Content over 280 chars split with `(1/N)` markers

功能	API限制	说明
字符数	280	表情符号算作2个字符
图片数量	最多4张	自动转换为PNG格式（最大宽度1000px）
视频时长	2分钟	API限制（原生应用允许2分20秒）
视频大小	512 MB	支持MP4、MOV格式
分线程	自动处理	超过280字符的内容会以 `(1/N)` 标记拆分

Character Counting

字符计数规则

X has specific character counting rules that Publora handles automatically:

Standard characters = 1
Emojis = 2 characters
URLs counted by literal length
Thread markers reserve 10 characters per tweet

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

标准字符 = 1个字符
表情符号 = 2个字符
URL按实际长度计数
分线程标记每条推文占用10个字符

Auto-Threading

自动分线程

When content exceeds 280 characters, Publora automatically creates a connected thread:

Content split at paragraph breaks, then sentence boundaries, then word boundaries
Each part numbered with
```
(1/N)
```
,
```
(2/N)
```
format
Tweets connected via X's
```
reply_to_id
```
parameter

当内容超过280字符时，Publora会自动创建关联的线程：

内容先按段落拆分，再按句子边界拆分，最后按单词边界拆分
每个部分以
```
(1/N)
```
、
```
(2/N)
```
格式编号
推文通过X平台的
```
reply_to_id
```
参数关联

Manual Thread Breaks

手动分线程断点

Use

---

on its own line to force a thread break:

This is my first tweet in the thread.

---

This is my second tweet in the thread.

---

And this is my third tweet!

单独一行使用

---

可强制拆分线程：

This is my first tweet in the thread.

---

This is my second tweet in the thread.

---

And this is my third tweet!

Available Tools

可用工具

create_post

Create a new X/Twitter post or thread.

Parameters:

```
platforms
```
: Array with your X connection ID (e.g.,
```
["twitter-12345678"]
```
)
```
content
```
: Post text (auto-threads if over 280 chars)
```
scheduledTime
```
: ISO 8601 datetime (required - for immediate posting, use current time + 1 minute)

创建新的X/Twitter帖子或线程。

参数：

```
platforms
```
: 包含你的X关联ID的数组（例如：
```
["twitter-12345678"]
```
）
```
content
```
: 帖子文本（超过280字符时自动分线程）
```
scheduledTime
```
: ISO 8601格式的日期时间（必填 - 如需立即发布，使用当前时间+1分钟）

get_upload_url

Get presigned URL for media uploads.

Parameters:

```
postGroupId
```
: Post ID to attach media to
```
fileName
```
: File name (e.g., "image.png", "video.mp4")
```
contentType
```
:
```
image/png
```
,
```
image/jpeg
```
,
```
video/mp4
```
```
type
```
:
```
"image"
```
or
```
"video"
```

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

参数：

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

list_posts / update_post / delete_post

Manage scheduled and draft posts.

管理已调度和草稿状态的帖子。

Examples

示例

Simple Tweet

简单推文

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

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

Tweet with Images

带图片的推文

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

Note: Up to 4 images allowed. All images auto-converted to PNG.

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

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

Long-Form Thread

长内容线程

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."

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."

Scheduled Tweet

定时推文

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

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

Important Restrictions

重要限制

Pro plan required: X/Twitter is excluded from the free Starter plan due to Twitter API costs.
2-minute video limit: The X API limits videos to 2 minutes, even though the native app allows longer videos.
Image auto-conversion: All images are converted to PNG (max 1000px width) before upload. Animated GIFs lose animation.
No image+video mix: A tweet can have images OR video, not both.
Media on first tweet only: In threads, images/video attach to the first tweet only.

需Pro套餐：由于Twitter API成本原因，免费Starter套餐不支持X/Twitter功能。
2分钟视频限制：X API限制视频时长为2分钟，即使原生应用允许更长时长。
图片自动转换：所有图片上传前会转换为PNG格式（最大宽度1000px），动态GIF会失去动画效果。
不可混合图片与视频：一条推文只能包含图片或视频，不能同时包含两者。
媒体仅可附加到首条推文：在线程中，图片/视频只能附加到第一条推文。

Best Practices

最佳实践

Content

内容创作

Hook in first line: Most engagement happens on the first tweet
Optimal thread length: 3-7 tweets for best engagement
Emoji awareness: Remember emojis count as 2 characters

首行设置钩子：大部分互动发生在第一条推文
最优线程长度：3-7条推文的互动效果最佳
注意表情符号计数：记住表情符号算作2个字符

Timing

发布时机

Best times: 8-10 AM, 12-1 PM, 5-6 PM in target timezone
Frequency: 3-5 tweets per day for growth
Threads: Post in morning for maximum visibility

最佳时段：目标时区的8-10点、12-13点、17-18点
发布频率：每天3-5条推文以实现增长
线程发布：上午发布可获得最大曝光

Engagement

互动技巧

Reply to comments within the first hour
Quote tweet your own threads for visibility
Use relevant hashtags (1-2 per tweet)

评论发布后1小时内回复
引用转发自己的线程以增加曝光
使用相关话题标签（每条推文1-2个）

Troubleshooting

故障排除

Error	Cause	Solution
"X/Twitter requires Pro plan"	Using Starter plan	Upgrade to Pro at publora.com/settings
"Content too long"	Over 280 chars and threading failed	Add manual `---` breaks
"Video too long"	Over 2 minutes	Trim video to under 2 minutes
"Too many images"	More than 4 images	Reduce to 4 or fewer
"Rate limit exceeded"	X API limit reached	Wait and retry

错误信息	原因	解决方案
"X/Twitter requires Pro plan"	使用Starter套餐	在publora.com/settings升级到Pro套餐
"Content too long"	超过280字符且自动分线程失败	添加手动 `---` 断点
"Video too long"	视频时长超过2分钟	将视频修剪至2分钟以内
"Too many images"	图片数量超过4张	减少至4张或更少
"Rate limit exceeded"	达到X API限制	等待后重试