Community写作与编辑github.com

publora/threads-post

通过 Publora MCP 创建并排定 Meta Threads 帖子,支持图片轮播与回复控制。适用于需要发布到 Threads 的场景。多帖连续发布功能已被平台禁用,因此长内容将保留为单帖。不适用于 Instagram(请使用 instagram-post)或 X(请使用 x-post)。

threads-post 是什么?

该技能用于通过 Publora MCP 服务器在 Meta 的 Threads 平台上创建和排定帖子。支持单帖、图片轮播(2–20 张图片)以及回复控制。目前由于平台连接问题,多帖连续发布(multi-part threading)被禁用。用户必须先注册 Publora 免费账户,通过 Instagram OAuth 连接 Threads,获取 API 密钥,然后将 Agent 连接到 MCP 服务器(https://mcp.publora.com)。技能提供多个工具:create_post 用于创建帖子(支持可选排定时间与媒体 URL),get_upload_url 和 complete_media 用于上传媒体文件,list_connections 用于查看已连接账户。还包括管理草稿/已排定帖子的 list_posts、get_post、update_post、delete_post 等工具。Threads 帖子限制为 500 字符、最多 1 个话题标签、5 个链接。图片轮播支持 JPEG/PNG(每个不超过 8 MB),视频支持 MP4/MOV(最长 5 分钟,不超过 1 GB)。每日可发 250 帖,回复 1000 条。该技能还提供详细的故障排除表以及发布、时间安排和互动的最佳实践。

兼容平台✓Claude Code✓Codex CLI✓Cursor
npx skills add https://github.com/publora/skills/tree/main/skills/threads-post

Installed? Explore more 写作与编辑 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Threads 帖子

在 Meta 的 Threads 上通过 Publora MCP 服务器创建和排定帖子。支持单帖、图片轮播(2–20 张图片)和回复控制。目前多帖连续发布因平台连接问题被禁用。

前提条件

计划: 适用于免费起步(Starter)计划。当前限额与定价:publora.com/pricing。

入门指南

  1. 创建账户,前往 publora.com/register(免费)
  2. 连接 Threads,通过 Instagram OAuth 在 Publora Dashboard 中完成
  3. 获取 API 密钥,前往 app.publora.com/dashboard/api
  4. 连接你的 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 严格:输入错误的平台或键名会返回验证错误,而不是静默忽略。

重要限制

  1. 单个话题标签限制:Threads 每帖最多允许 1 个话题标签。额外标签会被平台忽略。

  2. 发布后无法编辑:帖子一旦发布,无法通过 API 编辑。如需修改请删除后重新发布。

  3. 视频轮播不支持:Publora 的轮播实现仅支持图片。独立视频帖子可以正常使用。

  4. 多帖连续发布暂时不可用:将内容拆分为多个关联回复的功能暂时不可用。单帖和轮播功能正常。

示例

纯文本帖子

请在 Threads 上发布以下内容:
"刚刚发现一个超赞的效率技巧,今天省了我 2 小时。关键是把类似任务批处理在一起。"

图片轮播

创建一个包含这 5 张产品进化截图的 Threads 轮播。
配文:"从概念到发布——我们 6 个月的旅程。#buildinpublic"

注意:需要 2–20 张图片。轮播中不支持视频。

长内容(作为独立帖子发布)

由于连续发布功能被禁用,请明确要求各部分:

请在 Threads 上将这些内容作为独立帖子发布:
"连续帖:作为第一代创始人我犯的 7 个错误

---

1. 招聘太快。我们从 2 人涨到 15 人只用了 3 个月,文化受到了影响。

---

2. 忽视了单位经济。收入感觉很好,直到我们计算了 CAC..."

排定帖子

请将此帖子排定在明天上午 10 点发布:
"周一动力:开始的最佳时间是昨天。第二好的时间是现在。"

最佳实践

  1. 开头要吸引人:前两行决定互动量——让它们有分量
  2. 最佳长度:单帖 100–250 字符效果更佳
  3. 原生内容:原创、对话式的帖子更受平台青睐
  4. 单个话题标签:使用一个高度相关的话题标签(平台限制)
  5. 无编辑选项:发布前仔细检查内容

发布时间

  • 最佳时段:目标时区早上 7–9 点、中午 12–1 点、晚上 7–9 点
  • 频率:每天 1–3 帖促进增长
  • 一致性:定期发帖表明账户活跃

互动

  • 在发布后一小时内回复评论
  • 交叉引用你的 Instagram(两个账户已关联)
  • 使用相关话题/关键词提高被发现的机会

故障排除

错误原因解决方案
"账户未连接"Threads/Instagram OAuth 已过期通过 Publora 仪表盘重新连接
"内容过长"帖子超过 500 字符且连续发布失败手动添加 --- 分隔符
"媒体上传失败"格式或大小不符合要求检查:图片 < 8 MB,仅支持 JPEG/PNG
"轮播需要 2–20 个项目"图片数量错误确保轮播包含 2–20 张图片
超过每日 250 帖达到速率限制等待 24 小时

Individual skills in this repo

This repo contains 8 individual skills — each has its own dedicated page.

publora/bluesky-post

Use when the user wants to post or schedule to Bluesky through Publora. Handles the 300-character cap, auto-detected hashtags and links, up to 4 images, and videos. Alt text cannot be set through the API. Needs a Bluesky app password, never the main password. Not for Mastodon (use social-post).

publora/instagram-post

Use when the user wants to post or schedule to Instagram through Publora: a single image, a 2-10 image carousel, a Reel or a Story. Requires a Business account and an image or video; text-only posts are rejected by the API. Not for Threads (use threads-post).

publora/linkedin-analytics

Analyze LinkedIn performance and manage engagement through Publora. Use when the user asks how a LinkedIn post or account performed (impressions, reach, reactions, comments, reshares, follower growth) or wants to react, comment, reshare or resolve an @mention. Statistics run over the REST API, engagement over MCP tools. Not for creating posts (use linkedin-post).

publora/linkedin-post

Use when the user wants to publish or schedule a LinkedIn post through Publora: text, a multi-image grid, a video, a PDF document, or @mentions. Not for analytics, reactions, comments or reshares (use linkedin-analytics), and not for other platforms.

publora/social-post

Use when the user wants to post or schedule to YouTube, a Facebook Page or Mastodon through Publora. YouTube needs a video on every post, Facebook publishes to Pages only, Mastodon caps at 500 characters. Not for the platforms that have their own skill.

publora/telegram-post

Use when the user wants to post or schedule to a Telegram channel or group through Publora, using a bot. Covers Telegram markdown, silent delivery, link previews and forward protection. Bot API caps media captions at 1,024 characters and videos at 50 MB. Not for other platforms (each has its own skill).

publora/tiktok-post

Use when the user wants to upload or schedule a TikTok video through Publora, with privacy, comment, duet, stitch and commercial-disclosure settings. Video runs 3 seconds to 10 minutes at 23+ FPS; carousels take up to 35 images. Unaudited apps can publish private videos only. Not for Reels (use instagram-post).

publora/x-post

Use when the user wants to post or schedule to X (Twitter) through Publora, including threads auto-split past 280 characters, up to 4 images, or a video up to 140 seconds. X needs a paid Publora plan. Not for Threads or Bluesky (each has its own skill).

相关技能