Google CrUX MCP

English | Русский

A1 Google CrUX MCP는 실사용자 Core Web Vitals 데이터를 AI 앱에 제공합니다. 공개 사이트나 페이지가 LCP, INP, CLS를 통과하는지 확인하고, 모바일과 데스크톱을 비교하며, 지표가 시간에 따라 어떻게 변했는지 볼 수 있습니다.

Google의 Chrome UX Report 데이터셋을 읽습니다. 이는 Chrome 사용자로부터 수집된 필드 데이터이며, 합성 속도 테스트나 사이트를 변경하는 방법이 아닙니다.

• 읽기 전용 도구 6개. Core Web Vitals 평가, 기기 비교, 오리진-페이지 비교, 40주 추세, 원시 최신 또는 과거 기록을 제공합니다.

• 실사용자 데이터. PageSpeed Insights와 Google의 Core Web Vitals 신호가 사용하는 것과 동일한 CrUX 필드 데이터입니다.

• 명확한 가용성 경계. 실사용자 트래픽이 충분한 공개 오리진과 URL만 데이터를 가지며, no_data는 유효한 결과입니다.

• 알려진 할당량 비용. CrUX는 프로젝트당 분당 150개의 쿼리를 허용합니다. 기기 비교는 API 호출 4회, 오리진-페이지 비교는 API 호출 2회를 사용합니다.

읽기 전용 질문으로 시작하세요:

https://example.com은 모바일에서 Core Web Vitals를 통과하나요?

서버 연결 · 사용 사례 살펴보기 · 기술 문서

1분 만에 작동 확인하기

사용자: https://example.com/pricing은 모바일에서 Core Web Vitals를 통과하나요?

어시스턴트: p75 LCP, INP, CLS와 그 양호/개선 필요/불량 등급, 그리고 종합 결과를 보여줍니다. 변경되는 것은 없습니다.

사용자: 이 페이지를 사이트 평균과 비교하고, 모바일이 데스크톱과 어떻게 다른지 보여주세요.

어시스턴트: 오리진과 URL을 비교한 다음, 기기 그룹과 트래픽 점유율을 비교합니다. 6개 도구는 모두 공개 CrUX 데이터셋만 읽습니다.

Related MCP server: GSC Analyst Connector

목차

• 빠른 시작

• 무엇을 요청할 수 있나요?

• CrUX 데이터 읽는 방법

• 액세스 권한 얻기

• 구성

• 데이터, 한도 및 백그라운드 작업

• 기술 문서

• 지원

빠른 시작

Node.js 20+와 Chrome UX Report API가 활성화된 Google Cloud API 키가 필요합니다.

1. 제한된 API 키를 만드세요.

2. 서버를 AI 앱에 추가하세요.

3. 위의 읽기 전용 질문을 물어보세요.

설정 → 플러그인 → MCP 서버에서 서버 추가를 선택한 다음 CRUX_API_KEY와 함께 npx -y mcp-google-crux@latest를 추가합니다.

codex mcp add google-crux --env CRUX_API_KEY=your_key -- npx -y mcp-google-crux@latest
codex mcp list

Codex MCP 문서

claude mcp add --env CRUX_API_KEY=your_key --transport stdio --scope user google-crux -- npx -y mcp-google-crux@latest
claude mcp list

Claude Code MCP 문서

설정 → 개발자 → 구성 편집을 열고 다음을 추가합니다: {"mcpServers":{"google-crux":{"command":"npx","args":["-y","mcp-google-crux@latest"],"env":{"CRUX_API_KEY":"your_key"}}}}.

구성 편집을 사용할 수 없는 경우 macOS에서는 ~/Library/Application Support/Claude/claude_desktop_config.json을, Windows에서는 %APPDATA%\Claude\claude_desktop_config.json을 편집합니다. Claude Desktop MCP 문서

