LinkedIn

核心用法

LinkedIn技能提供完整的LinkedIn REST API代理服务，通过Maton网关实现OAuth托管认证。主要功能包括：

• 内容发布：创建文本/图片/视频/文章动态，支持个人和组织账号
• 广告管理：Campaign创建、预算控制、受众定位，涵盖31个定向维度
• 档案查询：获取个人资料、组织信息、分享统计数据
• 公共数据：Ad Library广告库检索、Job Library职位搜索

技术实现采用网关代理模式，所有请求通过gateway.maton.ai/linkedin/rest/转发，自动注入OAuth Token。开发者仅需管理Maton API密钥，无需处理Token刷新。

显著优点

1. 零OAuth运维：Maton托管完整的OAuth生命周期，包括授权、刷新、失效处理
2. 原生API完整覆盖：直接映射LinkedIn官方REST API，非爬虫方案，稳定性高
3. 多租户支持：可管理多个LinkedIn账号连接，通过Maton-Connection头指定
4. 版本管控：强制LinkedIn-Version: 202506头部，确保API兼容性
5. 媒体上传优化：提供完整的视频/图片分片上传工作流示例，规避URL编码陷阱

潜在局限

• 账户白名单限制：Marketing API需联系support@maton.ai开通广告账户权限
• 格式复杂性：commentary字段使用Little Text Format，15种特殊字符需转义
• 上传URL隔离：媒体上传需直连LinkedIn域名（非网关），增加集成复杂度
• 请求配额严格：个人级限流150次/日，企业级10万次/日

适合人群

• 社媒自动化运营团队（内容批量发布、舆情监测）
• B2B营销人员（LinkedIn广告投放、线索收集）
• HR/招聘平台（职位同步、候选人档案获取）
• 竞品分析工具开发者（Ad Library数据采集）

常规风险

| 风险类型 | 说明 |

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

| 数据泄露 | MATON_API_KEY泄露可导致账号被滥用，需严格环境变量管理 |

| 内容合规 | 自动化发布需遵守LinkedIn社区规范，避免封号 |

| 广告预算失控 | 程序错误可能导致广告持续投放，建议设置日预算上限 |

| 权限过度 | OAuth范围默认包含`w_member_social`，可按需最小化授权 |

核心功能

LinkedIn Skill 提供了一套完整的 LinkedIn API 集成方案，通过 Maton 网关代理实现托管式 OAuth 认证，主要涵盖四大能力：

社交内容管理：支持文本、图片、视频、文档等多格式帖子发布，包含完整的媒体上传流程（初始化→上传→发布）。特别提供了针对 LinkedIn 专有「Little Text Format」的转义处理指南，确保富文本内容正确渲染。

营销广告平台：深度对接 LinkedIn Marketing API，支持广告账户管理、广告系列创建与优化、精准定向设置（31 种定向维度包括技能、行业、职级等），以及广告效果追踪。

数据洞察访问：可读取用户个人资料、组织信息、社交互动数据，同时提供 LinkedIn Ad Library 公开广告数据库和 Job Library 职位库的查询能力，支持竞品分析和市场研究。

连接生命周期管理：通过独立的 ctrl.maton.ai 控制台管理 OAuth 连接，支持多账户切换、连接状态监控和权限撤销。

显著优势

• 零 OAuth 复杂度：Maton 网关自动处理令牌刷新和注入，开发者只需关注业务逻辑
• 官方 API 完整覆盖：基于 LinkedIn REST API 202506 版本，功能与官方文档同步
• 生产级示例：提供 Python/JS 完整工作流代码，视频上传等复杂流程有详细陷阱规避说明
• 多租户支持：通过 Maton-Connection 头部可在单一 API Key 下管理多个 LinkedIn 账户

局限与约束

| 限制类型 | 具体说明 |

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

| 速率限制 | 个人用户 150 请求/天，应用级 10 万/天 |

| 广告准入 | 营销 API 需额外申请白名单，联系 support@maton.ai |

| 媒体处理 | 视频上传需严格遵循 4 步流程，URL 编码问题必须用 Python urllib 规避 |

| 内容格式 | commentary 字段 15+ 种保留字符需转义，否则内容截断 |

| 账户隔离 | Person ID 按应用隔离，不可跨应用复用 |

适用人群

• 社交媒体运营：需要批量发布、定时内容、多账户管理的团队
• B2B 营销人员：利用 LinkedIn 精准职业定向进行线索获取和品牌推广
• 市场研究分析师：通过 Ad Library 进行竞品广告策略分析
• 招聘技术团队：集成 Job Library 构建职位聚合或内推系统
• 开发者/产品经理：构建 LinkedIn 原生集成的工作流自动化工具

风险提示

• 密钥安全：MATON_API_KEY 是访问用户 LinkedIn 数据的唯一凭证，泄露将导致账户被完全控制
• OAuth 权限：首次连接需明确授权 w_member_social 等敏感范围，建议定期审查已授权应用
• 内容合规：自动化发布需遵守 LinkedIn 社区准则，高频或违规内容可能触发平台封禁
• 数据边界：通过 API 获取的 profile 数据受 LinkedIn 开发者协议约束，不可用于未授权的数据贩卖或 AI 训练