Community이미지github.com

steipete/browser-use

기존 Chrome 세션을 활용한 브라우저 작업 자동화: Chrome 플러그인 우선, mcporter 폴백.

browser-use란 무엇인가요?

이 기술은 사용자의 기존 Chrome 프로필과 세션을 재사용하여 브라우저 작업을 자동화합니다. 로그인이 필요한 웹사이트에서 격리된 프로필을 사용하면 캡차, 장치 확인, SSO/확장 프로그램 상태 누락 등이 발생할 수 있기 때문에, 가능하면 기존 Chrome 프로필을 사용하는 것이 강력히 권장됩니다. Codex 세션에서 `Chrome` 또는 `Chrome [Internal]` 플러그인을 직접 호출할 수 있으면 해당 플러그인을 사용하고, 그렇지 않으면 mcporter의 `chrome-devtools` 라우트를 폴백으로 사용합니다. 브라우저 자동화는 Playwright, Puppeteer, AppleScript 등 대체 도구를 사용하지 않고 오직 이 경로를 통해서만 수행하며, 스크린샷이나 라이브 UI 문제 해결에 특히 유용합니다. 또한 Chrome의 원격 디버깅 연결 요청(Allow remote debugging?)을 Peekaboo를 통해 자동 처리하는 기능을 포함하며, 연결 실패 시 조용히 다른 도구로 전환하지 않고 사용자에게 알립니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/browser-use

Installed? Explore more 이미지 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

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

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

문서

Browser Use

기존 Chrome 세션에 대한 브라우저 작업에 사용합니다.

설정 복구 세부 사항은 mcporter-config.md에 있습니다.

경로

  1. 현재 세션에서 Codex Chrome 또는 Chrome [Internal] 플러그인을 호출할 수 있으면, 해당 플러그인에 번들된 Chrome 제어 기술을 사용합니다.
  2. 그렇지 않으면 아래 mcporter chrome-devtools 경로를 사용합니다.

디스크에 번들 또는 설치되어 있다고 해서 사용 가능한 것은 아닙니다. 플러그인이 활성 세션에서 호출 가능해야 합니다. 두 경로 모두 사용자의 기존 Chrome 프로필을 사용해야 합니다.

mcporter 폴백의 경우 다음 대상을 사용하세요:

mcporter call chrome-devtools.<tool>

로그인이 많이 필요한 사이트는 격리된 프로필에서 대부분 실패합니다. 새 세션은 캡차, 장치 확인, SSO/확장 프로그램 상태 누락을 유발하기 때문입니다. 로그인이 필요한 모든 웹사이트에 대해 기존 Chrome 프로필을 강력히 선호합니다.

사용자가 명시적으로 격리된/새 브라우저를 요청하지 않는 한, 브라우저 제어에 chrome-isolated, Playwright, Puppeteer, Codex 앱 내 브라우저, AppleScript, osascript, GUI 스크립팅 또는 macOS open을 절대 사용하지 마십시오.

스크린샷/라이브 UI 버그는 이 기존 Chrome 경로가 필요합니다. curl, 소스 검사, Worker 스모크 테스트 또는 로컬 Playwright는 보조 증빙 자료일 뿐입니다. 사용자가 렌더링된 브라우저 문제를 보여주거나 페이지가 로그인/프로필 상태에 의존할 수 있는 경우 동등한 것으로 취급하지 마십시오.

MCP 확인

mcporter list chrome-devtools --schema
mcporter call chrome-devtools.list_pages --args '{}' --output text

list_pages는 사용자의 실제 열린 탭을 표시해야 합니다. 빈/기본 격리된 Chrome을 표시하면 중단하고 재연결 실패를 알리십시오.

호출이 Chrome이 인증/연결/업데이트 프롬프트를 표시하는 동안 중단된 것처럼 보이면, 폴백하기 전에 연결 알림을 처리하십시오. 보이는 Chrome Allow 버튼을 누르려면 Peekaboo를 선호하고, 그렇지 않으면 사람이 처리할 때까지 기다리십시오. 첫 번째 출력이 느리다고 데몬을 다시 시작하거나 MCP 프로세스를 종료하지 마십시오.

