연동
Shopify
커스텀 앱 액세스 토큰으로 Shopify를 연결합니다. 필요한 범위, 블로그 선택기, 이미지 업로드, 게시 방식 등을 다룹니다.
업데이트 2026-09-13
Climb AI는 커스텀 앱의 Admin API 액세스 토큰을 사용해 Shopify 블로그에 게시합니다. 이는 모든 비공개 연동을 위해 생성하는 것과 같은 종류의 토큰이며, 이 스토어에만 범위가 지정됩니다.
- 1커스텀 앱 만들기Shopify 관리자에서 설정 → 앱 및 판매 채널 → 앱 개발로 이동해 앱 만들기를 클릭하고 이름을 지정하세요(예: "Climb AI").
- 2Admin API 범위 부여하기Admin API 범위를 구성하고 read_content, write_content, write_files를 활성화하세요. 앱을 스토어에 설치합니다.
- 3액세스 토큰 복사하기앱의 API 자격 증명 탭에서 Admin API 액세스 토큰을 표시하세요. 토큰은
shpat_로 시작합니다. Shopify는 토큰을 한 번만 보여줍니다. - 4Climb AI에 세부 정보 입력하기사이트 설정에서 Shopify를 선택하고 스토어 이름(
.myshopify.com앞부분), 액세스 토큰, 게시물에 표시할 작성자 이름을 입력하세요. Climb AI가 토큰을 확인하고 스토어의 블로그를 가져옵니다. - 5블로그 선택하기Climb AI가
blogs.json을 통해 채우는 드롭다운에서 새 아티클이 게시될 블로그를 선택하세요.
액세스 토큰은
shpat_… 형식과 일치해야 하고 스토어 이름은 문자, 숫자, 하이픈만 허용됩니다. Climb AI는 연결을 시도하기 전에 두 가지를 모두 검증합니다.무엇이 게시되는가
| Shopify로 전송됨 | Shopify에서 읽음 |
|---|---|
| 아티클 제목, HTML 본문, 작성자 이름 | 블로그 목록(선택기용) |
| GraphQL 단계적 업로드를 통해 Shopify Files로 업로드되는 이미지 | 생성/업데이트된 아티클의 라이브 URL |
blogs/{blogId}/articles.json을 통한 생성/업데이트 | — |
아티클 이미지는 3단계 GraphQL 흐름을 거칩니다.
stagedUploadsCreate가 임시 업로드 대상을 가져오고, 버퍼가 해당 위치에 PUT되며, 그다음 fileCreate가 이를 Shopify Files에 등록합니다. 따라서 이미지는 Climb AI에서 핫링크되지 않고 귀하의 스토어 도메인에서 제공됩니다.Climb AI는 Shopify의 "unstable" 채널을 따라가는 대신 고정된 Shopify Admin API 버전을 사용하고 의도적으로 업데이트합니다. 이렇게 하면 Shopify가 API 버전을 폐기할 때 예상치 못한 호환성 중단을 피할 수 있습니다.
자주 묻는 질문
블로그 기능이 활성화된 모든 플랜이며, 여기에는 모든 표준 Shopify 플랜이 포함됩니다.
관련 문서
- 사이트 연결 — 각 온보딩 단계에서 요구하는 사항, 자동으로 채워지는 항목, 게시 플랫폼을 선택하는 위치를 설명합니다.
- 아티클 이미지 — 스타일 선택, 아티클당 이미지 개수, 이미지 허용량에서 차감되는 항목, alt text가 작성되는 방식을 설명합니다.
- 아티클 내보내기(HTML, Markdown, JSON) — 편집기에서 바로 모든 아티클을 HTML, Markdown 또는 JSON으로 다운로드하세요. JSON은 웹훅이 받는 것과 동일한 객체입니다.
내 사이트에서 직접 써볼 준비가 되셨나요?
5일 무료 체험, 6일차까지 아무 비용도 청구되지 않으며, 그 이후에는 30일 환불 보장.
5일 무료 체험 · 30일 환불 보장 · 평생 가격 고정
여전히 막히셨나요? hello@climbai.io