연동
사이트 연동 가이드
수정이 사이트에 반영되는 방식은 사이트를 만든 방식에 따라 다릅니다. 테스트 사이트와 테스트 데이터로 시작해, 각 수정이 어디로 가는지와 게시되는지를 확인하세요.
개발자가 아니라면 설정 가이드에서 Google과 WordPress 연결을 스크린샷으로 안내합니다.
공통 준비
자체 개발 사이트용 API와 CMS 초안 작업에는 이용 중인 Growth 또는 Pro 요금제, 확인이 끝난 사이트 소유 확인, 그리고 소유자의 수정별 승인이 필요합니다. Connections 화면에서 소유를 확인한 뒤, API 화면에서 결과를 기록할 수 있는 키를 만드세요. API 키만으로는 수정을 승인할 수 없습니다.
HTTPS 페이지 URL과 수정 필드를, 그 페이지에 실제로 표시되는 CMS 레코드와 필드에 하나씩 연결하세요. 설정하기 전에 테스트 데이터, 담당자, 게시 절차를 준비하세요.
자체 개발 사이트
수정 API 사양에 따라 사이트 서버에 처리를 구현합니다. 승인된 수정을 가져와 URL과 필드를 허용 목록으로 확인하고, 현재 값이 “변경 전” 값과 같을 때만 초안을 저장하세요. 저장한 버전과 결과를 API에 보고합니다.
지원하는 수정 필드는 title, description, h1, body입니다. 예를 들어 https://example.com/about의 title을 자체 “회사 소개” 레코드의 제목에 연결합니다. 게시는 사람이 확인한 뒤 따로 합니다.
WordPress
Connections 화면에서 사이트를 연결합니다. 대상 글과 페이지를 수정할 수 있는 WordPress 사용자의 애플리케이션 비밀번호를 준비하고, 먼저 테스트 페이지에서 시험하세요. 필요한 수정 권한으로만 제한하고, 쓰지 않는 비밀번호는 취소하세요. 스크린샷이 있는 순서는 WordPress 연결에 있습니다.
게시된 페이지에 반영하면 공개 중인 내용이 바로 바뀝니다. Use this edit 같은 조작이 쓰기 승인입니다. 별도 초안 생성은 지원하지 않습니다. 페이지 빌더나 수정할 수 없는 필드는 문구를 복사해 직접 반영하세요.
CMS 초안 작업
microCMS, Shopify, Webflow, Contentful, Sanity용으로 직접 운영 환경에서 실행하는 초안 작업 예시가 있습니다. Node.js 22.13 이상과, 영구 디스크에 둔 비공개 SQLite 저널이 필요합니다. CMS 비밀 정보는 자체 서버의 비밀 저장소에서 환경 변수로 넘기고, 브라우저·설정 파일·로그에는 절대 넣지 마세요. Get1pct는 CMS 비밀 정보를 보관하지 않으며 이 작업을 대신 실행하지 않습니다.
지금은 테스트용 구현입니다. 다섯 가지 모두 전용 테스트 환경의 미게시 콘텐츠로 초안 저장, 다시 읽기, 재실행 결과를 실제 환경에서 확인했습니다. 확인 범위는 그 테스트 항목뿐입니다. Shopify는 상품명을 확인했으며 SEO 필드는 실제 API로 시험하지 않았습니다.
아래 예시는 URL과 Get1pct 필드를 microCMS의 엔드포인트, 콘텐츠 ID, 필드에 연결합니다. 값은 테스트 환경에 맞게 바꾸세요.
{
"projectId": "test-project-id",
"provider": "microcms",
"options": { "serviceId": "example-sandbox" },
"targets": [{
"page": "https://example.com/about",
"field": "title",
"target": {
"endpoint": "draft-fixtures", "id": "about", "field": "title",
"draftKeyEnv": "MICROCMS_DRAFT_KEY_ABOUT"
}
}]
}공통 환경 변수는 GET1PCT_API_ORIGIN, GET1PCT_PROJECT_ID, GET1PCT_API_KEY, GET1PCT_CMS_CONFIG, GET1PCT_CMS_JOURNAL입니다. CMS별 자격 증명은 아래 변수에 넣습니다.
Shopify
Dev Dashboard에서 앱을 만들고 client credentials grant로 서버 토큰을 받습니다. 게시하지 않는 개발 스토어와 미게시 DRAFT 상품을 사용하세요. read_products와 write_products 권한의 토큰을 SHOPIFY_INTEGRATION_TOKEN에 넣고, shop(예: example.myshopify.com)과 productId(예: gid://shopify/Product/123)를 지정합니다. title과 description은 SEO 필드, h1은 상품명에 해당하며 본문은 지원하지 않습니다.
Webflow
테스트 사이트의 CMS 읽기·쓰기 권한이 있는 토큰을 WEBFLOW_INTEGRATION_TOKEN에 넣습니다. 기본 로캘에서 수정할 수 있는 PlainText 필드를 collectionId, itemId, fieldSlug로 지정하세요. 템플릿이 그 필드를 실제로 표시하는지 확인하세요. 변경은 스테이징에 저장되며, 게시는 별도 단계입니다.
Contentful
테스트 스페이스와 환경에서, 대상 엔트리를 읽고 수정할 수 있는 관리 API 토큰을 CONTENTFUL_INTEGRATION_TOKEN에 넣습니다. spaceId, environmentId, entryId, fieldId, locale(예: en-US)을 지정합니다. 기존 텍스트 필드는 지원하지만 Rich Text는 지원하지 않습니다. 게시된 엔트리의 변경은 따로 게시할 때까지 미게시 상태로 남습니다.
Sanity
테스트 데이터셋에서 대상 초안을 읽고 수정할 수 있는 토큰을 SANITY_INTEGRATION_TOKEN에 넣습니다. projectId, dataset, drafts.로 시작하는 기존 documentId, 문자열 필드 field를 지정합니다. Portable Text는 지원하지 않습니다. Studio에서 내용을 확인하고, 공개하려면 따로 게시하세요.
microCMS
테스트 서비스에 리스트 API와 미게시 콘텐츠를 준비하고, 그 API의 GET과 PATCH로만 제한한 키를 MICROCMS_INTEGRATION_API_KEY에 넣습니다. 초안의 draftKey는 설정의 draftKeyEnv가 가리키는 환경 변수에 넣습니다. serviceId, endpoint, id, 텍스트 필드 field를 지정합니다. 기존 미게시 콘텐츠만 지원합니다.
테스트와 운영
- 테스트 데이터로 URL, 필드, “변경 전” 값이 일치하는지 확인한 뒤, 승인된 수정 하나만 처리합니다.
- CMS 관리 화면에서 초안 값과 버전을 확인하고, 공개 페이지가 바뀌지 않았는지 확인합니다. WordPress 직접 업데이트는 테스트 페이지에서 시험합니다.
- “변경 전” 값 불일치나 권한 오류는 원인을 조사하세요. 저장이 성공했는지 알 수 없으면 같은 저널로 이어서 실행하고 다시 읽으세요. 무작정 다시 보내거나 저널을 지우지 마세요.
microCMS, Shopify, Webflow에서는 마지막 확인과 저장 사이의 동시 수정을 완전히 막을 수 없습니다. 테스트하는 동안 다른 사람이나 작업이 같은 레코드를 수정하지 않도록 하세요.