核心用法
LinkedIn skill 通过 Maton 代理网关（api.maton.ai/linkedin/rest/）封装 LinkedIn 官方 REST API，实现托管式 OAuth 认证。用户只需持有 Maton API Key，无需自行处理 OAuth 令牌刷新与存储。主要功能覆盖四大场景：
1. 个人资料与组织管理：获取当前用户 profile、查询组织 ACL、按 vanity name 查找组织、获取分享统计等；
2. 内容发布：支持纯文本、图文、文章链接、视频（多段上传）多种形态，视频需 4 步流程（initialize→upload→finalize→post）；
3. 广告营销：完整 Campaign 生命周期管理（Account → Campaign Group → Campaign → Creative），支持预算、排期、定向（31 种 facets）与状态控制；
4. 公开数据查询：Ad Library 与 Job Library 提供广告投放与职位发布的公开检索。
所有请求须携带 Authorization: Bearer $MATON_API_KEY 与 LinkedIn-Version: 202506 头部。多账户场景可通过 Maton-Connection 头部指定连接。
显著优点
- 零 OAuth 维护成本：Maton 集中托管令牌生命周期，用户无需关心 refresh token 与过期处理。
- 原生 REST 语义：与 LinkedIn 官方 API 字段、端点、分页机制保持一致，文档可复用。
- 多租户支持：同一 API Key 可绑定多个 LinkedIn 账号，通过 connection_id 切换。
- 细粒度权限：OAuth scope 仅请求
openid profile email w_member_social，最小权限原则。 - 丰富媒体支持：视频、文档、图片上传流程完整，且文档给出 Python urllib 完整示例，规避 shell 变量编码问题。
潜在缺点与局限性
- 速率限制严格：Member 级别仅 150 请求/天，营销场景易触发 429；Application 级别 10 万/天对高频自动化仍可能吃紧。
- 内容格式门槛高：
commentary字段使用 Little Text Format，大量保留字符需转义（如#*@等），漏转义会导致内容截断，增加开发调试成本。 - 媒体上传链路复杂：图片/视频/文档需先 initialize 获取预签名 URL，再直连 LinkedIn 域名上传（非网关），最后 finalize/create post，链路长、失败点分散。
- 视频上传编码陷阱：预签名 URL 含多层 URL encode（如
%253D），文档明确禁止通过 shell/curl 传递，必须使用 Python urllib 直接解析 JSON，技术门槛对非 Python 用户不友好。 - 依赖 Maton 平台可用性：OAuth 托管与请求代理均依赖 Maton 服务，若其故障或商业策略调整，将直接影响本 skill。
适合人群
- B2B 营销团队：需程序化批量管理 LinkedIn 广告账户与内容发布。
- 社交媒资管理工具开发者：构建多平台发布器，降低 OAuth 接入成本。
- 招聘 Tech 团队：通过 Job Library API 监控竞品职位投放策略。
- 个人创作者/工作室：多账号矩阵运营，需统一 API Key 管理多个 LinkedIn 身份。
常规风险
- 密钥泄露风险：
MATON_API_KEY若泄露，攻击者可操作用户 LinkedIn 账号发帖、修改广告，需严格环境变量或秘密管理器隔离。 - 内容合规风险：自动化发帖若未做敏感词过滤，可能触发平台审核或封号；广告素材需符合 LinkedIn 广告政策。
- 误操作风险：广告 API 支持预算与排期修改，脚本 bug 可能导致高额消耗或广告误启停，建议沙箱测试。
- 数据隐私：通过 profile/organization 端点可获取成员与雇主信息，需确保符合 GDPR/CCPA 等法规。
- Rate limit 服务降级：高频调用触发 429 后，需实现指数退避重试，否则任务堆积。