linkedin-post

LinkedIn 帖子

使用 Publora MCP 服务创建并安排 LinkedIn 帖子。支持文本帖子、单张图片、多图片帖子（网格布局）、视频和 PDF 文档。

前置条件

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

开始使用

1. 创建账户：publora.com/register（免费）
2. 连接 LinkedIn：在 Publora 控制面板中通过 OAuth 连接
3. 获取 API 密钥：前往 app.publora.com/dashboard/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 标头（不要使用 Authorization: Bearer）：

# Get your 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": ["linkedin-Tz9W5i6ZYG"],
    "content": "Your post content here",
    "scheduledTime": "2026-03-25T10:00:00Z"
  }'

平台 ID 格式：linkedin-{id}，其中 {id} 来自 /platform-connections 响应。

ID 示例：linkedin-Tz9W5i6ZYG、linkedin-abc123xyz

📖 完整 API 文档：docs.publora.com

平台限制

功能	限制
字符数	最多 3,000 个
“查看更多”前可见内容	前 210 个字符
图片	最多 10 张（网格布局，不可滑动的轮播）
图片大小	36,152,320 像素是主要限制；上限为 50 MB
图片格式	JPEG、PNG、GIF、WebP（WebP 会自动转换）
视频时长	30 分钟
视频大小	最多 500 MB
视频格式	仅限 MP4

可用工具

create_post

创建新的 LinkedIn 帖子，或安排稍后发布。

参数：

• platforms：包含你的 LinkedIn 连接 ID 的数组（例如，["linkedin-abc123"]）
• content：帖子文本（最多 3,000 个字符）
• 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：要附加媒体的帖子 ID
• fileName：文件名（例如，“chart.png”）
• contentType：MIME 类型（例如，“image/jpeg”、“video/mp4”、“application/pdf”）
• type：“image”或“video”

complete_media

在 get_upload_url 上传文件后，预签名 PUT 请求成功时，完成文件处理。此步骤为可选操作，因为排期时也会完成待处理媒体的处理；但提前调用可在发布前显示格式和探测错误。通过 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 可清理已上传的文件。

提及个人和公司

LinkedIn 帖子支持使用 URN 语法进行 @提及：

@{urn:li:person:MEMBER_ID|Display Name}       # Mention a person
@{urn:li:organization:ORG_ID|Company Name}    # Mention a company

示例：

Great insights from @{urn:li:person:4986615|Serge Bulaev} at @{urn:li:organization:107107343|Creative Content Crafts Inc}!

**重要：**显示名称必须与 LinkedIn 个人资料名称完全一致（区分大小写），包括 "Inc"、"LLC" 等公司后缀。

不要手动编写成员 ID。linkedin_list_mentionables MCP 工具可将名称解析为正确的 URN；请参阅 linkedin-analytics 技能。

重要的 API 限制

1. 不支持自然流量轮播图：无法通过 API 发布可滑动的多图轮播图（仅支持赞助内容）。多图帖子会以网格布局显示。

2. 不支持混合媒体：同一帖子中不能同时包含图片、视频或文档。

3. 不支持富文本：LinkedIn API 不支持粗体、斜体或其他格式。请使用纯文本或 Unicode 字符来强调内容。

4. 轮播图的 PDF 替代方案：如需分享可滑动的多页内容，请改为上传 PDF 文档。

示例

简单文本帖子

Schedule a LinkedIn post for tomorrow at 9 AM:
"We're thrilled to announce the release of our AI writing assistant. After 18 months of development, we're ready to help teams write better content faster."

带提及的帖子

Create a LinkedIn post mentioning our CEO:
"Excited to share insights from @{urn:li:person:4986615|Serge Bulaev} on the future of AI in content creation."

多图帖子

Create a LinkedIn post with 4 product screenshots showing our new dashboard features.

注意：图片会以网格布局显示，而不是可滑动的轮播图。

PDF 文档帖子

Share our Q4 report as a PDF on LinkedIn with a summary caption.

这是分享类似轮播图的多页内容的最佳方式。

最佳实践

1. 首行很重要：前 210 个字符会显示在“查看更多”之前，请让内容引人注目
2. 最佳长度：少于 1,300 个字符的帖子往往效果更好
3. 发布时间：受众所在时区的周二至周四上午 8–10 点
4. 话题标签：使用 3–5 个相关话题标签——支持将其作为纯文本发布
5. 互动：以问题结尾，鼓励评论

故障排除

错误	原因	解决方案
"Account not connected"	LinkedIn OAuth 已过期	在 Publora 控制面板中重新连接
"MEDIA_ASSET_PROCESSING_FAILED"	文件过大或格式错误	检查：图片 < 5 MB，视频 < 500 MB，且为 MP4 格式
"Rate limited" (429)	API 调用过多	等待后重试，并使用退避策略
"Cannot mix media types"	同一帖子中同时包含图片和视频	每个帖子只使用一种媒体类型
MCP 不可用	服务端问题	使用 REST API 作为备用方案（见上文）