Community연구 & 데이터 분석github.com

huangyrcn/web-kit

AI 에이전트 스킬 (검색 + 페이지 읽기 + 다운로드): 단일 컨테이너 백엔드(SearxNG + Chrome/CDP, 4계층 자가 치유)로 자체 호스팅합니다.

web-kit란 무엇인가요?

huangyrcn/web-kit은 AI 에이전트(예: Claude Code, Cursor, Codex)가 웹 검색, 페이지 읽기, 파일 다운로드를 수행할 수 있도록 설계된 스킬입니다. 이 스킬은 SearxNG(메타 검색 엔진)와 Chrome(CDP 프로토콜)을 단일 Docker 컨테이너로 패키징하여 자체 호스팅 환경을 제공합니다. '4계층 자가 치유' 메커니즘을 통해 컨테이너 내부 서비스의 장애를 자동으로 감지하고 복구하여, 긴 세션에서도 안정적인 웹 상호작용을 보장합니다. 개발자는 이 스킬을 통해 에이전트에게 검색 기능, 웹 페이지 콘텐츠 추출, 파일 다운로드 기능을 부여할 수 있으며, 외부 API 의존성 없이 완전한 프라이버시를 유지할 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add huangyrcn/web-kit

Installed? Explore more 연구 & 데이터 분석 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

web-kit은(는) 무엇을 하나요?

AI 에이전트 스킬 (검색 + 페이지 읽기 + 다운로드): 단일 컨테이너 백엔드(SearxNG + Chrome/CDP, 4계층 자가 치유)로 자체 호스팅합니다.

개요

이 스킬은 AI 에이전트가 웹에서 정보를 검색하고, 페이지 내용을 읽고, 파일을 다운로드할 수 있게 해줍니다. 백엔드는 SearxNG(메타 검색 엔진)와 Chrome(CDP 프로토콜)을 하나의 Docker 컨테이너로 결합하여 간편한 자체 호스팅을 지원합니다.

특징

  • 검색: SearxNG를 통한 익명 메타 검색
  • 페이지 읽기: Chrome CDP를 이용한 웹 페이지 콘텐츠 추출
  • 다운로드: 파일 다운로드 지원
  • 4계층 자가 치유: 서비스 장애 자동 감지 및 복구
  • 단일 컨테이너: 손쉬운 배포 및 관리

시작하기

필수 조건

  • Docker 및 Docker Compose 설치

실행 방법

git clone https://github.com/huangyrcn/web-kit.git
cd web-kit
cp .env.example .env  # 환경 변수 설정
docker-compose up -d

환경 변수

변수설명기본값
SEARXNG_PORTSearxNG 포트8888
CHROME_CDP_PORTChrome CDP 포트9222
HEAL_INTERVAL자가 치유 검사 간격(초)30

스킬 사용법

AI 에이전트에게 다음과 같은 명령을 내릴 수 있습니다:

아키텍처

graph TD
    A[AI 에이전트] -->|검색/읽기/다운로드 요청| B[web-kit API]
    B --> C[SearxNG 검색 엔진]
    B --> D[Chrome CDP]
    E[자가 치유 모니터] --> C
    E --> D

라이선스

MIT

관련 스킬