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	URL から取得したウェブサイトのブランド要素（ロゴ、色、フォント）をもとに、AI を使って新しい 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 は、API のメッセージを含む MCP ツールエラー（isError: true）になります。
• 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 を参照してください。