Shareglow

shareglow-mcp

适用于 Shareglow 的 MCP 服务：扫描链接预览、生成 Open Graph 图片、创建带有独立预览的短链接，并通过任意 MCP 客户端读取点击统计数据。

这是 Shareglow REST API（/v1）的轻量客户端。你的 API 密钥会直接传递，因此计划限制和速率限制保持不变。此服务不保存自身凭据。

托管端点

https://mcp.getshareglow.com/mcp
Authorization: Bearer sk_live_...

传输方式：Streamable HTTP。请在 https://app.getshareglow.com/developer 创建 API 密钥。

工具

工具	描述
scan_url	扫描公开网页并报告其链接预览（Open Graph / Twitter Card）元数据、各平台的预览效果，以及附有修复建议的问题。
generate_og_image	根据模板 ID（参见 list_templates）和标题、副标题等文本参数，渲染 1200x630 的 Open Graph 图片。返回永久图片 URL，以及图片是否已缓存。可选的 exp（Unix 秒数，付费计划）可让签名 URL 过期。
create_template_from_url	使用 AI 根据指定 URL 中网站的品牌元素（徽标、颜色、字体）设计新的 OG 图片模板。返回布局 ID、需要传入的变量，以及提取出的品牌套件。会计入计划的 AI 配额。
list_templates	列出工作区可用于渲染的 OG 图片模板（内置和自定义），并提供 ID、名称、版本和尺寸。
create_short_link	创建带有独立链接预览的短链接。可选自定义别名和 A/B 变体（标题、描述、imageUrl 或 templateId）。返回 ID、shortUrl 和变体。
get_link_stats	按 ID 获取短链接的点击分析数据：总数，以及按日期、国家/地区、设备、浏览器和引荐来源划分的细分数据。可选指定 from/to 日期（YYYY-MM-DD）。
refresh_preview	在修改页面的 OG 标签或图片后，强制社交平台重新获取链接预览：更新 og:image 缓存破坏参数、重新抓取 Facebook，并返回 LinkedIn Post Inspector 链接和 X 缓存说明。

客户端设置

Claude Code

claude mcp add --transport http shareglow https://mcp.getshareglow.com/mcp \
  --header "Authorization: Bearer sk_live_..."

Claude Desktop

Claude Desktop 通过 mcp-remote 连接远程服务。将以下内容添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "shareglow": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.getshareglow.com/mcp", "--header", "Authorization:${AUTH}"],
      "env": { "AUTH": "Bearer sk_live_..." }
    }
  }
}

也可以不使用远程服务，改用下方的 stdio 服务。

Cursor

~/.cursor/mcp.json：

{
  "mcpServers": {
    "shareglow": {
      "url": "https://mcp.getshareglow.com/mcp",
      "headers": { "Authorization": "Bearer sk_live_..." }
    }
  }
}

本地 stdio（任意客户端）

{
  "mcpServers": {
    "shareglow": {
      "command": "npx",
      "args": ["-y", "shareglow-mcp"],
      "env": { "SHAREGLOW_API_KEY": "sk_live_..." }
    }
  }
}

也可以通过 --api-key sk_live_... 传入密钥。SHAREGLOW_API_URL 用于指定服务连接的其他 REST 基础 URL（默认值为 https://app.getshareglow.com）。

错误和限制

• 每个工具都需要其 REST 调用所需的密钥权限范围。密钥缺少相应权限时会返回 403 insufficient_scope。
• REST 401、402、403 和 429 会转换为 MCP 工具错误（isError: true），并包含 API 返回的消息。
• 转发前会验证 URL（仅限 http/https，且不允许使用私有或本地主机）。
• 工具结果截断为最多 20,000 个字符。API 密钥会从所有结果和错误中脱敏。

本地开发

npm install
npm run typecheck
npm test
npm run build
npm run dev          # Streamable HTTP on PORT (default 8791)
npm run dev:worker   # Cloudflare Worker via wrangler dev

需要 Node 22 或更高版本。

许可证

MIT，详见 LICENSE。