searchconsole-mcp

프로젝트를 위한 Google Search Console 자동화 MCP 서버: 검색 분석, 사이트맵 관리, 사이트 속성 및 URL 검사.

도구

Related MCP server: Google Search Console + GA4 MCP Server

일회성 Google 설정

1. Google Cloud Console에서 프로젝트를 생성합니다.

2. Google Search Console API를 활성화합니다 (APIs & Services > Library).

3. 서비스 계정을 생성하고 (IAM & Admin > Service Accounts) JSON 키를 다운로드합니다.

4. 각 Search Console 속성에 대해: Settings > Users and permissions > Add user에서 서비스 계정 이메일(...@...iam.gserviceaccount.com)을 붙여넣고 소유자(Owner) 권한을 부여합니다 (URL 검사 API에는 소유자 권한이 필요합니다).

구성

환경 변수:

서버는 시작 시 작업 디렉터리에서 .env 파일도 로드합니다.

MCP 클라이언트에 등록

opencode (~/.config/opencode/opencode.json 또는 프로젝트 .opencode/opencode.json):

{
  "mcp": {
    "searchconsole": {
      "type": "local",
      "command": ["node", "/absolute/path/to/searchconsole-mcp/dist/index.js"],
      "environment": {
        "GSC_SERVICE_ACCOUNT_FILE": "/absolute/path/to/service-account.json",
        "GSC_DEFAULT_SITE": "sc-domain:example.com"
      }
    }
  }
}

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "searchconsole": {
      "command": "node",
      "args": ["/absolute/path/to/searchconsole-mcp/dist/index.js"],
      "env": {
        "GSC_SERVICE_ACCOUNT_FILE": "/absolute/path/to/service-account.json",
        "GSC_DEFAULT_SITE": "sc-domain:example.com"
      }
    }
  }
}

개발

npm install
npm run build     # tsc -> dist/
npm start         # run the server on stdio
npm run smoke     # boots the server and lists tools

참고 사항

• 분석 데이터는 약 2일 지연됩니다. 최신 부분 데이터를 포함하려면 dataState: "all"을 전달하세요.

• API는 요청당 분석 행을 25,000개로 제한합니다. 페이지네이션에는 startRow를 사용하세요.

• API로 사이트를 추가하면 소유권이 확인될 때까지 미검증 상태로 남습니다. 가장 쉬운 방법은 먼저 UI에서 서비스 계정 이메일을 소유자(Owner)로 추가하는 것입니다.