Market Research
시장 트렌드, 경쟁사, 타겟 고객 종합 조사·분석 → 시장조사 보고서 자동 생성 DMAP 플러그인
개요
market-research 플러그인은 웹 검색 기반으로 시장 정보를 수집하고, SWOT 프레임워크로 종합 분석한 뒤, 구조화된 시장조사 보고서를 자동 생성합니다. 3개의 전문 에이전트(researcher, architect, writer)가 협업하여 정보 수집부터 보고서 작성까지 전 과정을 처리합니다.
주요 기능:
- 시장 트렌드, 경쟁사, 타겟 고객 정보 웹 검색 자동 수집
- SWOT 분석 및 교차 전략(SO/WO/ST/WT) 도출
- Mermaid 다이어그램 포함 마크다운 보고서 자동 생성
설치
사전 요구사항
플러그인 설치
방법 1: 마켓플레이스 — GitHub (권장)
# 1. GitHub 저장소를 마켓플레이스로 등록
claude plugin marketplace add {owner}/market-research
# 2. 플러그인 설치
claude plugin install market-research@{marketplace-name}
# 3. 설치 확인
claude plugin list
방법 2: 마켓플레이스 — 로컬
# 1. 로컬 경로를 마켓플레이스로 등록
claude plugin marketplace add ./market-research
# 2. 플러그인 설치
claude plugin install market-research@{marketplace-name}
# 3. 설치 확인
claude plugin list
방법 3: 로컬 경로 (세션 단위)
# 플러그인 디렉토리를 직접 지정하여 실행 (세션 종료 시 해제)
claude --plugin-dir ./market-research
설치 후 setup 스킬 실행:
/market-research:setup
- Brave Search MCP 서버 자동 설치
- CLAUDE.md에 라우팅 테이블 등록
- 적용 범위 선택 (모든 프로젝트 / 현재 프로젝트만)
업그레이드
Git Repository 마켓플레이스
저장소의 최신 커밋을 가져와 플러그인을 업데이트함.
# 마켓플레이스 업데이트 (최신 커밋 반영)
claude plugin marketplace update {marketplace-name}
# 플러그인 재설치
claude plugin install market-research@{marketplace-name}
# 설치 확인
claude plugin list
갱신이 반영되지 않는 경우: 플러그인을 삭제 후 재설치함.
claude plugin remove market-research@{marketplace-name}
claude plugin marketplace update {marketplace-name}
claude plugin install market-research@{marketplace-name}
로컬 마켓플레이스
로컬 경로의 파일을 직접 갱신한 뒤 마켓플레이스를 업데이트함.
# 1. 로컬 플러그인 소스 갱신
cd {plugin-source-path}
git pull origin main
# 2. 마켓플레이스 업데이트
claude plugin marketplace update {marketplace-name}
# 3. 플러그인 재설치
claude plugin install market-research@{marketplace-name}
setup 재실행: 업그레이드 후 gateway/install.yaml에 새 도구가 추가된 경우
/market-research:setup을 재실행하여 누락된 도구를 설치할 것.
사용법
슬래시 명령
| 명령 | 설명 |
|---|
/market-research:setup | 플러그인 초기 설정 (Brave Search MCP 설치) |
/market-research:research | 시장조사 실행 (전체 워크플로우) |
/market-research:help | 사용 가능한 명령 안내 |
자동 라우팅
다음과 같은 자연어 요청도 자동으로 처리됩니다:
- "시장조사 해줘", "시장 분석", "경쟁사 분석", "SWOT 분석" →
/market-research:research
- "market-research 설정" →
/market-research:setup
- "도움말", "뭘 할 수 있어" →
/market-research:help
사용 예시
사용자: 한국 전기차 충전 인프라 시장을 조사해줘
→ 플러그인이 시장 트렌드·경쟁사·타겟 고객 조사 → SWOT 분석 → 보고서 생성을 자동 수행
→ output/market-research-report.md에 최종 보고서 저장
시장조사 워크플로우
Phase 1: 조사 주제 설정 ──→ 사용자 입력 (시장/산업, 범위, 경쟁사 등)
Phase 2: 정보 수집 ──→ 시장 트렌드 + 경쟁사 + 타겟 고객 웹 검색
Phase 3: 종합 분석 ──→ SWOT 분석 + 교차 전략 + 권장사항
Phase 4: 보고서 생성 ──→ 마크다운 보고서 (Mermaid 다이어그램 포함)
Phase 5: 검증 및 완료 ──→ 보고서 품질 확인
에이전트 구성
| 에이전트 | 티어 | 역할 |
|---|
| researcher | MEDIUM | 웹 검색 기반 시장 정보 수집 전문가 |
| architect | HIGH | SWOT 프레임워크 종합 분석 전문가 |
| writer | MEDIUM | 시장조사 보고서 작성 전문가 |
요구사항
필수 도구
| 도구 | 유형 | 용도 |
|---|
| Brave Search MCP | MCP 서버 | 웹 검색 (시장 정보 수집) |
Brave Search API Key는 https://brave.com/search/api/ 에서 무료로 발급 가능합니다.
런타임 호환성
| 런타임 | 지원 |
|---|
| Claude Code | ✅ |
| Codex CLI | 미검증 |
| Gemini CLI | 미검증 |
디렉토리 구조
market-research/
├── .claude-plugin/
│ ├── plugin.json # 플러그인 매니페스트
│ └── marketplace.json # 마켓플레이스 매니페스트
├── skills/
│ ├── core/
│ │ └── SKILL.md # 핵심스킬: 의도 판별 및 라우팅
│ ├── setup/
│ │ └── SKILL.md # 설정스킬: Brave Search MCP 설치
│ ├── help/
│ │ └── SKILL.md # 유틸리티: 명령 안내
│ └── research/
│ └── SKILL.md # 지휘자스킬: 시장조사 오케스트레이션
├── agents/
│ ├── researcher/
│ │ ├── AGENT.md # 정보 수집 전문가
│ │ ├── agentcard.yaml
│ │ └── tools.yaml
│ ├── architect/
│ │ ├── AGENT.md # 종합 분석 전문가
│ │ ├── agentcard.yaml
│ │ └── tools.yaml
│ └── writer/
│ ├── AGENT.md # 보고서 작성 전문가
│ ├── agentcard.yaml
│ └── tools.yaml
├── gateway/
│ ├── install.yaml # 설치 매니페스트
│ ├── runtime-mapping.yaml # 추상→구체 매핑
│ └── mcp/
│ └── brave-search.json # Brave Search MCP 설정
├── commands/
│ ├── setup.md # /market-research:setup
│ ├── help.md # /market-research:help
│ └── research.md # /market-research:research
├── output/ # 산출물 디렉토리
└── README.md # 사용 가이드 (현재 파일)
라이선스
MIT License
lucas-flatwhite
MalekAG
miles990
wshobson
xrf9268-hue
JuliusBrussee