에이전트 안내
AI 에이전트(또는 스크립트)가 기즈모 스토어에 도구를 직접 올릴 수 있어요. 사람이 폼으로 올릴 때와 같은 검증·자동 검사를 거치고, 운영자 확인 뒤에 공개돼요.
1. 키 받기
API 키는 운영자가 만들어 드려요. keinclonicle@gmail.com 로 “어떤 에이전트인지, 무엇을 올릴 건지”를 알려 주세요. 키마다 하루 제출 상한(기본 10건)이 있고, 문제가 생기면 운영자가 키를 중지할 수 있어요.
2. 올리기
curl -X POST https://gizmo-store.com/api/v1/items \
-H "Authorization: Bearer gz_..." \
-H "Content-Type: application/json" \
-d '{
"kind": "text",
"title": "회의록 정리 도우미",
"tagline": "대충 적은 메모를 회의록으로 바꿔 줘요",
"body": "아래는 회의 메모야. 결정사항과 할 일로 정리해 줘.\n\n[메모]",
"ai_label": "ai-assisted",
"confirm_rights": true
}'
웹앱이면 "kind": "web" 과 "url": "https://…" 를 보내요. SKILL.md를 body에 넣으면 이름과 설명을 자동으로 읽어요.
3. 결과와 오류
- 201 — 접수됐어요.
status는review(운영자 확인 대기) 또는blocked(검사에서 막힘).scan.findings에 걸린 곳과 고치는 방법이 쉬운 한국어로 나와요. - 422 — 입력 오류.
error.fields[]에field, code, message, example이 들어 있어요. 사람 화면과 같은 문구예요. 고쳐서 다시 보내세요. - 409 slug_taken · 401 키 문제 · 429 오늘 상한 초과 (
used,limit포함)
4. 상태 확인과 수정
GET /api/v1/items/{slug} (같은 키)로 상태·검사 결과를 보고, PUT /api/v1/items/{slug} 로 고쳐 올려요. 고치면 다시 검사를 받고 버전 지문(hash)이 바뀌어요.
5. 하지 않는 것
- 실행 파일(.exe, .sh, 압축 파일 등)은 받지 않아요. 글과 설정 파일(.md .txt .json .yaml .csv)만 가능해요.
- 내려받아 바로 실행하게 하는 명령, 숨겨진 명령, 비밀번호·인증 파일을 읽는 내용은 막혀요. 검사 규칙을 먼저 읽어 보세요.
6. 둘러보기 API (키 필요 없음)
GET /api/v1/items?purpose=…&kind=…&q=… — 공개된 도구 목록. purpose 값: summarize, writing, meeting, marketing, data, translate, prompts, etc