LinkBit

本地服务

linkbit.live商业与营销02 周前更新

代码仓库访问官网

关于 LinkBit

LinkBit 是用于管理短链接的 MCP 服务，可从支持 MCP 的客户端创建链接、生成二维码并查看点击分析。它还支持批量创建、链接更新和停用或删除操作。

主要功能

01创建单条或批量短链接
02设置 slug、备注和 UTM 参数
03更新、停用或删除链接
04生成 PNG 或 SVG 二维码
05查看链接及账户分析

适用场景

01为营销活动创建带 UTM 的短链接
02批量缩短一组目标网址
03生成用于印刷的二维码
04按日期查看点击来源和设备

MCP 相关

该 MCP 服务向客户端提供短链接创建、列表、更新、停用和删除工具，以及二维码生成与分析查询工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "yutotanakastar-linkbit": {
      "command": "npx",
      "args": [
        "-y",
        "linkbit-mcp"
      ],
      "env": {
        "API_KEY": "<API_KEY>",
        "APP_URL": "<APP_URL>"
      }
    }
  }
}

启动命令npx -y linkbit-mcp

需要配置的环境变量

API_KEY密钥LinkBit API key (slk_...)

APP_URLAPI origin, default https://linkbit.live

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmlinkbit-mcp1.0.4stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填
note	string	否
slug	string	否
utm_term	string	否
utm_medium	string	否
utm_source	string	否
destination	string	是
utm_content	string	否
utm_campaign	string	否

详细介绍

linkbit-mcp

适用于 LinkBit 的 MCP 服务：通过 Claude、ChatGPT、Cursor 和 n8n 缩短链接、批量创建链接、生成 QR 码并查看点击分析。

公开文档：linkbit.live/docs · linkbit.live/mcp

设置

在 linkbit.live 登录，并在 API Keys 页面创建 API 密钥（slk_...）。
需要 Node.js 18+（fetch）。

APP_URL=https://linkbit.live
API_KEY=slk_your_key

REST API 支持使用 以下任一种方式进行身份验证：Authorization: Bearer slk_... 或 x-api-key: slk_...。此服务使用 Bearer。

安装

npx -y linkbit-mcp

Claude Code：

claude mcp add linkbit -e API_KEY=slk_your_key -e APP_URL=https://linkbit.live -- npx -y linkbit-mcp

Claude Desktop / Cursor（mcp.json）：

{
  "mcpServers": {
    "linkbit": {
      "command": "npx",
      "args": ["-y", "linkbit-mcp"],
      "env": {
        "APP_URL": "https://linkbit.live",
        "API_KEY": "slk_your_key"
      }
    }
  }
}

提示词示例

将 https://example.com/campaign 缩短为 slug spring，并设置 utm_source newsletter
列出我的链接，并显示自 2026-01-01 以来第一个 ID 的点击量
禁用链接 <id>，然后生成可用于打印的 PNG QR 码

工具

工具	参数	说明
`shorten_url`	`destination`（必填）、`slug`、`note`、`utm_source`、`utm_medium`、`utm_campaign`、`utm_term`、`utm_content`	不会覆盖 URL 上已有的 `utm_*`；保留 `#fragment`
`shorten_urls`	`urls[]`，包含相同字段	批量创建
`list_links`	—	按最新优先排列
`update_link`	`id`、可选的 destination/slug/note/UTM/`disabled`	PATCH
`disable_link`	`id`、可选的 `disabled`（默认为 true）	停止重定向。`destructiveHint: true`
`delete_link`	`id`	永久删除。`destructiveHint: true`
`get_qr`	`id`、`format` png\|svg、`color`、`logo`、`print`	在可能的情况下以图像块形式返回 PNG
`get_link_stats`	`id`、可选的 `from`、`to`（YYYY-MM-DD）	国家、设备、引荐来源、每日数据
`get_analytics`	—	账户概览

错误

工具调用失败（缺少密钥、401、URL 无效、达到每日限额、目标地址不安全）会通过 tools/call 返回，并设置 isError: true，以便模型向用户解释。协议错误（未知方法、JSON 格式错误）仍会作为 JSON-RPC 错误返回。

401 — API 密钥缺失或错误（slk_...）。请在 API Keys 页面创建密钥。
400 — URL 无效、slug 已被占用、达到每日创建限额、目标地址被屏蔽或不安全。
404 — 链接 ID 未知。
如果 Node 版本低于 18，进程将在启动时失败（需要 fetch）。

n8n、Make 和自定义 Agent 也可以使用相同的请求头调用 /api/v1。

本地开发（ShortLinks monorepo）

在 npm publish 之前，Cursor 可以运行此文件夹中的副本：

将 mcp/cursor.mcp.json.example 复制到 .cursor/mcp.json（被 git 忽略）或 ~/.cursor/mcp.json。
将 slk_… 密钥粘贴到 env.API_KEY。
发布前在此仓库中使用 "command": "node" 和 "args": ["mcp/src/index.js"]。