SEMrush 자동화
SEMrush SEO 분석을 Claude Code에서 직접 실행하세요. 터미널을 떠나지 않고 도메인 키워드 분석, 백링크 프로필 감사, 키워드 난이도 조사, 관련 용어 발견, 유기적 페이지 성능 추적이 가능합니다.
툴킷 문서: composio.dev/toolkits/semrush
설정
- Composio MCP 서버를 구성에 추가하십시오:
https://rube.app/mcp - 메시지가 표시되면 SEMrush 계정을 연결하십시오. 에이전트가 인증 링크를 제공합니다.
- 모든 SEMrush 툴에는 지역 데이터베이스를 지정하는
database매개변수가 필요합니다 (예:us,uk,de). 대상 지역에 맞는 올바른 지역을 선택하십시오.
핵심 워크플로
1. 도메인 유기적 키워드 분석
도메인에 대한 모든 유기적 검색 키워드를 검색합니다. 위치, 트래픽 추정치, CPC, 키워드 난이도를 포함합니다.
툴: SEMRUSH_DOMAIN_ORGANIC_SEARCH_KEYWORDS
주요 매개변수:
domain(필수) -- 예:example.comdatabase(필수) -- 지역 데이터베이스 코드 (예:us,uk,de)display_limit(기본값 10000) 및display_offset(기본값 0) -- 페이지네이션display_sort-- 위치, 트래픽, 볼륨 등으로 정렬 (예:tr_desc트래픽 내림차순)display_date-- 과거 데이터는YYYYMM15형식 (월별) 또는YYYYMMDD(일별)export_columns--Ph(구문),Po(위치),Nq(볼륨),Tr(트래픽),Kd(난이도) 등 열 지정display_filter-- 특정 열로 필터링
예시 프롬프트: "example.com의 US 데이터베이스에서 상위 100개 유기적 키워드를 트래픽 순으로 가져와"
2. 키워드 개요 및 일괄 분석
개별 키워드에 대한 상세 메트릭을 얻거나 한 번에 최대 100개 키워드를 분석합니다.
툴: SEMRUSH_KEYWORD_OVERVIEW_ONE_DATABASE, SEMRUSH_BATCH_KEYWORD_OVERVIEW
단일 키워드:
phrase(필수) -- 조사할 키워드database(필수) -- 지역 데이터베이스
일괄 (최대 100개 키워드):
phrase(필수) -- 세미콜론으로 구분된 키워드 (최대 255자)database(필수) -- 지역 데이터베이스export_columns--Ph(구문),Nq(볼륨),Cp(CPC),Co(경쟁도),Kd(난이도),In(의도)
예시 프롬프트: "US 데이터베이스에서 'seo services;content marketing;link building' 키워드 메트릭을 가져와"
3. 도메인 유기적 페이지 보고서
도메인에서 가장 많은 유기적 트래픽과 가시성을 제공하는 URL을 발견합니다.
툴: SEMRUSH_DOMAIN_ORGANIC_PAGES
주요 매개변수:
domain(필수) -- 대상 도메인database(필수) -- 지역 데이터베이스display_sort-- 예:pc_desc트래픽 점유율 내림차순display_limit및display_offset-- 페이지네이션export_columns--Ur(URL),Pc(트래픽 %),Tg(트래픽),Tr(트래픽 비용)
예시 프롬프트: "트래픽 점유율 기준으로 example.com의 상위 50개 유기적 페이지를 보여줘"
4. 백링크 프로필 개요
도메인의 백링크 요약 정보를 가져옵니다. 권위 점수(Ascore), 링크 유형, 참조 도메인 수를 포함합니다.
툴: SEMRUSH_BACKLINKS_OVERVIEW
주요 매개변수:
target(필수) -- 도메인, 서브도메인 또는 전체 URLtarget_type(필수) --root_domain,domain또는urlexport_columns--ascore(권위 점수),total(전체 백링크),domains_num(참조 도메인),follows_num,nofollows_num등
예시 프롬프트: "example.com의 백링크 개요를 권위 점수와 참조 도메인 수를 포함하여 가져와"
5. 키워드 난이도 평가
특정 키워드에 대해 상위 10위 내에 랭크하기 어려운 정도를 0-100 척도로 점수화합니다.
툴: SEMRUSH_KEYWORD_DIFFICULTY
주요 매개변수:
phrase(필수) -- 분석할 키워드database(필수) -- 지역 데이터베이스export_columns--Ph(구문),Kd(난이도 점수)
예시 프롬프트: "US에서 'best project management software'의 키워드 난이도는?"
6. 관련 키워드 발견
시드 키워드에 대한 동의어, 변형 및 관련 용어를 찾아 콘텐츠 전략을 확장합니다.
툴: SEMRUSH_RELATED_KEYWORDS
주요 매개변수:
phrase(필수) -- 시드 키워드database(필수) -- 지역 데이터베이스display_limit(기본값 10000) -- 최대 결과 수display_sort-- 예:nq_desc볼륨 내림차순,kd_asc가장 쉬운 순export_columns--Ph,Nq,Kd,Cp,Co,Rr(관련성 점수)
예시 프롬프트: "US에서 'project management'의 관련 키워드를 검색 볼륨 순으로 찾아줘"
알려진 문제점
- 페이지네이션 필수:
SEMRUSH_DOMAIN_ORGANIC_SEARCH_KEYWORDS및SEMRUSH_DOMAIN_ORGANIC_PAGES는 매우 큰 데이터셋을 반환할 수 있습니다. 항상display_limit과display_offset을 사용하고 단일 페이지가 완전하다고 가정하지 마십시오. - CSV 스타일 응답: 많은 SEMrush 툴이 단일 필드(예:
data/keyword_data)에 CSV 스타일 텍스트로 데이터를 반환합니다. 분석이나 보고서 결합 전에 반드시 행과 열을 파싱해야 합니다. - "ERROR 50 :: NOTHING FOUND": 이 문자열은 해당 데이터베이스에 도메인 또는 키워드 데이터가 없음을 의미합니다. 전송 오류가 아닌 유효한 0-결과 응답으로 처리하십시오.
- 배치 키워드 제한:
SEMRUSH_BATCH_KEYWORD_OVERVIEW는 문제가 있거나 너무 큰 배치(phrase필드 최대 255자)에 대해 HTTP 400을 반환할 수 있습니다. 배치를 줄이거나 개별 조회를 위해SEMRUSH_KEYWORD_OVERVIEW_ONE_DATABASE로 대체하십시오. - 날짜 형식: 과거 날짜는 월별 데이터에
YYYYMM15형식(예:20231015)을 사용해야 합니다. 잘못된 형식을 사용하면 예기치 않은 결과가 반환됩니다. - 지역 데이터베이스 중요: 항상 대상 지역에 맞는 올바른 지역 데이터베이스를 사용하십시오.
us와uk의 결과는 볼륨, CPC 및 순위에서 크게 다를 수 있습니다. - 열 코드: 내보내기 열은 짧은 코드(
Ph,Nq,Kd등)를 사용합니다. 트래픽, CPC, 위치 및 난이도와 같은 주요 메트릭이 유지되도록export_columns를 지나치게 좁히지 마십시오.
빠른 참조
| 툴 슬러그 | 설명 |
|---|---|
SEMRUSH_DOMAIN_ORGANIC_SEARCH_KEYWORDS | 도메인의 유기적 키워드 (위치 및 트래픽 포함) |
SEMRUSH_KEYWORD_OVERVIEW_ONE_DATABASE | 단일 키워드 메트릭 (볼륨, CPC, 난이도) |
SEMRUSH_BATCH_KEYWORD_OVERVIEW | 최대 100개 키워드의 배치 메트릭 |
SEMRUSH_DOMAIN_ORGANIC_PAGES | 도메인의 트래픽별 상위 유기적 페이지 |
SEMRUSH_BACKLINKS_OVERVIEW | 권위 점수를 포함한 백링크 프로필 요약 |
SEMRUSH_BACKLINKS | 대상의 상세 백링크 목록 |
SEMRUSH_KEYWORD_DIFFICULTY | 키워드 난이도 점수 (0-100) |
SEMRUSH_RELATED_KEYWORDS | 시드 구문의 관련/유사 키워드 |
SEMRUSH_CATEGORIES | 신뢰도 등급이 포함된 도메인 카테고리 |
SEMRUSH_DOMAIN_ORGANIC_SUBDOMAINS | 서브도메인 수준 유기적 순위 분석 |
Composio 제공