테스트된 연결 프롬프트 복구:

PB="${PEEKABOO_BIN:-$HOME/bin/peekaboo}"
[ -x "$PB" ] || PB="$(command -v peekaboo)"
"$PB" permissions status --json
"$PB" see --app frontmost --path /tmp/chrome-attach.png --json --annotate
# UI에 Chrome "Allow remote debugging?"이 표시되면, 보이는 Allow 버튼만 클릭하십시오.
"$PB" click --coords <allow_x>,<allow_y> --json
mcporter call chrome-devtools.list_pages --args '{}' --output text

오래된 메모가 아닌 현재 Peekaboo 스냅샷의 좌표를 사용하십시오. 성공은 list_pages가 사용자의 실제 Chrome 탭을 반환함을 의미합니다.

연결 알림 규칙: 현재 스냅샷에 Chrome이 DevTools/MCP/브라우저 자동화 연결을 허용하라는 메시지가 명확히 표시되면, 보이는 Allow 버튼을 한 번 클릭한 다음 list_pages를 다시 실행하십시오. 버튼이 보이지 않거나 프롬프트가 모호하면 중단하고 물어보십시오. 조용히 Playwright/Puppeteer로 전환하지 마십시오.

list_pages가 DevToolsActivePort 오류로 실패하면, 사용자에게 Chrome 또는 DevTools 브리지를 다시 시작하도록 요청한 후 한 번 재시도하십시오:

mcporter daemon restart
mcporter call chrome-devtools.list_pages --args '{}' --output text

여전히 실패하면 중단하고 Chrome DevTools MCP를 사용할 수 없다고 알리십시오. AppleScript를 사용하지 마십시오.

시끄러운 복구 루프를 피하십시오. 반복된 MCP/브라우저 재시작은 재연결/로그인 프롬프트 및 알림을 트리거할 수 있습니다. 한 번 시도한 후 일시 중지하고 더 조용한 경로를 선택하십시오.

일반적인 흐름

# list_pages에서 페이지 ID 선택
mcporter call chrome-devtools.select_page --args '{"pageId":9}' --output text

# 페이지 검사
mcporter call chrome-devtools.take_snapshot --args '{}' --output text

# 선택한 페이지 탐색
mcporter call chrome-devtools.navigate_page --args '{"url":"https://example.com"}' --output text

# 최신 스냅샷의 요소 uid 클릭
mcporter call chrome-devtools.click --args '{"uid":"1_38","includeSnapshot":true}' --output text

# 입력/채우기
mcporter call chrome-devtools.fill --args '{"uid":"1_13","value":"text","includeSnapshot":true}' --output text

# JS 실행, 출력에서 비밀 유지
mcporter call chrome-devtools.evaluate_script --args '{"function":"() => document.title"}' --output json

작업 전에 take_snapshot을 사용하고 현재 uid 값만 사용하십시오. 시각적 레이아웃이 중요하지 않으면 take_screenshot을 피하십시오.

라이브 UI 증명

스크린샷 회귀, 배포된 대시보드 확인 또는 렌더링된 브라우저가 버그인 모든 경우:

mcporter call chrome-devtools.list_pages --args '{}' --output text
mcporter call chrome-devtools.select_page --args '{"pageId":9}' --output text
mcporter call chrome-devtools.navigate_page --args '{"url":"https://example.com"}' --output text
mcporter call chrome-devtools.take_snapshot --args '{}' --output text
mcporter call chrome-devtools.evaluate_script --args '{"function":"() => document.body.innerText"}' --output json

기존 로그인/프로필을 포함하는 탭 세트를 사용하십시오. 브라우저 자동화를 사용할 수 없으면, 격리된 브라우저 도구로 대체하는 대신 이를 검증 격차로 보고하십시오.

비밀 처리

페이지 DOM, 네트워크 로그 또는 입력에서 토큰/비밀번호를 절대 출력하지 마십시오. 토큰 확인의 경우 모양만 반환하십시오: 있음/없음, 길이, 상태 코드, 계정/조직 이름.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

steipete/nano-banana-pro

Nano Banana/Gemini image gen/edit: text/image input, 512-4K workflows.

관련 스킬