threads-post

Threads 帖文

使用 Publora MCP 服务在 Meta 的 Threads 上创建和安排帖文。支持单条帖文、多部分串帖（相互连接的回复）、图片轮播（2-20 张图片）以及回复控制。

前提条件

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

开始使用

1. 在 publora.com/register 创建账户（免费）
2. 在 Publora Dashboard 中通过 Instagram OAuth 连接 Threads
3. 在 app.publora.com/dashboard/api 获取 API 密钥；仅当 Agent 无法通过 OAuth 登录，或你将使用下方的 REST API 备用方案时才需要
4. 将你的 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": ["threads-12345"],
    "content": "Your post content",
    "scheduledTime": "2026-03-25T10:00:00Z"
  }'

平台 ID 格式：threads-{id}（来自 /platform-connections）

📖 文档：docs.publora.com

平台限制

功能	限制
每条帖文的字符数	500（串帖中的每个部分）
话题标签	每条帖文最多 1 个
链接	每条帖文最多 5 个
轮播图片数量	2-20
图片大小	8 MB
图片格式	JPEG、PNG（WebP 会自动转换）
视频时长	5 分钟
视频大小	1 GB
视频格式	MP4、MOV
每日帖文数量	250
每日回复数量	1,000

可用工具

create_post

创建新的 Threads 帖文或串帖。

参数：

• platforms：包含你的 Threads 连接 ID 的数组（例如，["threads-12345"]）
• content：帖文文本（超过 500 个字符时会自动拆分为串帖）
• scheduledTime：ISO 8601 UTC 日期时间。**可选：**省略此项则将帖文创建为草稿。发送未来时间即可安排发布。若时间早于当前时间五分钟或以上，则会被拒绝并返回 SCHEDULED_TIME_IN_PAST；如需立即发布，请使用当前时间加一分钟。
• mediaUrls：最多 10 个公开的 https 图片或视频 URL。Publora 会在服务器端下载这些内容，并在验证前将其附加到帖文，因此媒体处理和安排发布时间可在一次调用中完成。这是“一次调用完成”的替代方案，无需先创建草稿，再调用 get_upload_url，然后调用 complete_media。每小时最多可接收 60 个 URL。

get_upload_url

获取用于上传图片的预签名 URL。

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 可清理已上传的文件。

多部分串

将完整文本放在一个 content 字段中。Publora 会将其作为一串相互连接的回复发布，每个部分都是对前一个部分的回复。

• 自动拆分： 超过 500 个字符的内容会被拆分成一串回复，而不是被拒绝。拆分时优先选择段落分隔处，其次是换行处、句末，最后是单词边界。自动拆分的部分会添加 (1/3) 格式的后缀，并为每个部分的后缀预留 10 个字符，因此每部分大约能容纳 490 个字符的原文。Emoji 按 2 个字符计算。
• 自行分段： 仅包含 --- 的一行（前后各有一个换行符）会设置分段。完整的一组 [1/3]、[2/3]、[3/3] 标记也可以。自行分隔的部分会按原文发布，不会添加编号。超过长度限制的 --- 部分会再次自动拆分；超过长度限制的 [n/m] 部分会被拒绝，并返回 THREAD_PART_TOO_LONG。
• 媒体： 仅附加到第一部分；后续部分仅包含文本。
• 权限： 串式回复需要连接具备 threads_manage_replies 权限。若没有此权限，帖子会在发布任何部分之前被拒绝，并返回 THREADS_PERMISSION_REQUIRED；请在 Publora Channels 中重新连接账号并批准所有权限。单条帖子和轮播不需要此权限。
• 检查结果： get_post 会返回 isThread: true，并在 threadParts[] 中为每个部分提供一个条目（index、content、status、publishedId）。如果串式回复中途失败（THREAD_PARTIALLY_PUBLISHED）或结果未知，已发布的部分仍在线：只发布缺失的部分，切勿重新创建整串内容。

MCP 或 REST 中都没有 parts 数组，也没有编号或串接开关：content 是唯一输入。

回复控制

通过 REST API 的 platformSettings 控制谁可以回复你的帖子：

值	说明
""（空）	平台默认行为（任何人都可以回复）
"everyone"	明确允许任何人回复
"accounts_you_follow"	仅你关注的账号可以回复
"mentioned_only"	仅被提及的账号可以回复

注意：MCP 的 create_post 和 update_post 工具以及 REST 均接受 platformSettings。此架构严格：拼错的平台或键会导致校验错误，而不会被静默忽略。

重要限制

1. 每条帖子最多一个话题标签：Threads 每条帖子最多允许 1 个话题标签。平台会忽略额外的话题标签。

2. 帖子无法编辑：发布后，无法通过 API 编辑 Threads 帖子。如有需要，请删除后重新发布。

3. 不支持视频轮播：Publora 的轮播功能仅支持图片。单独发布视频则可正常使用。

4. 串式回复需要 threads_manage_replies 权限：在授予此权限之前创建的连接，必须重新连接后才能发布多部分串式回复。单条帖子和轮播不受影响。

示例

简单文本帖子

Post this to Threads:
"Just discovered an amazing productivity hack that saved me 2 hours today. The key is batching similar tasks together."

图片轮播

Create a Threads carousel with these 5 product evolution screenshots.
Caption: "From concept to launch - our 6-month journey. #buildinpublic"

注意：需要 2-20 张图片。轮播不支持视频。

多部分串式回复

每个由 --- 分隔的文本块都会成为串中的一条回复，并按原文发布，不会添加编号：

Post this to Threads as a thread:
"Thread: 7 mistakes I made as a first-time founder

---

1. Hiring too fast. We went from 2 to 15 in 3 months. The culture suffered.

---

2. Ignoring unit economics. Revenue felt great until we calculated CAC..."

定时发布的帖子

Schedule this for tomorrow at 10 AM:
"Monday motivation: The best time to start was yesterday. The second best time is now."

最佳实践

1. 先抓住注意力：前 2 行决定用户是否继续阅读，要精心撰写
2. 最佳长度：单条帖子控制在 100-250 个字符，效果较好
3. 原生内容：原创、自然的帖子会获得更多推荐
4. 单个话题标签：使用一个高度相关的话题标签（平台限制）
5. 无法编辑：发布前仔细检查内容

发布时间

• 最佳时段：目标时区的上午 7-9 点、中午 12-1 点、晚上 7-9 点
• 发布频率：每天发布 1-3 条帖子，促进增长
• 保持规律：定期发布表明账号处于活跃状态

互动

• 在第一小时内回复评论
• 关联你的 Instagram（账号已关联）
• 使用相关话题/关键词，便于用户发现

故障排除

错误	原因	解决方案
"Account not connected"	Threads/Instagram OAuth 已过期	通过 Publora 控制面板重新连接
THREADS_PERMISSION_REQUIRED	链需要 threads_manage_replies	在 Publora Channels 中重新连接 Threads，并批准所有权限
THREAD_PART_TOO_LONG	[n/m] 部分超过 500 个字符	缩短该部分，或使用 --- 分隔，系统会自动重新拆分
THREAD_PARTIALLY_PUBLISHED	前面的部分已发布，但后续部分发布失败	在 get_post 中读取 threadParts，仅发布缺失的部分
"Media upload failed"	格式或大小不正确	检查：图片小于 8 MB，且仅支持 JPEG/PNG
"Carousel requires 2-20 items"	图片数量不正确	确保轮播图包含 2-20 张图片
250 posts/day exceeded	达到速率限制	等待 24 小时