Skip to main content
Glama
deenesjakoptruzh
paivaxqz

cliqueja

by paivaxqz
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Local

Clique Já

존재 이유

Playwright와 puppeteer는 훌륭합니다 — 하지만 “지금 이 버튼만 클릭하면 되는데”에는 무겁습니다.
Clique Já는 이미 Chrome 탭 하나를 잡아, 빨간 마이크로 런타임(__cliqueja)을 주입하고, WebSocket을 통해 밀리초 단위로 명령에 응답합니다.

Clique Já

기존 자동화

브라우저

Chrome 실제 (기존 세션)

격리된 Chromium

세션 / 로그인

이미 로그인됨

재인증 / storage state

클릭당 지연시간

1 evaluate

전체 스택

AI 에이전트

MCP 도구

스크립트 / 커스텀

Related MCP server: monkeysee

흐름도

flowchart LR
  subgraph Agent["Agente / CLI"]
    MCP["mcp.mjs<br/>tools MCP"]
    HTTP["POST /cmd"]
  end

  subgraph Hub["Hub local :17321"]
    H["hub.mjs<br/>WebSocket + HTTP"]
  end

  subgraph Chrome["Chrome"]
    EXT["Extensão Clique Já<br/>service worker"]
    TAB["Aba http(s)"]
    INJ["inject.js<br/>window.__cliqueja"]
  end

  MCP -->|WS| H
  HTTP -->|HTTP| H
  H <-->|WS| EXT
  EXT -->|scripting MAIN world| INJ
  INJ --> TAB

한 번의 클릭 흐름

sequenceDiagram
  participant A as Agente
  participant H as Hub :17321
  participant E as Extensão
  participant P as Página

  A->>H: { method: "click", sel: "button" }
  H->>E: mesmo envelope (WS)
  E->>P: inject + __cliqueja.click
  P-->>E: ok (+ flash vermelho)
  E-->>H: { ok: true }
  H-->>A: result

자세한 아키텍처: docs/ARCHITECTURE.md

빠른 시작

1. Hub

git clone https://github.com/paivaxqz/cliqueja.git
cd cliqueja
npm install
npm run hub
# ou: start-hub.bat  (Windows)

Hub는 오직 127.0.0.1:17321에서만 수신합니다.

2. 확장 프로그램

  1. Chrome → chrome://extensions → 개발자 모드

  2. Load unpacked → ext/ 폴더

  3. http(s) 사이트를 엽니다 (chrome:// 제외)

  4. 아이콘 클릭 → 이 탭 사용 (배지 ON 빨간색)

3. HTTP 스모크 테스트

curl http://127.0.0.1:17321/status
curl -X POST http://127.0.0.1:17321/cmd -H "content-type: application/json" -d "{\"method\":\"ping\"}"

4. AI의 MCP (사용자 PC)

Hub + 확장 프로그램은 사용자 PC에서 실행됩니다 — 클라우드가 아닙니다.

전체 가이드 (3단계 + Cursor/Claude): docs/MCP.md

Cursor 설정 — 사용자의 clone 경로:

{
  "mcpServers": {
    "cliqueja": {
      "command": "node",
      "args": ["${workspaceFolder}/mcp.mjs"]
    }
  }
}

Cursor에서 연 폴더가 clone이 아니라면 절대 경로를 사용하세요 (C:\\Users\\...\\cliqueja\\mcp.mjs 또는 /Users/.../cliqueja/mcp.mjs).

도구: cliqueja_status · abas · usar_aba · ir · click · fill · texto · snapshot · links · upload

왜 Vercel이 아닌가요?

Vercel은 사용자의 Chrome을 열지도 못하고 확장 프로그램의 WebSocket(127.0.0.1)도 받을 수 없습니다.
Vercel에서 랜딩/문서는 괜찮습니다. Hub + MCP + 확장 프로그램 = 항상 로컬. → docs/MCP.md

5. lib 모드 (가벼운 Playwright)

npm run exemplo

index.js + inject.js: Chrome은 playwright-core를 통해, 동작당 evaluate 1회, 모서리에 빨간 마커 표시.

셀렉터

  • CSS: button.buy, #email

  • 텍스트: text=Entrar

  • XPath: xpath=//button[@type='submit']

확장 프로그램 기본 타임아웃: 4s (inject는 requestAnimationFrame으로 대기합니다).

구조

cliqueja/
├── ext/                 # Chrome MV3 (load unpacked)
│   ├── manifest.json
│   ├── background.js    # WS client + comandos
│   ├── inject.js        # runtime na página
│   ├── popup.*          # UI vermelha
│   └── icon-128.png
├── hub.mjs              # bridge WS/HTTP
├── mcp.mjs              # MCP stdio → hub
├── index.js             # lib Playwright rápida
├── inject.js            # mesmo runtime (lib)
├── exemplo.js
├── start-hub.bat
└── docs/
    └── ARCHITECTURE.md

보안

  • Hub는 localhost 전용 — 포트를 노출하지 마세요

  • 확장 프로그램은 파일 업로드 때에만 debugger를 요청합니다 (CDP DOM.setFileInputFiles)

  • 에이전트가 무엇을 클릭할 수 있는지 이해하지 못한 채 공유 기기에서 실행하지 마세요

  • 사용에 따른 책임은 본인에게 있으며, 자동화하는 사이트의 ToS를 준수하세요

라이선스

MIT · Clique Já · paivaxqz

This server cannot be deployed

Let your AI agent see the webWeb-to-screenshot MCP for Claude, Cursor and Codex. No cookie banners. Free to start.snap-render.comAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • monkeysee

    juliocesar
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables MCP clients to drive a real, logged-in Chrome browser for web automation tasks like navigation, clicking, typing, and screenshotting.
    0
    MIT

  • Real Browser MCP

    ton-to-ton
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables browser automation over MCP using a real Chrome browser with existing profile, supporting real tabs, downloads, cookies, and RPA workflows.
    354 npm
    MIT

  • chrome-mcp

    dawei008
    F
    license
    Not graded
    quality
    D
    maintenance
    Drive your real, signed-in Chrome browser from any MCP client, enabling browser automation such as navigation, clicking, typing, and screenshots through standard MCP tools.
    1
    -