Scrapling
유료 API 없이 웹 페이지를 읽게 할 때
에이전트가 웹 페이지를 가져와 정리된 내용으로 읽게 하는 파이썬 스크래핑 라이브러리의 MCP 서버입니다.
설치
설치 전에 알아 둘 것
Python 3.10 이상이 필요합니다. scrapling install은 필요한 브라우저와 시스템 의존성을 내려받습니다. 이 과정이 미리 끝난 Docker 이미지(pyd4vinci/scrapling)도 있습니다.
필요한 것만 골라 등록합니다.
MCP 서버
마지막 명령의 경로는 which scrapling-mcp(Windows는 where scrapling-mcp)로 찾은 값으로 바꿉니다. 등록한 뒤에는 앱을 완전히 끄고 다시 시작합니다.
- 터미널에서 실행MCP 서버 1번째 명령 복사
pip install "scrapling[ai]" - 터미널에서 실행MCP 서버 2번째 명령 복사
scrapling install - 터미널에서 실행MCP 서버 3번째 명령 복사
claude mcp add ScraplingServer "/Users/ <MyUsername>/ .venv/ bin/ scrapling-mcp"
Agent Skill
에이전트가 Scrapling 코드를 직접 쓸 때 참고하는 지침입니다.
- 터미널에서 실행Agent Skill 1번째 명령 복사
npx skills add D4Vinci/Scrapling --skill scrapling-official
언제 쓰면 좋나
에이전트가 자바스크립트로 그려지는 페이지나 로그인한 내 계정 페이지를 읽어야 하는데, 유료 API 대신 내 PC에서 돌리고 싶을 때 씁니다. MCP 서버는 페이지 가져오기, 클릭 같은 페이지 조작, 스크린샷을 도구로 주고, Agent Skill은 에이전트가 Scrapling 코드를 현재 API에 맞게 쓰게 합니다. 사이트 구조가 바뀌어도 요소를 다시 찾는 기능이 있어 오래 돌릴 크롤러를 만들 때도 쓸 수 있습니다.
한눈에
- 종류
- MCP 서버에이전트에 외부 도구를 잇는 프로그램
- 지원 도구
- Claude Code
- 라이선스
- BSD-3-Clause
- 최근 업데이트
- 2026-11-05
- 정보 확인일
- 2026-11-07
주의할 점
- 사이트 약관, robots.txt, 저작권, 개인정보 법을 지키는 책임은 사용자에게 있습니다. 봇 차단을 넘는 기능은 사이트 약관과 충돌할 수 있고, README도 교육과 연구 목적으로 제공한다고 밝힙니다. 상업적으로 쓴다면 사이트의 허락을 먼저 확인하세요.
pip install scrapling만으로는 파서만 설치되어 가져오기 기능을 쓸 수 없습니다. MCP 서버는scrapling[ai]가 필요합니다.- 프롬프트 인젝션 방어는 숨긴 요소와 HTML 주석을 걷어 내는 방식입니다. 기본값인
main_content_only를 켜 두어도 화면에 보이는 문장은 그대로 에이전트에게 들어갑니다. - 스텔스 브라우저는 HTTPS 인증서 오류를 무시하는 것이 기본값이고, 관리자는 스크래핑을 위한 의도된 동작이라고 밝혔습니다(#514). 로그인 정보가 오가는 작업이라면 이 점을 고려하세요.
- MCP 서버를 HTTP로 띄워 다른 기기에서 쓴다면
SCRAPLING_MCP_AUTH_TOKEN으로 인증을 켜세요. - 아직 1.0 전이고, MCP 서버의 동작이 호환되지 않게 바뀐 적이 있습니다(#424). 업데이트 뒤에는 도구 목록을 확인하는 편이 좋습니다.
커뮤니티 반응
HN에는 지금까지 못 읽은 사이트가 없었다는 사용자 언급이 있습니다. Geekflare와 Scrapfly의 비교 글은 HTTP와 브라우저를 한 크롤링에서 함께 쓰고 사이트가 바뀌어도 요소를 다시 찾는 점을 장점으로 꼽습니다. 다만 두 글 모두 직접 시험하지 않았고, 경쟁 상품을 파는 업체의 글입니다. 기본 설치에 가져오기 기능이 빠져 있다는 점, 아직 1.0 전이라는 점, 봇 차단을 넘는 기능이 사이트 약관과 충돌할 수 있다는 점이 지적됩니다. 요소 재탐색은 실제 대상에서 먼저 시험해 보라는 조언도 있습니다.
다른 사용자들의 공개 후기를 요약했습니다(2026-11-07 확인).
비슷한 도구
Scrapling 대신 쓸 만한 도구와 같은 문서 검색 카테고리에서 별이 많은 도구입니다.