DataForSEO: 실시간 SEO 데이터 (확장 기능)
DataForSEO MCP 서버를 통한 실시간 검색 데이터. 9개의 API 모듈과 79개 이상의 MCP 도구를 통해 실시간 SERP 결과(유기적 + 이미지), 키워드 메트릭, 백링크 프로필, 온페이지 분석, 콘텐츠 분석, 비즈니스 리스팅, AI 가시성 확인 및 LLM 언급 추적을 제공합니다.
사전 요구 사항
이 스킬을 사용하려면 DataForSEO 확장 기능이 설치되어 있어야 합니다:
./extensions/dataforseo/install.sh
가용성 확인: DataForSEO 도구를 사용하기 전에 serp_organic_live_advanced 또는 다른 DataForSEO 도구가 사용 가능한지 확인하여 MCP 서버가 연결되어 있는지 확인하세요. 도구를 사용할 수 없는 경우 사용자에게 확장 기능이 설치되지 않았다는 사실을 알리고 설치 지침을 제공하세요.
API 크레딧 인식
DataForSEO는 API 호출당 비용을 청구합니다. 효율적으로 사용하세요:
- 여러 개의 단일 호출보다는 벌크 엔드포인트를 선호하세요.
- 사용자가 별도로 지정하지 않는 한 기본 매개변수(미국, 영어)를 사용하세요.
- 세션 내에서 결과를 캐시하고, 동일한 데이터를 다시 가져오지 마세요.
- 비용이 많이 드는 작업(전체 백링크 크롤링, 대규모 키워드 목록)을 실행하기 전에 사용자에게 경고하세요.
비용 보호 장치
모든 DataForSEO MCP 호출 전, 비용 추정을 실행하세요:
"${CODEX_SEO_ROOT}/scripts/codex-seo" run dataforseo_costs.py check <endpoint> [--count N]
"status": "approved"인 경우 → API 호출을 진행합니다."status": "needs_approval"인 경우 → 사용자에게 비용 견적을 보여주고 진행하기 전에 확인을 요청하세요."status": "blocked"인 경우 → 일일 예산 한도를 초과한다는 사실을 사용자에게 알리고 진행하지 마세요.
각 API 호출 완료 후, 비용을 기록하세요:
"${CODEX_SEO_ROOT}/scripts/codex-seo" run dataforseo_costs.py log <endpoint> <actual_cost>
비용 관리를 위한 사용자 명령어:
$seo dataforseo costs today→ 오늘의 지출 내역을 표시합니다.$seo dataforseo costs summary→ 7일 지출 기록을 표시합니다.$seo dataforseo costs config --mode threshold --threshold 0.50→ 승인 모드를 구성합니다.
전체 가격표, 예산 사전 설정 및 비용 절감 팁은 references/cost-tiers.md를 참조하세요.
빠른 참조
| 명령어 | 설명 |
|---|---|
$seo dataforseo serp <keyword> | Google 유기적 SERP 결과 |
$seo dataforseo serp-images <keyword> | 유기적 SERP의 이미지 요소 (고정된 MCP 서버에는 Google 이미지 도구가 없음) |
$seo dataforseo serp-youtube <keyword> | YouTube 검색 결과 |
$seo dataforseo youtube <video_id> | YouTube 동영상 심층 분석 |
$seo dataforseo keywords <seed> | 키워드 아이디어 및 제안 |
$seo dataforseo volume <keywords> | 키워드 검색량 |
$seo dataforseo difficulty <keywords> | 키워드 난이도 점수 |
$seo dataforseo intent <keywords> | 검색 의도 분류 |
$seo dataforseo trends <keyword> | Google 트렌드 데이터 |
$seo dataforseo backlinks <domain> | 전체 백링크 프로필 |
$seo dataforseo competitors <domain> | 경쟁사 도메인 분석 |
$seo dataforseo ranked <domain> | 도메인 순위 키워드 |
$seo dataforseo intersection <domains> | 키워드/백링크 중복 |
$seo dataforseo traffic <domains> | 대량 트래픽 추정 |
$seo dataforseo subdomains <domain> | 순위 데이터가 있는 하위 도메인 |
$seo dataforseo top-searches <domain> | 도메인을 언급하는 상위 검색어 |
$seo dataforseo onpage <url> | 온페이지 분석 (Lighthouse + 파싱) |
$seo dataforseo tech <domain> | 기술 스택 감지 |
$seo dataforseo whois <domain> | WHOIS 등록 데이터 |
$seo dataforseo content <keyword/url> | 콘텐츠 분석 및 트렌드 |
$seo dataforseo listings <keyword> | 비즈니스 리스팅 검색 |
$seo dataforseo ai-scrape <query> | GEO를 위한 ChatGPT 웹 스크레이퍼 |
$seo dataforseo ai-mentions <keyword> | GEO를 위한 LLM 언급 추적 |
SERP 분석
$seo dataforseo serp <keyword>
실시간 Google 유기적 검색 결과를 가져옵니다.
MCP 도구: serp_organic_live_advanced
기본 매개변수: location_code=2840 (미국), language_code=en, device=desktop, depth=100
추가 지원: serp_organic_live_advanced 도구는 se 매개변수를 통해 Google, Bing 및 Yahoo를 지원합니다. 검색 엔진을 전환하려면 "bing" 또는 "yahoo"를 지정하세요.
출력: 순위, URL, 제목, 설명, 도메인, 추천 스니펫, AI 개요 참조, People Also Ask.
$seo dataforseo serp-youtube <keyword>
YouTube 검색 결과를 가져옵니다. GEO에 유용합니다. YouTube 언급은 AI 인용과 가장 강한 상관 관계를 보입니다.
MCP 도구: serp_youtube_organic_live_advanced
출력: 동영상 제목, 채널, 조회수, 업로드 날짜, 설명, URL.
$seo dataforseo youtube <video_id>
특정 YouTube 동영상에 대한 심층 분석: 정보, 댓글 및 자막. YouTube 언급을 유용한 GEO 신호로 취급하되, AI 가시성 상관 관계는 방법론에 따라 다릅니다.
MCP 도구: serp_youtube_video_info_live_advanced, serp_youtube_video_comments_live_advanced, serp_youtube_video_subtitles_live_advanced
매개변수: video_id (YouTube 동영상 ID, 예: "dQw4w9WgXcQ")
출력: 동영상 메타데이터(제목, 채널, 조회수, 좋아요, 설명), 최고 댓글 (참여도 포함), 자막/대본 텍스트.
$seo dataforseo serp-images <keyword>
키워드에 대해 Google이 유기적 결과에 표시하는 이미지 요소를 보고합니다(고정된 MCP 서버에는 Google 이미지 도구가 없으므로 전체 이미지 SERP가 아닙니다). 어떤 이미지가 나타나는지, 어떤 도메인이 이를 지배하는지 확인하고 시각적 콘텐츠 기회를 식별합니다.
MCP 도구: 없음. 고정된 [email protected]은 Google 이미지 SERP 도구를 노출하지 않습니다(2026-09-23 패키지 확인). MCP를 통해 이미지 SERP 데이터를 사용할 수 없다고 말하고 그 이름의 도구를 호출하지 마십시오. serp_organic_live_advanced 결과의 images 요소(있는 경우)가 가장 가까운 대안입니다.
기본 매개변수: location_code=2840 (미국), language_code=en, device=desktop, depth=100
매개변수: keyword (필수), depth (선택 사항, 최대 700, 100-결과 단위로 청구됨), search_param (선택 사항, 예: "site:example.com")
비용 경고: site: 또는 filetype: 연산자를 사용하면 API 비용이 5배 증가합니다. 필터링된 쿼리를 실행하기 전에 사용자에게 경고하세요.
출력: 위치, 제목, 대체 텍스트, 소스 페이지 URL, 직접 이미지 URL, 도메인, 인코딩된 URL.
제공할 분석:
- 도메인 지배력: 가장 많은 이미지 위치를 차지하는 사이트(상위 10개 도메인)
- 대체 텍스트 패턴: 상위 순위 이미지의 일반적인 제목/대체 텍스트 패턴
- 형식 분포: 상위 결과의 WebP 대 JPEG 대 PNG(image_url 확장자에서 유추)
- 기회 식별: 사용자가 유기적 순위를 보유하고 있지만 이미지 존재감이 없는 키워드
키워드 연구
$seo dataforseo keywords <seed>
시드 키워드에서 키워드 아이디어, 제안 및 관련 용어를 생성합니다.
MCP 도구: dataforseo_labs_google_keyword_ideas, dataforseo_labs_google_keyword_suggestions, dataforseo_labs_google_related_keywords
기본 매개변수: location_code=2840 (미국), language_code=en, limit=50
출력: 키워드, 검색량, CPC, 경쟁 수준, 키워드 난이도, 트렌드.
$seo dataforseo volume <keywords>
키워드 목록의 검색량 및 메트릭을 가져옵니다.
MCP 도구: kw_data_google_ads_search_volume
매개변수: keywords (배열, 쉼표로 구분), location_code, language_code
출력: 키워드, 월간 검색량, CPC, 경쟁, 월간 트렌드 데이터.
$seo dataforseo difficulty <keywords>
순위 경쟁력을 위한 키워드 난이도 점수를 계산합니다.
MCP 도구: dataforseo_labs_bulk_keyword_difficulty
매개변수: keywords (배열), location_code, language_code
출력: 키워드, 난이도 점수 (0-100), 해석 (쉬움/중간/어려움/매우 어려움).
$seo dataforseo intent <keywords>
사용자 검색 의도별로 키워드를 분류합니다.
MCP 도구: dataforseo_labs_search_intent
매개변수: keywords (배열), location_code, language_code
출력: 키워드, 의도 유형 (정보, 탐색, 상업, 거래), 신뢰도 점수.
$seo dataforseo trends <keyword>
Google 트렌드 데이터를 사용하여 시간 경과에 따른 키워드 트렌드를 분석합니다.
MCP 도구: kw_data_google_trends_explore
매개변수: keywords (배열), location_code, date_from, date_to, language_code
출력: 키워드, 시계열 데이터, 트렌드 방향, 계절성 신호.
도메인 및 경쟁사 분석
$seo dataforseo backlinks <domain>
포괄적인 백링크 프로필 분석.
MCP 도구: backlinks_summary, backlinks_backlinks, backlinks_anchors, backlinks_referring_domains, backlinks_bulk_spam_score, backlinks_timeseries_summary
기본 매개변수: 하위 호출당 limit=100
출력: 총 백링크, 참조 도메인, 도메인 순위, 스팸 점수, 상위 앵커, 시간 경과에 따른 신규/손실 백링크, dofollow 비율, 상위 참조 도메인.
$seo dataforseo competitors <domain>
경쟁 도메인을 식별하고 트래픽을 추정합니다.
MCP 도구: dataforseo_labs_google_competitors_domain, dataforseo_labs_google_domain_rank_overview, dataforseo_labs_bulk_traffic_estimation
출력: 경쟁 도메인, 키워드 중복 %, 예상 트래픽, 도메인 순위, 공통 키워드.
$seo dataforseo ranked <domain>
도메인이 순위를 차지하는 키워드를 위치 및 페이지 데이터와 함께 나열합니다.
MCP 도구: dataforseo_labs_google_ranked_keywords, dataforseo_labs_google_relevant_pages
기본 매개변수: limit=100, location_code=2840
출력: 키워드, 위치, URL, 검색량, 트래픽 점유율, SERP 기능.
$seo dataforseo intersection <domain1> <domain2> [...]
2-20개 도메인 간의 공유 키워드 및 백링크 소스를 찾습니다.
MCP 도구: dataforseo_labs_google_domain_intersection, backlinks_domain_intersection
매개변수: domains (2-20 배열)
출력: 도메인별 위치가 있는 공유 키워드, 공유 백링크 소스, 도메인별 고유 키워드.
$seo dataforseo traffic <domains>
하나 이상의 도메인에 대한 유기적 검색 트래픽을 추정합니다.
MCP 도구: dataforseo_labs_bulk_traffic_estimation
매개변수: domains (배열)
출력: 도메인, 예상 유기적 트래픽, 예상 트래픽 비용, 상위 키워드.
$seo dataforseo subdomains <domain>
순위 데이터 및 트래픽 추정치와 함께 하위 도메인을 열거합니다.
MCP 도구: dataforseo_labs_google_subdomains
매개변수: target (도메인), location_code, language_code
출력: 하위 도메인, 순위 키워드 수, 예상 트래픽, 유기적 비용.
$seo dataforseo top-searches <domain>
결과에서 특정 도메인을 언급하는 가장 인기 있는 검색어를 찾습니다.
MCP 도구: dataforseo_labs_google_top_searches
매개변수: target (도메인), location_code, language_code
출력: 검색어, 검색량, 도메인 위치, SERP 기능, 트래픽 점유율.
기술 / 온페이지
$seo dataforseo onpage <url>
Lighthouse 감사 및 콘텐츠 파싱을 포함한 온페이지 분석을 실행합니다.
MCP 도구: on_page_instant_pages, on_page_content_parsing, on_page_lighthouse
사용법:
on_page_instant_pages: 빠른 페이지 분석 (상태 코드, 메타 태그, 콘텐츠 크기, 페이지 타이밍, 끊어진 링크, 온페이지 검사)on_page_content_parsing: 페이지 콘텐츠 추출 및 파싱 (일반 텍스트, 단어 수, 구조)on_page_lighthouse: 전체 Lighthouse 감사 (성능 점수, 접근성, 모범 사례, SEO, Core Web Vitals)
출력: 크롤링된 페이지, 상태 코드, 메타 태그, 제목, 콘텐츠 크기, 로드 시간, Lighthouse 점수, 끊어진 링크, 리소스 분석.
$seo dataforseo tech <domain>
도메인에서 사용되는 기술을 감지합니다.
MCP 도구: domain_analytics_technologies_domain_technologies
출력: 기술 이름, 버전, 카테고리 (CMS, 분석, CDN, 프레임워크 등).
$seo dataforseo whois <domain>
WHOIS 등록 데이터를 검색합니다.
MCP 도구: domain_analytics_whois_overview
출력: 등록 기관, 생성 날짜, 만료 날짜, 네임서버, 등록자 정보 (공개인 경우).
콘텐츠 및 비즈니스 데이터
$seo dataforseo content <keyword/url>
콘텐츠 품질을 분석하고, 주제별로 콘텐츠를 검색하며, 구문 트렌드를 추적합니다.
MCP 도구: content_analysis_search, content_analysis_summary, content_analysis_phrase_trends
매개변수: keyword (검색/트렌드용) 또는 URL (요약용)
출력: 품질 점수가 있는 콘텐츠 일치, 감정 분석, 가독성 메트릭, 시간 경과에 따른 구문 트렌드 데이터.
$seo dataforseo listings <keyword>
지역 SEO 경쟁 분석을 위해 비즈니스 리스팅을 검색합니다.
MCP 도구: business_data_business_listings_search
매개변수: keyword, location (선택 사항)
출력: 업체명, 설명, 카테고리, 주소, 전화번호, 도메인, 평점, 리뷰 수, 등록 상태.
AI 가시성 / GEO
$seo dataforseo ai-scrape <query>
ChatGPT 웹 검색이 쿼리에 대해 반환하는 내용을 스크랩합니다. ChatGPT 가시성 확인: 대상 키워드에 대해 ChatGPT가 인용하는 소스를 확인하세요. 가능한 경우 Google AI 개요 및 AI 모드를 GSC 생성형 AI 보고서와 함께 확인하세요.
MCP 도구: ai_optimization_chat_gpt_scraper
매개변수: query, location_code (선택 사항), language_code (선택 사항). ai_optimization_chat_gpt_scraper_locations를 사용하여 사용 가능한 위치를 조회하세요.
출력: ChatGPT 응답 콘텐츠, 인용된 소스/URL, 참조된 도메인.
$seo dataforseo ai-mentions <keyword>
LLM이 브랜드, 도메인 및 주제를 언급하는 방식을 추적합니다. GEO에 중요합니다. 여러 LLM 플랫폼에서 실제 AI 가시성을 측정합니다.
MCP 도구: ai_opt_llm_ment_search, ai_opt_llm_ment_top_domains, ai_opt_llm_ment_top_pages, ai_opt_llm_ment_agg_metrics
매개변수: keyword, location_code (선택 사항), language_code (선택 사항). 사용 가능한 위치/언어는 ai_opt_llm_ment_loc_and_lang을, 지원되는 LLM 모델은 ai_optimization_llm_models를 사용하세요.
워크플로:
ai_opt_llm_ment_search로 LLM 언급 검색 (LLM 응답 전반에서 브랜드/키워드 언급 찾기)ai_opt_llm_ment_top_domains로 상위 언급 도메인 가져오기- 특정 키워드에 대한 상위 언급 페이지의 경우
ai_opt_llm_ment_top_pages사용 ai_opt_llm_ment_agg_metrics로 집계 메트릭 검색 (전반적인 LLM 가시성 트렌드)
출력: LLM 응답 내 언급, LLM 유형, 도메인 언급 횟수, 상위 인용 페이지, 브랜드 감정, 시간 경과에 따른 추세.