Ahrefs 자동화
Claude Code에서 바로 Ahrefs SEO 분석을 실행하세요. 백링크 프로필을 분석하고, 키워드를 연구하며, 시간 경과에 따른 도메인 권위를 추적하고, 유기적 키워드 순위를 감사하며, 터미널을 떠나지 않고 여러 URL을 배치 분석할 수 있습니다.
툴킷 문서: composio.dev/toolkits/ahrefs
설정
- Composio MCP 서버를 설정에 추가하세요:
https://rube.app/mcp - 메시지가 표시되면 Ahrefs 계정을 연결하세요. 에이전트가 인증 링크를 제공합니다.
- 대부분의 도구는
target(도메인 또는 URL)과country코드 (ISO 3166-1 alpha-2)가 필요합니다. 일부는YYYY-MM-DD형식의date도 필요합니다.
핵심 워크플로우
1. 사이트 탐색기 지표
도메인의 포괄적인 SEO 지표를 검색합니다. 백링크 수, 참조 도메인, 유기적 키워드 순위 및 트래픽 추정치를 포함합니다.
도구: AHREFS_RETRIEVE_SITE_EXPLORER_METRICS
주요 매개변수:
target(필수) -- 분석할 도메인 또는 URLdate(필수) --YYYY-MM-DD형식의 지표 날짜country-- ISO 국가 코드 (예:us,gb,de)mode-- 범위:exact,prefix,domain또는subdomains(기본값)protocol--both,http또는httpsvolume_mode--monthly또는average
예시 프롬프트: "example.com의 오늘 기준 미국 Ahrefs 사이트 지표를 가져와줘"
2. 과거 지표 추적
트렌드 분석 및 경쟁사 벤치마킹을 위해 도메인의 SEO 지표가 시간에 따라 어떻게 변했는지 추적합니다.
도구: AHREFS_RETRIEVE_SITE_EXPLORER_METRICS_HISTORY, AHREFS_DOMAIN_RATING_HISTORY
전체 지표 이력:
target(필수) -- 추적할 도메인date_from(필수) --YYYY-MM-DD형식의 시작 날짜date_to-- 종료 날짜history_grouping--daily,weekly또는monthly(기본값)select--date,org_cost,org_traffic,paid_cost,paid_traffic등의 열
도메인 평판(DR) 이력:
target(필수),date_from(필수),date_to,history_grouping
예시 프롬프트: "지난 1년간 example.com의 월별 도메인 평판 이력을 보여줘"
3. 백링크 분석
소스 URL, 앵커 텍스트, 링크 속성 및 참조 도메인 지표를 포함한 포괄적인 백링크 목록을 검색합니다.
도구: AHREFS_FETCH_ALL_BACKLINKS
주요 매개변수:
target(필수) -- 도메인 또는 URLselect(필수) -- 쉼표로 구분된 열 (예:url_from,url_to,anchor,domain_rating_source,first_seen_link)limit(기본값 1000) -- 결과 수aggregation--similar_links(기본값),1_per_domain또는allmode--exact,prefix,domain또는subdomainshistory--live,since:YYYY-MM-DD또는all_timewhere--is_dofollow,domain_rating_source,anchor등 열에 대한 고급 필터 표현식
예시 프롬프트: "example.com에 대한 상위 100개의 dofollow 백링크를 앵커 텍스트 및 참조 DR과 함께 가져와줘"
4. 키워드 연구
키워드 개요 지표를 확인하고 콘텐츠 전략을 위한 일치하는 키워드 변형을 검색합니다.
도구: AHREFS_EXPLORE_KEYWORDS_OVERVIEW, AHREFS_EXPLORE_MATCHING_TERMS_FOR_KEYWORDS
키워드 개요:
select(필수) -- 반환할 열 (볼륨, 난이도, CPC 등)country(필수) -- ISO 국가 코드keywords-- 쉼표로 구분된 키워드 목록where-- 볼륨, 난이도, 의도 등으로 필터링
일치하는 용어:
select(필수) 및country(필수)keywords-- 쉼표로 구분된 시드 키워드match_mode--terms(순서 무관) 또는phrase(정확한 순서)terms--all또는questions(질문 형식 키워드만)
예시 프롬프트: "미국에서 '프로젝트 관리'에 대한 키워드 변형을 볼륨 및 난이도와 함께 찾아줘"
5. 유기적 키워드 감사
도메인이 유기적 검색에서 어떤 키워드에 대해 순위를 매기는지 확인하고, 포지션 추적 및 과거 비교 기능을 제공합니다.
도구: AHREFS_RETRIEVE_ORGANIC_KEYWORDS
주요 매개변수:
target(필수) -- 도메인 또는 URLcountry(필수) -- ISO 국가 코드date(필수) --YYYY-MM-DD형식의 날짜select-- 반환할 열 (키워드, 포지션, 볼륨, 트래픽, URL 등)date_compared-- 이전 날짜와 비교where--keyword,volume,best_position, 의도 플래그 등에 대한 고급 필터 표현식limit(기본값 1000),order_by
예시 프롬프트: "미국에서 example.com이 상위 10위 안에 드는 모든 유기적 키워드를 보여줘"
6. 배치 URL 분석
최대 100개의 URL 또는 도메인을 동시에 분석하여 경쟁사 또는 사이트 섹션 간의 SEO 지표를 비교합니다.
도구: AHREFS_BATCH_URL_ANALYSIS
주요 매개변수:
targets(필수) --url,mode(exact/prefix/domain/subdomains) 및protocol(both/http/https)을 포함하는 객체의 배열select(필수) -- 열 식별자의 배열country-- ISO 국가 코드output--json또는php
예시 프롬프트: "competitor1.com, competitor2.com, competitor3.com의 SEO 지표를 비교해줘"
알려진 문제점
- 열 선택은 필수입니다: 대부분의 Ahrefs 도구는 반환할 열을 지정하는
select매개변수가 필요합니다. 이를 생략하거나 유효하지 않은 열 이름을 사용하면 오류가 발생합니다. 각 도구의 응답 스키마에서 유효한 식별자를 확인하세요. - 날짜 형식 일관성: 날짜는
YYYY-MM-DD형식이어야 합니다. 일부 과거 데이터 엔드포인트는 정확한 날짜가 아닌history_grouping으로 설정된 세분성으로 데이터를 반환합니다. - API 단위 비용이 다릅니다: 열마다 다른 API 단위를 소비합니다. 스키마에서 "(5 units)" 또는 "(10 units)"으로 표시된 열은 더 비쌉니다.
traffic,refdomains_source또는difficulty와 같은 비용이 많이 드는 열을 요청할 때 API 사용량을 모니터링하세요. - 배치 제한은 100개 대상입니다:
AHREFS_BATCH_URL_ANALYSIS는 요청당 최대 100개의 대상을 허용합니다. 더 큰 분석의 경우 여러 배치로 나누세요. - 필터 표현식은 복잡합니다:
where매개변수는 표준 SQL이 아닌 Ahrefs의 필터 표현식 구문을 사용합니다. 각 도구의 스키마에서 열 설명을 참조하여 지원되는 필터 유형과 값 형식을 확인하세요. - offset 매개변수는 더 이상 사용되지 않습니다:
offset매개변수는 2024년 5월 31일에 더 이상 사용되지 않습니다. 커서 기반 페이지네이션을 사용하거나limit을 조정하세요. - 모드는 범위에 큰 영향을 미칩니다:
mode를 기본값인subdomains로 설정하면 모든 하위 도메인이 포함되어domain또는exact모드에 비해 결과 수가 크게 증가할 수 있습니다.
빠른 참조
| 도구 슬러그 | 설명 |
|---|---|
AHREFS_RETRIEVE_SITE_EXPLORER_METRICS | 도메인/URL의 현재 SEO 지표 |
AHREFS_RETRIEVE_SITE_EXPLORER_METRICS_HISTORY | 시간 경과에 따른 과거 SEO 지표 |
AHREFS_DOMAIN_RATING_HISTORY | 도메인 평판(DR) 이력 |
AHREFS_FETCH_ALL_BACKLINKS | 필터링 기능을 갖춘 포괄적인 백링크 목록 |
AHREFS_FETCH_SITE_EXPLORER_REFERRING_DOMAINS | 참조 도메인 목록 |
AHREFS_GET_SITE_EXPLORER_COUNTRY_METRICS | 국가별 트래픽 분석 |
AHREFS_BATCH_URL_ANALYSIS | 최대 100개 URL의 배치 분석 |
AHREFS_EXPLORE_KEYWORDS_OVERVIEW | 키워드 지표 개요 |
AHREFS_EXPLORE_MATCHING_TERMS_FOR_KEYWORDS | 일치하는 키워드 변형 |
AHREFS_EXPLORE_KEYWORD_VOLUME_BY_COUNTRY | 국가별 키워드 볼륨 |
AHREFS_RETRIEVE_ORGANIC_KEYWORDS | 도메인의 유기적 키워드 순위 |
AHREFS_RETRIEVE_SITE_EXPLORER_KEYWORDS_HISTORY | 과거 키워드 순위 데이터 |
AHREFS_RETRIEVE_TOP_PAGES_FROM_SITE_EXPLORER | SEO 지표 기준 상위 성과 페이지 |
AHREFS_GET_SERP_OVERVIEW | 특정 키워드에 대한 SERP 개요 |
Composio 제공