linkedctl (Alexey Pelykh)

OAuth2 CLI和MCP服务器 领英 API

它的作用

• 发布内容 --文本、图像、视频、文档、文章、多图像旋转木马和民意调查
• 评论和反应 --创建、列出和删除帖子上的评论和反应
• 组织支持 --作为一个组织发布、评论、反应和查看分析
• 分析 --每个职位、每个成员和每个组织的统计数据
• 媒体上传 --将图像、视频和文档上传到LinkedIn
• 职位草案 --发布前将帖子另存为草稿
• OAuth 2.0身份验证 使用自己的LinkedIn应用程序
• 直接令牌传递 用于从其他应用程序获得的令牌
• MCP服务器 用于AI助手集成（Claude、Cursor等）
• 命令行界面 用于可脚本化的LinkedIn操作

先决条件

• >= 24
• A. LinkedIn开发者应用 具有适当的权限

安装

npm install -g linkedctl

或者直接运行：

npx linkedctl --help

快速开始

1. 在以下位置创建LinkedIn应用程序 linkedin.com/developers
2. 配置OAuth 2.0凭据
3. 身份验证：

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

1. 开始使用：

   linkedctl post "Hello from LinkedCtl!"

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

MCP集成

MCP客户端配置

Claude Desktop

添加到您的Claude Desktop配置(claude_desktop_config.json):

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

Claude Code

claude mcp add linkedctl -- npx linkedctl mcp

Cursor

添加 .cursor/mcp.json 在项目根目录中：

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

Windsurf

添加 ~/.codeium/windsurf/mcp_config.json:

{
    "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)，LinkedCtl会写入CWD文件（如果存在），否则会写入主目录文件。

档案

个人资料允许您管理多个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开发者应用程序支持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. 配置文件 （配置文件特定文件，或CWD/home回退）

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 和 --format json|table.

stats --查看分析

常见选项：

profile --管理配置文件

profile create 选项：

whoami --显示当前用户

linkedctl whoami
linkedctl whoami --format json

completion --壳牌完井

linkedctl completion bash
linkedctl completion zsh

安全

• 依赖机器人 通过自动拉取请求使依赖关系保持最新
• CodeQL 对每个推送和拉取请求进行分析，以实现自动漏洞检测
• 路径遍历验证 配置文件名可防止目录转义攻击
• 统一身份验证错误处理 所有MCP工具都提供一致的身份验证失败消息
• 破坏性行动 （删除帖子、删除评论、删除个人资料）需要交互式确认，除非 --force 已通过

免责声明

这是一个独立的项目，不隶属于领英公司，也不得到领英公司的认可或与领英公司有关联。LinkedIn是LinkedIn公司的商标。

许可证

仅限AGPL-3.0

将LinkedCtl用作CLI工具或MCP服务器：无许可义务-自由使用。

使用 @linkedctl/core 作为项目中的库：您的组合作品必须根据AGPL-3.0（或兼容许可证）获得许可。