Skip to content

usamaasfar/agent-browse

Repository files navigation

Agent Browse

npm @agent-browse/cli npm @agent-browse/mcp npm @agent-browse/api License: MIT

Agent Browse gives AI agents direct access to the web through Ollama — browse, search, and fetch with cited, grounded answers, running entirely on your own machine.

Features

  • Local by default — runs on your own machine via Ollama, no cloud or API keys required
  • Grounded answers — all answers are based solely on fetched page content
  • Adaptive depth — searches, fetches, and follows links as needed for the query
  • Sub-agent delegation — complex multi-part queries are split and handled in parallel

Interfaces

Package Role
@agent-browse/cli Human-facing command line interface
@agent-browse/mcp MCP server exposing a single browse tool
@agent-browse/api Programmatic wrapper for app/server integration

Quick Start

CLI

npm install -g @agent-browse/cli
agent-browse what is bun js runtime
agent-browse what is the latest version of react https://react.dev

MCP

{
  "mcpServers": {
    "agent-browse": {
      "command": "npx",
      "args": ["-y", "@agent-browse/mcp"]
    }
  }
}

API

npm install @agent-browse/api
import { AgentBrowse } from "@agent-browse/api";

const browser = new AgentBrowse();

const answer = await browser.browse("what is bun js runtime");
console.log(answer);

Documentation

License

MIT

About

browsing for agents

Resources

License

Stars

Watchers

Forks

Contributors