macOS/Linux에서는 ~/.cursor/mcp.json에, Windows에서는 %USERPROFILE%\.cursor\mcp.json에 다음을 추가합니다: {"mcpServers":{"google-crux":{"type":"stdio","command":"npx","args":["-y","mcp-google-crux@latest"],"env":{"CRUX_API_KEY":"your_key"}}}}. Cursor MCP 문서

MCP: Open User Configuration을 실행하고 다음을 추가하세요:

{"servers":{"google-crux":{"type":"stdio","command":"npx","args":["-y","mcp-google-crux@latest"],"env":{"CRUX_API_KEY":"${input:crux_api_key}"}}},"inputs":[{"type":"promptString","id":"crux_api_key","description":"Google Cloud API key","password":true}]}

MCP: List Servers로 확인하세요. VS Code MCP 문서

무엇을 요청할 수 있나요?

• 이 공개 오리진 또는 URL이 Core Web Vitals를 통과하나요?

• 휴대폰, 데스크톱, 태블릿 및 전체 기기 결과를 비교합니다.

• 이 페이지가 사이트 평균보다 빠르거나 느립니까?

• 지난 25주 동안 LCP, INP, CLS는 어떻게 변했나요?

• 기술 검토를 위해 원시 CrUX 히스토그램과 백분위수를 보여줍니다.

CrUX 데이터 읽는 방법

CrUX는 매일 갱신되는 28일 이동 창을 보고합니다. 기록 데이터는 주 단위이며 월요일에 갱신됩니다. 핵심 값은 p75입니다. 관찰된 방문의 75%가 이 값 이하입니다. get_core_web_vitals는 지표 임계값을 대신 해석하며, 원시 기록 도구는 전체 히스토그램과 밀도 비율을 노출합니다.

데이터가 없다고 해서 사이트가 고장 난 것은 아닙니다. Google이 해당 오리진, URL 또는 기기 그룹에 대해 충분히 큰 공개 Chrome 사용자 샘플을 보유하지 않았음을 의미합니다. 태블릿과 개별 URL에는 데이터가 없는 경우가 많습니다.

액세스 권한 얻기

1. Google Cloud Console에서 프로젝트를 만들거나 선택합니다. CrUX에는 결제 계정이 필요하지 않습니다.

2. Chrome UX Report API를 사용 설정합니다.

3. API 및 서비스 → 사용자 인증 정보에서 API 키를 만듭니다.

4. 키를 Chrome UX Report API로 제한하고 CRUX_API_KEY로 전달하세요.

이 키는 MCP 클라이언트 구성에 저장되고 API 요청 URL에 포함되어 전송되므로 비밀번호처럼 취급하세요.

구성

데이터, 한도 및 백그라운드 작업

• 읽기 전용 공개 데이터셋. 이 서버는 사이트, Search Console, CrUX 레코드 또는 Google 순위를 변경할 수 없습니다.

• 할당량 인식 재시도. 백오프를 적용하여 429, 5xx 및 네트워크 오류를 재시도합니다. 프로젝트당 분당 150쿼리 할당량을 계획할 때 복합 비교를 염두에 두세요.

• 백그라운드 모니터링 없음. 이 서버는 호출되는 동안에만 작동합니다. AI 앱이 예약 작업을 지원한다면 주기적인 성능 보고서를 만들 수 있습니다.

• 익명 텔레메트리. 설치 및 버전 데이터와 도구 이름을 전송하며, API 키, 조회된 URL, 결과, 인자 또는 프롬프트는 절대 전송하지 않습니다. 옵트아웃하려면 ASKADS_TELEMETRY=0을 설정하세요.

기술 문서

• MCP 기능 카탈로그 — 각 도구에 대한 작업 중심 페이지.

• 모든 도구 및 입력

• 개발 문서

• 게시 문서

• CrUX API 문서

지원

버그를 발견했거나 시나리오가 필요하신가요? 이슈를 생성하거나 Telegram으로 글을 남겨 주세요.