convez.ai
MCP ServerAutomaçãoIntermediário
itielsefer23

nissia browser

itielsefer23/nissia-browser

Navegação web eficiente para agentes IA com modo humanizado e baixo custo de tokens

Ver no GitHub
InicialPluginScore · de 0 a 100

Ferramenta 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-browser

1 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

Estrelas
1
Forks
0
Acompanhando
1
Saúde
71%
Último commit
há 5 meses
Versão
v0.3.4
Issues abertas
0
Contribuidores
2

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 --focus now picks the richest matching block (no more grabbing an embedded card), reliable clicks on lazy SPAs, and install.ps1 adds 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

  1. Search — quickly find things on the web and get a short list of results. The fastest.
  2. Navigate — open a specific site and read or extract what you need (runs in the background, no window).
  3. 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 keeps navigator.webdriver false 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 reload and retry.
  • Signs in once, stays warm. nissia browser login opens 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-browser then /plugin install nissia-browser@nissia
  • Cursor / Codex / opencode / any shell agent: run nissia init in your project (drops AGENTS.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:

  1. Run nissia --version. If it prints a version, jump to step 4.
  2. 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.
  3. 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 /plugin commands above.
    • Cursor / Codex / opencode / other: run nissia init in the project root.
  4. Verify: nissia browser detect lists their browsers and nissia 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.md and calls nissia ... directly; the full per-site playbook is in .nissia/recipes.md. Both are created by nissia 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:
    1. Run an instance (e.g. docker run -d -p 8888:8080 searxng/searxng) and turn on the JSON output format in its settings.yml.
    2. Point nissia at it: set NISSIA_SEARXNG_URL=http://localhost:8888 (or add "searxng_url": "http://localhost:8888" to <data-dir>/search.json).
    3. Select it: NISSIA_SEARCH_PROVIDER=searxng nissia search "your query".
  • 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 in NISSIA_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:

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.

Ver o original no GitHub

Bom para

Relacionados