Linkly CLI

Linkly CLI 是一个从终端管理 Linkly 账户的命令行工具。创建短链接、获取点击分析、管理自定义域名、处理 webhooks 和导出数据 — 无需离开 shell 或编写任何 API 代码。

它基于 Linkly API 构建，运行在 macOS、Linux 和 Windows 上。

安装

CLI 需要 Node.js 20 或更新版本。使用 npm 全局安装：

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

这会将 linkly 命令添加到您的系统。确认它工作正常：

linkly --help

登录

CLI 支持两种登录方式。您只需执行一次 — 您的凭证会安全地保存在您的计算机上，并在每次运行时重复使用。

要使用 API 密钥 登录，运行：

linkly auth login --api-key

系统会提示您粘贴 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

二维码和数据导出

下载链接的二维码，或将链接和点击数据导出为 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

Webhooks

订阅 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

将 CLI 与 AI 代理一起使用

可以运行 shell 命令的编码助手 — 如 Claude Code 或 Cursor — 可以直接驱动 Linkly CLI。

• 向任何命令添加 --json 以获取原始 API 响应而不是格式化表格。
• 运行 linkly schema 以 JSON 形式打印完整的命令树 — 每个命令、参数和选项 — 以便助手可以发现 CLI 能做什么。
• 向任何命令添加 --help 查看其选项和示例。

如果您的 AI 助手无法运行 shell 命令，请改用 Linkly MCP Server — 它将 Claude 和 ChatGPT 等助手直接连接到您的 Linkly 账户。