lovstudio-find-logo

name	lovstudio-find-logo
description	Fetch a company/product logo from public sources (Clearbit, og:image, favicon) given a brand name or URL, score candidates (wide-aspect + transparent preferred), and archive the best + runner-ups to the configured logo collection directory. Trigger when the user says "find logo", "找 logo", "抓 logo", "收集 logo", "brand asset", "需要 <brand> 的 logo", or wants logos laid out for a website/PPT/poster.
license	MIT
compatibility	Requires Python 3.8+ (stdlib only — no pip deps). Cross-platform: macOS, Windows, Linux.
metadata	{"author":"lovstudio","version":"0.2.0","tags":["branding","assets","logo","scraping"]}

find-logo — collect brand logos, prefer wide + transparent

Takes a brand name or URL, probes Clearbit + the site's own og:image / <link rel=icon> / favicon, scores each candidate, and archives the best one plus a couple of alternates into the configured collection directory.

When to Use

• User asks to collect one or more brand logos for a slide/poster/site lineup
• User names companies to drop into a partners/press strip
• User gives a URL and wants its logo pulled down cleanly

Workflow (MANDATORY)

Step 1: Identify each brand

Accept any mix of names and URLs. If the user gave only a name with no obvious domain, ask — don't silently guess .com (script will guess, but for non-US or ambiguous brands that fails).

Use AskUserQuestion when:

• Brand name is ambiguous (e.g. "Apple" = fruit vs. Inc.)
• No URL and the domain isn't guessable (xAI → x.ai, not xai.com)
• User gave a list without URLs

Step 2: Fetch — one brand per invocation

python3 scripts/find_logo.py --name "Anthropic" --url https://anthropic.com --json

For a batch, loop; the script is idempotent per <slug>/ (re-runs overwrite).

Step 3: Inspect score; fall back to WebSearch if needed

• Exit code 0 → logo archived. The printed score is your quality signal:
  • ≥ 60 — solid: SVG or transparent PNG with wide/square aspect
  • 20–60 — usable: probably a favicon or small PNG
  • < 20 — weak: only ICO or tiny stub found
• Exit code 2 / status: "no-candidates" → script found nothing. Do NOT give up. Use WebSearch for "<brand> logo svg site:*.com" or the brand's press-kit page, then re-invoke with --url <direct-image-url> is not supported — if you have a direct image URL, save it into the configured collection directory under <slug>/logo.<ext> and hand-write meta.json using the existing layout as a template.

Step 4: Report

Report back with the archive path and the primary's aspect + format. If the score is weak, tell the user and offer to retry with a specific press-kit URL or Wikipedia SVG.

CLI Reference

Argument	Default	Description
--name	—	Brand/product name. Used for slug + meta.
--url	—	Official URL or bare domain. Overrides the name-based domain guess.
--slug	slugified name	Override the directory slug under the archive root.
--out	LOVSTUDIO_FIND_LOGO_OUTPUT_DIR or ~/.lovstudio/logo-collection	Archive root.
--keep-alts	2	How many runner-up candidates to keep as alt-N.<ext>.
--json	off	Emit a JSON result to stdout (use this when chaining).

At least one of --name or --url is required.

Archive Layout

~/.lovstudio/logo-collection/
├── anthropic/
│   ├── logo.png            # primary (highest score)
│   ├── alt-1.png           # runner-ups
│   ├── alt-2.png
│   └── meta.json           # sources, scores, dimensions, fetched_at
├── vercel/
│   ├── logo.png            # 1200x628 transparent banner
│   └── ...
└── stripe/
    ├── logo.svg
    └── ...

Scoring Heuristic (why a candidate wins)

• Format: SVG (+40) > PNG (+20) > WebP (+10) > JPG (-10) > ICO (-20)
• Transparency: +30 if alpha channel present (SVG always counts)
• Aspect ratio: +25 for wide (≥2:1), +10 for landscape (≥1.3:1), -5 for square, -15 for tall/portrait
• Short edge: +15 if ≥128px, +5 if ≥64px, -20 if <32px
• Size sanity: -30 if payload <400 bytes (almost certainly a stub)

This matches the "prefer 长条形 + rgba" preference — wide transparent logos come out on top, square favicons land as alternates.

Dependencies

Stdlib only (urllib, html.parser, argparse). No pip install required.

User Configuration

Default archive files live under ~/.lovstudio/logo-collection/. Override this per run with --out, or set LOVSTUDIO_FIND_LOGO_OUTPUT_DIR for the skill.

Known Limits

• The name → domain guess is a crude lowercase-strip + .com suffix. For anything not on .com, pass --url explicitly.
• No Clearbit API key is used — we hit the unauthenticated endpoint, which covers most major brands but not all.
• WebSearch fallback is Claude's responsibility, not the script's.