Skip to content
Back to search

openbrand

SkillWorks with Claude CodeGitHub

Extract brand assets (logos, colors, backdrop images, brand name) from any website URL. Use when building branded interfaces, generating style guides, or needing brand identity data from a URL.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/tight-studio--openbrand/badge.svg)](/listings/tight-studio--openbrand)

HTML

<a href="/listings/tight-studio--openbrand"><img src="/api/listings/tight-studio--openbrand/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 82 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: openbrand
  3. description: Extract brand assets (logos, colors, backdrop images, brand name) from any website URL. Use when building branded interfaces, generating style guides, or needing brand identity data from a URL.
  4. ---
  5. # OpenBrand
  6. Extract brand assets from any website URL — logos, colors, backdrop images, and brand name.
  7. ## Setup
  8. ### MCP Server (recommended for Claude Code / Cursor)
  9. ```bash
  10. claude mcp add --transport stdio \
  11. --env OPENBRAND_API_KEY=your_api_key \
  12. openbrand -- npx -y openbrand-mcp
  13. ```
  14. Get your free API key at [openbrand.sh/dashboard](https://openbrand.sh/dashboard).
  15. Once configured, use the `extract_brand_assets` tool with a URL to get structured brand data.
  16. ### npm package (no API key needed)
  17. ```bash
  18. npm add openbrand
  19. ```
  20. ```typescript
  21. import { extractBrandAssets } from "openbrand";
  22. const result = await extractBrandAssets("https://stripe.com");
  23. if (result.ok) {
  24. // result.data.brand_name → "Stripe"
  25. // result.data.logos → LogoAsset[]
  26. // result.data.colors → ColorAsset[]
  27. // result.data.backdrop_images → BackdropAsset[]
  28. }
  29. ```
  30. ### API
  31. ```bash
  32. curl "https://openbrand.sh/api/extract?url=https://stripe.com" \
  33. -H "Authorization: Bearer your_api_key"
  34. ```
  35. ## What it extracts
  36. | Asset | Sources |
  37. |-------|---------|
  38. | **Logos** | Favicons, apple-touch-icons, header/nav logos, inline SVGs (with dimension probing) |
  39. | **Brand colors** | theme-color meta tags, manifest.json, dominant colors from logo imagery |
  40. | **Backdrop images** | og:image, CSS backgrounds, hero/banner images |
  41. | **Brand name** | og:site_name, application-name, logo alt text, page title |
  42. ## Response format
  43. ```json
  44. {
  45. "brandName": "Stripe",
  46. "logos": [
  47. { "url": "https://...", "type": "favicon", "resolution": { "width": 32, "height": 32, "aspect_ratio": 1 } }
  48. ],
  49. "colors": [
  50. { "hex": "#635bff", "usage": "primary" },
  51. { "hex": "#0a2540", "usage": "secondary" }
  52. ],
  53. "backdrops": [
  54. { "url": "https://...", "description": "Hero image" }
  55. ]
  56. }
  57. ```
  58. ## When to use this skill
  59. - Building a landing page or UI that matches a client's brand
  60. - Generating brand style guides or design tokens
  61. - Creating branded email templates or marketing materials
  62. - Populating brand fields in a CMS or design tool
  63. - Any task where you need logos, colors, or imagery from a website
README.md · README · 145 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center">
  2. <img src="public/logo.svg" alt="OpenBrand logo" width="80" height="84" />
  3. </p>
  4. <h1 align="center">OpenBrand</h1>
  5. <p align="center">Extract any brand from a URL</p>
  6. <p align="center">Try it out at <a href="https://openbrand.sh">openbrand.sh</a></p>
  7. <p align="center">
  8. <img src="public/openbrand.gif" alt="OpenBrand demo" width="600" />
  9. </p>
  10. <p align="center"><sub>Demo prepared with <a href="https://tight.studio/">Tight Studio</a></sub></p>
  11. Extract brand assets (logos, colors, backdrops, brand name) from any website URL.
  12. ## As an API call
  13. Get your free API key from [openbrand.sh/dashboard](https://openbrand.sh/dashboard).
  14. **cURL**
  15. ```bash
  16. curl "https://openbrand.sh/api/extract?url=https://stripe.com" \
  17. -H "Authorization: Bearer your_api_key"
  18. ```
  19. **TypeScript**
  20. ```typescript
  21. const res = await fetch(
  22. "https://openbrand.sh/api/extract?url=https://stripe.com",
  23. { headers: { Authorization: "Bearer your_api_key" } }
  24. );
  25. const brand = await res.json();
  26. ```
  27. **Python**
  28. ```python
  29. import requests
  30. res = requests.get(
  31. "https://openbrand.sh/api/extract",
  32. params={"url": "https://stripe.com"},
  33. headers={"Authorization": "Bearer your_api_key"},
  34. )
  35. brand = res.json()
  36. ```
  37. ## As an [agent skill](https://skills.sh/tight-studio/openbrand/openbrand)
  38. Add OpenBrand to Claude Code, Cursor, Codex, Gemini CLI, and [40+ other agents](https://skills.sh):
  39. ```bash
  40. npx skills add tight-studio/openbrand
  41. ```
  42. Once installed, your agent automatically knows how to extract brand assets — just ask it to "extract brand assets from stripe.com".
  43. ## As an [npm package](https://www.npmjs.com/package/openbrand)
  44. No API key required. Runs as a library from your server-side code.
  45. ```bash
  46. npm add openbrand
  47. ```
  48. ```typescript
  49. import { extractBrandAssets } from "openbrand";
  50. const result = await extractBrandAssets("https://stripe.com");
  51. if (result.ok) {
  52. // result.data.brand_name → "Stripe"
  53. // result.data.logos → LogoAsset[]
  54. // result.data.colors → ColorAsset[]
  55. // result.data.backdrop_images → BackdropAsset[]
  56. } else {
  57. // result.error.code → "ACCESS_BLOCKED" | "NOT_FOUND" | "SERVER_ERROR" | ...
  58. // result.error.message → human-readable explanation
  59. }
  60. ```
  61. ## As an [MCP server](https://www.npmjs.com/package/openbrand-mcp)
  62. Use OpenBrand as a tool in Claude Code, Cursor, or any MCP-compatible client.
  63. 1. Install the MCP server (no API key needed to install):
  64. ```bash
  65. claude mcp add --transport stdio openbrand -- npx -y openbrand-mcp
  66. ```
  67. 2. Get your API key from [openbrand.sh/dashboard](https://openbrand.sh/dashboard) and add it:
  68. ```bash
  69. claude mcp add --transport stdio \
  70. --env OPENBRAND_API_KEY=your_api_key \
  71. openbrand -- npx -y openbrand-mcp
  72. ```
  73. Or add to `.claude/settings.json`:
  74. ```json
  75. {
  76. "mcpServers": {
  77. "openbrand": {
  78. "command": "npx",
  79. "args": ["-y", "openbrand-mcp"],
  80. "env": {
  81. "OPENBRAND_API_KEY": "your_api_key"
  82. }
  83. }
  84. }
  85. }
  86. ```
  87. Then ask Claude to "extract brand assets from stripe.com" and it will use the `extract_brand_assets` tool automatically.
  88. ## Self-hosting the web app
  89. ```bash
  90. git clone https://github.com/tight-studio/openbrand.git
  91. cd openbrand
  92. bun install
  93. bun dev
  94. ```
  95. No environment variables required. Open http://localhost:3000.
  96. ## What it extracts
  97. - **Logos** — favicons, apple-touch-icons, header/nav logos, inline SVGs (with dimension probing)
  98. - **Brand colors** — from theme-color meta tags, manifest.json, and dominant colors from logo imagery
  99. - **Backdrop images** — og:image, CSS backgrounds, hero/banner images
  100. - **Brand name** — from og:site_name, application-name, logo alt text, page title
  101. ## Tech stack
  102. Next.js, React, TypeScript, Cheerio, Sharp, Tailwind CSS
  103. ## License
  104. [MIT](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.