Community이미지github.com

소셜 공유 이미지 및 아이콘 생성기

Next.js App Router 사이트에 필요한 1200×630 오픈그래프 이미지, Twitter/X 카드 태그, 파비콘, 앱 아이콘, Apple 터치 아이콘, 그리고 블로그 게시물별 OG 이미지를 생성하고 검증합니다.

소셜 공유 이미지 및 아이콘 생성기란 무엇인가요?

이 스킬은 Next.js App Router 기반 웹사이트에 필요한 모든 소셜 공유 이미지와 아이콘을 생성, 구성 및 검증하는 프로세스를 자동화합니다. 사용자가 OG 이미지, 소셜 미리보기, 링크 미리보기, 공유 카드, Twitter 카드, 파비콘 또는 앱 아이콘을 언급하거나, 사이트 링크가 X, LinkedIn, Slack, Discord, WhatsApp에서 이미지를 표시하지 않을 때 활성화됩니다. 이 스킬은 next/og의 ImageResponse를 사용하여 1200×630 크기의 오픈그래프 이미지를 생성하고, Twitter/X 카드 태그를 설정하며, 파비콘, 앱 아이콘, Apple 터치 아이콘을 모든 주요 플랫폼(iOS, Android, 현대 브라우저)에서 호환되도록 만듭니다. 또한 블로그 게시물, 문서, 제품 페이지에 대한 페이지별 OG 이미지를 생성하여 각 페이지가 자체 메타데이터를 설정할 때 루트 이미지가 사라지는 문제를 해결합니다. 스킬은 프로젝트 구조를 검사하고, 메타데이터베이스 설정을 확인하며, 정적 내보내기(static export) 호환성에 대한 특별 지침을 제공합니다. 마지막으로 내장 검증 스크립트를 실행하여 모든 이미지가 올바른 크기, 파일 크기, HTTP 상태 및 URL 절대 경로를 가지고 있는지 확인하고, 배포 후 실제 플랫폼 도구로 다시 스크랩하도록 안내합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/nandot12/nextjs-launch-skills/tree/main/skills/launch-social-images

Installed? Explore more 이미지 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

소셜 공유 이미지 및 아이콘

누군가가 사이트 링크를 X, LinkedIn, Slack, Discord 또는 WhatsApp에 붙여넣으면 읽기 쉬운 제목이 포함된 큰 이미지가 나타나야 합니다. 브라우저와 휴대폰은 선명한 아이콘을 표시해야 합니다.

1. 검사

  • App 폴더(src/app/ 또는 app/), 기존 favicon.ico, icon.*, apple-icon.*, opengraph-image.*, twitter-image.* 확인.
  • 루트 레이아웃의 metadataBase. 이것이 없으면 og:image URL이 상대 경로가 되어 소셜 플랫폼이 무시합니다. 없으면 추가하세요 (launch-seo 스킬 참조 또는 metadataBase: new URL("https://your-domain.com") 설정).
  • next.config.*: output: "export"?
  • 브랜드: 이름, 태그라인, 기본 색상, 로고 (SVG 권장). globals.css에서 토큰을 재사용하세요.
  • 버전에 맞는 문서 읽기:
    • node_modules/next/dist/docs/01-app/03-api-reference/03-file-conventions/01-metadata/opengraph-image.md
    • node_modules/next/dist/docs/01-app/03-api-reference/03-file-conventions/01-metadata/app-icons.md
    • node_modules/next/dist/docs/01-app/03-api-reference/04-functions/image-response.md

2. 오픈그래프 이미지 (사이트 전체)

assets/opengraph-image.tsx를 app/opengraph-image.tsx로 복사하고 브랜드 값을 수정하세요. alt, size (1200×630), contentType을 내보내며, next/og의 ImageResponse로 이미지를 그립니다.

공유 이미지 디자인 규칙:

  • 최소 64px 이상, 가독성이 높은 3~8단어의 제목. 300px 너비의 썸네일에서도 읽을 수 있어야 합니다.
  • 중요한 콘텐츠는 중앙 1000×500 영역 안에 유지하세요. 일부 플랫폼은 가장자리를 자릅니다.
  • 브랜드 마크 + 도메인 이름을 구석에 넣어 링크가 어디로 가는지 알 수 있게 하세요.
  • Flexbox만 사용: ImageResponse는 CSS의 일부만 지원합니다 (display: flex, 그리드 없음). 자식이 두 개 이상인 모든 요소에는 display: "flex"가 필요합니다.
  • 글꼴: 기본 글꼴은 별도 설정 없이 작동합니다. 사용자 정의 글꼴의 경우 .ttf/.otf/.woff 파일 (.woff2 아님)을 readFile로 로드하여 fonts 옵션에 전달하세요 (문서 참조).
  • 크기 제한: 오픈그래프는 8MB, Twitter는 5MB. 생성된 PNG는 일반적으로 100KB 미만입니다.

