Linkly MCP Server

🚀 Linkly MCP 服務器

Linkly MCP 服務器是一個基於 MCP（模型上下文協議）的服務器，它能讓 Claude 和 ChatGPT 等 AI 助手創建和管理短鏈接、跟蹤點擊情況，並實現 URL 管理自動化。

✨ 主要特性

鏈接管理

• create_link - 可完全自定義創建新的短鏈接（支持 UTM 參數、像素代碼、開放圖等）
• update_link - 更新現有鏈接
• delete_link - 刪除鏈接
• get_link - 獲取特定鏈接的詳細信息
• list_links - 列出工作區中所有鏈接及其點擊統計信息
• search_links - 按名稱、URL 或備註搜索鏈接

分析功能

• get_clicks - 獲取近期點擊數據
• get_analytics - 獲取用於繪製圖表的時間序列點擊數據（按天/小時）
• get_analytics_by - 按維度（國家、平臺、瀏覽器等）分組獲取點擊計數
• export_clicks - 導出詳細的點擊記錄

域名管理

• list_domains - 列出工作區中所有自定義域名
• create_domain - 添加自定義域名
• delete_domain - 刪除自定義域名

網絡鉤子管理

• list_webhooks - 列出工作區級別的網絡鉤子訂閱
• subscribe_webhook - 訂閱一個 URL 以接收所有鏈接的點擊事件
• unsubscribe_webhook - 取消訂閱一個網絡鉤子 URL
• list_link_webhooks - 列出特定鏈接的網絡鉤子
• subscribe_link_webhook - 訂閱一個 URL 以接收特定鏈接的點擊事件
• unsubscribe_link_webhook - 取消訂閱特定鏈接的點擊事件

📦 安裝指南

cd integrations/mcp-server
npm install

📚 詳細文檔

配置

設置以下環境變量：

export LINKLY_API_KEY="your-api-key"
export LINKLY_WORKSPACE_ID="your-workspace-id"

你可以在 Linkly 儀表盤的 設置 → API 中找到這些信息。

與 Claude Desktop 快速開始

將以下內容添加到你的 Claude Desktop 配置文件中（在 macOS 上為 ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "linkly": {
      "command": "npx",
      "args": ["-y", "linkly-mcp-server"],
      "env": {
        "LINKLY_API_KEY": "your-api-key",
        "LINKLY_WORKSPACE_ID": "your-workspace-id"
      }
    }
  }
}

有關詳細的設置說明和使用示例，請參閱 Claude Desktop 設置指南。

與 ChatGPT 快速開始

你可以通過創建帶有操作的自定義 GPT，在 ChatGPT 中使用 Linkly。這允許你直接在 ChatGPT 對話中管理短鏈接。

有關分步說明，請參閱 ChatGPT 設置指南。

在 Claude Code 中使用

將以下內容添加到你的 Claude Code MCP 設置中：

{
  "mcpServers": {
    "linkly": {
      "command": "npx",
      "args": ["-y", "linkly-mcp-server"],
      "env": {
        "LINKLY_API_KEY": "your-api-key",
        "LINKLY_WORKSPACE_ID": "your-workspace-id"
      }
    }
  }
}

💻 使用示例

可用工具

create_link

創建一個新的短鏈接。

必需參數：

• url - 目標 URL

可選參數：

• name - 鏈接的暱稱
• note - 私有備註
• domain - 自定義域名
• slug - 自定義後綴（必須以 / 開頭）
• enabled - 鏈接是否激活（默認：true）
• utm_source, utm_medium, utm_campaign, utm_term, utm_content - UTM 參數
• og_title, og_description, og_image - 開放圖元數據
• fb_pixel_id - Meta/Facebook 像素 ID
• ga4_tag_id - Google Analytics 4 標籤 ID
• gtm_id - Google 標籤管理器 ID
• cloaking - 在 iframe 中隱藏目標 URL
• forward_params - 將 URL 參數轉發到目標
• block_bots - 阻止機器人和爬蟲
• hide_referrer - 隱藏推薦信息
• expiry_datetime - 鏈接過期時間（ISO 8601 格式）
• expiry_destination - 過期後的備用 URL

