Config 작성 패턴

Config 작성 패턴

Skill Seeker config 파일 작성을 위한 패턴과 예시입니다. 문서 사이트 유형별 최적화된 설정을 제공합니다.

언제 이 스킬을 사용하나요?

• "config 작성법"
• "selector 설정 방법"
• "스크래핑 설정"
• "config 파일 만들기"
• "URL 패턴 설정"

Config 파일 기본 구조

{
  "name": "framework-name",
  "description": "이 스킬을 언제 사용해야 하는지 설명",
  "base_url": "https://docs.example.com/",
  "selectors": {
    "main_content": "article",
    "title": "h1",
    "code_blocks": "pre code"
  },
  "url_patterns": {
    "include": ["/docs"],
    "exclude": ["/blog", "/changelog"]
  },
  "categories": {
    "getting_started": ["intro", "quickstart", "installation"],
    "api": ["api", "reference", "methods"]
  },
  "rate_limit": 0.5,
  "max_pages": 500
}

문서 프레임워크별 패턴

Docusaurus

{
  "selectors": {
    "main_content": "article.markdown",
    "title": "header h1",
    "code_blocks": "pre.prism-code code"
  },
  "url_patterns": {
    "include": ["/docs/"],
    "exclude": ["/blog/", "/community/"]
  }
}

GitBook

{
  "selectors": {
    "main_content": "main.gitbook-root",
    "title": "h1",
    "code_blocks": "pre code"
  },
  "url_patterns": {
    "include": [""],
    "exclude": ["/changelog"]
  }
}

MkDocs / Material

{
  "selectors": {
    "main_content": "article.md-content",
    "title": "h1",
    "code_blocks": "pre code"
  },
  "url_patterns": {
    "include": [""],
    "exclude": ["/search/"]
  }
}

ReadTheDocs

{
  "selectors": {
    "main_content": "div.document",
    "title": "h1",
    "code_blocks": "pre"
  },
  "url_patterns": {
    "include": ["/en/latest/", "/en/stable/"],
    "exclude": ["/genindex", "/search"]
  }
}

VuePress

{
  "selectors": {
    "main_content": "main.page",
    "title": "h1",
    "code_blocks": "div.language- code"
  },
  "url_patterns": {
    "include": ["/guide/", "/api/"],
    "exclude": []
  }
}

Sphinx

{
  "selectors": {
    "main_content": "div.body",
    "title": "h1",
    "code_blocks": "pre"
  },
  "url_patterns": {
    "include": [""],
    "exclude": ["/genindex", "/py-modindex", "/search"]
  }
}

CSS Selector 가이드

기본 패턴

패턴	예시	설명
태그	article	HTML 태그
클래스	.content	CSS 클래스
ID	#main	HTML ID
조합	article.docs	태그 + 클래스
자식	article > h1	직접 자식
후손	article h1	모든 후손

복잡한 Selector

{
  "main_content": "article.markdown, div.content",
  "title": "h1:first-child, header h1",
  "code_blocks": "pre code, div[class*='language-'] code"
}

URL 패턴 가이드

Include 패턴

• /docs/ - docs 폴더 하위 모든 페이지
• /api/v2/ - 특정 버전 API 문서
• /guide/ - 가이드 섹션

Exclude 패턴

• /blog/ - 블로그 포스트 제외
• /changelog - 변경 로그 제외
• /community/ - 커뮤니티 페이지 제외
• /_ - 내부 페이지 제외

Categories 설정

권장 카테고리

{
  "categories": {
    "getting_started": ["intro", "quickstart", "installation", "setup"],
    "core_concepts": ["concepts", "fundamentals", "basics", "overview"],
    "api_reference": ["api", "reference", "methods", "functions"],
    "guides": ["guide", "tutorial", "how-to", "examples"],
    "configuration": ["config", "settings", "options"],
    "advanced": ["advanced", "internals", "architecture"]
  }
}

성능 최적화

대규모 사이트 (1000+ 페이지)

{
  "max_pages": 500,
  "rate_limit": 1.0,
  "url_patterns": {
    "include": ["/docs/latest/"],
    "exclude": ["/docs/v1/", "/docs/v2/"]
  }
}

소규모 사이트 (<100 페이지)

{
  "max_pages": 100,
  "rate_limit": 0.3
}

Config 검증

config 파일 유효성 검사:

mcp__skill-seeker__validate_config
- config_path: config 파일 경로

페이지 수 추정:

mcp__skill-seeker__estimate_pages
- config_path: config 파일 경로

트러블슈팅

"No content found" 오류

• main_content selector가 올바른지 확인
• 브라우저 개발자 도구로 실제 HTML 구조 확인

페이지가 너무 많이 스크래핑됨

• url_patterns.exclude에 불필요한 경로 추가
• max_pages 제한 설정

코드 블록이 누락됨

• code_blocks selector 확인
• 사이트별 syntax highlighter 클래스 확인

카테고리가 잘못 분류됨

• categories 키워드 수정
• URL 구조에 맞는 키워드 사용