SEO Operations & Automation (seo-ops)은(는) 무엇을 하나요?
seo MCP 서버를 부트스트래핑하고, 사전 푸시 및 CI/CD 품질 게이트를 통합하며, 증거 기반 기술 및 순위 감사를 실행하기 위한 자동화된 실행 설명서입니다.
Phase 0: 필수 사전 점검 및 자동 설치
[!IMPORTANT] 수동 설정 제로 가정: 코드 분석이나 감사를 수행하기 전에
seoCLI와 MCP 서버가 현재 세션에 구성되어 있고 사용 가능한지 확인하십시오.
flowchart TD
Start["/seo-ops 호출"] --> Check{"SEO MCP / CLI가 구성되었습니까?"}
Check -->|아니오 / 누락| AutoInstall["1. 자동 설치 실행<br/>('npm i -g seo' + mcp_config.json 작성)"]
AutoInstall --> TestDaemon["2. 확인: 'npx -y seo mcp serve --test'"]
TestDaemon --> PromptRestart["3. 사용자에게 Agent/IDE 재시작 요청 및 중단"]
Check -->|예 / 활성| RouteIntent["사용자 의도 라우팅 진행"]
자체 설치 실행 설명서 (MCP / CLI가 없을 때 실행)
- 패키지 설치:
npm install -g seo - MCP 서버 구성:
.agents/mcp_config.json(및~/.gemini/config/mcp_config.json)에 다음 내용이 포함되어 있는지 확인하십시오:{ "mcpServers": { "seo": { "command": "npx", "args": ["-y", "seo", "mcp", "serve"] } } } - 데몬 확인:
npx -y seo mcp serve --test - 재시작 요청 및 턴 중단:
이번 세션에서 MCP 도구가 새로 추가된 경우, Antigravity는 도구를 등록하기 위해 세션/윈도우 다시 로드가 필요합니다. 다음을 명확히 알려주십시오:
"
seoCLI 및 MCP 서버가 설치 및 등록되었습니다. IDE 창을 다시 로드하거나 에이전트 세션을 다시 시작하여 새로운 MCP 도구(seo_list_reports,seo_describe_report,seo_run_report)가 로드되도록 한 후,/seo-ops를 다시 호출하십시오." 활성 도구 없이 수동 코드 편집이나 추측성 추정을 진행하지 마십시오.
활성 의도 라우팅 (MCP / CLI 준비 완료 시)
필수 조건이 충족되면 사용자에게 프롬프트를 표시하거나 컨텍스트를 검사하여 목표를 확인하십시오:
flowchart LR
Route["활성 세션"] --> A["1. CI/CD 및 사전 푸시 설정 (setup-cicd)"]
Route --> B["2. 기술 및 온페이지 감사 (audit-technical)"]
Route --> C["3. Search Console 및 성장 감사 (audit-gsc)"]
Route --> D["4. 환경 상태 점검 (check-health)"]
Pathway A: 저장소 CI/CD 및 사전 푸시 품질 게이트 (setup-cicd)
개발 및 배포 파이프라인에서 제로 회귀 SEO 게이트를 적용하십시오:
- 1. Node 22+ 확인:
node -v를 실행하여 Node 22+ 런타임인지 확인합니다. - 2. 로컬 사전 푸시 훅 구성:
- dev 서버 자동 프로빙(활성 인스턴스 재사용 또는 프로세스 트리 정리와 함께
cmd.exe /c pnpm run dev실행)을 사용하여 사전 푸시 실행기 스크립트(scripts/seo-pre-push.ps1또는scripts/seo-pre-push.sh)를 배포합니다. .husky/pre-push에서 개별 단계를 실행합니다:pnpm run test:all pnpm run seo:pre-push- cicd-pipeline-guide.md를 참조하십시오.
- dev 서버 자동 프로빙(활성 인스턴스 재사용 또는 프로세스 트리 정리와 함께
- 3. GitHub Actions 워크플로우 설치:
- seo-ci.yml.template을 사용하여
.github/workflows/seo-check.yml을 생성합니다.
- seo-ci.yml.template을 사용하여
- 4. 파이프라인 검증:
- Windows:
powershell -ExecutionPolicy Bypass -File .agents/skills/seo-ops/scripts/verify-seo-setup.ps1 -Mode cicd - Linux/macOS:
bash .agents/skills/seo-ops/scripts/verify-seo-setup.sh -m cicd
- Windows:
Pathway B: 기술 및 온페이지 감사 (audit-technical)
로컬 빌드 또는 라이브 URL에 대한 증거 기반 크롤링을 실행합니다:
- 1. 로컬 빌드 / 대상 시작:
pnpm build && pnpm start를 실행하여http://127.0.0.1:3000에서 실행합니다.
- 2. 기술 감사 실행:
- MCP 통해:
seo_run_report를reportId: "audit-page"또는"site-crawl"와params: {"url": "http://127.0.0.1:3000"}로 호출합니다. - CLI 통해:
npx -y seo report --url http://127.0.0.1:3000 --actions-only --json
- MCP 통해:
- 3. Next.js 코드 수정:
generateMetadata()업데이트 (title, description, OpenGraph, canonical).- JSON-LD 구조화된 데이터 컴포넌트 (
BreadcrumbList,Article,WebSite) 수정. - 내부 깨진
<Link>태그 및app/sitemap.ts수정. - ranking-optimization-guide.md를 참조하십시오.
- 4. 수정 사항 확인:
seo audit-page --url <target-url>를 다시 실행하여 깨끗한 제로 발견 상태를 확인합니다.
Pathway C: Search Console 및 성장 기회 (audit-gsc)
Search Console을 통해 라이브 도메인의 순위 기회를 발견하십시오:
- 1. MCP 통해 보고서 검색:
seo_list_reports호출 (category:"gsc"또는"pseo").seo_describe_report를reportId: "quick-wins","second-page", 또는"pseo-patterns"로 호출.
- 2. 기회 감사 실행:
- 대상 속성으로
seo_run_report호출 (site: "sc-domain:example.com").
- 대상 속성으로
- 3. 개선 사항 적용:
- Quick Wins (순위 4–10):
<title>및<meta description>을 개선하여 CTR을 높입니다. - Second Page (순위 10–20): 권위 있는 상위 페이지에서 컨텍스트 내부 링크를 추가하고 콘텐츠를 심화합니다.
- pSEO 패턴:
generateStaticParams()로 동적 라우트를 구성합니다.
- Quick Wins (순위 4–10):
- 4. 재확인: 업데이트된 메타와 스키마가 프로덕션 SSR 빌드에서 올바르게 렌더링되는지 확인합니다.
엣지 케이스 및 알려진 문제점
- 프로세스 재시작 필요:
.agents/mcp_config.json이 수정되면, 에이전트는 세션/윈도우가 다시 로드될 때까지 새 도구에 접근할 수 없습니다. 재시작 프롬프트를 절대 건너뛰지 마십시오. - Windows 경로 해결: Windows에서
%PATH%바이너리 조회 오류를 피하기 위해 항상"command": "npx"와 함께["-y", "seo", "mcp", "serve"]를 사용하십시오. - 정적 추측 금지: MCP 도구나 CLI 보고서를 먼저 실행하지 않고 SEO를 위해 코드를 정적으로 검사하지 마십시오.
- 증거 분리: 관찰된 크롤링 증거를 외부 제공자 키워드 추정과 분리하여 유지하십시오.