技能介绍

要解决什么问题

LinkedIn 的 REST API 与 Marketing API 分散在多个文档里，OAuth 令牌刷新、版本头（如 LinkedIn-Version: 202506）和多连接账号切换也容易在脚本里踩坑。若你希望在 Agent 对话里读个人/组织资料、发文字/链接/图片/视频帖，或查 Ad Library、管广告账户与 Campaign，需要一套把认证与网关路径说清楚的技能说明，而不是零散 curl 示例。

技能如何工作

本技能以 Maton（api.maton.ai）为入口：请求被代理到 api.linkedin.com，并在服务端注入已绑定的 LinkedIn OAuth Token。你只需配置 MATON_API_KEY，并在 REST 调用里带上版本头；多账号时用 Maton-Connection 指定连接。

连接管理：在 Maton 侧列出/创建/删除 LinkedIn 连接，创建连接返回的 URL 需在浏览器完成 OAuth。

内容与资料

个人：/rest/me 等 Profile 接口；发帖需 person URN（urn:li:person:{personId}）与 lifecycleState: "PUBLISHED"
发帖：commentary 使用 Little Text Format，保留字符（|{}@[]()<>#*_~ 等）须反斜杠转义，否则正文会被截断
图片：初始化上传 → PUT 二进制到 LinkedIn 预签名 URL → 创建帖子（三步）
视频：初始化 → 直传 www.linkedin.com/dms-uploads/... → finalize → 发帖；预签名 URL 含 %253D 等编码，文档要求用 Python urllib 整条链路处理，勿经 shell/curl 变量展开

公开与营销数据

Ad Library：按关键词、广告主、国家、日期等检索公开广告
Marketing API：广告账户、Campaign Group/Campaign 的 CRUD；Campaign 状态与 Objective 类型有固定枚举
组织：ACL、vanity name 查询、分享统计与组织帖子

写入与安全约定：技能明确要求所有 create/update/delete 先向用户说明操作与请求体，等待确认后再发；删除类与改预算/定向等广告操作需额外确认，避免误触财务与不可逆删除。

适用边界与注意点

权限取决于 OAuth scope（如 w_member_social、rw_ads）；403 时需核对 Maton 连接已授权范围
路径必须以 linkedin 为前缀（例如 https://api.maton.ai/linkedin/rest/me），否则网关路由错误
限流：Member 约 150 次/天、Application 约 100,000 次/天（UTC）
媒体上传 URL 不走 Maton 网关、无需 Authorization；Profile 头像 URL 可能过期需重拉
广告定向涉及合规：需符合 LinkedIn 广告政策与反歧视相关法规

截图预览

使用场景

已在 Maton 完成 LinkedIn OAuth，需要在对话里核对文案与可见范围后再创建 `PUBLIC` 或 `CONNECTIONS` 文字帖。
按关键词、广告主名或国家代码查询 Ad Library，导出竞品公开广告素材与投放日期用于复盘。
在指定广告账户下列表 Campaign，创建或修改 DRAFT/ACTIVE 状态、预算与定向前先展示请求体并获业务确认。
为企业组织 Page 读取分享统计与帖子列表，对照某段时间内的曝光与内容类型表现。

适合人员

负责 LinkedIn 付费投放的投放专员，要在 Agent 中读写广告账户与 Campaign，且不能接受未确认的改预算操作。
维护企业 LinkedIn 主页的社媒运营，需稳定发链接帖/图片帖，并处理 Little Text Format 转义与 `@` 提及语法。
做 B2B 竞品与市场调研的分析人员，依赖 Ad Library、Job Library 公开检索而非登录广告后台。
通过 Maton（`api.maton.ai/linkedin/...`）集成 LinkedIn 的后端工程师，需管理多连接头 `Maton-Connection` 与视频上传链路。