---
name: logohub
description: 检索品牌矢量标志、读取 SVG 源码、获取 1024px PNG/JPEG/WebP 栅格图。当用户需要品牌 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`，不含 SVG 源码 |
| `get_logo` | 按 slug 或 id 取单个品牌 | 元数据 + `svgContent` + `urls` |
| `get_logos` | 按 slug 批量取，1–20 条 | 元数据 + `urls`，缺失项见 `missing` |

## HTTP API

| 路径 | 说明 |
|---|---|
| `GET https://logohub.afengblog.com/api/search?q=&category=&sort=&limit=&offset=` | 检索，`q` 必填，`limit` 上限 20，`sort` 取 `latest` / `name` |
| `GET https://logohub.afengblog.com/api/logos/:slug` | 单条元数据 + `svgContent` + `urls` |
| `GET https://logohub.afengblog.com/api/logos?q=&category=&sort=&limit=&offset=` | 列表与筛选，默认不含 SVG 源码，`limit` 上限 20 |
| `GET https://logohub.afengblog.com/api/stats` | 收录总量与分类计数 |
| `GET https://logohub.afengblog.com/api/health` | 健康检查，数据库未就绪返回 503 |

## 检索规则

- 多个关键词以空白分隔，按 AND 组合。
- 单个关键词的匹配权重由高到低：slug/id 全等 > 中文名/英文名全等 > 拼音全等 > slug/id/中英名前缀 > 拼音前缀 > 标签命中 > 中英名/拼音包含 > 描述包含。
- 支持拼音：`支付宝` 可用 `zhifubao`（全拼）或 `zfb`（首字母）命中；`微信` 可用 `weixin` 或 `wx`。
- 不做拼写纠错与模糊匹配，无结果时改用品牌英文名或更短前缀。

## 资源 URL

每条结果都带 `urls`：

| 字段 | 形态 | 说明 |
|---|---|---|
| `page` | `https://logohub.afengblog.com/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` 字段指向的详情页注明来源与合规声明。