🌱 복붙 API & MCP

138만+ (목표 1,000만) 한국 가상 시드 회원 데이터를 REST와 MCP(Model Context Protocol)로 제공합니다. PII는 기본 마스킹되며, unmask=true 사용 시 Bearer 토큰이 필요합니다.

인증

Authorization: Bearer <SEEDKIT_API_TOKEN>   # 공개 REST
X-API-KEY: <EXTERNAL_API_KEY>               # 외부 트리거 · 헬스 · 내부 크론
# MCP는 별도 — OAuth 2.1 (아래 MCP 섹션 참고)

토큰은 프로젝트 시크릿 SEEDKIT_API_TOKEN / EXTERNAL_API_KEY 로 관리됩니다. 리포트 HTML은 위 토큰 대신 ?t= HMAC 리포트 토큰, 소유자 JWT, 공개 쇼케이스 여부로 접근 제어합니다.

REST 엔드포인트 · 데이터 조회

REST 엔드포인트 · 생성 · 배치

REST 엔드포인트 · 리포트 · 외부 연동

내부 전용(운영·크론): /cron-cleanup-stuck, /admin-cleanup-stuck, /retry-rejected-personas, /simulation-demo — 스펙에 x-internal: true 로 표시되며 외부 파트너 대상이 아닙니다.

사람이 읽는 개요·과금·연동 시작 안내는 /developers 에 있습니다.

예시 · 데이터/배치

curl https://bokput.io/api/public/v1/stats/summary

curl -H "Authorization: Bearer $TOKEN" \
  "https://bokput.io/api/public/v1/members?limit=10&region=11"

curl -X POST -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"label":"api-batch","targetCount":1000}' \
  https://bokput.io/api/public/v1/batches

예시 · 리포트 · 외부 트리거

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

# 외부 상품 등록 → 조사 트리거 (완료 시 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}'

예시 · MCP

# 툴 목록
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}}}

# 댓글 생성 (1회 20건, 초과분은 예약)
{"jsonrpc":"2.0","id":3,"method":"tools/call",
 "params":{"name":"community_comments_generate","arguments":{"post_id":"<uuid>","count":20}}}

MCP (Streamable HTTP)

MCP 클라이언트(Claude, Cursor 등)에서 다음 URL을 등록하세요:

https://bokput.io/mcp
Accept: application/json, text/event-stream

인증은 OAuth 2.1(동적 클라이언트 등록)입니다. 클라이언트가 자동 등록되고 브라우저 동의 화면에서 로그인하면 해당 계정 권한으로 툴이 실행됩니다. REST 전용 SEEDKIT_API_TOKEN 은 MCP에 사용하지 않습니다.

등록된 tools는 29종이며 4갈래로 나뉩니다. 전체 인자·권한은 tools/list 응답 스키마가 정본입니다.

시드킷 (10)

• generate_personas — 페르소나 배치 생성
• get_occupation_list — 직업 목록 조회 (읽기 전용)
• get_batch_stats — 배치 통계 (읽기 전용)
• export_personas — 페르소나 내보내기 (읽기 전용)
• seedkit_stats_summary — 시드 회원 통계 요약 (읽기 전용)
• seedkit_members_search — 시드 회원 검색 (읽기 전용)
• seedkit_members_get — 시드 회원 상세 (읽기 전용)
• seedkit_batches_list — 시드 배치 목록 (읽기 전용)
• seedkit_batches_create — 시드 배치 생성
• seedkit_batches_generate_chunk — 시드 배치 청크 생성

임대 (7)

• lease_tenant_get — 임대 테넌트 조회 (읽기 전용)
• lease_status — 임대 상태·쿼터 조회 (읽기 전용)
• lease_alerts_list — 실패·스킵 알림 조회 (읽기 전용)
• lease_personas_list — 임대 페르소나 목록 (읽기 전용)
• lease_persona_get — 임대 페르소나 상세 (읽기 전용)
• lease_seats_allocate — 좌석 배정
• lease_seats_release — 좌석 해제

커뮤니티 (8)

• community_post_create — 커뮤니티 글 등록
• community_post_update — 커뮤니티 글 수정·숨김
• community_posts_list — 커뮤니티 글 목록 (읽기 전용)
• community_comments_generate — 페르소나 댓글·품평 생성
• community_comments_list — 댓글 목록 (읽기 전용)
• community_comment_moderate — 댓글 숨김·복구
• community_sentiment_summary — 반응 요약 (읽기 전용)
• community_embed_config — 임베드 설정 조회 (읽기 전용)

서사·음성 (4)

• generate_narratives — 페르소나 서사 생성
• get_narratives — 생성된 서사 조회 (읽기 전용)
• synthesize_speech — 음성합성 (TTS)
• list_synth_voices — 음성합성 보이스 목록 (읽기 전용)