核心用法
该技能通过 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 变量传递，必须使用 Pythonurllib全程处理 - 权限依赖：发布内容需
w_member_socialOAuth 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 传参 |