agentrhq/webcmd
Self-learning agent browser
Webcmd란 무엇인가?
Webcmd는 AI 에이전트를 위한 자기 학습 브라우저 자동화 레이어입니다. 에이전트가 실제 브라우저(Playwright 스타일 명령을 통해)를 제어할 수 있게 하면서, 마주치는 페이지, 작업, API의 로컬 "사이트맵 메모리"를 자동으로 구축합니다. 다음에 에이전트가 같은 사이트에서 작업해야 할 때, 전체 사이트를 다시 탐색하는 대신 해당 메모리를 재사용할 수 있어 토큰 사용량과 비용을 최대 90% 절감합니다.
핵심 개념
| 레이어 | 도움이 되는 경우 | 제공 내용 |
|---|---|---|
| 0. 실시간 브라우저 제어 | 사이트가 새롭거나 작업에 최신 데이터가 필요한 경우. | webcmd browser를 통해 에이전트는 실제 브라우저 세션에서 클릭, 입력, 네트워크 호출 캡처, 콘텐츠 스크래핑을 할 수 있습니다. |
| 1. 사이트맵 메모리 | 사이트는 알려져 있지만 정확한 워크플로우가 알려지지 않은 경우. | Webcmd는 관찰된 페이지, 상태, 작업, 폴백 경로의 사이트맵을 기록합니다. 이 메모리는 로컬(또는 Webcmd Cloud)에 저장되며 이후 에이전트가 쿼리할 수 있습니다. |
작동 방식 (높은 수준)
- 세션 시작 – 프로필은 쿠키를 저장합니다; 세션은 해당 프로필 내의 격리된 브라우저 창입니다.
- 실시간 명령 실행 – 에이전트는 Playwright 스타일 스크립트(또는 간단한 CLI 명령)를 세션에 보냅니다.
- 조용히 학습 – 브라우저가 실행되는 동안 Webcmd는 유용한 탐색 정보(링크, 양식, API 호출, 페이지 제목 등)를 추출하여 로컬 메모리에 추가합니다.
- 메모리 재사용 – 향후 에이전트는 저장된 사이트맵이나 특정 페이지 데이터를 Webcmd에 요청할 수 있어 재탐색을 피할 수 있습니다.
- 선택적 클라우드 – 첫 액세스는 Webcmd Cloud에서 시드를 가져올 수 있습니다; 이후 학습은 사용자 머신에 유지됩니다.
빠른 시작 (README에서)
# 전역 설치 (Node 20.6+ 필요)
npm install -g @agentrhq/webcmd
# 브라우저 스킬 추가 (Claude, Codex 등 선택)
webcmd skills add
스킬을 설치한 후 다음과 같은 명령을 실행할 수 있습니다:
webcmd를 사용하여 Hacker News와 Reddit에서 브라우저 자동화에 대한 최신 논의를 조사하고, 소스 링크와 함께 간결한 비교를 반환하세요.
에이전트는 실제 브라우저를 시작하고 검색을 수행하며 탐색 컨텍스트를 나중에 재사용할 수 있도록 저장합니다.
예시 사용 사례
- 연구 집계 – PubMed, Reddit, Hacker News에서 제목, 초록, URL을 가져와 깔끔한 요약을 반환합니다.
- 전자상거래 모니터링 – Grainger에서 부품 번호를 조회하고 가격/재고 정보를 가져와 SAP 구매 주문 상태와 결합합니다.
- 소셜 미디어 큐레이션 – 로그인된 LinkedIn 프로필로 읽지 않은 메시지를 요약; X/Twitter 프로필로 최근 북마크를 수집합니다.
- AI 도구 검색 – 과거 ChatGPT 또는 Claude 대화, 노트북, 생성된 자산을 가져옵니다.
- 예약 및 쇼핑 – Amazon, Blinkit, Practo 등에서 제품 가용성, 가격, 예약 슬롯을 비교합니다.
벤치마크
Webcmd는 BU Bench V1 100개 작업 브라우저 자동화 스위트에서 평가되었습니다. 달성:
- 67% 정확도 (테스트된 도구 중 가장 높음)
- 작업당 $0.255 비용 (가장 낮음)
- 작업당 9.8 에이전트 턴 (가장 적음)
벤치마크는 모든 도구에 동일한 Pi 컨트롤러, Codex
gpt-5.4판정자, CloakBrowser 엔진을 사용하여 비교를 공정하게 했습니다.
설치 및 기본 명령
| 명령 | 용도 |
|---|---|
webcmd skills add |
브라우저 스킬 하네스 설치 (Claude, Codex, 사용자 정의). |
webcmd --profile <name> session create "<desc>" -f json |
새 격리 세션 생성; 세션 ID 반환. |
webcmd --profile <name> --session <id> browser run --file explore.js |
세션 내에서 Playwright 스타일 스크립트 실행. |
webcmd --profile <name> --session <id> browser tabs |
세션에서 열린 탭 나열. |
webcmd --profile <name> --session <id> browser run --stdin |
한 줄 스크립트 파이프 (예: return await page.title();). |
webcmd --profile <name> session close <id> |
세션을 닫고 리소스 정리. |
제한 사항 및 현재 상태
- 베타 / 불안정 – 프로젝트는 활발히 개발 중; API는 변경될 수 있습니다.
- 로컬 메모리만 – 머신 간 영구 공유에는 선택적 Webcmd Cloud(아직 개발 중)가 필요합니다.
- 실제 브라우저 필요 – 내부적으로 Playwright를 사용하므로 헤드리스 또는 헤드 브라우저 환경이 필요합니다.
- 에이전트 특정 프롬프트 – 이 도구는 LLM 프롬프트에서 호출되도록 설계되었습니다; 원시 CLI 사용은 가능하지만 덜 인체공학적입니다.
라이선스
Apache 2.0 (LICENSE 참조).
더 알아보기
- 문서 – https://webcmd.dev/docs (에이전트 프롬프트, 개념, CLI 참조)
- Discord 커뮤니티 – https://discord.gg/9YP2C9tvMp
- GitHub 저장소 – https://github.com/agentrhq/webcmd
TL;DR
Webcmd는 AI 에이전트에게 라이브 브라우저 + 메모리 조합을 제공합니다: 에이전트는 실시간 웹 작업을 수행할 수 있고, 시스템은 재사용 가능한 사이트맵을 조용히 기록하여 후속 작업의 반복 탐색과 토큰 비용을 크게 줄입니다. Playwright 위에 구축된 Node 기반 CLI로, 연구, 소셜, 쇼핑, AI 도구 자동화 시나리오를 대상으로 합니다.
관련
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트