LinkedIn

核心用法

LinkedIn技能提供完整的LinkedIn API接入能力，采用托管OAuth模式简化认证流程。核心功能包括：

• 内容发布：支持文本、图文、链接、视频等多种UGC帖子类型
• 广告管理：完整的Marketing API接入，涵盖广告账户、广告组、广告系列创建与管理
• 档案查询：获取用户/组织档案信息、权限列表
• 公开数据：Ad Library广告库、Job Library职位库查询
• 媒体上传：图片、视频、文档的分片上传支持

使用流程：获取Maton API Key → 创建LinkedIn连接 → 完成OAuth授权 → 通过gateway代理调用API。所有请求需携带Authorization: Bearer $MATON_API_KEY及协议版本头X-Restli-Protocol-Version: 2.0.0。

显著优点

1. 零OAuth配置成本：Maton托管OAuth流程，无需开发者自行申请LinkedIn应用、处理token刷新
2. 协议自动处理：网关层自动注入认证token，开发者只需关注业务API调用
3. 多连接管理：支持同一用户管理多个LinkedIn账号，通过Maton-Connection头切换
4. 完整Marketing API：覆盖从账户创建到广告投放的全链路B2B营销能力
5. 公开数据免OAuth：Ad Library、Job Library等公开接口无需用户授权即可访问

潜在缺点与局限

1. 严格的速率限制：个人级别仅150请求/天，重度自动化场景受限
2. 多步骤媒体上传：图片/视频发布需经历注册→上传→创建帖子三步，开发复杂度较高
3. URN格式强约束：所有资源标识需严格遵循urn:li:person:{id}等格式，易出错
4. 版本头混乱：不同API需搭配不同版本头（v2需X-Restli-Protocol-Version，REST API需额外LinkedIn-Version）
5. Maton平台依赖：OAuth状态、API网关稳定性完全依赖第三方Maton服务

适合人群

• B2B营销团队：需程序化管理LinkedIn广告投放的企业用户
• 内容运营者：寻求自动化发布、跨平台内容同步的社交媒体经理
• SaaS开发者：构建LinkedIn集成功能的第三方应用开发者
• 招聘技术团队：需批量查询职位公开数据或集成申请流程的HR Tech产品

常规风险

• 数据权限风险：w_member_social等写入权限一旦授权，技能可代表用户发帖、修改广告，需警惕token泄露后的越权操作
• 平台依赖风险：Maton作为中间层网关，其服务中断将直接导致技能失效
• 合规风险：自动化发布内容需遵守LinkedIn平台政策，滥用可能触发账号封禁
• API版本漂移：LinkedIn频繁更新API版本，REST API强制要求版本头，存在未来兼容性风险

核心用法

该 Skill 是 LinkedIn API 的标准化接入文档，用户通过 Maton 网关（gateway.maton.ai）调用 LinkedIn 官方 API，实现四大核心功能：

1. 社交分享：创建纯文本、链接文章、图片、视频等多种类型的帖子（UGC Posts），支持公开或仅好友可见的可见性设置
2. 广告管理：完整的 Marketing API 支持，包括广告账户管理、广告系列组/广告系列创建与编辑、预算设置、目标受众定向
3. 数据洞察：Ad Library 公开数据查询（无需 OAuth）、组织帖子统计、广告投放数据分析
4. 用户与组织：获取个人资料信息、管理组织权限、查询公司页面数据

使用流程简洁：获取 Maton API Key → 建立 LinkedIn OAuth 连接 → 通过 REST API 调用。所有请求需携带 Authorization: Bearer $MATON_API_KEY 和 X-Restli-Protocol-Version: 2.0.0 头部。

显著优点

• 零代码执行风险：纯 Markdown 文档型 Skill，无任何可执行代码或第三方依赖
• 托管 OAuth 简化开发：Maton 平台自动处理复杂的 LinkedIn OAuth 流程，用户无需自建认证服务器
• 功能覆盖全面：涵盖社交分享、广告投放、数据分析三大场景，满足 B2B 营销完整需求
• 官方 API 透传：直接对接 api.linkedin.com，无中间层数据篡改风险
• 开源透明：MIT 许可证，文档完整，调用示例覆盖 Python、JavaScript、curl 等多种语言

潜在局限

• 速率限制严格：个人用户仅 150 请求/天，大规模运营需申请企业级权限
• 依赖 Maton 服务可用性：若 Maton 网关故障，服务将中断；API Key 需从 Maton 平台获取
• OAuth 范围有限：当前仅支持 openid、profile、email、w_member_social 基础权限，无法访问 LinkedIn 全部 API 能力
• 无实时推送：不支持 Webhook 或实时事件通知，需轮询获取更新
• 地域合规：LinkedIn API 在中国大陆等地区访问受限

适合人群

• 内容运营人员：需要自动化 LinkedIn 账号的内容发布与排期
• B2B 营销团队：管理 LinkedIn 广告投放、分析竞品广告策略（通过 Ad Library）
• 开发者/技术运营：快速集成 LinkedIn 功能到内部工具，无需投入 OAuth 开发成本
• 招聘团队：通过 Job Library API 分析职位市场数据

常规风险

• API Key 泄露风险：MATON_API_KEY 需妥善保管，泄露可能导致账号被滥用
• OAuth 授权过期：长期未使用的连接可能失效，需定期在 ctrl.maton.ai 检查
• 内容合规：自动化发帖需遵守 LinkedIn 社区准则，避免被封禁
• 成本不可控：广告投放 API 操作可能产生实际费用，需设置预算上限