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 → Developer mode

  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 + 拡張機能はユーザーのマシン上で動作します — クラウドではありません。

完全ガイド（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上のランディングページ/ドキュメントはOK。Hub + MCP + 拡張機能 = 常にローカル。 → docs/MCP.md

5. ライブラリモード（軽量Playwright）

npm run exemplo

index.js + inject.js: playwright-core経由のChrome、アクションごとに1回のevaluate、隅に赤いマーク。

セレクタ

  • CSS: button.buy, #email

  • テキスト: text=Entrar

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

拡張機能のデフォルトタイムアウト: 4秒（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）

  • エージェントが何をクリックし得るかを理解せずに共有マシンで実行しないでください

  • 自己責任で使用してください。自動化するサイトの利用規約を尊重してください

ライセンス

MIT · Clique Já · paivaxqz

This server cannot be deployed

Give agents eyes on the webHosted screenshot MCP. Send a URL, get a pixel-perfect image. $0.002 per grab. Works with Claude, Cursor, and Codex.grabbit.liveAd

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
    -