nissia browser
itielsefer23/nissia-browser
Navegação web eficiente para agentes IA com modo humanizado e baixo custo de tokens
Ver no GitHubFerramenta de navegação web otimizada para agentes de IA, construída em Rust. Oferece busca, navegação e modo agente com automação humanizada (fecha banners, preenche formulários, simula comportamento humano) gastando poucos tokens. Funciona como CLI em Windows, macOS e Linux.
Instalação
npx convez-ai itielsefer23/nissia-browser1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Agentes IA executarem buscas na web e extrair resultados sem screenshots
- Automação de formulários e interações web com comportamento humanizado
- Navegação discreta evitando detecção de bot com geolocalização e user-agent consistentes
Veredito

Solução técnica bem pensada para reduzir custo de tokens em automação web com agentes. O modo humanizado com gestão de cookies, mouse realista e comportamento adaptativo é genuinamente útil, embora exija familiaridade com CLI e integração em pipelines de agentes.
README
A tradução para o português deste README ainda está na fila.
nissia browser lets an AI coding agent (Claude Code, Codex, Cursor and others) use a real web browser while spending very few tokens. It is a small command-line tool: your agent runs simple commands and only the useful result comes back. No MCP server, no heavy screenshots, and no API keys for everyday use. Works on Windows, macOS and Linux.
What's new in v0.3.4
Agent-mode browsing is now genuinely human, can sign in once and stay warm, can finish a purchase safely, and is harder to detect. All of it runs inside the binary (0 extra tokens) and is adaptive (full realism where it matters, fast everywhere else).
- 🧑 Human browsing (
--pace fast|human|protected): curved mouse with jitter and overshoot, scroll with inertia, lognormal typing with the occasional typo, and a pause after a page loads. - 🔎 Operates like a person: uses the site's own search box, applies filters one by one and sorts, scrolls the listing for real, opens a few product pages and compares.
- 📊 Honest reporting: counts only what actually entered the viewport ("scanned N of M"), never claims to have read the whole page.
- 🔐 Warm logged-in profile (
nissia browser login): sign in to your accounts once; the session persists and is reused (also the strongest anti-bot signal). - 🛒 Safe buying: stops at the order summary and waits for your explicit OK before paying, and refuses to type card / CVV fields.
- 🥷 Stealth 2026: consistent geo / timezone / language / user-agent across the session;
verified 0 flags on bot.sannysoft; never calls
Runtime.enable. - 🩹 Fixes:
read --focusnow picks the richest matching block (no more grabbing an embedded card), reliable clicks on lazy SPAs, andinstall.ps1adds nissia to your PATH.
See the full changelog or the v0.3.4 release.
Why it is cheap and fast
- It returns just the text or data you ask for, never whole pages or images.
- Whole flows run in one
nissia batch(one connection, one round-trip) with adaptive waits. - A full "operate a form and read the results" task is about 500–900 tokens and a few seconds.
- Works with any agent that can run a shell command.
The 3 modes
- Search — quickly find things on the web and get a short list of results. The fastest.
- Navigate — open a specific site and read or extract what you need (runs in the background, no window).
- Agent — give it a goal: it searches, opens the best page, closes cookie and ad pop-ups, fills forms and reads the answer, in a real visible browser you can watch.
What makes the Agent mode good
- Closes the annoying stuff. Cookie consent banners (OneTrust, Didomi, Sourcepoint, Quantcast, even the ones inside iframes) and ad pop-ups, so the page is readable.
- Acts like a human. Real mouse clicks (including calendar cells and grids via
click --sel), human-paced scrolling and typing, natural referrers, and it keepsnavigator.webdriverfalse without the flag that shows Chrome's "you are automated" banner — so sites do not treat it as a bot. - Recovers like a human. If a page errors or half-loads, it can
reloadand retry. - Signs in once, stays warm.
nissia browser loginopens a dedicated profile so it uses your logged-in accounts (and passes anti-bots better). - Buys safely. With payment already saved and your go-ahead, it reaches the order summary, stops, and only pays after you confirm — and it never types card numbers or CVV.
- Your browser, your choice. Chrome, Edge, Brave or Opera (
nissia browser detect).
Install
nissia is a small nissia binary plus instructions for your agent. A pasted link installs
instructions, not a binary, so the binary step always happens once. Pick whichever is easier:
Easiest: paste this repo's link to your AI agent
Paste https://github.com/itielsefer23/nissia-browser into Claude Code, Cursor, or Codex and say
"install nissia browser". The agent reads this README and does it for you (it will ask before running
the installer, since that downloads and runs a script). Agents: follow For AI agents below.
Or do it yourself (2 steps)
1. Install the binary (one line, no Rust needed):
# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/itielsefer23/nissia-browser/master/install.sh | sh
# Windows (PowerShell)
irm https://raw.githubusercontent.com/itielsefer23/nissia-browser/master/install.ps1 | iex
2. Wire it to your tool:
- Claude Code:
/plugin marketplace add itielsefer23/nissia-browserthen/plugin install nissia-browser@nissia - Cursor / Codex / opencode / any shell agent: run
nissia initin your project (dropsAGENTS.md+.nissia/recipes.md)
That's it. Run nissia --help to see everything. (Build from source instead: git clone the repo, then
cargo install --path crates/nissia-cli.)
For AI agents installing this
A user pasted this repo and asked you to install nissia. Do exactly this:
- Run
nissia --version. If it prints a version, jump to step 4. - The binary is missing. Ask the user to confirm (it downloads and runs a script), then run the
one-liner for their OS from step 1 above. Re-run
nissia --version; if PATH hasn't refreshed, use the path the installer printed. - Set it up for the current tool:
- Claude Code: copy the
skills/nissia-browser/folder into the user's~/.claude/skills/(personal skills are auto-discovered) — or tell the user to run the two/plugincommands above. - Cursor / Codex / opencode / other: run
nissia initin the project root.
- Claude Code: copy the
- Verify:
nissia browser detectlists their browsers andnissia search "test"returns results. Done — tell the user.
Quick examples
nissia search "best laptops 2026" # quick web search
nissia browser detect # which browsers are installed
nissia snap https://example.com --focus main # open a page, list clickable elements
nissia read https://example.com --focus main # read a page as clean text
nissia dismiss # close cookie banners and pop-ups
nissia update # check for a newer version
Run nissia --help to see everything.
Updating
nissia tells you when a newer version is out: nissia update --check (cached for 24h, used by
the skill on startup). Run the installer again to upgrade, then re-copy the skill from this repo.
After installing
- Claude Code: call
/nissia-browser(or just ask it to search/browse). It asks which mode (Search / Navigate / Agent) and, for Agent mode, which browser, then runs nissia for you. Update the plugin with/plugin update nissia-browser@nissia. - Cursor / Codex / other: the agent reads
AGENTS.mdand callsnissia ...directly; the full per-site playbook is in.nissia/recipes.md. Both are created bynissia init.
Documentation
- docs/GUIDE.md — complete guide: the 3 modes, browser selection and default, Agent mode, human navigation (mouse trajectory, typed search, read-scroll, pop-up closing), operating forms, batch, full command reference.
- docs/TOKEN-ECONOMY.md — how it keeps token cost tiny.
- docs/SPEED.md — performance numbers and how to stay fast.
Optional extras
You don't need any of these. The defaults (DuckDuckGo search + you, the agent, driving) work with no setup and no keys. These are only for specific cases:
- SearXNG for better/unlimited search. SearXNG is a
free, open-source metasearch engine you run yourself (one Docker container). It aggregates
Google, Bing, etc. and has no rate limits, so search results are richer than the default. Use
it only if the built-in DuckDuckGo search isn't enough for you. To enable:
- Run an instance (e.g.
docker run -d -p 8888:8080 searxng/searxng) and turn on the JSON output format in itssettings.yml. - Point nissia at it: set
NISSIA_SEARXNG_URL=http://localhost:8888(or add"searxng_url": "http://localhost:8888"to<data-dir>/search.json). - Select it:
NISSIA_SEARCH_PROVIDER=searxng nissia search "your query".
- Run an instance (e.g.
- Hands-off agent (opt-in).
nissia agent "<goal>"runs a small internal LLM loop and prints only the final answer. It needs your own API key inNISSIA_AGENT_API_KEY; it is off by default and the normal search/navigate/agent modes never use it.
Feedback
Ideas, comments and "this site didn't work" reports are very welcome and shape the skill:
- 💡 Open a feedback issue (structured form).
- 🐞 Report a bug.
- 💬 Discussions for free-form comments and questions.
License
MIT — free to use, change and share, including in commercial projects. The only rule is to keep the license and copyright notice. nissia is a fork of the MIT-licensed snact project by Kiyeon Jeon, whose original copyright is kept in LICENSE next to ours.