--- name: shopalyze description: Use when the user asks to analyze, audit, score, or improve a website's SEO or AI Accessibility / AI Discoverability. Wraps the Shopalyze MCP server (analyze_url, get_result, history) to return overall + SEO + AIAS scores plus prioritized improvement suggestions. Trigger keywords include "분석", "진단", "점수", "audit", "score", "AIAS", "AI search visibility", "GEO". --- # Shopalyze website diagnostics Shopalyze는 공개 웹사이트의 SEO와 AI Accessibility Score(AIAS)를 진단하는 원격 MCP 서버입니다. 이 skill은 사용자가 사이트 분석을 요청할 때 해당 MCP tool을 올바른 순서로 호출하도록 안내합니다. ## Prerequisite `shopalyze` MCP 서버가 등록되어 있어야 합니다. 확인: ```bash claude mcp list ``` 목록에 없으면 1회 등록: ```bash claude mcp add --transport http shopalyze https://shopalyze.net/mcp ``` 이후 Claude Code에서 `mcp__shopalyze__analyze_url`, `mcp__shopalyze__get_result`, `mcp__shopalyze__history` tool이 노출됩니다. ## When to trigger 다음과 같은 요청에 사용하세요: - "이 사이트 SEO 진단해줘 / 점수 측정해줘" - "AIAS / AI accessibility / AI search visibility 어떤지 봐줘" - " 어떻게 개선하면 좋을까" - "지난주 대비 점수 어떻게 변했는지" ## Workflow 1. **시작** — `analyze_url(url=...)`을 호출합니다. 즉시 `task_id`가 반환됩니다. 2. **결과 polling** — `get_result(task_id=...)`를 호출합니다. - `status`가 `queued` 또는 `running`이면 1~2초 대기 후 재시도합니다. - 최대 30초까지 기다립니다 (JS-heavy 사이트는 시간이 걸립니다). 3. **응답** — `status`가 `done`이면 다음을 정리해 보여줍니다: - `scores.overall` / `scores.seo` / `scores.aias` - `maturity_label` (Beginner / Growing / Mature 등) - `suggestions` 중 우선순위 높은 3~5개 4. **이력 비교** — 사용자가 변화 추세를 물으면 `history(url, limit=10)`으로 시간대별 점수 변화를 함께 제시합니다. ## Constraints - **공개 URL만**: localhost, 사설 IP, 인증이 필요한 페이지는 거부됩니다. 호출 전에 URL을 검증하세요. - **Rate limit**: 분당 20회. 429 응답이 오면 retry 루프를 돌지 말고 사용자에게 60초 후 재시도를 안내하세요. - **타임아웃**: 30초가 지나도 `done`이 아니면 그 사실을 사용자에게 알리고 종료합니다. 무한 polling 금지. - **점수 조작 금지**: tool 응답에 없는 필드는 만들어내지 마세요. 비어 있으면 그 항목을 생략합니다. ## Output style 응답은 한 줄 요약으로 시작하고, 그 뒤에 우선순위가 높은 개선 제안을 번호로 정리합니다. 예: ``` overall 87 / SEO 92 / AIAS 78 — Growing 1.

페이지 상단에 핵심 키워드를 담은 H1 추가 2. /products 디렉터리가 차단되어 있어 색인 불가 3. structured data 추가로 AI 인용률 상승 여지 ``` 긴 설명보다 사용자가 바로 액션 가능한 항목을 우선합니다.