linkedin

LinkedIn

通过 Hyper MCP 提供的 LinkedIn 集成发布内容的技能。

超出范围 — 转交给其他技能

请求	转交给
Instagram 帖子 / Reel / Story	instagram
TikTok 自然内容发布	tiktok
TikTok 广告活动	tiktok-ads
Meta（Facebook / Instagram）广告	meta-ads
Google Ads 广告活动	google-ads
Amazon Sponsored Products 广告活动	amazon-ads

要求

• 已安装并连接 Hyper MCP。 https://app.hyperfx.ai/mcp
• 已连接 LinkedIn 集成：https://app.hyperfx.ai/apps。
• 发布公司主页帖子时，已连接的成员账号必须有权代表该组织发帖。

如果 search("linkedin_text_posts_create") 未找到 linkedin_text_posts_create，请停止并告知用户启用 Hyper MCP 并连接 LinkedIn。

如何运行此技能中的工具

此技能中的每个工具均以其规范工具名称命名。使用当前界面提供的调用方式运行：

界面	查找工具	运行工具
MCP 客户端（Claude、Cursor、Codex、ChatGPT）	search("<what you want to do>")，然后 describe("<name>")	call("<name>", {...})
Hyper CLI	hyperai search "<what you want to do>"，然后 hyperai describe <name>	hyperai call <name> --json '{...}'

如果未找到工具，则表示其集成未连接或未在工作区中启用：请停止并告知用户需要连接哪个集成。

工具一览

工具	用途
linkedin_text_posts_create	发布常规成员或组织文本帖子；也可通过文章字段发布文章 / 链接帖子。
linkedin_organization_posts_create	明确以公司主页身份发帖（已知 organization_id 时）。
linkedin_document_posts_create	发布 PDF / 文档帖子 — LinkedIn 会将页面呈现为可滑动浏览的文档。
linkedin_carousels_create_from_text	AI 文本转轮播流程 — 生成幻灯片、合成为 PDF，并以文档帖子的形式发布。

发帖规则

1. 发布常规成员或组织帖子时，使用 linkedin_text_posts_create。
2. 用户明确要求以公司主页身份发帖，且你已知 organization_id 时，使用 linkedin_organization_posts_create。
3. 上传 PDF / 文档时，使用 linkedin_document_posts_create。LinkedIn 会将 PDF 页面呈现为可滑动浏览的文档帖子。
4. 用户希望通过 AI 生成的幻灯片完成文本转轮播工作流时，使用 linkedin_carousels_create_from_text。

文章 / 链接帖子

不要依赖 LinkedIn 为通过 API 创建的帖子抓取 Open Graph 元数据。

要可靠地发布文章帖子：

• 提供 article_url。
• 优先提供明确的 article_title、article_description 和 thumbnail_url。
• 如果省略这些字段，后端可能会从分享页面的元数据中推导相应信息，但明确填写仍然更可靠。

编辑或准备 LinkedIn 文章帖子时，使用以下结构：

linkedin_text_posts_create(
    text="Caption text",
    article_url="https://example.com/article",
    article_title="Explicit preview title",
    article_description="Explicit preview description",
    thumbnail_url="https://example.com/thumbnail.jpg",
    organization_id="123456789",  # optional
)

文档和轮播帖子

LinkedIn 轮播帖子通过 PDF 文档帖子实现。

原生 PDF 流程

已有 PDF URL 或存储文件 ID 时，使用 linkedin_document_posts_create：

linkedin_document_posts_create(
    text="Caption text",
    title="Deck title",
    document_url="https://example.com/deck.pdf",
    organization_id="123456789",  # optional
)

文本转轮播流程

用户希望系统根据一段源文本生成轮播内容时，使用 linkedin_carousels_create_from_text：

linkedin_carousels_create_from_text(
    text_content="Source content for the slides",
    title="Carousel title",
    caption="LinkedIn caption",
    num_slides=4,
    style="professional",
    color_scheme="blue",
    organization_id="123456789",  # optional
)

当前实现：

• 将源文本解析为幻灯片内容。
• 使用图像模型生成一张网格图。
• 将网格图拆分为单张幻灯片图片。
• 合成为 PDF。
• 将 PDF 发布为 LinkedIn 文档帖子。
• 返回帖子公开 URL — 将其展示给用户，以确认轮播帖子已发布。

支持的幻灯片数量为 4、6 和 9。

手动编辑幻灯片

当前的 LinkedIn 轮播内容工作流基于 PDF。在发布前，它不支持完整的实时画布编辑流程。

如果用户想要手动调整：

1. 先生成轮播内容素材。
2. 在外部查看或编辑生成的幻灯片图片／PDF。
3. 使用 linkedin_document_posts_create 发布最终 PDF。

除非当前环境确实提供相应工具，否则不要承诺产品内可编辑画布工作流。

以组织身份发布

向公司主页发布时：

• 如果不知道 organization_id，请先调用 linkedin_managed_pages_list()——它会返回已连接账号可以发布内容的所有公司主页及其 ID。
• 发布前，使用 linkedin_organizations_posts_list_detailed(organization_id=...) 预览近期帖子，以避免意外重复。
• 将 organization_id 传递给你使用的发布工具。
• 请注意，LinkedIn 的组织发布权限可能会影响发布。
• 如果帖子因权限错误而发布失败，请确认经过身份验证的账号是否有权向该组织发布内容。

故障模式与恢复方法

• 文章预览为空／错误。 LinkedIn 未采用抓取到的元数据。请再次调用 linkedin_text_posts_create，并明确提供 article_title、article_description 和 thumbnail_url。
• 向组织发布时出现权限错误。 请与用户确认其 LinkedIn 账号是否有权向目标 organization_id 的主页发布内容。
• linkedin_carousels_create_from_text 返回的幻灯片数量不符合预期。 仅支持 num_slides 为 4、6 或 9。
• 文档帖子因 URL 无效而发布失败。 document_url 必须是可直接获取的 PDF（无需身份验证，且不能是 HTML 重定向页面）。