TL;DR

同花顺 공식 A주 금융 데이터 서비스는 REST API, MCP, Node.js CLI, Python SDK와 Agent Skill을 한 레포지토리에서 통합 제공하며 단일 API Key로 모든 인터페이스를 호출하도록 구성되어 있습니다. marketdb는 DuckDB 기반의 로컬 증분 동기화와 전/후 복권 뷰를 제공하여 대규모 백필과 연구용 SQL 분석을 로컬에서 빠르게 수행하게 합니다. 에이전트 통합을 위해 Skill과 MCP 엔드포인트 템플릿을 제공하므로 Claude·Cursor 같은 MCP 호환 클라이언트에 빠르게 연결할 수 있습니다. 분·tick·해외·거시·뉴스 원문은 공개 범위에 포함되지 않으므로 요구사항에 맞는 데이터 범위를 먼저 확인해야 합니다.

핵심 포인트

• 공식 제공 소스로서 A주 전용 데이터와 동화순 특화 지표(涨停池·连板·龙虎榜 등)를 통합해 단일 계약으로 접근할 수 있도록 구성되어 있습니다. 이 통합은 동일한 필드 계약과 문서 중심의 governance를 통해 API·Skill·CLI 간 불일치를 줄이도록 설계되어 있습니다. 개발자 관점에서 표준화된 필드와 예제·샘플 코드가 풍부해 실제 도입 장벽을 낮춥니다.
• Agent Skill과 MCP 엔드포인트를 통해 Claude·Cursor·Windsurf 등 MCP 호환 클라이언트에 빠르게 연결할 수 있으며, Skill은 환경 감지와 대용량 결과 낙하 규칙을 내장해 에이전트의 안전한 운영을 돕습니다. 이로 인해 에이전트가 직접 인증을 노출하지 않고도 대화형 데이터 접근을 수행하도록 지원합니다. MCP 접속 정보 예시가 README에 포함되어 있어 설정이 직관적입니다.
• marketdb(DuckDB)와 CLI를 통한 로컬 증분 동기화·SQL 뷰 지원으로 연구자가 대량의 역사 데이터를 로컬 환경에서 빠르게 분석할 수 있게 구성되어 있습니다. CLI의 안정적 JSON 출력과 파일 낙하 옵션은 자동화 파이프라인과 에이전트 워크플로우에서 재현 가능한 데이터 입출력을 보장합니다. 연구·백테스트 환경에서 데이터 일관성과 성능을 동시에 확보하는 데 실용적입니다.
• 동일한 API Key로 REST API, MCP, CLI와 Python SDK에 모두 접근할 수 있도록 통합된 인증 체계를 제공하며, 이를 통해 에이전트와 애플리케이션에서 자격 증명을 일관되게 재사용할 수 있습니다. 인증은 CLI의 auth login, 환경변수, stdin 등 안전한 입력 경로를 권장하며 키를 코드나 로그에 남기지 않도록 설계되어 있습니다. 이 통합 방식은 운영 환경에서 인증 관리와 권한 분리를 단순화합니다.

이미지 분석