Claude, Cursor 같은 AI 어시스턴트를 Semrush API와 직접 연결해 실시간 SEO 분석을 수행하는 MCP 서버 및 CLI 도구
중간맛 분석
스택: Node.js 18+, vanilla JavaScript(트랜스파일 없음), @modelcontextprotocol/, zod
난이도: 1/5 (설치) ~ 3/5 (커스터마이징)
바로 쓸 수 있는가: 예. Semrush 유료 구독과 키만 있으면 즉시 사용 가능
데모: Claude Desktop나 Cursor에 연결 후 "example.com의 SEO 개요를 분석해줘", "마케팅 관련 로우 디피컬티 키워드 20개 찾아줘" 같은 자연언어 질문으로 18개 도구(키워드 리서치, 백링크 분석, 경쟁사 분석, SERP 스냅샷 등)를 활용할 수 있습니다. 로는 semrush-ai domain example.com --organic -l 30 같은 명령어로 터미널에서 직접 실행 가능.
이런 레포예요
이럴 때 쓰면 좋아요
- AI 어시스턴트에게 자연언어로 경쟁 도메인 대비 키워드 갭을 분석하게 하고 타겟팅 전략 수립
- 마케팅팀이 Claude나 Cursor를 통해 100개 키워드의 디피컬티를 한 번에 채점받은 뒤 우선순위 결정
- 개발자가 AI 코딩 에이전트(Claude Code)에게 Semrush 데이터를 기반으로 SEO 개선 스크립트나 보고서 자동화 생성
핵심 기능
대안 대비 차별점
공식 Semrush MCP 대비 자체 호스팅되어 API 키가 로컬에 남아있고, 별도 빌드 없이 즉시 설치 가능하며, 개발자가 아닌 사용자도 따라 할 수 있는 명확한 단계별 설명이 제공됩니다.
먹어본 사람들
실제로 차려 먹어본 손님들의 흔적이에요 — 한마디와 완주 인증 모두 검수 후 공개돼요.
이 레포, 해먹는 법
처음 오셨어요? 어렵지 않아요 — 위에서 아래로 따라 하면 내 컴퓨터에 이 레포를 차려서 바로 맛볼 수 있어요.
준비물
- Node.js 18 이상
- Semrush 유료 구독 또는 API 유닛 구매
- Semrush API 키
바로 차려먹기Node.js (npm)
깃밥이 레포 구조를 확인하고 만든 실행 명령이에요. 터미널에 붙여넣으면 받기부터 실행까지 한 번에 진행돼요.
git clone --depth 1 https://github.com/springvoiceswell/semrush-ai-tool.git && cd semrush-ai-tool && npm install && npm run start
코드는 내 컴퓨터에서 실행돼요 — 처음 보는 레포라면 내용을 한번 훑어보고 실행하는 습관을 추천해요.
README가 안내하는 자세한 단계 보기
- Node.js 18+ 설치 (없으면 nvm으로 설치)
nvm install --lts
- 도구 설치
mkdir -p semrushai && cd semrushai && npm install github:springvoiceswell/semrush-ai-tool
- Semrush API 키 환경 변수 설정 (Semrush 계정에서 API 탭에서 키 복사)
echo 'export SEMRUSH_API_KEY="your_api_key_here"' >> ~/.zshrc && source ~/.zshrc
- 설정 확인
npx semrush-ai-tool units
- Claude Desktop 연결 (MCP 설정) —
~/Library/Application Support/Claude/claude_desktop_config.json생성/편집:
{
"mcpServers": {
"semrush-ai-tool": {
"command": "npx",
"args": ["-y", "github:springvoiceswell/semrush-ai-tool"],
"env": {
"SEMRUSH_API_KEY": "your_api_key_here"
}
}
}
}
- Claude Desktop 재시작 후 사용 가능 (자연언어로 SEO 분석 질의)
깃밥트라이로 맛보기
받아보기 귀찮고 살짝 불안했다면 — 안전 스캔부터 설치까지 터미널 한 줄로 끝나요.
터미널에 붙여넣으면 깃밥 안전 스캔 → 격리 폴더 clone → 설치 → 실행법 안내까지 자동이에요. 처음이어도 괜찮아요 — 이 한 줄이 전부예요.
npx gitbap-try springvoiceswell/semrush-ai-tool
Node.js만 있으면 설치 없이 실행돼요 · 깃밥트라이가 뭐예요? →
별 추이 · 7일
확인 시각
활용성 · 따라 만들기 좋은가
- 관대한 라이선스
- 테스트 있음
- 예제 디렉토리
- 최근 활동
- AGENTS.md
- llms.txt
- 템플릿
🟢 최근 활동 있음 · 2026년 생성
「마케팅·그로스」 이런 레포, 매주 받아보실래요?
매주 월요일 아침, 골라 담은 밥상만. 광고 없이 · 언제든 해지.
내 레포인가요? README에 깃밥 배지 달기
[](https://www.gitbap.com/r/springvoiceswell/semrush-ai-tool)🔌 클로드에서 바로 써보기 — 깃밥 연결하는 법
깃밥을 클로드에 연결하면 이런 레포를 클로드·커서·Codex에서 바로 찾고 체험할 수 있어요.
클로드 설정 → 커넥터에 이 주소를 붙여넣기.
https://www.gitbap.com/api/mcp플러그인을 설치하면 /gitbap-trending·/gitbap-try 슬래시 커맨드로 레포를 그 자리에서 체험. Claude Code에서 아래 두 줄을 차례로 실행하세요.
/plugin marketplace add jakeparkcolde/gitbap-cowork/plugin install gitbap-cowork@gitbapAI가 README 기반으로 요약했습니다 · 원문 보기