API + Skill
Statix API로 페이지 만들기, 고치기, 지우기와 지표 조회를 자동화할 수 있습니다. CI 파이프라인과 배포 스크립트에서 직접 호출하거나, 스킬로 에이전트에게 맡기세요.
스킬로 에이전트에게 맡기기
API 사용법을 에이전트에 한 번 알려 두면, "개인정보처리방침 써서 올려줘" 한마디로 문서를 쓰고 올리는 일까지 처리합니다. Claude Code는 아래 내용을 스킬 파일로 저장하세요.
---
name: statix
description: Statix(statix.kr)에 정적 HTML 페이지를 API로 올리고 고치고 지운다. 개인정보처리방침, 이용약관, 지원 페이지, 앱 소개 페이지처럼 공개 URL이 필요한 페이지를 만들거나 갱신해 달라는 요청에 쓴다.
---
너는 Statix API로 정적 페이지를 배포한다.
베이스 URL: https://flzwoyvuujcgfnmurjdj.supabase.co/functions/v1/api
인증: Authorization: Bearer $STATIX_API_KEY
(환경 변수에서만 읽고, 키 값을 답변이나 페이지 내용에 절대 쓰지 마라)
엔드포인트:
GET /pages 목록 pages:read
POST /pages 생성 pages:write
GET /pages/{id} 조회 (content 포함) pages:read
PATCH /pages/{id} 수정 (내용 덮어쓰기) pages:write
DELETE /pages/{id} 삭제 pages:write
GET /stats 조회 지표 (?days=7) pages:read
할 일:
1. 요청받은 문서(개인정보처리방침, 이용약관, 랜딩 페이지 등)를
완결된 HTML 한 덩어리로 작성한다.
외부 CSS·JS를 참조하지 말고 <style> 태그로 인라인 처리한다.
페이지 하나는 500KB 까지다. 이미지는 base64 로 넣지 말고 외부 주소로 불러온다.
2. POST /pages 에 { title, slug, content, published: true, seo } 를 보낸다.
slug 는 소문자 영문·숫자·하이픈·점만 쓴다.
slug 를 index 로 하면 사이트 루트(/)에서 열린다.
sitemap.xml · robots.txt · llms.txt 는 자동으로 만들어지므로 보통은 올리지 않는다.
사용자가 내용을 직접 정하고 싶어 할 때만 같은 slug 의 페이지를 게시한다. 그러면 그 내용이
자동 생성본 대신 나가고, 이후 페이지를 추가해도 자동으로 갱신되지 않는다.
app-ads.txt 처럼 slug 가 .txt · .json · .xml 로 끝나는 페이지는 HTML 이 아니라
그 파일 형식 그대로 나간다. content 에 파일 내용만 넣는다.
published 를 생략하면 곧바로 공개된다. false 로 올리면 초안이며 주소는 404 다.
HTML 에는 <html lang>, <meta name="viewport">, 제목 태그(h1) 를 반드시 넣는다.
검색·AI 노출은 페이지의 검색 설정 seo 로 정한다 (POST · PATCH 에 함께 보낸다):
seo: { indexable, title, description, image }
- indexable: false 면 검색에서 빼고 사이트맵·llms.txt 에도 싣지 않는다 (기본 true)
- title, description: 검색 결과와 공유 미리보기에 보이는 문구
- image: 공유 미리보기 이미지의 https 주소
seo 에 적은 항목은 HTML 의 같은 태그보다 우선한다. PATCH 는 seo 에서 보낸 항목만
바꾸고, 빈 문자열을 보낸 항목은 지운다.
공개하면 안 되는 페이지(테스트, 내부용)는 indexable: false 로 올린다.
3. 응답 data.url 을 사용자에게 그대로 알려준다. 그 주소가 곧 살아 있는 URL이다.
4. 이미 있는 페이지를 고칠 때는 GET /pages/{id} 로 현재 content 를 읽고,
({id} 자리에 slug 를 써도 된다. 찾을 때는 GET /pages?search=글자 를 쓴다.)
PATCH /pages/{id} 로 고친다. 지우고 다시 만들지 마라 —
PATCH 는 URL·조회수를 유지하지만 재생성은 id 가 바뀐다.
PATCH 는 내용을 덮어쓰고 이전 내용은 보관되지 않는다.
5. 실패하면 error.code 로 분기한다.
- conflict : slug 가 이미 있다. error.id 가 그 페이지다. 같은 문서를 고치는 것이면
PATCH /pages/{error.id} 로, 다른 문서면 다른 slug 로 한 번만 재시도한다.
- limit_exceeded: 플랜 한도다. 재시도하지 말고 사용자에게 알린다.
- 401 / 403 : 키나 스코프 문제다. 재시도하지 말고 사용자에게 알린다.
6. 페이지가 얼마나 읽히는지 물으면 GET /stats 로 답한다.
data.daily(일별 조회수), data.pages(페이지별), data.referrers(유입 경로),
data.bots(읽어 간 검색엔진·AI) 를 그대로 근거로 쓰고 추측하지 않는다.
data.limited 가 true 면 Free 플랜이라 최근 7일 조회수만 온 것이다.
만들기 전에 GET /pages 로 같은 slug 가 있는지 확인하고, 같은 페이지를
중복해서 만들지 마라. 지우는 것은 사용자가 명시적으로 요청할 때만 한다.Codex는 AGENTS.md, Cursor는 .cursor/rules처럼 각 도구의 규칙 파일에 아래 지시문을 붙여넣으면 됩니다. 시스템 프롬프트나 도구 설명에 넣어도 됩니다.
너는 Statix API로 정적 페이지를 배포한다.
베이스 URL: https://flzwoyvuujcgfnmurjdj.supabase.co/functions/v1/api
인증: Authorization: Bearer $STATIX_API_KEY
(환경 변수에서만 읽고, 키 값을 답변이나 페이지 내용에 절대 쓰지 마라)
엔드포인트:
GET /pages 목록 pages:read
POST /pages 생성 pages:write
GET /pages/{id} 조회 (content 포함) pages:read
PATCH /pages/{id} 수정 (내용 덮어쓰기) pages:write
DELETE /pages/{id} 삭제 pages:write
GET /stats 조회 지표 (?days=7) pages:read
할 일:
1. 요청받은 문서(개인정보처리방침, 이용약관, 랜딩 페이지 등)를
완결된 HTML 한 덩어리로 작성한다.
외부 CSS·JS를 참조하지 말고 <style> 태그로 인라인 처리한다.
페이지 하나는 500KB 까지다. 이미지는 base64 로 넣지 말고 외부 주소로 불러온다.
2. POST /pages 에 { title, slug, content, published: true, seo } 를 보낸다.
slug 는 소문자 영문·숫자·하이픈·점만 쓴다.
slug 를 index 로 하면 사이트 루트(/)에서 열린다.
sitemap.xml · robots.txt · llms.txt 는 자동으로 만들어지므로 보통은 올리지 않는다.
사용자가 내용을 직접 정하고 싶어 할 때만 같은 slug 의 페이지를 게시한다. 그러면 그 내용이
자동 생성본 대신 나가고, 이후 페이지를 추가해도 자동으로 갱신되지 않는다.
app-ads.txt 처럼 slug 가 .txt · .json · .xml 로 끝나는 페이지는 HTML 이 아니라
그 파일 형식 그대로 나간다. content 에 파일 내용만 넣는다.
published 를 생략하면 곧바로 공개된다. false 로 올리면 초안이며 주소는 404 다.
HTML 에는 <html lang>, <meta name="viewport">, 제목 태그(h1) 를 반드시 넣는다.
검색·AI 노출은 페이지의 검색 설정 seo 로 정한다 (POST · PATCH 에 함께 보낸다):
seo: { indexable, title, description, image }
- indexable: false 면 검색에서 빼고 사이트맵·llms.txt 에도 싣지 않는다 (기본 true)
- title, description: 검색 결과와 공유 미리보기에 보이는 문구
- image: 공유 미리보기 이미지의 https 주소
seo 에 적은 항목은 HTML 의 같은 태그보다 우선한다. PATCH 는 seo 에서 보낸 항목만
바꾸고, 빈 문자열을 보낸 항목은 지운다.
공개하면 안 되는 페이지(테스트, 내부용)는 indexable: false 로 올린다.
3. 응답 data.url 을 사용자에게 그대로 알려준다. 그 주소가 곧 살아 있는 URL이다.
4. 이미 있는 페이지를 고칠 때는 GET /pages/{id} 로 현재 content 를 읽고,
({id} 자리에 slug 를 써도 된다. 찾을 때는 GET /pages?search=글자 를 쓴다.)
PATCH /pages/{id} 로 고친다. 지우고 다시 만들지 마라 —
PATCH 는 URL·조회수를 유지하지만 재생성은 id 가 바뀐다.
PATCH 는 내용을 덮어쓰고 이전 내용은 보관되지 않는다.
5. 실패하면 error.code 로 분기한다.
- conflict : slug 가 이미 있다. error.id 가 그 페이지다. 같은 문서를 고치는 것이면
PATCH /pages/{error.id} 로, 다른 문서면 다른 slug 로 한 번만 재시도한다.
- limit_exceeded: 플랜 한도다. 재시도하지 말고 사용자에게 알린다.
- 401 / 403 : 키나 스코프 문제다. 재시도하지 말고 사용자에게 알린다.
6. 페이지가 얼마나 읽히는지 물으면 GET /stats 로 답한다.
data.daily(일별 조회수), data.pages(페이지별), data.referrers(유입 경로),
data.bots(읽어 간 검색엔진·AI) 를 그대로 근거로 쓰고 추측하지 않는다.
data.limited 가 true 면 Free 플랜이라 최근 7일 조회수만 온 것이다.
만들기 전에 GET /pages 로 같은 slug 가 있는지 확인하고, 같은 페이지를
중복해서 만들지 마라. 지우는 것은 사용자가 명시적으로 요청할 때만 한다.키는 에이전트가 도는 환경의 환경 변수(STATIX_API_KEY)에 두세요. 대화 기록이나 생성한 HTML 안에 키가 들어가면 그대로 유출됩니다. 규칙 파일 없이 도구로 바로 연결하려면 AI Agent (MCP)를 쓰세요.
베이스 URL
https://flzwoyvuujcgfnmurjdj.supabase.co/functions/v1/api모든 요청과 응답은 UTF-8 JSON입니다. 성공 응답은 data 키에, 실패 응답은 error 키에 담깁니다.
인증
모든 엔드포인트는 API Key가 필요합니다. 대시보드 > API Key에서 발급한 키를 Authorization 헤더에 담아 보내세요.
Authorization: Bearer stx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx헤더 이름을 바꾸기 어려운 환경이라면 x-api-key: stx_... 도 지원합니다.
키는 서버에서만 사용하세요.
API Key는 계정 전체 권한을 갖습니다. 브라우저 코드나 공개 저장소에 넣지 마세요. 유출이 의심되면 대시보드에서 즉시 만료 처리하고 새로 발급하면 됩니다.
스코프
키를 발급할 때 권한을 고릅니다. 필요한 최소 권한만 주는 편이 안전합니다.
GET /pagesPOST /pages, DELETE /pages/{id}엔드포인트
/pages쿼리 파라미터
| 이름 | 타입 | 필수 | 설명 |
|---|---|---|---|
| limit | number | 선택 | 한 번에 가져올 개수. 기본 20, 최대 100. |
| offset | number | 선택 | 건너뛸 개수. 기본 0. |
| published | true | false | 선택 | 게시 상태로 필터링합니다. 생략하면 전체. |
| search | string | 선택 | 제목이나 slug에 이 글자가 들어 있는 페이지만 가져옵니다. |
요청
curl "https://flzwoyvuujcgfnmurjdj.supabase.co/functions/v1/api/pages?limit=20" \
-H "Authorization: Bearer $STATIX_API_KEY"응답 200
{
"data": [
{
"id": "8f14e45f-ceea-467a-9f8b-3f2c1d4e5a6b",
"title": "개인정보처리방침",
"slug": "privacy-policy",
"published": true,
"view_count": 128,
"url": "https://mysubdomain.statix.kr/privacy-policy",
"created_at": "2026-08-01T02:11:43.201Z",
"updated_at": "2026-08-12T09:30:02.118Z"
}
],
"pagination": {
"limit": 20,
"offset": 0,
"total": 1,
"has_more": false
}
}/pages요청 바디
| 이름 | 타입 | 필수 | 설명 |
|---|---|---|---|
| title | string | 필수 | 페이지 제목. |
| content | string | 필수 | 페이지 HTML. 최대 500KB (UTF-8 기준). 넘으면 413. |
| slug | string | 선택 | URL 경로. 소문자 영문·숫자·하이픈(-)·점(.)만 사용합니다. 생략하면 제목에서 자동 생성됩니다. |
| published | boolean | 선택 | 게시 여부. 기본 true(올리면 곧바로 공개). 초안으로 두려면 false를 보내세요. |
| seo | object | 선택 | 검색 설정. { indexable, title, description, image }. indexable을 false로 두면 검색에서 빼고 사이트맵·llms.txt에도 싣지 않습니다(기본 true). title·description은 검색 결과와 공유 미리보기 문구, image는 공유 이미지의 https 주소입니다. 적은 항목은 HTML의 같은 태그보다 우선합니다. |
요청
curl -X POST "https://flzwoyvuujcgfnmurjdj.supabase.co/functions/v1/api/pages" \
-H "Authorization: Bearer $STATIX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"title": "이용약관",
"slug": "terms",
"content": "<h1>이용약관</h1><p>...</p>",
"published": true
}'응답 201
{
"data": {
"id": "3b2a1c9d-7e6f-4a5b-8c9d-0e1f2a3b4c5d",
"title": "이용약관",
"slug": "terms",
"published": true,
"view_count": 0,
"url": "https://mysubdomain.statix.kr/terms",
"created_at": "2026-08-23T04:22:10.339Z",
"updated_at": "2026-08-23T04:22:10.339Z"
}
}플랜 한도를 넘으면 429 limit_exceeded가 반환됩니다. Free는 20개, Pro는 1,000개까지 만들 수 있습니다.
/pages/{id}요청
curl "https://flzwoyvuujcgfnmurjdj.supabase.co/functions/v1/api/pages/3b2a1c9d-7e6f-4a5b-8c9d-0e1f2a3b4c5d" \
-H "Authorization: Bearer $STATIX_API_KEY"응답 200
{
"data": {
"id": "3b2a1c9d-7e6f-4a5b-8c9d-0e1f2a3b4c5d",
"title": "이용약관",
"slug": "terms",
"published": true,
"view_count": 42,
"url": "https://mysubdomain.statix.kr/terms",
"content": "<h1>이용약관</h1><p>...</p>",
"created_at": "2026-08-01T02:11:43.201Z",
"updated_at": "2026-08-12T09:30:02.118Z"
}
}목록(GET /pages)에는 content가 들어 있지 않습니다. 내용을 고치기 전에 이 엔드포인트로 현재 HTML을 먼저 읽으세요.
/pages/{id}요청 바디
| 이름 | 타입 | 필수 | 설명 |
|---|---|---|---|
| title | string | 선택 | 페이지 제목. |
| slug | string | 선택 | URL 경로. 바꾸면 기존 주소는 더 이상 열리지 않습니다. |
| content | string | 선택 | 페이지 HTML. 최대 500KB. 넘기면 저장된 내용을 덮어씁니다. 이전 내용은 보관하지 않습니다. |
| published | boolean | 선택 | 게시 여부. |
| seo | object | 선택 | 검색 설정. 보낸 항목만 바뀝니다. 항목을 지우려면 빈 문자열을 보내세요. 형식은 POST /pages와 같습니다. |
요청
curl -X PATCH "https://flzwoyvuujcgfnmurjdj.supabase.co/functions/v1/api/pages/3b2a1c9d-7e6f-4a5b-8c9d-0e1f2a3b4c5d" \
-H "Authorization: Bearer $STATIX_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "content": "<h1>이용약관</h1><p>개정판</p>" }'지우고 다시 만들지 마세요.
수정은 내용만 덮어쓰므로 페이지 ID와 URL, 조회수, 검색 설정이 그대로 유지됩니다. 삭제 후 재생성하면 ID가 바뀌고 조회 기록이 사라집니다. 이미 스토어 심사에 제출한 주소라면 특히 위험합니다. 이전 내용은 보관하지 않으니, 되돌릴 가능성이 있으면 고치기 전에 GET으로 받아 두세요.
/pages/{id}경로 파라미터
| 이름 | 타입 | 필수 | 설명 |
|---|---|---|---|
| id | uuid | 필수 | 삭제할 페이지 ID. 목록 조회 응답의 id 값입니다. |
요청
curl -X DELETE "https://flzwoyvuujcgfnmurjdj.supabase.co/functions/v1/api/pages/3b2a1c9d-7e6f-4a5b-8c9d-0e1f2a3b4c5d" \
-H "Authorization: Bearer $STATIX_API_KEY"응답 200
{
"data": {
"id": "3b2a1c9d-7e6f-4a5b-8c9d-0e1f2a3b4c5d",
"deleted": true
}
}/stats쿼리 파라미터
| 이름 | 타입 | 필수 | 설명 |
|---|---|---|---|
| days | number | 선택 | 기간. 7 · 30 · 90 · 365 중 하나. Free 플랜은 무엇을 보내도 7입니다. |
| limit | number | 선택 | 페이지별 목록에 실을 개수. 조회가 있는 페이지를 많이 본 순으로 싣습니다. 기본 20, 최대 100. |
| page | string | 선택 | 페이지 ID 또는 slug. 페이지별 목록과 크롤러 방문 기록을 그 페이지로 좁힙니다. |
응답 200
{
"data": {
"plan": "pro",
"days": 7,
"from": "2026-11-09",
"to": "2026-11-15",
"limited": false,
"daily": [{ "day": "2026-11-15", "views": 42, "botViews": 9 }],
"pages": [{ "id": "…", "title": "개인정보처리방침", "slug": "privacy", "views": 30, "botViews": 5 }],
"referrers": [{ "host": "direct", "views": 25 }, { "host": "chatgpt.com", "views": 4 }],
"bots": [{ "bot": "search:Googlebot", "hits": 5 }, { "bot": "ai:GPTBot", "hits": 3 }]
}
}views는 사람이 본 횟수입니다. 검색엔진·AI 크롤러와 링크 미리보기는 botViews와 bots에 따로 셉니다. 날짜는 한국 시간 기준입니다. Free 플랜은 limited: true이고 최근 7일의 views만 옵니다(referrers와 bots는 빈 배열).
에러
실패 응답은 항상 아래 형태입니다. code로 분기하세요. HTTP 상태 코드만 보고 판단하지 않아도 됩니다. message는 에이전트가 읽고 스스로 고칠 수 있도록 영어로 옵니다.
{
"error": {
"code": "insufficient_scope",
"message": "This request needs the pages:write scope.",
"requiredScope": "pages:write",
"grantedScopes": ["pages:read"]
}
}| code | HTTP | 의미 |
|---|---|---|
| unauthorized | 401 | Authorization 헤더가 없습니다. |
| invalid_api_key | 401 | 키가 존재하지 않거나, 만료 처리됐거나, 만료일이 지났습니다. |
| insufficient_scope | 403 | 이 요청에 필요한 스코프가 키에 없습니다. |
| validation_error | 400 | 요청 값이 올바르지 않습니다. |
| not_found | 404 | 대상을 찾을 수 없습니다. |
| conflict | 409 | 이미 사용 중인 slug입니다. |
| limit_exceeded | 429 | 플랜별 페이지 생성 한도에 도달했습니다. |
| method_not_allowed | 405 | 해당 경로가 지원하지 않는 메서드입니다. |
| internal_error | 500 | 서버 오류입니다. |
JavaScript 예제
Node.js 18 이상이면 별도 패키지 없이 fetch로 호출할 수 있습니다.
const BASE_URL = "https://flzwoyvuujcgfnmurjdj.supabase.co/functions/v1/api";
const API_KEY = process.env.STATIX_API_KEY;
async function statix(path, init = {}) {
const response = await fetch(BASE_URL + path, {
...init,
headers: {
Authorization: `Bearer ${API_KEY}`,
"Content-Type": "application/json",
...init.headers,
},
});
const payload = await response.json();
if (!response.ok) {
throw new Error(`[${payload.error.code}] ${payload.error.message}`);
}
return payload;
}
// 목록 조회
const { data: pages } = await statix("/pages?limit=50");
// 생성
const { data: created } = await statix("/pages", {
method: "POST",
body: JSON.stringify({
title: "새 랜딩 페이지",
content: "<h1>안녕하세요</h1>",
published: true,
}),
});
console.log("생성됨:", created.url);
// 삭제
await statix(`/pages/${created.id}`, { method: "DELETE" });