개발자 · API & MCP 연동

과금 단위

사용량 기반이 아니라 자산 단위로 계약합니다.

인증

경로에 따라 인증 방식이 다릅니다. REST 토큰은 MCP에 사용하지 않습니다.

Authorization: Bearer <SEEDKIT_API_TOKEN>   # 공개 REST
X-API-KEY: <EXTERNAL_API_KEY>               # 외부 트리거 · 헬스
MCP  https://bokput.io/mcp                  # OAuth 2.1 (동적 클라이언트 등록 + 동의 화면)

REST 예시

서버-서버 연동용. 응답은 모두 JSON(리포트는 HTML)입니다.

# 1) 코퍼스 규모 확인 (인증 없음)
curl https://bokput.io/api/public/v1/stats/summary

# 2) 페르소나 조회 (마스킹)
curl -H "Authorization: Bearer $SEEDKIT_API_TOKEN" \
  "https://bokput.io/api/public/v1/members?limit=10&region=11"

# 3) 외부 상품 등록 → 조사 트리거 (완료 시 callback_url 로 POST)
curl -X POST https://bokput.io/api/public/v1/external-simulate-trigger \
  -H "X-API-KEY: $EXTERNAL_API_KEY" -H "Content-Type: application/json" \
  -d '{"product_name":"수분 크림","category":"beauty",
       "external_source":"partner-shop","external_ref_id":"SKU-1001",
       "callback_url":"https://partner.example.com/hooks/bokput","panel_size":100}'

# 4) 리포트 HTML (HMAC 토큰)
curl "https://bokput.io/api/public/v1/simulation-report/<id>?t=<report_token>"

MCP 예시

Claude·Cursor 등 MCP 클라이언트에 URL만 등록하면 툴 29종(시드킷 10 · 임대 7 · 커뮤니티 8 · 서사·음성 4)이 노출됩니다.

# 툴 목록
curl -X POST https://bokput.io/mcp \
  -H "authorization: Bearer <OAUTH_ACCESS_TOKEN>" \
  -H "content-type: application/json" \
  -H "accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# 좌석 배정 (임대)
{"jsonrpc":"2.0","id":2,"method":"tools/call",
 "params":{"name":"lease_seats_allocate",
           "arguments":{"count":50,"category_code":"beauty","gender":"female","age_min":25,"age_max":39}}}

# 댓글 생성 → 요약
{"jsonrpc":"2.0","id":3,"method":"tools/call",
 "params":{"name":"community_comments_generate","arguments":{"post_id":"<uuid>","count":20}}}

지켜야 하는 제약

• 페르소나 연령 19~50세 하드컷 (코드 + DB 트리거 이중 방어).
• 좌석 상한 초과 배정 불가, 같은 페르소나가 한 글에 두 번 댓글 금지.
• 댓글 중복 3중 차단(본문 해시 · 정규화 동일 · 3-gram 유사도 0.8+).
• 품질 게이트: 30~180자, 광고 문구·전문가 훈수·통계 날조·반복 붕괴 차단.
• 생성된 댓글·후기는 파트너 화면에서 “합성 소비자 패널 의견”으로 표기.

Try-it · 브라우저에서 바로 호출

콘솔에서 발급한 REST 토큰이 이 브라우저에 저장돼 있으면 자동으로 채워집니다. 인증 없는 엔드포인트는 토큰 없이도 실행됩니다.

아직 실행하지 않았습니다. 실행 버튼을 눌러 실제 엔드포인트를 호출해보세요.

언어별 예시 코드

cURL · JavaScript · Python · TypeScript 로 복사하거나 파일로 다운로드할 수 있습니다.

curl -X GET "https://bokput.io/api/public/v1/stats/summary"

curl -X GET "https://bokput.io/api/public/v1/members?limit=5&region=11" \
  -H "authorization: Bearer $SEEDKIT_API_TOKEN"

curl -X GET "https://bokput.io/api/public/v1/members/1" \
  -H "authorization: Bearer $SEEDKIT_API_TOKEN"

curl -X GET "https://bokput.io/api/public/v1/occupations"

curl -X POST https://bokput.io/mcp \
  -H "authorization: Bearer <OAUTH_ACCESS_TOKEN>" \
  -H "content-type: application/json" \
  -H "accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

curl -X POST https://bokput.io/mcp \
  -H "authorization: Bearer <OAUTH_ACCESS_TOKEN>" \
  -H "content-type: application/json" \
  -H "accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"lease_seats_allocate","arguments":{"count":50,"category_code":"beauty","gender":"female","age_min":25,"age_max":39}}}'

curl -X POST https://bokput.io/mcp \
  -H "authorization: Bearer <OAUTH_ACCESS_TOKEN>" \
  -H "content-type: application/json" \
  -H "accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"community_comments_generate","arguments":{"post_id":"00000000-0000-0000-0000-000000000000","count":20}}}'

API 버전 · 변경이력

호환성에 영향을 주는 변경은 이 목록에 먼저 기록됩니다.