LinkedIn

核心用法

该技能通过 Maton 网关（gateway.maton.ai）代理 LinkedIn REST API，提供托管式 OAuth 认证。用户只需配置 MATON_API_KEY 环境变量，即可调用 LinkedIn 个人资料读取、帖子发布（文本/图片/视频/文章）、广告账户管理、Ad Library 公开数据查询等功能。

关键工作流程：
1. 认证管理：在 ctrl.maton.ai 创建/管理 OAuth 连接，支持多连接切换（Maton-Connection 头）
2. 内容发布：创建帖子需使用 urn:li:person:{id} 格式作者 URN；图片/视频上传采用 3-4 步流程（初始化 → 直传二进制 → [视频需 finalize] → 创建帖子）
3. 广告投放：支持广告账户、推广活动组（Campaign Group）、推广活动（Campaign）的 CRUD 操作，涵盖 7 种营销目标（品牌认知、网站访问、潜在客户开发等）
4. 公开数据：Ad Library 和 Job Library 无需 OAuth，可直接搜索广告内容和职位信息

显著优点

• 托管 OAuth：无需自行处理 LinkedIn 开发者应用注册和 Token 刷新
• 功能全面：覆盖 Profile、Social API、Marketing API、Ad Library 四大领域
• 版本对齐：默认使用 LinkedIn-Version: 202506，与官方最新接口同步
• 多语言示例：提供 Python、JavaScript、Bash 完整代码片段

潜在缺点与局限性

• 严格限速：Member 级别仅 150 请求/天，不适合高频场景
• 格式陷阱：帖子 commentary 字段使用 Little Text Format，15 个保留字符（\|{}@[]()<>#*_~）必须转义，否则内容被截断
• 上传复杂性：视频上传 URL 含多层 URL 编码（%253D），严禁通过 shell 变量传递，必须使用 Python urllib 全程处理
• 权限依赖：发布内容需 w_member_social OAuth scope，需用户主动授权
• 网关锁定：媒体上传的预签名 URL 直传 LinkedIn（不经过网关），与 API 调用路径分离，增加调试复杂度

适合人群

• 社媒运营团队：定时发布、批量内容同步
• B2B 营销人员：LinkedIn 广告投放与效果追踪
• 开发者：构建 LinkedIn 集成自动化工具
• 研究者：通过 Ad Library 分析竞品广告策略

常规风险

| 风险类型 | 说明 | 缓解建议 |

|---------|------|---------|

| **OAuth 授权风险** | 用户需授权第三方 Maton 平台访问 LinkedIn 数据 | 审查 Maton 隐私政策，定期在 LinkedIn 账号设置中检查授权应用 |

| **API 密钥泄露** | `MATON_API_KEY` 泄露可导致账户被滥用 | 使用环境变量/密钥管理服务，避免硬编码 |

| **内容发布错误** | 转义字符遗漏导致帖子内容截断或格式错乱 | 使用提供的 `escape_linkedin_commentary()` 辅助函数 |

| **速率超限** | 150 次/天的 Member 限制易被触发 | 实施请求计数与退避策略，优先使用批量接口 |

| **视频上传失败** | URL 编码处理不当导致签名失效 | 严格遵循文档要求：Python `urllib` 全程处理，禁止 shell 传参 |