gpters Scraper

gpters Scraper

지피터스 멤버 프로필에서 게시물을 자동 수집하여 로컬 Markdown 파일로 저장합니다.

사전 요구사항

필수 패키지

pip install selenium webdriver-manager beautifulsoup4 lxml

설치 확인

python -c "import selenium; print(f'Selenium {selenium.__version__}')"
python -c "import bs4; print('BeautifulSoup 설치됨')"

Chrome 브라우저: Windows 11에 기본 탑재되어 있으며, ChromeDriver는 자동으로 설치됩니다 (webdriver-manager).

---

사용 방법

기본 실행 (최근 10개 게시물)

python scripts/​scrape_posts.py --profile-url "https://www.gpters.org/​member/​WZlPiwwnpW"

추가 옵션

# 최근 20개 게시물 수집
python scripts/​scrape_posts.py --profile-url "URL" --max-results 20

# 헤드리스 모드 (백그라운드 실행)
python scripts/​scrape_posts.py --profile-url "URL" --headless

# 중복 파일 덮어쓰기
python scripts/​scrape_posts.py --profile-url "URL" --no-skip

# 출력 경로 변경
python scripts/​scrape_posts.py --profile-url "URL" --output-dir "내_경로/"

---

옵션 설명

---

출력 형식

저장 경로

docs/​notes/​gpters_editor_soyeon/
├── 20260106_Claude_Code_자동화.md
├── 20250105_GPT_활용_가이드.md
└── ...

Markdown 파일 예시

# Claude Code로 업무 자동화 시작하기

