---
name: logohub
description: 檢索品牌向量標誌、讀取 SVG 原始碼、獲取 1024px PNG/JPEG/WebP 柵格圖，支援 zh-CN / zh-TW / ja / en 四種語言版本。當使用者需要品牌 Logo 素材、品牌主色或向量檔案地址時使用。
---

# LogoHub 品牌向量標誌

LogoHub 收錄主流科技企業、人工智慧大模型、程式語言、雲原生基礎設施、大學校徽等品牌的高精度向量標誌，公開只讀，無需註冊與金鑰。

站點根地址：`https://logohub.afengblog.com`

## 何時用 MCP，何時用 HTTP API

- 需要被工具呼叫編排（客戶端內多輪檢索、按 slug 取原始碼）：接入 MCP，端點 `https://logohub.afengblog.com/mcp`。
- 只需一次取用、寫指令碼或做靜態構建：直接呼叫 HTTP API，少一層協議開銷。
- 兩者資料一致：同一套檢索加權、同一套 URL 契約、同一套語言版本、共用同一份限流配額。

## MCP 工具

| 工具 | 用途 | 返回 |
|---|---|---|
| `search_logos` | 按關鍵詞、拼音或分類檢索，支援 `limit` 與 `offset` 翻頁 | 後設資料 + `urls` + `alternates`，不含 SVG 原始碼 |
| `get_logo` | 按 slug 或 id 取單個品牌 | 後設資料 + `svgContent` + `urls` + `alternates` |
| `get_logos` | 按 slug 批次取，1–20 條 | 後設資料 + `urls` + `alternates`，缺失項見 `missing` |

三個工具都接受可選參數 `locale`。

## HTTP API

| 路徑 | 說明 |
|---|---|
| `GET https://logohub.afengblog.com/api/search?q=&category=&sort=&order=&limit=&offset=&lang=` | 檢索，`q` 必填，`limit` 上限 20，`sort` 取 `latest` / `name`，`order` 取 `asc` / `desc` |
| `GET https://logohub.afengblog.com/api/logos/:slug?lang=` | 單條後設資料 + `svgContent` + `urls` + 同類推薦 |
| `GET https://logohub.afengblog.com/api/logos?q=&category=&sort=&order=&limit=&offset=&lang=` | 列表與篩選，預設不含 SVG 原始碼，`limit` 上限 20 |
| `GET https://logohub.afengblog.com/api/stats` | 收錄總量與分類計數 |
| `GET https://logohub.afengblog.com/api/health` | 健康檢查，資料庫未就緒返回 503 |

## 語言版本

- 取值：`zh-CN`（簡體中文，預設）、`zh-TW`（繁體中文）、`ja`（日本語）、`en`（English）。
- HTTP API 用 `lang` 參數，大小寫不敏感（相容 `zh-hk`、`zh-hant` 自動歸一到 `zh-TW`）；MCP 用 `locale` 參數，必須是上述規範寫法。預設都按 `zh-CN` 返回。
- 返回頂層與每條結果都帶 `locale`，標明內容所屬的語言版本；`name`、`categoryName`、`description`、`tags` 按該語言返回，`nameZhCN` 始終保留簡體原名。
- `urls.page` 是該語言的詳情頁地址；`alternates` 給出全部語言版本詳情頁的完整地址，引用來源時按讀者語言選擇。
- HTTP API 收到不支援的 `lang` 返回 `400`（`invalid_locale`，附 `supported` 列表）；MCP 收到不支援的 `locale` 由參數校驗拒絕。

## 檢索規則

- 多個關鍵詞以空白分隔，按 AND 組合。
- 單個關鍵詞的匹配權重由高到低：slug/id 全等 > 中文名/英文名全等 > 拼音全等 > slug/id/中英名前綴 > 拼音前綴 > 標籤命中 > 中英名/拼音包含 > 描述包含。
- 支援拼音：`支付寶` 可用 `zhifubao`（全拼）或 `zfb`（首字母）命中；`微信` 可用 `weixin` 或 `wx`。
- 支援繁體與各語言展示名：`支付寶`、`WeChat` 等均可直接命中。
- 不做拼寫糾錯與模糊匹配，無結果時改用品牌英文名或更短前綴。

## 資源 URL

每條結果都帶 `urls`：

| 欄位 | 形態 | 說明 |
|---|---|---|
| `page` | `https://logohub.afengblog.com/logo/{slug}` | 品牌詳情頁；指定語言時帶語言前綴，如 `/ja/logo/{slug}` |
| `svg` | `https://logohub.afengblog.com/logos/{svgFile}` | 原始向量檔案，靜態直出 |
| `png` | `https://logohub.afengblog.com/logos/{slug}.png` | 1024×1024 透明 PNG |
| `jpg` | `https://logohub.afengblog.com/logos/{slug}.jpg` | 1024×1024 白底 JPEG |
| `webp` | `https://logohub.afengblog.com/logos/{slug}.webp` | 1024×1024 透明 WebP |

柵格圖按 slug 即時生成，固定等比裝入 1024×1024，無尺寸參數。回應帶一年期 `Cache-Control`，可長期快取或交給 CDN 回源。

## 限流與錯誤

- `/api/*`、`/mcp` 與柵格圖按來源 IP 限制 20 請求/秒。
- 超限返回 `429` 與 `Retry-After`；回應頭含 `X-RateLimit-Limit`、`X-RateLimit-Remaining`。
- 未知 slug 的詳情與柵格圖返回 `404`；批次取用時缺失項列在 `missing` 中，整體仍返回 `200`。
- 柵格圖轉換失敗返回 `502`，重試即可。

## 使用範圍

所有品牌標誌與商標的智慧財產權歸原權利人所有。內容僅依據《中華人民共和國著作權法》第二十四條用於個人學習、學術交流、技術研發與設計鑑賞，禁止未經授權的商業使用。以 `page` 欄位指向的詳情頁註明來源與合規宣告。