# BrowserLemon 🍋

로컬 Chrome의 **현재 로그인 세션**을 AI가 MCP로 제어할 수 있게 해 주는 오픈소스 브라우저 브리지입니다. SNS 초안 작성과 사용자 승인 후 게시 흐름에 초점을 맞춥니다.

> Early MVP: 직접 검토 없이 운영 계정에 게시하지 마세요. 사이트 UI 변경에 따라 element ref가 무효화될 수 있습니다.

## 특징

- MCP 표준 입출력(stdio) 서버
- 이미 로그인된 Chrome 탭 사용: 쿠키와 비밀번호를 MCP 서버로 복사하지 않음
- 페이지 요약, 탭 목록, 이동, 클릭, 입력
- `draft_social_post`와 명시적 `confirmed=true`가 필요한 `publish_social_post`
- 로컬호스트 전용 WebSocket 및 게시 도메인 allowlist
- MIT 라이선스

## 설치

```bash
npm install
npm run build
```

Chrome에서 `chrome://extensions` → **개발자 모드** → **압축해제된 확장 프로그램을 로드** → 이 저장소의 `extension` 폴더를 선택합니다.

MCP 클라이언트 설정 예시:

```json
{
  "mcpServers": {
    "browserlemon": {
      "command": "node",
      "args": ["/absolute/path/to/browserlemon/dist/index.js"]
    }
  }
}
```

MCP 클라이언트를 재시작한 뒤 Chrome 툴바의 BrowserLemon 아이콘을 누릅니다. 배지에 `ON`이 표시되면 연결되었습니다.

## 권장 워크플로

1. `browser_status`로 연결 확인
2. `list_tabs`와 `read_page`로 대상 및 composer ref 확인
3. `draft_social_post`로 글 입력
4. 사용자가 브라우저에서 내용을 검토
5. 사용자가 명시적으로 승인한 경우에만 `publish_social_post(confirmed=true)` 호출

## 보안 모델

확장 프로그램은 사용자의 브라우저 권한으로 실행되므로 강력합니다. 신뢰하는 로컬 MCP 클라이언트에서만 서버를 실행하세요. 브리지는 `127.0.0.1`에만 바인딩되며 비밀번호 입력값은 페이지 스냅샷에서 제외됩니다. 다만 페이지 본문에는 개인정보가 포함될 수 있으므로 연결한 AI 서비스의 데이터 정책도 확인해야 합니다.

지원 게시 도메인: X/Twitter, LinkedIn, Facebook, Instagram, Threads, Bluesky, Mastodon.social. 읽기·초안 입력은 일반 http(s) 페이지에서도 가능합니다.

## 기여

버그 리포트와 PR을 환영합니다. 다음 우선순위는 per-site adapter, 이미지 업로드, 예약 게시, 감사 로그, 확장 프로그램 권한 세분화입니다.