인식 구조 API

검색어를 의도별 군집으로 묶은 소비자 인식 구조

APIListeningMind.AI에서 바로 쓰기

무엇을 하나요

검색어를 의도별 군집으로 묶은 소비자 인식 구조

카테고리를 고객 관점의 하위 주제로 나눌 때

사용 샘플

요청

curl -X POST https://daas.listeningmind.ai/v1/cluster_finder \
  -H 'Authorization: Bearer $LM_KEY' -H 'Content-Type: application/json' \
  -d '{"keyword": "제습기", "limit": 500, "market": "kr"}'

응답 (실제 샘플, 앞부분) · 2026-10-02

{
 "id": "ex-cluster_finder-kr",
 "tool": "cluster_finder",
 "market": "kr",
 "status": "done",
 "mode": "sample",
 "as_of": "2026-10-02",
 "epistemic": "OBSERVED",
 "clusters": [
  {
   "name": "제습기 군집 0",
   "keywords": [
    "제습기",
    "제습기 뜻",
    "제습기 사람있을때",
    "제습기 디시",
    "제습기 사용법",
    "겨울 제습기",
    "제습기 추천",
    "제습기 위치"
   ]
  },
  {
   "name": "제습기 군집 1",
   "keywords": [
    "제습기 원리",
    "제습기 효과",
    "제습기 대용",
    "제습기 장단점",
    "제습기 영어로",
    "제습기 와트",
    "제습기 원리 디시",
    "제습기 능력"
   ]
  },
  {
   "name": "제습기 군집 2",
   "keywords": [
    "제습기 가격",
    "가정용 제습기 가격",
    "삼성 제습기 가격",
    "lg 제습기 가격",
    "미니 제습기 가격",
    "제습기 가격 추천",
    "위닉스 제습기 가격",
    "제습기 렌탈 가격"
   ]
  },
  {
   "name": "위닉스 제습기 군집 0",
   "keywords": [
    "위닉스 제습기",
    "위닉스 제습기 인버터",
    "위닉스 제습기 추천",
    "위닉스 제습기 디시",
    "위닉스 제습기 자동 제습",
    "위닉스 제습기 12l",
    "위닉스 뽀송 20l",
    "위닉스 뽀송 12l 소음"
   ]
  },
  {
   "name": "위닉스 제습기 군집 1",
   "keywords": [
    "위닉스 제습기 16리터",
    "위닉스 뽀송 16l",
    "위닉스 뽀송 제습기 16l 디시",
    "위닉스 제습기 앱",
    "위닉스 제습기 비교",
    "위닉스 제습기 20리터",
    "위닉스 제습기 12리터 후기",
    "winix logo"
   ]
  },
  {
   "name": "위닉스 제습기 군집 2",
   "keywords": [
    "위닉스 15리터",
    "위닉스 제습기 리터",
    "위닉스 제습기 크기",
    "위닉스 제습기 12",
    "위닉스 6리터 제습기",
    "제습기 설명서",
    "위닉스 제습기 시간",
    "위닉스 자동 제습 습도"
   ]
  }
 ],
 "cost_detail": {
  "total_cost": 0,
  "unit": "lima",
  "would_cost": 183,
  "note": "Saved sample. No Lima was used."
 },
 "provenance": {
  "system": "Intent KG",
  "run_id": "751bfe44f8b1",
  "collected": "2026-10-02",
  "sources": [
   "naver",
   "google"
  ]
 },
 "untrusted_content": false
}

연결하기

Claude

설정 → 커넥터 → 사용자 지정 커넥터 추가에 주소를 넣습니다.

https://daas.listeningmind.ai/mcp

ChatGPT

GPT 만들기 → 작업(Actions) → OpenAPI 스키마 가져오기.

https://daas.listeningmind.ai/openapi.json

Cursor · Claude Code

mcp.json에 서버를 추가합니다.

https://daas.listeningmind.ai/mcp

REST

Authorization: Bearer 키로 부릅니다.

https://daas.listeningmind.ai/v1

권한과 안전

범위검색 데이터 조회와 분석 실행. 외부 시스템을 바꾸지 않습니다.
비용부르기 전에 값을 확인할 수 있고(estimate_cost), max_lima를 넘는 호출은 실행하지 않습니다.
사람 승인키 발급과 월 한도는 사람이 승인합니다. 개별 호출은 승인 없이 한도 안에서 실행됩니다.

사는 방법

사람이 살 때

리마를 충전해 두고 쓴 만큼 차감합니다(1리마 = 100원, 1리마 단위). 지금은 충전을 상담으로 받습니다. 충전 상담 · m-support@listeningmind.com

에이전트가 살 때

에이전트는 POST /v1/keys/request로 키를 요청하고, POST /v1/estimate_cost로 값을 확인한 뒤 POST /v1/cluster_finder를 부릅니다.

평가 ·

    아직 평가가 없습니다.

    평가할 수 있는 사람: 내 이메일로 받은 API 키로 데이터를 쓴 회원. 이름은 첫 글자만 보입니다. 다시 남기면 앞의 평가를 바꿉니다.

    자주 묻는 질문

    인식 구조 API는 무엇인가요?

    검색어를 의도별 군집으로 묶은 소비자 인식 구조.

    요금은 얼마인가요?

    호출당 2리마 + 군집 속 키워드 1,000개당 650리마.

    어떻게 시작하나요?

    키는 바로 발급되고 매달 무료 한도가 있으며, 샘플 호출은 무료입니다.