{"id":50927677,"url":"https://github.com/itielsefer23/nissia-browser","last_synced_at":"2026-06-17T01:01:07.394Z","repository":{"id":365063792,"uuid":"1270323546","full_name":"itielsefer23/nissia-browser","owner":"itielsefer23","description":"Token-cheap web browsing for AI agents (Claude Code, Codex, Cursor): search, navigate and an agent mode that closes cookie banners and acts human. CLI, no MCP, multi-browser (Chrome/Edge/Opera).","archived":false,"fork":false,"pushed_at":"2026-06-15T19:11:17.000Z","size":188,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-06-15T19:11:29.750Z","etag":null,"topics":["ai-agents","browser-automation","claude-code","cli","llm","rust","token-efficient","web-scraping"],"latest_commit_sha":null,"homepage":null,"language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/itielsefer23.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-06-15T15:46:49.000Z","updated_at":"2026-06-15T19:11:23.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/itielsefer23/nissia-browser","commit_stats":null,"previous_names":["itielsefer23/nissia-browser"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/itielsefer23/nissia-browser","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itielsefer23%2Fnissia-browser","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itielsefer23%2Fnissia-browser/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itielsefer23%2Fnissia-browser/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itielsefer23%2Fnissia-browser/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/itielsefer23","download_url":"https://codeload.github.com/itielsefer23/nissia-browser/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itielsefer23%2Fnissia-browser/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34429493,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-16T02:00:06.860Z","response_time":126,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","browser-automation","claude-code","cli","llm","rust","token-efficient","web-scraping"],"created_at":"2026-06-17T01:00:42.096Z","updated_at":"2026-06-17T01:01:07.389Z","avatar_url":"https://github.com/itielsefer23.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/nissia-browser-icon.png\" alt=\"nissia browser\" width=\"132\"\u003e\n\u003c/p\u003e\n\n\u003ch1 align=\"center\"\u003enissia browser\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cem\u003eA token-cheap way for AI agents to browse the web\u003c/em\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/license-MIT-blue.svg\" alt=\"License\"\u003e\u003c/a\u003e\n  \u003cimg src=\"https://img.shields.io/badge/rust-1.75%2B-orange.svg\" alt=\"Rust\"\u003e\n\u003c/p\u003e\n\n---\n\n**nissia browser** lets an AI coding agent (Claude Code, Codex, Cursor and others) use a real\nweb browser while spending very few tokens. It is a small command-line tool: your agent runs\nsimple commands and only the useful result comes back. No MCP server, no heavy screenshots,\nand no API keys for everyday use. Works on **Windows, macOS and Linux**.\n\n## Why it is cheap and fast\n- It returns just the text or data you ask for, never whole pages or images.\n- Whole flows run in one `nissia batch` (one connection, one round-trip) with adaptive waits.\n- A full \"operate a form and read the results\" task is about **500–900 tokens and a few seconds**.\n- Works with any agent that can run a shell command.\n\n## The 3 modes\n1. **Search** — quickly find things on the web and get a short list of results. The fastest.\n2. **Navigate** — open a specific site and read or extract what you need (runs in the\n   background, no window).\n3. **Agent** — give it a goal: it searches, opens the best page, closes cookie and ad\n   pop-ups, fills forms and reads the answer, in a real visible browser you can watch.\n\n## What makes the Agent mode good\n- **Closes the annoying stuff.** Cookie consent banners (OneTrust, Didomi, Sourcepoint,\n  Quantcast, even the ones inside iframes) and ad pop-ups, so the page is readable.\n- **Acts like a human.** Real mouse clicks (including calendar cells and grids via\n  `click --sel`), human-paced scrolling and typing, natural referrers, and it keeps\n  `navigator.webdriver` false **without** the flag that shows Chrome's \"you are automated\"\n  banner — so sites do not treat it as a bot.\n- **Recovers like a human.** If a page errors or half-loads, it can `reload` and retry.\n- **Your browser, your choice.** Chrome, Edge, Brave or Opera (`nissia browser detect`).\n\n## Install\n\nnissia is a small `nissia` **binary** plus **instructions** for your agent. A pasted link installs\ninstructions, not a binary, so the binary step always happens once. Pick whichever is easier:\n\n### Easiest: paste this repo's link to your AI agent\nPaste `https://github.com/itielsefer23/nissia-browser` into **Claude Code, Cursor, or Codex** and say\n*\"install nissia browser\"*. The agent reads this README and does it for you (it will ask before running\nthe installer, since that downloads and runs a script). Agents: follow **[For AI agents](#for-ai-agents-installing-this)** below.\n\n### Or do it yourself (2 steps)\n**1. Install the binary** (one line, no Rust needed):\n```bash\n# macOS / Linux\ncurl -fsSL https://raw.githubusercontent.com/itielsefer23/nissia-browser/master/install.sh | sh\n# Windows (PowerShell)\nirm https://raw.githubusercontent.com/itielsefer23/nissia-browser/master/install.ps1 | iex\n```\n**2. Wire it to your tool:**\n- **Claude Code:** `/plugin marketplace add itielsefer23/nissia-browser` then `/plugin install nissia-browser@nissia`\n- **Cursor / Codex / opencode / any shell agent:** run `nissia init` in your project (drops `AGENTS.md` + `.nissia/recipes.md`)\n\nThat's it. Run `nissia --help` to see everything. (Build from source instead: `git clone` the repo, then\n`cargo install --path crates/nissia-cli`.)\n\n### For AI agents installing this\nA user pasted this repo and asked you to install nissia. Do exactly this:\n1. Run `nissia --version`. If it prints a version, jump to step 4.\n2. The binary is missing. **Ask the user to confirm** (it downloads and runs a script), then run the\n   one-liner for their OS from step 1 above. Re-run `nissia --version`; if PATH hasn't refreshed, use the\n   path the installer printed.\n3. Set it up for the current tool:\n   - **Claude Code:** copy the `skills/nissia-browser/` folder into the user's `~/.claude/skills/`\n     (personal skills are auto-discovered) — or tell the user to run the two `/plugin` commands above.\n   - **Cursor / Codex / opencode / other:** run `nissia init` in the project root.\n4. Verify: `nissia browser detect` lists their browsers and `nissia search \"test\"` returns results. Done — tell the user.\n\n## Quick examples\n```bash\nnissia search \"best laptops 2026\"             # quick web search\nnissia browser detect                         # which browsers are installed\nnissia snap https://example.com --focus main  # open a page, list clickable elements\nnissia read https://example.com --focus main  # read a page as clean text\nnissia dismiss                                # close cookie banners and pop-ups\nnissia update                                 # check for a newer version\n```\nRun `nissia --help` to see everything.\n\n## Updating\nnissia tells you when a newer version is out: `nissia update --check` (cached for 24h, used by\nthe skill on startup). Run the installer again to upgrade, then re-copy the skill from this repo.\n\n## After installing\n- **Claude Code:** call `/nissia-browser` (or just ask it to search/browse). It asks which mode\n  (Search / Navigate / Agent) and, for Agent mode, which browser, then runs nissia for you. Update the\n  plugin with `/plugin update nissia-browser@nissia`.\n- **Cursor / Codex / other:** the agent reads `AGENTS.md` and calls `nissia ...` directly; the full\n  per-site playbook is in `.nissia/recipes.md`. Both are created by `nissia init`.\n\n## Documentation\n- [docs/GUIDE.md](docs/GUIDE.md) — complete guide: the 3 modes, browser selection and default,\n  Agent mode, human navigation (mouse trajectory, typed search, read-scroll, pop-up closing),\n  operating forms, batch, full command reference.\n- [docs/TOKEN-ECONOMY.md](docs/TOKEN-ECONOMY.md) — how it keeps token cost tiny.\n- [docs/SPEED.md](docs/SPEED.md) — performance numbers and how to stay fast.\n\n## Optional extras\nYou don't need any of these. The defaults (DuckDuckGo search + you, the agent, driving) work\nwith no setup and no keys. These are only for specific cases:\n\n- **SearXNG for better/unlimited search.** [SearXNG](https://github.com/searxng/searxng) is a\n  free, open-source metasearch engine you run yourself (one Docker container). It aggregates\n  Google, Bing, etc. and has no rate limits, so search results are richer than the default. Use\n  it only if the built-in DuckDuckGo search isn't enough for you. To enable:\n  1. Run an instance (e.g. `docker run -d -p 8888:8080 searxng/searxng`) and turn on the JSON\n     output format in its `settings.yml`.\n  2. Point nissia at it: set `NISSIA_SEARXNG_URL=http://localhost:8888` (or add\n     `\"searxng_url\": \"http://localhost:8888\"` to `\u003cdata-dir\u003e/search.json`).\n  3. Select it: `NISSIA_SEARCH_PROVIDER=searxng nissia search \"your query\"`.\n- **Hands-off agent (opt-in).** `nissia agent \"\u003cgoal\u003e\"` runs a small internal LLM loop and prints\n  only the final answer. It needs your own API key in `NISSIA_AGENT_API_KEY`; it is off by\n  default and the normal search/navigate/agent modes never use it.\n\n## Feedback\nIdeas, comments and \"this site didn't work\" reports are very welcome and shape the skill:\n- 💡 [Open a feedback issue](https://github.com/itielsefer23/nissia-browser/issues/new?template=feedback.yml) (structured form).\n- 🐞 [Report a bug](https://github.com/itielsefer23/nissia-browser/issues/new?template=bug_report.yml).\n- 💬 [Discussions](https://github.com/itielsefer23/nissia-browser/discussions) for free-form comments and questions.\n\n## License\n**MIT** — free to use, change and share, including in commercial projects. The only rule is to\nkeep the license and copyright notice. nissia is a fork of the MIT-licensed\n[snact](https://github.com/vericontext/snact) project by Kiyeon Jeon, whose original copyright\nis kept in [LICENSE](LICENSE) next to ours.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fitielsefer23%2Fnissia-browser","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fitielsefer23%2Fnissia-browser","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fitielsefer23%2Fnissia-browser/lists"}