Skip to main content
Glama
deenesjakoptruzh
paivaxqz

cliqueja

by paivaxqz
OverviewSchemaRelated ServersScoreDiscussions
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 installed

A
license - permissive license
Not graded
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • monkeysee

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

  • Real Browser MCP

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

  • Browser MCP

    CypherPotato
    F
    license
    Not graded
    quality
    C
    maintenance
    Enables MCP clients to control a real local browser window for web automation tasks such as clicking, typing, scrolling, and taking screenshots.
    11

View all related MCP servers

Related MCP Connectors

  • browser-mcp

    Hosted real Google Chrome MCP with per-user persistent state. Navigate, click, type, screenshot.

  • Tap

    Browser MCP for logged-in tasks. Uses your Chrome — credentials stay local. Zero-token replay.

  • Aginx Browser

    Stealth web browser for agents: search, fetch, click and type through persistent sessions over MCP.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/paivaxqz/cliqueja'

If you have feedback or need assistance with the MCP directory API, please join our Discord server