# UI에서 바로 쓸 수 있는 결과가 필요한 팀을 위한 Clearbit Logo API 대체안

> Clearbit Logo API는 이미 종료됐다. 진짜 어려운 문제는 URL을 바꾸는 게 아니라, 대시보드와 테이블, CRM, 브라우저 앱에서 바로 쓸 수 있는 결과물을 얻는 것이다.

## 무엇이 바뀌었나

예전 Clearbit 엔드포인트가 내려가자, 빠른 대체제를 찾던 팀들은 두 번째 문제를 빠르게 마주쳤다. 로고 파일 자체는 가져올 수 있지만, 매번 여백과 배경 처리, 프레이밍이 다르게 들어온다는 것이다.

## 다른 로고 파일 소스만으로는 부족한 이유

실제 제품 UI는 로고가 없어서 깨지기보다, 같은 테이블이나 카드 안에서 로고가 모두 다르게 보여서 깨진다. 마지막 단계인 패딩, 크롭, 배경, 브라우저 사용성이 중요하다.

## 대체재를 고를 때 봐야 할 것

- **배경 처리** — 무조건 투명 처리보다 원래 브랜드 배경을 보존할 수 있어야 한다.
- **일관된 프레이밍** — 같은 UI 슬롯 안에서 모든 로고가 예측 가능하게 맞아야 한다.
- **브라우저 친화 사용성** — 단순한 `<img>` 태그 사용을 위해 별도 서버가 필수여서는 안 된다.
- **빠른 마이그레이션** — 몇 개 도메인을 바로 테스트하고 빠르게 옮길 수 있어야 한다.

## ClearLogo가 맞는 지점

ClearLogo는 도메인을 받아 배경 인식, 자동 크롭, 비율 맞춤이 적용된 결과를 돌려준다. 파일 접근 자체보다 UI 화면 일관성을 우선하는 제품에 잘 맞는다.

### 브라우저 친화적인 기본 형태

```html
<img
  src="https://api.clearlogo.dev/logo/example.com?token=YOUR_BROWSER_KEY"
  alt="Example company logo"
/>
```

## 3단계 마이그레이션

1. **대표 도메인 몇 개를** [playground](https://clearlogo.dev/ko/docs/playground) **에서 테스트한다.**
2. **원하는 URL 형태를** 고른다.
3. **프로덕션 키를** 만들고 허용 도메인을 잠근다.

## 자주 묻는 질문

### Clearbit Logo API는 아직 쓸 수 있나요?

아니다. Clearbit Logo API는 이미 종료되었다. 단순히 다른 로고 파일을 가져오는 것 이상으로, UI 안에서 바로 쓸 수 있는 일관된 결과물이 필요하다.

### ClearLogo와 일반 로고 파일 소스의 차이는 무엇인가요?

ClearLogo는 표현 방식에 의견이 있다. 배경 인식, 자동 크롭, 비율 맞춤된 결과를 반환하기 때문에 UI의 같은 슬롯 안에서 모든 브랜드가 일관되게 보인다. 단순한 투명 PNG를 받아서 직접 정돈해야 하는 게 아니라는 뜻이다.

### 프론트엔드 코드의 `<img>` 태그에 바로 쓸 수 있나요?

네. 대시보드에서 브라우저 키를 만들고 앱이 동작하는 도메인을 허용하면, URL을 `<img>` 태그에 바로 넣을 수 있다. 별도 서명 서비스가 필요 없다.

### 마이그레이션은 얼마나 빠르게 가능한가요?

대부분의 팀이 대표 도메인 5-10개를 playground에서 몇 분이면 검증하고, URL 형태를 결정한 뒤 프로덕션 키를 만든다.