brand intelligence api ยท v0.1 ยท 2026

Hi, we're brandnana.

One CLI call returns a brand book โ€” a single-file workbook with live brand assets, competitor ads, and a deep product catalog. It installs straight into your agent as a Claude Code skill.

works with Claude Code Codex Cursor any MCP client
~/work ยท brandnana
$ brandnana book nike.com [brandnana] fetching nike.comโ€ฆ โœ“ brand identity 1.2s โœ“ 3 competitors 2.1s โœ“ 247 products 4.6s โœ“ 142 ads (meta+tt) 3.4s โœ“ design palette 0.8s [brandnana] installed brand book: nike open  ./nike.workbook.html query brandnana book query nike
247 brand books built
ยท
89 brands captured
ยท
123 MCP tools
ยท
0.42ms avg query
ยท
~3MB workbook size
ยง 01 ยท what you get

A single workbook your agent can read.

Drops at ~/.claude/skills/brands/<slug>/ with a SKILL.md so Claude knows when to use it. Everything else lives inside one offline-capable .workbook.html.

~/.claude/skills/brands/nike/
โ”œโ”€โ”€ SKILL.md โ†’ tells Claude when to use this skill โ”œโ”€โ”€ nike.workbook.html โ†’ single-file, gzip-packed, ~3 MB โ”‚   โ”œโ”€โ”€ brand.org ยท identity, palette, fonts, voice โ”‚   โ”œโ”€โ”€ competitors/ ยท adidas, puma, asics โ€” ad breakdowns โ”‚   โ”œโ”€โ”€ catalog/ ยท products by category / color / price โ”‚   โ”œโ”€โ”€ ads/ ยท 142 ad captures (streamed or embedded) โ”‚   โ””โ”€โ”€ timeline.org ยท what was captured, when, by who โ””โ”€โ”€ query.md โ†’ OQL examples, scoped to this brand
format
single-file HTML ยท WASM runtime baked in
data
org-mode tree ยท queryable via OQL
media
embedded (offline) or R2-linked (slim)
install
drops into ~/.claude/skills/brands/
query
brandnana book query nike '(under "Catalog/by-color/Black")'
ยง 02 ยท six verbs

Six verbs. One CLI. 123 MCP tools.

Each verb returns clean JSON if you call it raw โ€” or feeds straight into the brand book when you call brandnana book.

01

brand fetch

Pull live brand identity โ€” logos, palette, font stack, voice, social handles.

$ brandnana brand fetch nike.com
โœ“ primary: #111  ยท  secondary: #f5f5f5
โœ“ fonts: Futura, Inter, Arial
โœ“ logo: nike-swoosh.svg (24 KB)
โœ“ tone: bold, declarative, athletic
02

ads search

Scrape live creative from any brand's ad library โ€” Meta, TikTok, Google.

$ brandnana ads search --domain=adidas.com
โ€บ meta:    142 ads  (28 active)
โ€บ tiktok:   38 ads  (6 promoted)
โ€บ google:   54 ads  (18 with video)
โ€บ themes:  return-to-running ยท trail ยท y2k
03

catalog crawl

Extract a structured product catalog from any storefront โ€” Shopify, custom, anywhere.

$ brandnana catalog crawl glossier.com
โ–ธ products: 247 (32 categories)
โ–ธ images:   1,184 (avg 3.6mb)
โ–ธ price band: $14 โ€” $98
โ–ธ variants: 812 ยท colors: 42
04

brief generate

Composable creative brief โ€” pulls in brand context + a prompt, drops a tight one-pager.

$ brandnana brief generate "summer launch"
โœ“ strategy:  position vs Nike Air Max
โœ“ tone:       playful, surprising
โœ“ assets:    use SS25 palette
โœ“ word count: 412 ยท reading: 1m48s
05

design palette

Extract a design system palette from any logo, image, or whole brand.

$ brandnana design palette logo.png
โ— #f0c040  banana       (primary)
โ— #d65a3a  cherry       (secondary)
โ— #1f1a14  ink          (text)
โ— #fbf4e4  parchment    (background)
06

mcp ready

Drop into Claude Code, Codex, Cursor as a native MCP server. 123 tools, zero config.

$ brandnana mcp
[brandnana] mcp ready on stdio
  โžœ 123 tools exposed
  โžœ skill: ~/.claude/skills/brandnana/
  โžœ try:  use brandnana to research nike.com
ยง 03 ยท drop in

Drop into your agent in 30 seconds.

brandnana ships an MCP server too. One config block โ€” and your agent has 123 tools to fetch brands, search ads, crawl catalogs, generate briefs.

// ~/.claude/mcp.json
{
  "mcpServers": {
    "brandnana": {
      "command": "brandnana",
      "args": ["mcp"]
    }
  }
}

Your first brand book in under a minute.

No accounts. No SDKs. Just a CLI and an agent that already knows how to use it.

curl -fsSL https://install.brandnana.net | sh