원문: markfulton/agent-cookie-sync · 수집일: 2026-10-04 · 커밋
2787d9e(2026-09-25) · Stars 63 · MIT · 릴리스 없음 · 제작: Reinventing.AI(Mark Fulton)
한 줄 요약
클라우드에서 도는 에이전트는 자기만의 빈 브라우저를 쓰기 때문에 첫 작업부터 로그인 벽에 막힌다. 이 레포는 내 Chrome이 가진 세션 쿠키를 골라서 로컬 폴더로 내보내고, 에이전트가 그 파일을 받아 자기 Chrome에 주입하는 다리를 제공한다. 비밀번호는 오가지 않지만, 쿠키 자체가 “나로서 로그인된 상태”이므로 사실상 세션 탈취와 같은 권한을 의도적으로 위임하는 구조다.
동작 구조
세 부분으로 나뉜다.
| 구성 | 위치 | 역할 |
|---|---|---|
| Chrome 확장(Manifest V3) | 내 PC | cookies·alarms·nativeMessaging·storage 권한(+선택적 history)으로 쿠키를 읽어 내보냄 |
네이티브 호스트 cookie_sync_host.py | 내 PC | 확장이 stdin으로 보낸 쿠키 목록을 cookies.json, 메타를 cookies.meta.json으로 저장 |
agent/inject-cookies.py | 에이전트 PC | 받은 cookies.json을 CDP Storage.setCookies로 에이전트 Chrome에 주입 |
- 저장 위치: Windows는
%LOCALAPPDATA%\AgentCookieSync, 그 외는~/.agentcookiesync. - 내보내기 시점: 기본 15분 주기(변경 가능), 확장 아이콘 클릭, 온디맨드(
Request-Sync.ps1/request-sync.sh가sync-request.flag를 만들면 확장이 약 1분 내 내보내고 플래그 삭제), 그리고 로그인 쿠키가 바뀐 직후의 “즉시 동기화”(최대 2분에 1회). - 폴더 전송은 이 레포의 일이 아니다. 내 PC의 폴더를 에이전트 PC로 가져오는 동기화는 에이전트가 따로 수행하며, 확장과 호스트는 네트워크 호출이 전혀 없다고 명시한다.
- 주입 스크립트는
--remote-debugging-port로 뜬 에이전트 Chrome(Grok Bot·Muse는 기본으로 이렇게 뜬다)에 CDP로 붙는다(예:--port 9224 --dry-run). Chrome 130+가--remote-allow-origins=*없이는 CDP 웹소켓을 거부하는 문제는suppress_origin=True로 우회한다.--domains로 허용 도메인만 주입할 수 있고 쿠키 값은 출력하지 않는다.
무엇을 동기화할지 고르는 규칙
옵션 페이지에서 설정하며 적용된 규칙은 cookies.meta.json의 filter에 기록되어 에이전트가 받은 범위를 알 수 있다.
- 사이트 선택: 전체 / 고른 사이트만 / 고른 사이트 제외.
- 최근 사용 필터: 오늘·7·30·90일. Chrome은 쿠키 생성 시각을 저장하지 않으므로 브라우징 기록(선택 권한, 처음 고를 때 요청)과 설치 이후 관측한 쿠키 변경으로 추정한다.
- Google·Meta·X 상시 제외: 사이트 규칙을 담은
lib.js는 “never the big three”를 원칙으로 한다. README가 꼽는 대상은 Gmail, Drive, Search Console, Google Ads, YouTube, Facebook, Instagram, WhatsApp, Meta Ads Manager, x.com이다.
보안 모델: 작게 만들고 위험은 사용자에게
SECURITY.md는 경계를 분명히 적는다. 로컬 코드는 네트워크·서버·텔레메트리·업데이트 확인이 없고, 호스트는 쿠키 값을 출력하거나 로그하지 않는다. 한편 다음은 “보안 이슈가 아니다”라고 선을 긋는다.
cookies.json이 목록 내 모든 사이트에 나로서 로그인하는 키라는 점 → 폴더를 비밀번호 금고처럼 다루라.- 같은 계정의 봇들이 한 클라우드 컴퓨터를 공유하므로 로그인도 공유된다는 점 → 회사 직원에게 줄 만한 계정만 든 별도 Chrome 프로필에서 동기화하라.
- 사이트가 새 위치의 세션을 보고 로그아웃시키거나 추가 확인을 요구하는 것 → 사이트 보호 기능의 정상 동작.
폐기는 세 단계다: 확장 제거 → 동기화 폴더 삭제 → 로그아웃시키고 싶은 서비스의 비밀번호 변경(세션이 무효화됨).
눈여겨볼 점
- Google·Meta·X 제외는 기술이 아니라 계정 보호 정책이다. 클라우드 브라우저가 낯선 환경에서 접속하면 해당 플랫폼의 위험 탐지에 걸려 보안 경고·계정 잠금·광고 계정 정지가 날 수 있다는 이유다. 대신 각 서비스의 MCP·플러그인·공식 API를 쓰라고 안내하고, 에이전트에게 주는 프롬프트에도 이 금지를 넣었다. README와
agent/README.md에 “에이전트를 위한 최종 지침” 섹션이 따로 있어, 문서가 사람과 에이전트 양쪽 독자를 겨냥한다. - “폴더 동기화만으로는 부족하다”: 에이전트 Chrome의 쿠키 저장소는 별개이므로 주입 단계가 핵심이며, 주입 후 사이트를 새로고침해야 한다.
- 제품 깔때기: README 중간에 Agent Ops Club 가입(무료 계정)으로 이어지는 “8 plays”·“8 AI Employees” 홍보 블록과 UTM 링크가 들어 있다. 코드 자체는 MIT이며 “클라이언트 작업에 써도 되지만 클럽 이름으로 배포하지 말라”고 한다.
- 지원 대상은 Grok Bot과 Muse를 기준으로 테스트했다고 하며, 다른 에이전트는 “폴더 동기화가 가능하고 사용자 PC가 아닌 곳에서 브라우징하는 경우”라고만 설명한다. 사용자 PC에서 도는 에이전트에는 필요 없다.
위키 맥락에서의 위치
에이전트에게 로그인된 웹 접근을 주는 방식은 크게 세 갈래로 나뉜다. 이 레포는 그중 가장 단순하고 위험도가 높은 쪽이다.
| 방식 | 예 | 에이전트가 가지는 것 |
|---|---|---|
| 비밀번호를 가리고 로그인 대행 | 2026-07-18-claude-1password-zero-exposure-login | 승인된 로그인 행위, 비밀값은 못 봄 |
| 사용자의 실제 브라우저 세션에 직접 연결 | 2026-03-21-chrome-devtools-mcp-autoconnect | 내 PC의 활성 세션(같은 기계) |
| 세션 쿠키를 복제해 원격에 주입 | Agent Cookie Sync | 쿠키가 담긴 파일 자체(원격 기계) |
- 브라우저 자동화·컴퓨터 사용 에이전트의 전체 지형은 computer-use-agent-landscape와 browser-use를 참고.
- 같은 “로그인된 사용자 명의” 발상을 메신저에 적용한 도구가 2026-10-02-github-agent-messenger-agent-messenger이고, X 쿠키를 써서 리서치하는 스킬로 2026-10-01-github-mvanhorn-last30days-skill이 있다.
- 쿠키 파일이 유출되면 비밀번호·2차 인증을 우회하므로, 1Password류의 “비밀값 비노출” 접근과 정반대 지점에 있다는 점이 비교 포인트다.
확산
- 중국어권 X 계정 @wlzh의 소개 글이 있다.
한계와 주의
- README·SECURITY.md·매니페스트·
agent/README.md를 근거로 했고 설치·실행은 해 보지 않았다. “네트워크 호출 없음”, “쿠키 값 미출력”은 프로젝트 자체 주장이며 전체 소스를 감사하지 않았다. - 레포가 생긴 지 2주 안팎이고 Stars 63, 릴리스·태그가 없어 성숙도는 낮다.
- 호스트가 쿠키를 평문 JSON(
cookies.json)으로 디스크에 쓴다. 암호화 여부는 확인되지 않았고, 동기화 경로(에이전트 PC로의 전송)의 보호는 전적으로 사용자·에이전트 몫이다. - 위험은 쿠키를 받는 원격 환경이 안전한 정도에 비례한다. 같은 계정의 봇이 로그인을 공유하고, 에이전트의 프롬프트 인젝션이 곧 세션 오남용으로 이어질 수 있다는 점은 문서가 아니라 설계에서 도출한 우려다.