Linkly CLI

Linkly CLIはターミナルからLinklyアカウントを管理するためのコマンドラインツールです。ショートリンクを作成し、クリック分析を取得し、カスタムドメインを管理し、ウェブフックを処理し、データをエクスポート — すべてシェルを離れることなく、APIコードを書くこともなく実行できます。

Linkly APIに基づいて構築されており、macOS、Linux、Windowsで動作します。

インストール

CLIにはNode.js 20以降が必要です。npmでグローバルにインストールしてください：

npm install -g @linkly-link-shortener/cli

これにより、linklyコマンドがシステムに追加されます。動作確認してください：

linkly --help

サインイン

CLIは2つのサインイン方法をサポートしています。一度だけ実行すれば大丈夫です — 認証情報はマシンに安全に保存され、実行するたびに再利用されます。

APIキーでサインインするには、以下を実行してください：

linkly auth login --api-key

APIキーを貼り付けるよう求められます。APIキーはLinklyアカウント設定で確認できます。

代わりにOAuthでサインインするには、以下を実行してください：

linkly auth login

ブラウザが開き、アクセスを承認できます — コピーするAPIキーはありません。

いつでもステータスを確認したりサインアウトしたりできます：

linkly auth status

linkly auth logout

リンクの作成と管理

ショートリンクを作成、検索、検査、更新、削除します：

linkly links create --url https://example.com --name "Spring promo"

linkly links list --search promo

linkly links get 12345

linkly links update 12345 --url https://example.com/new

linkly links delete 12345

クリック分析

クリック数を国、ブラウザ、プラットフォーム別にグループ化して表示するか、日付範囲の時系列として表示します：

linkly analytics by country

linkly analytics timeseries --start 2026-01-01 --end 2026-01-31

カスタムドメイン

カスタムドメインをリストするか、新しいドメインを追加します：

linkly domains list

linkly domains create links.example.com

QRコードとデータエクスポート

リンクのQRコードをダウンロードするか、リンクとクリックデータをCSVまたはJSONでエクスポートします：

linkly links qr 12345 --output qr.png

linkly links export --format csv --output links.csv

linkly analytics export --format csv --output clicks.csv

ウェブフック

URLをサブスクライブして、単一のリンクまたはワークスペース全体のリアルタイムクリックイベントを受け取ります：

linkly webhooks add https://example.com/hook --link 12345

複数のワークスペースで作業する

アカウントに複数のワークスペースがある場合は、デフォルトを設定します：

linkly workspaces list

linkly workspaces use 42

--workspaceオプションで単一コマンド用に特定のワークスペースをターゲットにすることもできます。

スクリプト用のJSON出力

任意のコマンドに--jsonを追加して、フォーマットされたテーブルの代わりに生のAPIレスポンスを取得 — jqなどのツールにパイプするのに便利です：

linkly links list --json

ヘルプを得る

すべてのコマンドに組み込みヘルプがあります。linkly --helpで概要を表示するか、任意のコマンドに--helpを追加してオプションと例を表示します：

linkly links create --help

AIエージェントでCLIを使用する

シェルコマンドを実行できるコーディングアシスタント（Claude CodeやCursorなど）は、Linkly CLIを直接操作できます。

• 任意のコマンドに--jsonを追加して、フォーマットされたテーブルの代わりに生のAPIレスポンスを取得します。
• linkly schemaを実行して、コマンドツリー全体（すべてのコマンド、引数、オプション）をJSONで出力 — アシスタントがCLIの機能を発見できます。
• 任意のコマンドに--helpを追加してオプションと例を表示します。

AIアシスタントがシェルコマンドを実行できない場合は、代わりにLinkly MCP Serverを使用してください — ClaudeやChatGPTなどのアシスタントをLinklyアカウントに直接接続します。