Agent Skill (AI 에이전트)

SKILL.md 파일 1장으로 Hermes Agent · Claude Code 등 AI 에이전트에 Veacon 데이터 연결. 빌드 없이 REST 직접 호출.

Last updated: 2026-06-12

AI 에이전트가 Veacon API 를 호출하도록 가르치는 스킬 파일 1장을 제공합니다. SKILL.md 개방형 표준을 따르는 에이전트라면 동일하게 작동합니다. Hermes Agent 와 Claude Code 가 대표적입니다.

MCP 서버와 무엇이 다른가

Claude · MCP 서버와 같은 데이터를 다른 방식으로 연결합니다.

	Agent Skill	MCP 서버
대상	SKILL.md 표준 에이전트 (Hermes Agent, Claude Code)	MCP 클라이언트 (Claude Desktop, Continue, Cline)
설치	마크다운 파일 1장 복사	Node 18+ 빌드 + stdio config (alpha)
동작	에이전트가 REST API 직접 호출	전용 server 프로세스가 tool 노출
API key	`VEACON_API_KEY` env	`VEACON_API_KEY` env (동일)
Quota	플랜 quota 동일 차감	동일

두 경로 모두 같은 API, 같은 키, 같은 quota 를 씁니다. Claude Desktop 을 쓴다면 MCP 서버, 그 외 에이전트라면 Agent Skill 이 빠른 길입니다.

스킬 파일 최신 버전은 항상 다음 URL 에서 서빙됩니다:

https://veacon.io/skills/veacon/SKILL.md

bash

mkdir -p ~/.hermes/skills/veacon
curl -o ~/.hermes/skills/veacon/SKILL.md https://veacon.io/skills/veacon/SKILL.md

프로젝트 단위로 쓰려면 프로젝트 루트의 skills/veacon/ 에 동일하게 받습니다.

bash

mkdir -p ~/.claude/skills/veacon
curl -o ~/.claude/skills/veacon/SKILL.md https://veacon.io/skills/veacon/SKILL.md

특정 저장소에서만 쓰려면 그 저장소의 .claude/skills/veacon/ 에 받습니다.

에이전트 실행 환경에 환경변수로 주입합니다. 스킬 파일 안에 키를 적지 마세요. 스킬 파일은 팀원과 공유될 수 있습니다.

bash

export VEACON_API_KEY="veacon_pk_live_..."

발급: veacon.io/dashboard (무료 Starter 월 10,000 콜). 키 형식과 보안 수칙은 Authentication 참고.

스킬이 설치된 에이전트에 그냥 질문하면 됩니다:

text

강남 office 매매 최근 12개월 분포 알려줘. 표본 수와 신뢰도도.

서울 도심권 office cap rate 최근 8분기 추이.

11680 office 30평 250억이면 적정해?

Veacon 이 어떤 데이터 커버해?

에이전트가 pulse / series / indices / coverage / appraise 엔드포인트를 알아서 선택해 호출하고, 중앙값·표본 수·신뢰도와 인용 가능한 출처 표기까지 포함해 답합니다.

에이전트는 질의 1건에 API 1~3 콜을 사용합니다. 무절제한 호출을 막는 규율이 스킬 파일에 내장되어 있습니다: