linkedctl

用于 LinkedIn API 的 OAuth2 CLI 和 MCP 服务。

功能

• 发布内容 — 文本、图片、视频、文档、文章、多图轮播和投票
• 评论和回应 — 创建、列出和删除帖子的评论和回应
• 组织支持 — 以组织身份发布、评论、回应并查看分析数据
• 分析数据 — 按帖子、成员和组织统计数据
• 媒体上传 — 将图片、视频和文档上传到 LinkedIn
• 帖子草稿 — 将帖子保存为草稿，然后再发布
• 使用自己的 LinkedIn 应用进行 OAuth 2.0 身份验证
• 直接传递令牌，适用于从其他应用获取的令牌
• 用于 AI 助手集成（Claude、Cursor 等）的 MCP 服务
• 用于编写 LinkedIn 操作脚本的 CLI

前置条件

• Node.js >= 24
• 具有相应权限的 LinkedIn Developer App

安装

npm install -g linkedctl

或者直接运行：

npx linkedctl --help

快速开始

1. 在 linkedin.com/developers 创建 LinkedIn 应用
2. 配置 OAuth 2.0 凭据
3. 进行身份验证：

   linkedctl auth login --client-id YOUR_CLIENT_ID --client-secret YOUR_CLIENT_SECRET
   

4. 开始使用：

   linkedctl post "Hello from LinkedCtl!"
   

请参阅 OAuth 设置指南，了解详细的分步说明。

MCP 集成

MCP 客户端配置

{
    "mcpServers": {
        "linkedctl": {
            "command": "npx",
            "args": ["linkedctl", "mcp"]
        }
    }
}

claude mcp add linkedctl -- npx linkedctl mcp

{
    "mcpServers": {
        "linkedctl": {
            "command": "npx",
            "args": ["linkedctl", "mcp"]
        }
    }
}

{
    "mcpServers": {
        "linkedctl": {
            "command": "npx",
            "args": ["linkedctl", "mcp"]
        }
    }
}

可用工具

所有工具都接受可选的 profile 参数，以选择配置配置文件。

身份验证

帖子

post_create 支持以下富内容类型：

评论

表情回应

组织

分析

媒体

配置

配置文件格式

LinkedCtl 将配置存储在 YAML 文件中。每个文件代表一个独立的配置档案：

api-version: "202601"
oauth:
    client-id: "YOUR_CLIENT_ID"
    client-secret: "YOUR_CLIENT_SECRET"
    access-token: "YOUR_ACCESS_TOKEN"
    refresh-token: "YOUR_REFRESH_TOKEN"
    token-expires-at: "2026-05-03T12:00:00.000Z"

可用键：

配置文件的权限设置为 0600（仅所有者可读写）。

文件位置和优先级

如果未指定配置档案，LinkedCtl 会按以下顺序查找配置文件：

1. 当前工作目录中的 .linkedctl.yaml
2. 主目录中的 ~/.linkedctl.yaml

使用找到的第一个文件。写入时（例如执行 auth login 后），如果 CWD 文件存在，LinkedCtl 会写入该文件；否则写入主目录文件。

配置档案

配置档案可用于管理多个 LinkedIn 账户或配置。每个配置档案都作为独立的 YAML 文件存储在 ~/.linkedctl/ 下：

使用任何命令时，都可以添加 --profile 标志：

linkedctl --profile work auth login --client-id ID --client-secret SECRET
linkedctl --profile work post "Hello from my work account!"

使用 profile 命令管理配置档案：

linkedctl profile create work --access-token YOUR_TOKEN --api-version 202601
linkedctl profile list
linkedctl profile show work
linkedctl profile delete work

身份验证方式

OAuth 2.0（推荐）

LinkedCtl 支持使用你自己的 LinkedIn Developer App 进行 OAuth 2.0 身份验证：

linkedctl auth login --client-id YOUR_CLIENT_ID --client-secret YOUR_CLIENT_SECRET

直接使用令牌

如果你已经从其他应用获取了访问令牌：

linkedctl auth token --access-token YOUR_TOKEN

环境变量

环境变量的优先级高于配置文件中的值。

配置档案前缀环境变量

使用命名配置档案时，LinkedCtl 也会读取带有配置档案前缀的环境变量。配置档案名称会转换为大写，并将连字符替换为下划线：

CLIENT_ID、CLIENT_SECRET 和 API_VERSION 也遵循相同规则。

优先级顺序

配置值按以下顺序解析（优先级从高到低）：

1. 环境变量（如果启用了配置配置文件，则带有配置配置文件前缀）
2. 配置文件（特定配置配置文件，或当前工作目录/主目录回退）

CLI 参考

全局选项

auth — 管理身份验证

auth login 选项：

auth token 选项：

post — 管理 LinkedIn 帖子

# Shorthand: pass text as an argument
linkedctl post "Hello from LinkedCtl!"

# Explicit subcommand
linkedctl post create --text "Hello from LinkedCtl!"

# Pipe content from stdin
echo "Hello from LinkedCtl!" | linkedctl post create

post create 选项：

post list 选项：

comment — 管理评论

comment create 选项：

reaction — 管理表情反应

reaction create 选项：

org — 管理组织

media — 上传媒体

所有媒体命令均接受 --as-org <id> 和 --format json|table。

stats — 查看分析数据

常用选项：

profile — 管理配置配置文件

profile create 选项：

whoami — 显示当前用户

linkedctl whoami
linkedctl whoami --format json

completion — Shell 补全

linkedctl completion bash
linkedctl completion zsh

安全性

• Dependabot 通过自动创建拉取请求，确保依赖项保持最新
• CodeQL 会在每次推送和拉取请求时运行分析，以自动检测漏洞
• 路径遍历验证会检查个人资料名称，防止目录逃逸攻击
• 所有 MCP 工具均采用统一的身份验证错误处理，提供一致的身份验证失败消息
• 破坏性操作（删除帖子、删除评论、删除个人资料）需要交互式确认，除非传入 --force

免责声明

这是一个独立项目，与 LinkedIn Corporation 无关，也未获得其认可或与其存在关联。LinkedIn 是 LinkedIn Corporation 的商标。

许可证

AGPL-3.0-only

将 LinkedCtl 用作 CLI 工具或 MCP 服务：无需履行许可义务，可自由使用。

在项目中将 @linkedctl/core 用作库：你的组合成果必须采用 AGPL-3.0 或兼容许可证授权。