- **작성일**: 2025-01-06
- **URL**: [https://www.gpters.org/​post/​abc123](https://www.gpters.org/​post/​abc123)

## 요약
Claude Code를 활용하여 반복적인 업무를 자동화하는 방법에 대해 설명합니다.

---

**수집 일시**: 2025-01-06 14:30:15

---

실행 결과

성공 시 JSON 출력

{
  "status": "success",
  "profile_url": "https://www.gpters.org/​member/​WZlPiwwnpW",
  "collected_at": "2025-01-06T14:30:15",
  "collected": 10,
  "saved": 8,
  "skipped": 2,
  "saved_files": [
    "20260106_Claude_Code_자동화.md",
    "20250105_GPT_활용_가이드.md"
  ],
  "errors": []
}

실패 시 JSON 출력

{
  "status": "error",
  "collected": 0,
  "saved": 0,
  "skipped": 0,
  "saved_files": [],
  "errors": [
    {
      "type": "critical",
      "message": "Page load failed: no such element"
    }
  ]
}

---

에러 처리

일반적인 문제

1. ChromeDriver 설치 실패

✗ ChromeDriver installation failed

해결책: Chrome 브라우저가 설치되어 있는지 확인하세요.

2. 페이지 로딩 타임아웃

✗ Page load failed: Timeout waiting for element

해결책: 네트워크 연결을 확인하거나 잠시 후 다시 시도하세요.

3. 게시물 요소를 찾을 수 없음

✗ no such element: Unable to locate element

해결책: 지피터스 페이지 구조가 변경되었을 수 있습니다. references/​selector-guide.md를 참조하세요.

4. 한글 파일명 저장 오류 (Windows)

해결책: UTF-8 인코딩이 자동으로 적용되므로 추가 설정 불필요합니다.

---

워크플로우

1단계: 페이지 접속

• Chrome 브라우저 시작
• 프로필 URL로 이동
• JavaScript 렌더링 완료 대기 (5초)

2단계: 게시물 파싱

• 동적으로 로드된 게시물 목록 대기 (최대 15초)
• BeautifulSoup으로 HTML 파싱
• 제목, URL, 작성일, 요약 추출

3단계: Markdown 저장

• docs/​notes/​gpters_editor_soyeon/ 디렉토리 생성
• 파일명: YYYYMMDD_title.md 형식
• 중복 파일 자동 건너뜀 (--no-skip으로 덮어쓰기 가능)
• UTF-8 인코딩으로 한글 정상 저장

4단계: 결과 출력

• JSON 형식으로 결과 출력
• 저장 파일 목록 출력

---

Claude Code와 통합

자동 트리거

사용자가 다음 중 하나를 언급하면 자동으로 이 Skill을 실행합니다:

• "지피터스 게시물 수집"
• "gpters 스크랩"
• "editor_소연님 게시물"
• "프로필 크롤링"
• "지피터스에서 글 가져오기"

사용 예시

사용자:

editor_소연님의 지피터스 게시물 최근 15개 수집해줘

Claude Code 응답:

15개 게시물을 수집하여 12개 파일을 저장했습니다.

저장 위치: docs/​notes/​gpters_editor_soyeon/

신규 저장: 12개
- 20260106_Claude_Code_자동화.md
- 20250105_GPT_활용_가이드.md
...

건너뜬 중복: 3개

---

데이터 구조

상세 문서: references/​selector-guide.md

수집 데이터

각 게시물에서 추출되는 정보:

• title (string): 게시물 제목
• url (string): 게시물 링크 (절대 URL)
• published_date (string): 작성일 (YYYY-MM-DD 형식)
• summary (string): 게시물 요약 또는 본문 일부 (최대 200자)

---

고급 사용법

여러 프로필 수집

# editor_소연
python scripts/​scrape_posts.py --profile-url "https://www.gpters.org/​member/​WZlPiwwnpW" --max-results 20

# 다른 멤버
python scripts/​scrape_posts.py --profile-url "https://www.gpters.org/​member/​OTHER_ID" --output-dir "docs/​notes/​gpters_other/"

배치 처리 (여러 프로필 순회)

Python 스크립트 작성:

import subprocess
import json

profiles = [
    ("https://www.gpters.org/​member/​ID1", "profile1"),
    ("https://www.gpters.org/​member/​ID2", "profile2"),
]

for url, name in profiles:
    result = subprocess.run(
        ["python", "scripts/​scrape_posts.py",
         "--profile-url", url,
         "--output-dir", f"docs/​notes/​gpters_{name}"],
        capture_output=True,
        text=True
    )
    output = json.loads(result.stdout)
    print(f"{name}: {output['saved']}개 저장, {output['skipped']}개 건너뜀")

---

유지보수

페이지 구조 변경 시

지피터스 페이지가 변경되면 references/​selector-guide.md를 참조하여 CSS Selector를 업데이트하세요.

수정 단계:

1. Chrome DevTools (F12)에서 게시물 요소 구조 확인
2. scrape_posts.py의 Selector 값 업데이트
3. 작은 규모로 테스트 (--max-results 3)
4. 성공 시 full run 실행

로깅 활성화 (개발용)

Python 스크립트에 다음 추가:

import logging
logging.basicConfig(level=logging.DEBUG, format='%(asctime)s - %(levelname)s - %(message)s')

---

문제 해결 팁

브라우저 창이 제대로 로드되지 않는 경우

# GUI 모드에서 실행해서 상태 확인
python scripts/​scrape_posts.py --profile-url "URL" --max-results 5

# (헤드리스 모드는 나중에)

Selector 찾기

1. Chrome에서 https://www.gpters.org/member/WZlPiwwnpW 방문
2. F12 → Elements 탭
3. 게시물 요소 우클릭 → "Inspect" 또는 Ctrl+Shift+C로 선택
4. HTML 구조 확인

---

FAQ

Q: 스케줄링은 지원하나요?

A: MVP에는 수동 실행만 포함되어 있습니다. 자동 스케줄링이 필요하면 APScheduler 또는 Windows 작업 스케줄러를 별도로 설정하세요.

Q: 게시물 본문 전체를 수집할 수 있나요?

A: 현재는 제목, URL, 작성일, 요약만 수집합니다. 본문 전체 수집은 향후 업데이트 예정입니다.

Q: 이미지도 다운로드되나요?

A: 현재는 Markdown 텍스트만 저장합니다. 이미지 다운로드는 향후 기능 추가 예정입니다.

Q: 프록시 설정이 필요한가요?

A: 기본 설정은 프록시 없이 작동합니다. 필요시 scrape_posts.py의 setup_driver() 함수를 수정하세요.

---

관련 리소스

• references/​selector-guide.md - CSS Selector 유지보수 가이드
• Selenium 공식 문서
• BeautifulSoup 공식 문서

---

버전: 1.0.0 MVP 최종 업데이트: 2025-01-06 상태: Ready for Use ✅