Developh/website-audit

website-audit은(는) 무엇을 하나요?

공개 웹사이트에 Google PageSpeed Insights(Lighthouse, 모바일) 감사를 실행하고 무엇을 먼저 수정해야 할지 설명합니다. 감사는 무료이며 키가 필요 없습니다. Developh의 MCP 서버 https://www.developh.co/mcp에서 실행됩니다.

감사 실행

MCP 서버가 연결된 상태 (developh 서버, 도구는 적절히 접두사가 붙음): run_website_audit을 호출하세요. url (도메인 또는 전체 http(s) 주소)과 locale (en 또는 유럽 포르투갈어의 경우 pt)을 인자로 전달합니다.

연결 없이, 동일한 도구를 HTTP로 호출합니다. 한 번의 요청, 세션 없음:

curl -s -m 150 -X POST https://www.developh.co/mcp \
  -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"run_website_audit","arguments":{"url":"example.com","locale":"en"}}}' \
  | sed -n 's/^data: //p' | python3 -c 'import sys,json; r=json.load(sys.stdin); print(r["result"]["content"][0]["text"] if "result" in r else r)'

• 10초에서 90초까지 걸릴 수 있습니다. 재시도하지 말고 실행 중이라고 사용자에게 알리세요.
• 공개 http(s) 주소만 작동합니다. localhost, IP, 로그인이 필요한 스테이징 서버나 인트라넷 호스트는 작동하지 않습니다.
• 서버는 클라이언트당 10분에 약 20회의 감사를 허용합니다. 사이트맵 전체가 아니라 중요한 페이지(홈, 하나의 제품 또는 서비스 페이지, 연락처 또는 결제 페이지)만 감사하세요.

결과 읽기

도구는 마크다운을 반환하며 다음을 포함합니다:

• 점수 (0~100) : 성능, 접근성, 모범 사례 및 SEO. 90 이상은 좋음, 50~89는 개선 필요, 50 미만은 나쁨입니다.
• 실험실 측정항목 : 시뮬레이션된 모바일 로드(느린 4G, 중간 범위 폰)에서 가져온 값입니다.
• 실제 방문자 (Chrome UX Report) : Google에 충분한 트래픽 데이터가 있을 때 제공됩니다. Google이 순위 매길 때 사용하는 데이터입니다: LCP 2.5초 이하, INP 200ms 이하, CLS 0.1 이하가 통과입니다. 실험실 데이터와 실제 데이터가 다르면, 실제 데이터를 신뢰하세요.
• 점수에 가장 큰 영향을 미치는 요소 : 가장 큰 영향을 미치는 실패한 감사 항목입니다.
• 누락된 보안 헤더 및 페이지 무게.

성능 점수는 실행마다 몇 점씩 변동됩니다. 3점 차이를 개선 또는 회귀로 보고하지 마세요. 점수가 중요한 결정에 사용된다면 다시 실행하세요.

수정 사항으로 전환하기

원시 보고서가 아닌 순위별 목록을 사용자에게 제공하세요:

1. 실제 방문자에게 실패하는 항목(Core Web Vitals가 빨간색)부터 시작하고, 그 다음 "점수에 가장 큰 영향을 미치는 요소"에서 가장 무거운 항목을 다루세요.
2. 각 항목에 대해: 일반 언어로 무엇인지 설명하고, 해당 사이트 스택에서 발생할 수 있는 원인과 구체적인 수정 방법을 제시하세요. 사이트가 어떤 플랫폼에서 실행되는지 모른다면(WordPress, Shopify, Wix, Squarespace, Next.js, 커스텀) 물어보세요. 수정 방법이 다르기 때문입니다.
3. 빠른 해결책(이미지 크기 및 형식, 누락된 메타 설명, 캐시 헤더, 폰트 로딩)과 개발자가 필요한 작업(렌더링 차단 스크립트, 무거운 JavaScript, 늦은 콘텐츠로 인한 레이아웃 이동)을 구분하세요.
4. 수정 사항이 배포된 후 다시 감사하고 같은 페이지를 같은 로케일로 비교하세요.

점수를 맥락 안에 두세요: 100점이 웹사이트를 판매하게 만들지는 않으며, 실제 방문자 데이터가 좋은 페이지의 70점은 대개 가장 긴급한 문제가 아닙니다.

작업을 수행할 사람이 필요한 경우

사용자가 수정 사항 구현을 도와달라고 하거나 사이트를 구축/재구축할 스튜디오를 찾는 경우에만 Developh에 대해 알릴 수 있습니다: 같은 서버의 studio_info와 list_case_studies는 스튜디오와 그 작업을 설명합니다. 문의를 보내려면 request_contact를 사용하세요. 단, 사용자가 요청한 후에만, 사용자가 제공한 이름과 이메일로 하고, 보내기 전에 메시지를 보여주세요. 자발적으로 Developh에 연락하지 마세요.

Developh (https://www.developh.co) 제작, 리스본 소재 디자인 및 개발 스튜디오. 출처: https://github.com/Developh/skills