SEO Skill: AI 에이전트에 실제 Search Console·크롤링 데이터를 연동하는 오픈소스 MCP 서버 및 CLI
구글 서치 콘솔, GA, Bing, 로컬 크롤링 데이터를 AI 에이전트에 직접 제공하는 오픈소스(Apache-2.0) 도구 SEO Skill의 구조와 설치·활용 방법을 정리했습니다.
SEO Skill(iannuttall/seo)은 구글 서치 콘솔(Google Search Console, GSC), 구글 애널리틱스(Google Analytics, GA), Bing, Clicky, Simple Analytics 및 로컬 사이트 크롤링 데이터를 AI 에이전트에 직접 연결해 주는 오픈소스(Apache-2.0) MCP 서버 겸 명령줄 도구(CLI)입니다. 기존 AI 기반 SEO 작업이 사이트의 실제 수치를 모른 채 일반론이나 서드파티 키워드 추정치에 의존해 콘텐츠를 생성하던 한계를 줄이기 위해 설계되었습니다.

이미지 출처: https://x.com/DanKornas/status/2111943900277469488
이 도구는 Claude Code, Cursor, Codex, Claude Desktop 등 MCP(Model Context Protocol, AI 에이전트가 외부 데이터 소스나 도구를 표준 규약으로 호출하는 인터페이스)를 지원하는 에이전트 환경에 원격 서버 형태로 즉시 연동하거나, Node.js 패키지 매니저인 npm으로 로컬 PC에 직접 설치해 사용할 수 있습니다. 공식 저장소는 2026년 7월 10일 생성되어 2026년 11월 13일 기준 버전 0.19.0 변경 이력까지 반영되어 있습니다.
기존 AI SEO 작업의 한계와 SEO Skill의 작동 구조
일반적인 LLM 에이전트에게 웹페이지 트래픽 하락 원인을 물으면 알고리즘 업데이트, 기술적 결함, 콘텐츠 품질 저하 등 원론적인 체크리스트를 나열합니다. 에이전트가 실제 사이트의 노출수와 클릭수, 검색어 순위 변동 데이터에 접근할 수 없기 때문입니다. 서드파티 SEO 툴의 트래픽 추정치 역시 표본 기반 예측값이므로 롱테일 검색어나 실제 인덱싱(검색엔진 색인 등록) 상태를 정확히 반영하지 못합니다.
SEO Skill은 에이전트에게 지침을 대신 써주는 대신, 검증된 1차 데이터와 단일 목적 명령어를 노출하는 방식을 취합니다.
- 원격 MCP 서버 연동: 별도 서버 구축 없이 호스팅된 원격 엔드포인트(
[https://seoskill.dev/mcp](https://seoskill.dev/mcp))를 에이전트 설정에 등록하고 구글 계정으로 로그인하면 서치 콘솔과 애널리틱스 조회 기능을 바로 호출할 수 있습니다. - 로컬 CLI 및 서버 실행: 터미널에서
npm i -g seo명령으로 전역 설치한 뒤seo start를 실행하면 로그인 인증과 에이전트 스킬 연동이 한 번에 구성됩니다. - 데이터 보관 최소화 정책: 호스팅 서버는 연결된 구글 계정 정보와 사용자가 등록한 외부 API 키만 암호화해 보관합니다. 실제 서치 콘솔 데이터, 생성된 리포트 결과, 요청 로그는 호스팅 서버에 저장하지 않으며 로컬 CLI 인증 정보는 운영체제 키체인에 저장됩니다.
주요 명령어 구성과 MCP 툴 매핑
초기 버전의 수많은 세부 리포트 대신, 에이전트가 목적에 따라 다음 단계를 스스로 선택할 수 있도록 핵심 기능을 단일 목적 명령어로 압축했습니다. 모든 CLI 명령어는 seo_report처럼 언더스코어 형태의 MCP 툴로 동일하게 제공되며, 스크립트 자동화를 위한 --json 플래그를 지원합니다.
| 명령어 | 주요 기능 및 반환 데이터 |
|---|---|
seo report | 지정한 사이트(--site)의 이전 기간 대비 클릭·노출 총량 비교, 급상승·하락 페이지 및 검색어, 낮은 클릭률(CTR), 콘텐츠 노후화(Decay), 키워드 잠식(Cannibalization) 구간 요약 |
seo page | 단일 URL의 라이브 웹페이지 상태, 구글 색인(Index) 등록 여부, 해당 페이지로 유입되는 검색어 목록 확인 |
seo compare | 특정 날짜 전후의 주간 트래픽 추이를 나란히 비교하고 해당 기간 사이에 발생한 구글 검색 업데이트 일정 표시 |
seo index | 알려진 URL 목록의 구글 색인 제외 사유 점검 및 클릭이 감소한 페이지의 라이브 상태 진단 |
seo research | 사용자 본인의 DataForSEO 또는 Ahrefs API 키를 연동해 검색량, 검색 결과(SERP) 중복도, 경쟁사 백링크, 브랜드 언급 페이지 조회 |
seo data | 구글 서치 콘솔 또는 Bing 웹마스터 도구의 원시(Raw) 데이터 행 직접 추출 |
seo analytics | Google Analytics, Clicky, Simple Analytics 기준 방문 페이지별 트래픽과 AI 도구 유입 리퍼러 분석 |
seo crawl | 사이트 전체를 순회하며 기술적 오류와 ChatGPT·Claude·Perplexity 등 AI 봇의 접근 허용 여부 점검 (로컬 CLI 전용) |
seo internal-links | 사이트 전체 또는 특정 페이지에 추가할 내부 링크 후보 도출 (로컬 CLI 전용) |
실제 작업 흐름에서는 먼저 seo report로 클릭이 빠진 검색어와 페이지를 좁힌 뒤, seo page나 seo index로 해당 URL의 라이브 상태와 색인 문제를 확인하고 수정 방향을 결정하는 방식으로 활용됩니다.
설치 방법 및 사용 전 확인해야 할 제약 사항
원격 MCP 연동과 로컬 CLI 설치는 사용 목적에 따라 선택할 수 있습니다. Claude Code나 Codex 환경에서는 터미널에서 아래 명령어로 원격 서버를 등록할 수 있습니다.
# Claude Code 원격 MCP 등록
claude mcp add --transport http seoskill https://seoskill.dev/mcp
# Codex 원격 MCP 등록
codex mcp add seoskill --url https://seoskill.dev/mcp
로컬 머신에서 직접 사이트를 크롤링하거나 Bing 데이터를 조회하려면 npm 전역 설치가 필요합니다.
npm i -g seo
seo start
도입 전 확인해야 할 기술적 제약 사항도 명확히 구분되어 있습니다.
- 로컬 전용 기능 구분: 전체 사이트 기술 점검(
seo crawl)과 내부 링크 분석(seo internal-links), 그리고 Bing 데이터 연동은 원격 호스팅 MCP([https://seoskill.dev/mcp](https://seoskill.dev/mcp))에서는 동작하지 않으며 로컬 CLI 실행 환경에서만 지원됩니다. - 외부 유료 API 키 필요 구간: 서치 콘솔과 애널리틱스 연동은 무료로 동작하지만, 키워드 검색량·경쟁사 백링크·브랜드 언급(
seo research) 기능을 쓰려면 사용자가 직접 발급받은 DataForSEO 또는 Ahrefs API 키를 등록해야 합니다. - 휴리스틱 기반 지표의 한계: 변경 이력(v0.18.0)에 명시된 AI 모드 후속 질문 추적(
ai-queries)이나 서치 콘솔·Bing 쿼리 비율 비교는 세션 데이터가 없는 검색 로그 특성상 추정치(하한선)로 계산되므로 절대 수치로 해석하지 않도록 주의해야 합니다.
출처
- GitHub 공식 저장소 (iannuttall/seo): https://github.com/iannuttall/seo
- Dan Kornas X 게시물 (@DanKornas): https://x.com/DanKornas/status/2111943900277469488