linkedctl

LinkedIn API 用の OAuth2 CLI と MCP サーバーです。

できること

• コンテンツの投稿 — テキスト、画像、動画、ドキュメント、記事、複数画像カルーセル、アンケート
• コメントとリアクション — 投稿へのコメントやリアクションを作成、一覧表示、削除
• 組織のサポート — 組織として投稿、コメント、リアクション、分析データの表示
• 分析 — 投稿、メンバー、組織ごとの統計情報
• メディアのアップロード — LinkedIn への画像、動画、ドキュメントのアップロード
• 下書き投稿 — 公開前に投稿を下書きとして保存
• 独自の LinkedIn アプリを使った OAuth 2.0 認証
• 他のアプリケーションで取得したトークンを 直接渡す
• AI アシスタント連携用の MCP サーバー（Claude、Cursor など）
• スクリプトから 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 ファイルに設定を保存します。各ファイルは 1 つのプロファイルを表します。

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 にファイルが存在すればそのファイルに書き込み、存在しない場合はホームディレクトリのファイルに書き込みます。

プロファイル

プロファイルを使うと、複数の LinkedIn アカウントや設定を管理できます。各プロファイルは ~/.linkedctl/ の下に別々の YAML ファイルとして保存されます。

任意のコマンドで --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. 設定ファイル（プロファイル固有のファイル、または CWD／ホームディレクトリのフォールバック）

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 — シェル補完

linkedctl completion bash
linkedctl completion zsh

セキュリティ

• Dependabot が自動プルリクエストにより依存関係を最新の状態に保ちます
• CodeQL による分析がすべてのプッシュとプルリクエストで実行され、脆弱性を自動的に検出します
• プロファイル名の パストラバーサル検証 により、ディレクトリ外へのアクセス攻撃を防ぎます
• すべての MCP ツールで 認証エラー処理を統一 し、一貫した認証失敗メッセージを提供します
• 破壊的な操作（投稿の削除、コメントの削除、プロファイルの削除）では、--force が指定されていない限り、対話形式での確認が必要です

免責事項

これは独立したプロジェクトであり、LinkedIn Corporation との提携、承認、関連はありません。LinkedIn は LinkedIn Corporation の商標です。

ライセンス

AGPL-3.0-only

CLI ツールまたは MCP サーバーとして LinkedCtl を使用する場合：ライセンス上の義務はなく、自由に使用できます。

プロジェクトでライブラリとして @linkedctl/core を使用する場合：結合作品には AGPL-3.0（または互換性のあるライセンス）を適用する必要があります。