twitter-image는 선택 사항입니다. 없으면 X는 오픈그래프 이미지를 사용합니다. 루트 메타데이터가 twitter: { card: "summary_large_image" }를 설정하는지 확인하세요.

3. 페이지별 이미지 (블로그 게시물, 문서, 제품 페이지)

동적 세그먼트 내부에 opengraph-image.tsx를 추가하세요. 예: app/blog/[slug]/opengraph-image.tsx. 이 파일은 params (Promise)를 받아 게시물 제목을 로드할 수 있습니다. 이미지 파일에서 generateStaticParams를 내보내 모든 이미지가 사전 렌더링되도록 하세요. 모든 공유가 하나의 브랜드처럼 보이도록 동일한 템플릿을 유지하세요.

이는 생각보다 중요합니다. 페이지가 metadata/generateMetadata에서 자체 openGraph를 설정하면 상위의 openGraph 객체를 덮어써서 해당 페이지에서 루트 공유 이미지가 사라집니다. 세그먼트 레벨의 opengraph-image 파일 (또는 명시적인 openGraph.images)이 이 문제를 해결합니다.

4. 아이콘

파일 (app/ 내)크기용도
favicon.ico32×32 (멀티사이즈 가능)브라우저 탭, 앱 루트에 필수
icon.png 또는 icon.svg512×512 PNG 또는 SVG최신 브라우저, Android
apple-icon.png180×180iOS 홈 화면

ImageResponse를 사용하여 icon.tsx / apple-icon.tsx를 생성할 수도 있습니다. — assets/icon.tsx 참조. 출시 전에 기본 create-next-app favicon.ico를 교체하세요. .ico 도구를 사용할 수 없으면 32×32 icon.png로 대체하고 이전 favicon.ico를 삭제해도 괜찮습니다.

5. 정적 내보내기 참고 사항

output: "export" (Next.js 16.4에서 테스트됨) 사용 시:

  • cacheComponents는 정적 내보내기에서 꺼야 하며, 모든 생성된 이미지 파일 (opengraph-image.tsx, icon.tsx, apple-icon.tsx)은 export const dynamic = "force-static";가 필요합니다. 그렇지 않으면 빌드가 실패합니다. 동적 세그먼트에도 generateStaticParams가 필요합니다.
  • 생성된 이미지는 파일 확장자 없이 내보내집니다 (out/opengraph-image). 따라서 정적 호스트는 Content-Type 헤더 없이 서비스합니다 (Cloudflare Pages에서 확인됨). 일부 크롤러는 이를 거부합니다. 사이트 전체 이미지에 대한 최선의 해결책: 실행 중인 사이트에서 /opengraph-image를 열고 저장한 후 app/opengraph-image.png로 커밋합니다 (그런 다음 .tsx는 삭제). 올바른 타입의 opengraph-image.png로 내보내집니다. 아이콘도 마찬가지입니다 (app/icon.png, app/apple-icon.png). 게시물별 이미지의 경우 호스트의 헤더 파일에서 해당 경로에 Content-Type: image/png를 설정하세요 (Cloudflare Pages/Netlify의 public/_headers).

6. 검증

  1. npm run build가 통과해야 합니다. 빌드 출력은 opengraph-image 라우트를 나열합니다.

  2. 사이트를 시작하고 (npm run start 또는 out/ 폴더 서비스) 검사기를 실행합니다 (Node 18+, 종속성 없음). <skill-dir>은 이 SKILL.md가 포함된 폴더입니다:

    node <skill-dir>/scripts/check-og.mjs http://localhost:3000/ http://localhost:3000/blog/some-post
    

    페이지의 og:* 및 twitter:* 태그를 읽고, 이미지를 다운로드한 후 절대 URL, HTTP 상태, 파일 크기, 크기 (1200×630), og:image:alt, twitter:card를 확인합니다. 태그의 localhost URL은 metadataBase가 없거나 프로덕션에 대해 잘못 설정되었음을 의미하므로 보고됩니다.

  3. 브라우저에서 이미지 URL을 열고 확인하세요. 브라우저 창이 좁을 때 텍스트를 읽을 수 있는지 확인하세요.

  4. 배포 후 사용자에게 플랫폼별 도구 (LinkedIn Post Inspector, Facebook Sharing Debugger)로 테스트하도록 알리세요. 이 도구들은 캐시된 미리보기도 새로고침합니다.

보고서

생성된 이미지 및 아이콘 파일 목록, 검사기 출력, 그리고 플랫폼이 미리보기를 캐시한다는 알림을 나열하세요. 이미지 변경 후에는 위 도구들로 다시 스크랩하세요.

관련 스킬