Linkly CLI
Linkly CLI 是一个从终端管理您的 Linkly 账户的命令行工具。创建短链接、获取点击分析、管理自定义域名、处理 webhook 和导出数据 — 无需离开 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 账户。
相关文章
每月追踪500次点击，包含所有功能。