Description

n8n-nodes-ceki

Rent real human browsers inside your n8n workflows.

Ceki lets AI agents and automations rent live, human-operated browsers by the minute — real fingerprints, real IPs, real humans solving captchas. This package brings Ceki into n8n as a native node: drive a rented browser, scrape anti-bot pages, and screenshot from any geo.

• Real human browsers — not headless, not emulation. Actual Chrome sessions with genuine fingerprints that pass anti-bot checks.
• Geo-targeting — appear from RU, EE, US, or wherever a human host is online.
• Captchas solved by humans — navigate to the challenge, a real person solves it in real-time, the flow resumes.
• Pay-as-you-go — from $0.01/min. Pay only for the minutes you use; close the session and billing stops.
• Rent a browser from a workflow — search, rent, navigate, screenshot, scrape, all inside n8n.

Install

In self-hosted n8n: Settings → Community Nodes → Install → @ceki/n8n-nodes-ceki

Manually:

npm install @ceki/n8n-nodes-ceki

Credential

Create it once: Ceki API → set token to your agent token (ag_...) from the Ceki panel. One credential powers every node.

Nodes

Browser Ceki — one node, many operations

Works like the Google Drive or S3 node: pick an Operation and the node shows the relevant fields. Rent rents a browser itself; every other operation takes a session_id and resumes the same session.

| Operation | What it does |
|—|—|
| Rent | Rent a browser (by Schedule ID, or search by geo/price). Outputs a session_id. The session stays in a 120s grace window so the next node can resume it. |
| Navigate | Open a URL. |
| Click / Type / Scroll | Interact with the page (coordinates / text / delta). |
| Screenshot | Capture the page → binary (PNG/base64, optional full-page). |
| Snapshot | Screenshot + the session’s chat history. |
| Wait | Pause for a fixed duration (ms). |
| Wait for Selector | Wait until a CSS selector appears in the DOM (with timeout). |
| Upload | Upload a file (binary) into an by selector. |
| Close | Close the session and stop billing. |

Recipes — one shot, minimal fields, single lifecycle

| Node | What it does |
|—|—|
| Browser Ceki: Screenshot in Geo | Rent in a geo → open URL → screenshot → release. |
| Browser Ceki: Captcha-protected Scrape | Rent → navigate → (optional) wait for selector → requestCaptcha (a human solves it) → screenshot + HTML → release. Ceki’s signature use case: anti-bot sites open because the fingerprint is real. |

Session lifecycle

Each n8n node is stateless: it connects, performs its action, and disconnects. A rented browser survives a short grace window after disconnect, so consecutive nodes can share one session via session_id.

• Operation chains — Rent returns a session_id (disconnect without close → the session lives for 120s). The next node resumes that session, acts, and disconnects again. Ideal for quick multi-step flows.
• Recipes — rent, act, and release inside a single call. One lifecycle, zero resume overhead.

Example flow

[Browser Ceki: Rent] →sessionid→ [Browser Ceki: Screenshot] →sessionid→ [Browser Ceki: Close]
                                                                       ↓
                                                                 [Telegram: sendPhoto]

Example workflows

Ready-made workflows you can import directly into n8n — no configuration needed for the “Hello World” template:

• Hello World: Screenshot via Ceki — Manual trigger → rent a browser → navigate → screenshot → done. Import, attach your Ceki API credential, hit Execute. (5 min setup)
• Form → Create Task + Assign — Web form that creates a Ceki task and assigns an executor.
• Scheduled: Assign Backlog Task — Hourly scheduler that finds a cheap browser, picks a backlog task, assigns an agent.
• Telegram Bot → Screenshot — Send a URL to a Telegram bot, get back a screenshot from a real human browser in a chosen geo.
• Publish to Platform — Manual trigger → human-browser automation for vc.ru / Mataroa / HackerNoon posting.
• Create + Assign via Native Node — Use dedicated contract operations instead of HTTP calls.

All templates, setup instructions, and API details: Ceki-me/n8n-templates.

Develop

npm install
npm run build      # tsc → dist/
npm run typecheck

To use locally in n8n, link dist/ via N8NCUSTOMEXTENSIONS or NODE_PATH.

Links

• browser.ceki.me — rent a browser or become a host
• Docs — API key, SDK reference, recipes
• MCP — drive Ceki from any MCP-compatible agent

License

MIT.