OpenBrand — Извлечение брендов из URL

OpenBrand — инструмент для автоматического извлечения атрибутов бренда (логотипы, цвета, фоны, название) из любого веб-сайта. Работает как API, npm-пакет, MCP-сервер или самостоятельное веб-приложение.

Демо: openbrand.sh

Установка и использование

Как API

1. Получите бесплатный API-ключ на openbrand.sh/dashboard.
2. Отправьте запрос с параметром url и заголовком авторизации.

cURL

curl "https://openbrand.sh/api/extract?url=https://stripe.com" \
  -H "Authorization: Bearer your_api_key"

TypeScript

const res = await fetch(
  "https://openbrand.sh/api/extract?url=https://stripe.com",
  { headers: { Authorization: "Bearer your_api_key" } }
);
const brand = await res.json();

Python

import requests

res = requests.get(
    "https://openbrand.sh/api/extract",
    params={"url": "https://stripe.com"},
    headers={"Authorization": "Bearer your_api_key"}
)
brand = res.json()

Как npm-пакет (без API-ключа)

Установите пакет openbrand и используйте на сервере как библиотеку.

npm add openbrand

import { extractBrandAssets } from "openbrand";

const result = await extractBrandAssets("https://stripe.com");
if (result.ok) {
  // result.data.brand_name → "Stripe"
  // result.data.logos → LogoAsset[]
  // result.data.colors → ColorAsset[]
  // result.data.backdrop_images → BackdropAsset[]
} else {
  // result.error.code → "ACCESS_BLOCKED" | "NOT_FOUND" | "SERVER_ERROR"
  // result.error.message → пояснение
}

Как MCP-сервер (для Claude Code, Cursor и др.)

Установка без ключа:

claude mcp add --transport stdio openbrand -- npx -y openbrand-mcp

После получения API-ключа (на openbrand.sh/dashboard):

claude mcp add --transport stdio \
  --env OPENBRAND_API_KEY=your_api_key \
  openbrand -- npx -y openbrand-mcp

Или добавьте в .claude/settings.json:

{
  "mcpServers": {
    "openbrand": {
      "command": "npx",
      "args": ["-y", "openbrand-mcp"],
      "env": {
        "OPENBRAND_API_KEY": "your_api_key"
      }
    }
  }
}

После этого Claude сможет вызывать инструмент extract_brand_assets по команде вроде «извлеки бренд из stripe.com».

Самостоятельное развёртывание веб-приложения

git clone https://github.com/ethanjyx/openbrand.git
cd openbrand
bun install
bun dev

Откройте http://localhost:3000. Переменные окружения не требуются.

Что извлекает OpenBrand

• Логотипы — favicon, apple-touch-icon, логотипы в шапке/навигации, инлайновые SVG (с определением размеров).
• Цвета бренда — из метатегов theme-color, manifest.json и доминантных цветов логотипов.
• Фоновые изображения — og:image, CSS-фоны, изображения hero/баннера.
• Название бренда — из og:site_name, application-name, alt-текста логотипа, заголовка страницы.

Технологии

Next.js, React, TypeScript, Cheerio, Sharp, Tailwind CSS.

Лицензия

MIT — исходный код.