sqdshguy/wreq-js

Node.js의 TLS 핑거프린팅을 우회하는 Rust 기반 HTTP 클라이언트로, Cloudflare·DataDome 같은 봇 탐지 우회가 필요한 웹 스크래핑·자동화에 특화

개발 재료맘대로 써도 됨 · MIT데이터·크롤링TypeScript난이도
128+0이번 주0 찜
10포크2이슈

중간맛 분석

스택: Rust 네이티브 바인딩 + TypeScript 래퍼, Node.js HTTP 클라이언트 난이도: fetch() 호출만으로도 기본 사용 가능하지만 고급 세션·프록시·WebSocket 활용 시 학습곡선 있음 바로 쓸 수 있나: 네. install 후 fetch('url', {browser: 'chrome_142'}) 한 줄이면 작동 데모: 의 quickstart 예제로 즉시 테스트 가능하며, 공식 문서(wreq.sqdsh.win)에 sessions, WebSockets, proxy, streaming 사용 예제 충실

이런 레포예요

이럴 때 쓰면 좋아요

  • Cloudflare·DataDome 같은 봇 탐지 시스템이 있는 사이트에서 Node.js로 데이터 수집할 때
  • API가 브라우저 요청만 받고 Node.js 요청을 거부할 때 정상적인 브라우저 프로필로 우회
  • 멀티스텝 로그인 플로우나 세션 유지가 필요한 자동화 스크래핑

핵심 기능

Chrome, Firefox, Safari, Edge, OkHttp 등 실제 브라우저 TLS·HTTP 프로필 사전 탑재Rust 네이티브 바인딩으로 고속 처리, 브라우저 프로세스 오버헤드 없음Fetch 스타일 API + 세션·쿠키·프록시·WebSocket 지원

대안 대비 차별점

Rust 네이티브 계층에서 TLS 핸드셰이크와 네트워크 동작이 완전히 구현되어 있어 순수 JavaScript 헤더 조작(got-scraping) 대비 우회 신뢰성이 높고, Go 서브프로세스 모델(CycleTLS) 대비 성능과 메모리 효율이 우수하며, 다중 OS 프리빌드로 배포 편의성을 갖춘다.

바로 시작하기

  1. 패키지 설치
npm install wreq-js
  1. 기본 fetch 호출 (크롬 142 프로필, 윈도우 OS 지정)
node -e "import { fetch } from 'wreq-js'; fetch('https://example.com/api', { browser: 'chrome_142', os: 'windows' }).then(r => r.json()).then(console.log)"
  1. 세션 생성 및 여러 요청 재사용 (권장)
node -e "import { createSession } from 'wreq-js'; (async () => { const s = await createSession({browser: 'chrome_142'}); console.log(await (await s.fetch('https://example.com')).status); await s.close(); })()"
  1. WebSocket 연결 (브라우저 프로필과 헤더 적용)
node -e "import { websocket } from 'wreq-js'; (async () => { const ws = await websocket('wss://example.com/ws', {browser: 'chrome_142', headers: {Auth: 'token'}}); ws.onmessage = e => console.log(e.data); ws.send('hello'); })()"

별 추이 · 7일

128+0 / 7일

활용성 · 따라 만들기 좋은가

샘플 점수 34/100
  • 관대한 라이선스
  • 테스트 있음
  • 예제 디렉토리
  • 최근 활동
  • AGENTS.md
  • llms.txt
  • 템플릿

🟢 최근 활동 있음 · 2025년 생성

이 레포에 깃밥 배지 달기

[![깃밥](https://www.gitbap.com/badge/sqdshguy/wreq-js.svg)](https://www.gitbap.com/r/sqdshguy/wreq-js)

🔌 클로드에서 바로 써보기

깃밥을 클로드에 연결하면 이런 레포를 클로드·커서·Codex에서 바로 찾고 체험할 수 있어요.

방법 ① 커넥터 URL

클로드 설정 → 커넥터에 이 주소를 붙여넣기.

https://www.gitbap.com/api/mcp
방법 ② 플러그인 (체험까지)

플러그인을 설치하면 /gitbap-trending·/gitbap-try 슬래시 커맨드로 레포를 그 자리에서 체험. Claude Code에서 아래 두 줄을 차례로 실행하세요.

/plugin marketplace add jakeparkcolde/gitbap-cowork
/plugin install gitbap-cowork@gitbap
연결 방법 자세히 →

AI가 README 기반으로 요약했습니다 · 원문 보기