update_link

更新現有鏈接。

必需參數：

• link_id - 要更新的鏈接 ID

create_link 中的所有其他參數均為可選參數。

delete_link

刪除鏈接。

必需參數：

• link_id - 要刪除的鏈接 ID

get_link

獲取特定鏈接的詳細信息。

必需參數：

• link_id - 要檢索的鏈接 ID

list_links

列出工作區中的所有鏈接，無需參數。

get_clicks

獲取近期點擊數據。

可選參數：

• link_id - 按鏈接 ID 過濾點擊數據

get_analytics

獲取用於繪製圖表的時間序列點擊分析數據。

可選參數：

• start - 開始日期（YYYY-MM-DD，默認：30 天前）
• end - 結束日期（YYYY-MM-DD，默認：今天）
• link_id - 按特定鏈接過濾
• frequency - 時間粒度：day（默認）或 hour
• country - 按國家代碼過濾（例如，'US'、'GB'）
• platform - 按平臺過濾（桌面、移動、平板）
• browser - 按瀏覽器名稱過濾
• unique - 僅計算唯一點擊（按 IP）
• bots - 機器人過濾：include（默認）、exclude 或 only

get_analytics_by

按維度分組獲取點擊計數，適用於細分和前 N 報告。

必需參數：

• counter - 分組維度：country、platform、browser_name、referer、isp、link_id、destination、bot_name

可選參數：

• start - 開始日期（YYYY-MM-DD）
• end - 結束日期（YYYY-MM-DD）
• link_id - 按特定鏈接過濾
• country - 按國家代碼過濾
• platform - 按平臺過濾
• unique - 僅計算唯一點擊
• bots - 機器人過濾

export_clicks

導出包含完整信息的詳細點擊記錄。

可選參數：

• start - 開始日期（YYYY-MM-DD，默認：30 天前）
• end - 結束日期（YYYY-MM-DD，默認：昨天）
• link_id - 按特定鏈接過濾
• country - 按國家代碼過濾
• platform - 按平臺過濾
• bots - 機器人過濾

返回值：包含時間戳、瀏覽器、國家、URL、鏈接 ID、平臺、推薦來源、機器人、ISP 和參數的點擊記錄數組。

search_links

按名稱、URL 或備註搜索鏈接。

必需參數：

• query - 用於匹配鏈接名稱、URL 和備註的搜索字符串

list_domains

列出工作區中的所有自定義域名，無需參數。

create_domain

向工作區添加自定義域名。

必需參數：

• name - 域名（例如，'links.example.com'）

delete_domain

從工作區中刪除自定義域名。

必需參數：

• domain_id - 要刪除的域名 ID

list_webhooks

列出訂閱到工作區的所有網絡鉤子 URL，無需參數。

subscribe_webhook

訂閱一個網絡鉤子 URL 以接收所有鏈接的點擊事件。

必需參數：

• url - 用於接收點擊事件通知的網絡鉤子 URL

unsubscribe_webhook

取消訂閱工作區點擊事件的網絡鉤子 URL。

必需參數：

• url - 要取消訂閱的網絡鉤子 URL

list_link_webhooks

列出訂閱到特定鏈接的所有網絡鉤子 URL。

必需參數：

• link_id - 鏈接 ID

subscribe_link_webhook

訂閱一個網絡鉤子 URL 以接收特定鏈接的點擊事件。

必需參數：

• link_id - 鏈接 ID
• url - 用於接收點擊事件通知的網絡鉤子 URL

unsubscribe_link_webhook

取消訂閱特定鏈接的點擊事件的網絡鉤子 URL。

必需參數：

• link_id - 鏈接 ID
• url - 要取消訂閱的網絡鉤子 URL

📄 許可證

本項目採用 MIT 許可證。