Threads 帖子
在 Meta 的 Threads 上通过 Publora MCP 服务器创建和排定帖子。支持单帖、图片轮播(2–20 张图片)和回复控制。目前多帖连续发布因平台连接问题被禁用。
前提条件
计划: 适用于免费起步(Starter)计划。当前限额与定价:publora.com/pricing。
入门指南
- 创建账户,前往 publora.com/register(免费)
- 连接 Threads,通过 Instagram OAuth 在 Publora Dashboard 中完成
- 获取 API 密钥,前往 app.publora.com/dashboard/api
- 连接你的 Agent 到 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": ["threads-12345"],
"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 日期时间。可选:省略则创建为草稿。传入未来时间可排定发布。传入过去 5 分钟或更早的时间会被拒绝,返回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;这些 ID 无法猜测。
list_posts / get_post / update_post / delete_post
管理已排定和草稿状态的帖子。update_post 还可修改草稿或已排定帖子的 content 和 platforms,因此修正错字或更改目标平台不再需要删除后重新创建。delete_media 和 prune_media_reference 用于清理已上传的文件。
长内容
Threads 帖子限制为 500 字符,且 Publora 的多帖连续发布功能目前被禁用,因为 Threads 应用连接正在恢复中。超出限制的内容不会自动拆分,因此:
- 请将帖子保持在 500 字符以内,或
- 自行将各部分作为独立帖子发布,或
- 将长文版移至支持连续发布的平台(如 X)并附上链接。
手动 --- 分隔符和 [1/3] 标记会原样保留,但目前不会创建关联回复链。请联系 [email protected] 了解恢复时间。
回复控制
通过 REST API 的 platformSettings 控制谁可以回复你的帖子:
| 值 | 描述 |
|---|---|
""(空) | 默认平台行为(任何人都可以回复) |
"everyone" | 明确允许任何人回复 |
"accounts_you_follow" | 仅你关注的账户可以回复 |
"mentioned_only" | 仅被提及的账户可以回复 |
注意:platformSettings 不仅可通过 MCP 的 create_post 和 update_post 工具接受,也支持 REST 方式。其 schema 严格:输入错误的平台或键名会返回验证错误,而不是静默忽略。
重要限制
-
单个话题标签限制:Threads 每帖最多允许 1 个话题标签。额外标签会被平台忽略。
-
发布后无法编辑:帖子一旦发布,无法通过 API 编辑。如需修改请删除后重新发布。
-
视频轮播不支持:Publora 的轮播实现仅支持图片。独立视频帖子可以正常使用。
-
多帖连续发布暂时不可用:将内容拆分为多个关联回复的功能暂时不可用。单帖和轮播功能正常。
示例
纯文本帖子
请在 Threads 上发布以下内容:
"刚刚发现一个超赞的效率技巧,今天省了我 2 小时。关键是把类似任务批处理在一起。"
图片轮播
创建一个包含这 5 张产品进化截图的 Threads 轮播。
配文:"从概念到发布——我们 6 个月的旅程。#buildinpublic"
注意:需要 2–20 张图片。轮播中不支持视频。
长内容(作为独立帖子发布)
由于连续发布功能被禁用,请明确要求各部分:
请在 Threads 上将这些内容作为独立帖子发布:
"连续帖:作为第一代创始人我犯的 7 个错误
---
1. 招聘太快。我们从 2 人涨到 15 人只用了 3 个月,文化受到了影响。
---
2. 忽视了单位经济。收入感觉很好,直到我们计算了 CAC..."
排定帖子
请将此帖子排定在明天上午 10 点发布:
"周一动力:开始的最佳时间是昨天。第二好的时间是现在。"
最佳实践
- 开头要吸引人:前两行决定互动量——让它们有分量
- 最佳长度:单帖 100–250 字符效果更佳
- 原生内容:原创、对话式的帖子更受平台青睐
- 单个话题标签:使用一个高度相关的话题标签(平台限制)
- 无编辑选项:发布前仔细检查内容
发布时间
- 最佳时段:目标时区早上 7–9 点、中午 12–1 点、晚上 7–9 点
- 频率:每天 1–3 帖促进增长
- 一致性:定期发帖表明账户活跃
互动
- 在发布后一小时内回复评论
- 交叉引用你的 Instagram(两个账户已关联)
- 使用相关话题/关键词提高被发现的机会
故障排除
| 错误 | 原因 | 解决方案 |
|---|---|---|
| "账户未连接" | Threads/Instagram OAuth 已过期 | 通过 Publora 仪表盘重新连接 |
| "内容过长" | 帖子超过 500 字符且连续发布失败 | 手动添加 --- 分隔符 |
| "媒体上传失败" | 格式或大小不符合要求 | 检查:图片 < 8 MB,仅支持 JPEG/PNG |
| "轮播需要 2–20 个项目" | 图片数量错误 | 确保轮播包含 2–20 张图片 |
| 超过每日 250 帖 | 达到速率限制 | 等待 24 小时 |