Whooshly

Whooshly MCP

为你的 AI 助手提供营销链接工具包。Whooshly 提供托管的 Model Context Protocol 服务，让 Claude、ChatGPT 和任何 MCP 客户端都能直接在对话中创建短链接、动态 QR codes、UTM 模板、托管的 vCard 页面和可收集潜在客户信息的 landing pages，并读取真实的点击量与扫描量分析数据。

“缩短这个发布网址，为宣传单制作一个 QR 码，再为付费社交营销活动保存一个 UTM 模板”→ 三个工具，一条消息，链接真正归你所有。

• 🔗 whooshly.co 上的短链接，附带实时点击跟踪
• 🟧 动态 QR codes，以可扫描的 PNG 格式返回，直接显示在聊天中
• 🏷️ 可在不同营销活动中重复使用的 UTM 模板
• 📇 托管的 vCard 数字名片
• 📊 真实分析数据——每个链接的精确点击量／扫描量总计及每日数据序列
• 💸 **一次付费。**一次性付费即可解锁核心工具包，无需订阅。查看定价 →

该服务为托管服务——对于基于 URL 的客户端，无需运行任何程序。这个 npm 包是一个轻量级的 stdio 桥接程序，供尚不支持远程 MCP 的客户端（例如 Claude Desktop）使用，也可方便地通过 npx 调用。

---

1. 获取 Agent 令牌

每个工具都会操作你的 Whooshly 账户，因此你需要一个令牌：

1. 在 app.whooshly.co 登录
2. 打开 Agents → New token
3. 复制令牌（仅显示一次）

读取和写入操作都需要一次性解锁 Core；任何账户都可以使用 get_billing_status，以便 Agent 在执行操作前检查解锁状态。

---

2. 连接

Claude.ai / Claude（网页、桌面、移动端）——通过 URL，无需安装

添加一个指向远程服务的自定义连接器。Claude 会在浏览器中运行 OAuth 流程；批准后，工具便会显示。

https://app.whooshly.co/api/mcp

设置 → 连接器 → 添加自定义连接器 → 粘贴 URL。

ChatGPT——通过 URL

使用相同的 URL 添加连接器／自定义 MCP 服务：

https://app.whooshly.co/api/mcp

Claude Code——一条命令

claude mcp add whooshly --transport http https://app.whooshly.co/api/mcp

然后在 Claude Code 中使用 /mcp 进行身份验证，或传入令牌标头：

claude mcp add whooshly --transport http https://app.whooshly.co/api/mcp \
  --header "Authorization: Bearer $WHOOSHLY_TOKEN"

Claude Desktop（或任何 stdio 客户端）——通过此桥接程序

对于仅支持 stdio 的客户端，请使用此软件包。将其添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "whooshly": {
      "command": "npx",
      "args": ["-y", "whooshly-mcp"],
      "env": {
        "WHOOSHLY_TOKEN": "your-agent-token"
      }
    }
  }
}

就这么简单——重启客户端后即可使用 Whooshly 工具。

---

工具

工具	功能	访问权限
get_billing_status	检查账户是否已解锁 Core / Pro	任意
create_link	创建短链接 → ID、别名、短网址	Core
list_links	按创建时间从新到旧列出你的链接（游标分页）	Core
get_link_stats	获取某个链接的精确点击量／扫描量总计及每日数据序列	Core
create_qr	创建动态 QR 码，并以可扫描的 PNG 格式返回	Core
get_qr	重新获取已保存的 QR 码 PNG	Core
create_utm	保存可重复使用的 UTM 模板	Core
list_utm	列出已保存的 UTM 模板	Core
create_vcard	创建托管的 vCard 数字名片页面	Core
create_page	使用内容块在你的子域名上创建落地页	Core
update_page	编辑页面的内容块、主题或别名——不会删除页面	Core
list_pages	列出你的落地页及潜在客户数量	Core
get_page	获取单个页面的内容、潜在客户数量和 webhook 交付汇总	Core
search	按别名／目标网址搜索你的链接（深度研究）	Core
fetch	按 ID 获取单个链接的完整详情（深度研究）	Core

所有读取工具都标记为 readOnlyHint；写入工具只能创建或编辑——Agent 无法删除任何内容，无法读取潜在客户的个人详情（仅能查看数量），也无法查看或更改潜在客户 webhook。每个工具都只操作你自己的账户（openWorldHint: false）。

---

示例提示词

连接后，请尝试：

• “缩短 https://example.com/2026-summer-launch，并使用 slug summer26，然后显示二维码。”
• “创建一个名为 paid-social 的 UTM 模板，来源为 instagram，媒介为 cpc，营销活动为 summer-launch。”
• “我的 summer26 链接本周获得了多少次点击？”
• “为 Acme 的增长负责人 Jane Doe 制作一张 vCard，邮箱为 [email protected]。”

---

配置

环境变量	默认值	用途
WHOOSHLY_TOKEN	–	使用标准输入输出桥接时必填。你的 Agent 令牌。
WHOOSHLY_MCP_URL	https://app.whooshly.co/api/mcp	覆盖端点（可自托管／暂存环境）。

WHOOSHLY_API_TOKEN 可作为 WHOOSHLY_TOKEN 的别名使用。

---

桥接的工作原理

whooshly-mcp 从标准输入读取以换行符分隔的 JSON-RPC，将每条消息连同你的 bearer 令牌 POST 到托管服务，并将对应的回复写入标准输出。它没有任何 npm 依赖项（仅使用 Node 18+ 内置功能），因此体积小且易于审查——整个桥接只有一个文件：bin/whooshly-mcp.mjs。

繁重的工作——身份验证、速率限制、权限检查、二维码渲染、分析——都由 Whooshly 服务端完成。这个桥接只是一个传输适配层，仅此而已。

---

链接

• 网站： https://whooshly.co
• MCP 服务／连接指南： https://whooshly.co/mcp
• 应用／控制面板： https://app.whooshly.co
• MCP 端点： https://app.whooshly.co/api/mcp

许可证

MIT © Whooshly