TOOLS

MCP 도구

Claude 등 AI 에이전트가 Clever Insight 데이터를 직접 활용할 수 있는 MCP 인터페이스입니다.

데이터 범위 안내

시세·수급 원본 데이터는 제공하지 않으며 자체 산출 지표만 제공합니다. 모든 응답은 공개 자료 기반 사실 요약이며 투자 판단·권유가 아닙니다.

제공 도구 (무료 6종)

도구명	설명	주요 파생값
search_stocks	종목 코드·이름·시장·섹터 상위 10개 검색	code, name, market, sector
get_rankings	수익률·밸류·수급 등 6가지 관점 상위 20개 종목 파생 순위	chg_pct, ret_1d/5d/20d, per, pbr, inst_1d, forgn_1d
get_themes	자체 산출 테마 강도 상위 20개	id, name, score(자체 강도 지수), members
get_market_snapshot	시장 종합 상태 — 공포탐욕·종합점수·브레드스	score(종합점수), fg(공포탐욕), breadth(상승비율), subs
get_briefing	시황 브리핑 무료 블록 조회 (slot, date 지정)	headline, figures(파생 집계값), blocks(free 티어만)
get_track_record	자체 전략 실적 요약 및 백테스트 지표	summary, backtest(CAGR·MDD·PF 등 자체 산출)

모든 응답에 asof, source, disclaimer 공통 필드가 포함됩니다.

연결 방법

엔드포인트

https://mcp.clever-insight.vip

프로토콜: Streamable HTTP (MCP SDK 호환)

인증 헤더

Authorization: Bearer <API 키>

Claude Desktop 설정 예시

{
  "mcpServers": {
    "clever-insight": {
      "url": "https://mcp.clever-insight.vip",
      "headers": { "Authorization": "Bearer <API 키>" }
    }
  }
}

사용 한도

유형	한도	초과 시
분당 요청 수 (슬라이딩 윈도)	10 req/분	HTTP 429
일 요청 수 (자정 초기화)	1,000 req/일	HTTP 429
활성 키 최대 수	3개	발급 불가

API 키 발급

로그인 후 /me/api-keys/에서 무료로 발급할 수 있습니다. 최대 3개 활성 키를 관리할 수 있습니다.

API 키 발급하기

본 API는 공개 자료의 사실 요약 데이터를 제공하며 투자 판단·권유가 아닙니다. 시세·수급 원본 데이터는 제공하지 않습니다.