lovstudio-find-logo - SKILL.md Agent Skill

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", "需要的 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.