---
name: logohub
description: ブランドのベクターロゴを検索し、SVG ソースと 1024px の PNG/JPEG/WebP 画像を取得します。zh-CN / zh-TW / ja / en の 4 言語版に対応。ブランドロゴ素材、ブランドカラー、ベクターファイルの URL が必要なときに使います。
---

# LogoHub ブランドベクターロゴ

LogoHub はテック企業、AI モデル、プログラミング言語、クラウドネイティブ基盤、大学の校章などの高精度なベクターロゴを収録しています。読み取り専用の公開サービスで、登録や API キーは不要です。

サイトのルート：`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 で 1 件取得 | メタデータ + `svgContent` + `urls` + `alternates` |
| `get_logos` | slug で 1–20 件をまとめて取得 | メタデータ + `urls` + `alternates`。見つからない slug は `missing` |

3 つのツールはすべて任意引数 `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=` | 1 件のメタデータ + `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`（英語）。
- HTTP API は `lang`（大文字小文字を区別せず、`zh-hk` / `zh-hant` も `zh-TW` に正規化）、MCP は `locale`（正規の表記のみ）を使います。どちらも既定は `zh-CN` です。
- 結果の最上位と各項目に `locale` が付き、内容の言語版を示します。`name`、`categoryName`、`description`、`tags` はその言語で返り、`nameZhCN` には常に簡体字の元の名前が入ります。
- `urls.page` はその言語の詳細ページ、`alternates` はすべての言語版の詳細ページの完全な URL です。出典を示すときは読者の言語に合わせて選んでください。
- 対応していない `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}` | オリジナルの SVG ファイル |
| `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 に収めます。サイズの指定はできません。レスポンスには 1 年間の `Cache-Control` が付きます。

## レート制限とエラー

- `/api/*`、`/mcp`、ラスター画像は送信元 IP ごとに毎秒 20 リクエストまでです。
- 上限を超えると `429` と `Retry-After` を返し、`X-RateLimit-Limit` と `X-RateLimit-Remaining` ヘッダーが付きます。
- 存在しない slug の詳細とラスター画像は `404` です。まとめて取得する場合は `missing` に入り、全体は `200` を返します。
- ラスター変換に失敗すると `502` を返します。再試行して問題ありません。

## 利用範囲

すべてのブランドロゴと商標の知的財産権は各権利者に帰属します。中華人民共和国著作権法第24条に基づき、個人の学習、学術交流、技術研究、デザインの参考に限って提供しており、許可のない商用利用は禁止します。出典には `page` フィールドの詳細ページを示してください。