# Qrcoding Logo Librarian

> 생성 이미지에 기관/브랜드 로고를 정확히 삽입하는 스킬. 기관 로고는 getlogo.kr에서 공식 출처를 찾고, 본인 로고는 로고 링크로 리스트에 추가해 compose_qr_overlay로 위치·크기를 지정해 결정적으로 합성한다. 유료 플랜 기능.

- Skill: `contentscoin/qrcoding-logo-librarian` (Agent Skill)
- Install (CLI): `npx skillmds@latest add contentscoin/qrcoding-logo-librarian`
- Raw SKILL.md: https://api.skillmd.com/api/skills/contentscoin/qrcoding-logo-librarian/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Design & Media
- Author: contentscoin (https://skillmd.com/u/contentscoin)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/contentscoin/qrcoding-logo-librarian

---


# QR Coding Logo Librarian

생성되는 이미지(포스터/아트워크)에 **기관·브랜드 로고를 정확히 삽입**한다. 핵심 원칙은 QR과 동일하다: 로고를 **이미지 모델이 그리게 하지 말고**, 검증된 소스(로고 URL)에서 가져와 **결정적으로 합성**한다. **유료 플랜 전용** 기능이다.

## 로고 소스

1. **기관 로고 — getlogo.kr**
   - getlogo.kr은 한국 관공서·공공기관 로고 **디렉터리**다. 파일을 직접 호스팅하지 않고 **공식 출처 링크만 중계**한다.
   - 기관명/분류(중앙·지자체·공공기관)/지역으로 검색 → 해당 기관 항목 → **공식 출처(기관 공식 사이트의 CI/BI 페이지)**로 이동해 **공식 로고 파일 URL**을 확보한다. 가능하면 PNG 또는 SVG.
   - **상표·저작권은 각 권리자에게 있다.** 허가된 용도로만 사용하고, 로고를 변형·재색·왜곡하지 않는다.
2. **본인 로고 — 링크 첨부**
   - 사용자가 제공한 로고 이미지 **URL**(https 또는 data:image)을 그대로 사용한다.

## 로고 리스트 관리

- 수집한 로고를 `{이름, url}` 형태의 리스트로 관리한다(예: "행정안전부 → https://…/logo.png").
- **재사용**이 필요하면 로고를 워크스페이스 라이브러리에 영속화한다: 이미지를 받아 base64 `data:image/...` 로 만들어 `upload_logo` 호출 → `logoAssetId` 확보. (단 `upload_logo`는 PNG/JPG/WebP ≤100KB만 허용, SVG 불가. SVG 로고는 배치 시 URL을 직접 쓰면 된다.)
- 라이브러리 조회/삭제는 `list_logos` / `delete_logo`.

## 정확한 배치 (핵심)

먼저 사용자에게 **위치·크기·사용 방법**을 물어 프롬프트에 반영한 뒤, `compose_qr_overlay`에 `logo`를 함께 전달한다:

```
compose_qr_overlay(
  id,
  imageTool: "gpt-image" | "gemini" | "codex",
  placement: "card" | "transparent" | "framed",
  logo: { url, position, size, note }
)
```

- `position`: `top-left` · `top-right` · `bottom-left` · `bottom-right` · `top-center` · `bottom-center` · `center` (기본 top-right)
- `size`: `small`(~12%) · `medium`(~18%) · `large`(~26%) — 이미지 너비 대비 (기본 small)
- `note`: 사용 지침(예: "가로형 로고 사용", "주위 여백 확보", "헤더에 배치")
- 반환되는 지시문은 "**그 위치에 로고 자리를 비우고, 모델이 그리지 말고, 생성 후 URL의 실제 로고를 결정적으로 합성**(QR과 그 여백 침범 금지, 색·비율 변형 금지)"을 담는다.

## 유료 게이팅

- 로고 배치는 **유료 플랜 전용**이다. 무료 플랜이 `logo`를 넣으면 로고 가이드 없이 업그레이드 안내만 반환된다.
- 시작 전 `get_account_status`로 플랜을 확인하고, 무료면 업그레이드를 안내한다.

## 검증

- QR과 로고를 **모두 합성한 뒤** `validate_qr_scanability`로 스캔 가능성을 확인한다.
- 지원 옵션이 헷갈리면 `get_capabilities`의 `imageOverlay`(placement·logoPlacement)를 먼저 확인한다.