Clique Já

Почему существует

Playwright и puppeteer отличные — но тяжёлые для «просто кликнуть на эту кнопку сейчас».
Clique Já захватывает вкладку Chrome, которую вы уже используете, внедряет красный микро-рантайм (__cliqueja) и отвечает на команды через WebSocket за миллисекунды.

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. Загрузить распакованное → папка 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. MCP в ИИ (ПК пользователя)

Hub + расширение работают на машине пользователя — не в облаке.

Полное руководство (3 шага + Cursor/Claude): docs/MCP.md

Конфиг Cursor — путь до клона пользователя:

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

Если открытая в Cursor папка не является клоном, используйте абсолютный путь (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, 1 evaluate на действие, красная метка в углу.

Селекторы

• 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