AI 관련/AI 기술

Google Search Console SEO, Playwright MCP Extension 활용 가이드

재우니 2025. 12. 26. 14:36

Google Search Console SEO, Playwright MCP Extension 활용 가이드

이 가이드는 Google Search Console의 SEO 문제를 자동으로 확인하는 방법을 단계별로 설명합니다.

🎯 왜 필요한가요?

Google Search Console에는 중요한 크롤링(Crawl) 데이터가 있는데, API로는 볼 수 없어서 매번 웹사이트에 접속해서 확인해야 합니다. 이 과정을 자동화하면 시간을 절약하고 정기적으로 모니터링할 수 있습니다.

 

 

📋 준비물

  1. Google Chrome 브라우저
  2. Claude Code (터미널에서 Claude를 사용할 수 있는 도구)
  3. Google Search Console 계정 (이미 있다고 가정)

1단계: Claude Code 설치하기

Windows/Mac 공통

터미널(또는 명령 프롬프트)을 열고 아래 명령어를 입력합니다:

npm install -g @anthropic-ai/claude-code

 

 

설치가 완료되면 다음 명령어로 실행합니다:

claude-code

 

 

2단계: Playwright MCP Extension 설치하기

Playwright는 브라우저를 자동으로 조작할 수 있게 해주는 도구입니다.

2-1. Extension 다운로드

  1. 이 링크로 이동
  2. 페이지에서 extension 폴더를 다운로드 (ZIP 파일로 다운로드 후 압축 해제)

2-2. Chrome에 Extension 추가

  1. Chrome 브라우저를 열고 주소창에 chrome://extensions/ 입력
  2. 오른쪽 위의 "개발자 모드" 토글을 켭니다
  3. "압축해제된 확장 프로그램을 로드합니다" 버튼 클릭
  4. 다운로드한 extension 폴더를 선택

![Chrome Extension 설정 화면 예시]

2-3. Extension이 제대로 설치되었는지 확인

Chrome 오른쪽 위 확장 프로그램 아이콘 영역에 Playwright MCP가 표시되면 성공입니다.

3단계: Claude Code에 Playwright MCP 연결하기

3-1. 설정 파일 찾기

운영체제별로 설정 파일 위치가 다릅니다:

Mac/Linux:

~/.config/claude-code/mcp.json

 

 

Windows:

%APPDATA%\claude-code\mcp.json

 

3-2. 설정 파일 수정

파일을 텍스트 에디터(VS Code, 메모장 등)로 열고 아래 내용을 추가합니다:

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": ["@playwright/mcp@latest", "--caps", "vision", "--extension"]
    }
  }
}

 

 

주의: 이미 mcpServers 항목이 있다면, 기존 내용에 "playwright": {...} 부분만 추가하세요.

 

3-3. Claude Code 재시작

터미널을 닫고 다시 열어서 claude-code 명령어로 실행합니다.

4단계: Google에 로그인하기 (중요!)

Playwright가 여러분의 Google 로그인 세션을 사용할 수 있도록 해야 합니다.

  1. Chrome 브라우저에서 Google Search Console에 로그인
  2. 로그인 상태를 유지한 채로 브라우저를 열어둡니다

왜 이렇게 하나요?
매번 자동 로그인을 구현하는 것보다, 이미 로그인된 브라우저 세션을 가져오는 게 훨씬 쉽고 안전합니다.

5단계: SEO 문제 확인 루틴 정리하기

자동화하기 전에, 수동으로 어떻게 확인하는지 정리해야 합니다. 예를 들어:

1. Google Search Console 접속
2. 왼쪽 메뉴에서 "설정" > "크롤링 통계" 클릭
3. 다음 항목들을 확인:
   - 일일 크롤링 요청 수가 평소보다 50% 이상 감소했는지
   - 크롤링 오류율이 5% 이상인지
   - 호스트 상태가 "사용 불가"인지
4. 문제가 있으면 스크린샷 저장 및 보고

 

 

이런 식으로 단계별로 작성하세요.

6단계: Claude Code로 자동화 실행하기

6-1. Claude Code 실행

터미널에서:

claude-code

 

 

6-2. 명령어 입력

Claude Code가 실행되면 다음과 같이 요청합니다:

Google Search Console에서 SEO 문제를 확인해줘.

확인할 URL: https://search.google.com/search-console?resource_id=YOUR_SITE_URL

다음 항목들을 체크해줘:
1. 크롤링 통계 페이지의 일일 요청 수
2. 크롤링 오류율
3. 인덱싱 상태

각 항목에서 문제가 발견되면 스크린샷과 함께 보고서를 작성해줘.

 

 

YOUR_SITE_URL 부분을 여러분의 실제 사이트 URL로 바꾸세요.

6-3. 권한 허용

처음 실행하면 "브라우저를 제어해도 되나요?"라는 메시지가 나타납니다.

Allow browser control? [y/N]

y 를 입력하고 Enter를 누릅니다.

 

6-4. 결과 확인

Claude Code가:

  1. Chrome 브라우저를 자동으로 열고
  2. Google Search Console 페이지를 방문하며
  3. 스크린샷을 찍고 분석한 후
  4. 문제점을 정리한 보고서를 작성해줍니다

💡 실전 팁

주기적으로 실행하기

매일 같은 시간에 자동 실행되도록 설정할 수 있습니다.

 

 

Mac/Linux (cron 사용):

# crontab 편집
crontab -e

# 매일 오전 9시에 실행 (아래 줄 추가)
0 9 * * * cd /path/to/your/script && claude-code run seo-check.txt

 

 

Windows (작업 스케줄러 사용):

  1. "작업 스케줄러" 검색 후 실행
  2. "기본 작업 만들기" 클릭
  3. 이름 입력 후 실행 주기 설정
  4. 프로그램 시작에서 claude-code 경로 지정

문제 해결

"MCP 서버를 찾을 수 없습니다" 오류:

  • mcp.json 파일 경로가 맞는지 확인
  • Claude Code를 재시작했는지 확인

브라우저가 열리지 않습니다:

  • Chrome Extension이 제대로 설치되었는지 확인
  • Chrome이 완전히 종료되어 있는지 확인 (작업 관리자에서 프로세스 확인)

로그인이 안 됩니다:

  • Chrome에서 Google Search Console에 로그인되어 있는지 확인
  • 로그인 세션이 만료되지 않았는지 확인

🎓 배운 점

이 자동화를 통해:

  • 반복적인 수동 작업을 줄일 수 있습니다
  • API가 없는 기능도 브라우저 자동화로 해결할 수 있습니다
  • 업무 프로세스를 문서화하고 자동화하는 방법을 배웁니다
  • 팀의 다른 사람도 같은 작업을 쉽게 수행할 수 있게 됩니다

 

 

원본 출처

 

https://www.gpters.org/marketing/post/automating-google-search-console-fbU1mvsDkrejdgO?utm_source=newsletter&utm_medium=email&utm_campaign=case-newsletter&utm_term=251222

 

ClaudeCode에서 구글 서치콘솔 SEO 확인 자동화하기

이슈 구글 서치 콘솔에서는 서치 콘솔 API로는 볼 수 없는 데이터가 있습니다. 특히 SEO(검색 엔진 최적화)에서 Crawl stats와 관련된 데이터가 정말 중요한 데이터임에도 불구하고 서치 콘솔 API로 볼

www.gpters.org

 

 

저작자표시 비영리 동일조건 (새창열림)