smart-web-mcp weekly downloads statistics

smart-web

One local MCP entry point for finding, reading, and using the web.

Goal: finish the user's web task—not merely return a successful request or a browser handoff. Use fast retrieval where it works; continue through the approved local browser-use session when it does not.

Principles

• Judge success by the requested content or action, including comments and exact product identity. • Measure search relevance, freshness, query constraints, and usable sources—not result count. • Prioritize failures from real workflows across sites, not a single showcase domain. • Keep output compact, with source evidence, attempt history, and explicit omissions. • Isolate fragile site logic; detect drift and repair it through bounded, verified agent runs.

Status

The package exposes four retrieval tools plus the bounded smartbrowser action tool. The operator-first revamp is in progress: broader interactive coverage and automatic repair remain acceptance goals, not a claim of universal support. The legacy web-task-api backend is retired; browser actions use the approved local session. Tabs close after each batch by default; opt-in bounded continuation preserves top-level read/action/read state in one owning server for at most 60 seconds and 10 calls. Cross-tool retrieval/action continuity remains open.

Track shipped evidence and remaining work in the revamp issue. Browser-readable content should not require the user to switch tools; genuine login, permission, or unavailable-content limits remain explicit.

Quick start

Requires Node.js 24 (LTS) or 26 (Current) and npm. Development pins and isolated runtime checks: runtime support. Start the stdio server:

MCP host configuration:

Use --init-settings to create the default settings file, or --print-settings-example to inspect it. The published npm package can lag source; verify the runtime you actually use.

Tool routing

• smartfetch first when the user already gave a URL or shortlink. • smartsearch when the user gave a topic, keywords, or a site: query. • smartcrawl when you already know the site and need multiple relevant pages. • smartvertical for Korean/local structured lookups. • smartbrowser for explicit approved-browser input/click/filter/wait/screenshot batches; see action scope and limits.

Use compact output first; request a larger budget when needed. Partial output is honest evidence, not task completion. Never substitute a search snippet, loading screen, or unrelated listing for the requested source. The CLI smart-web fetch --format json (or --json) prints structured output. Use --include-comments to request source-bound discussion comments on generic articles; add --export-comments for a private pre-clipping copy when inline delivery is partial. Public GitHub pull requests return bound top-level conversation comments; inline review threads are not collected and are marked partial when present or unverifiable. --budget full controls bounded delivery, not source completeness. Invalid budget names fail before retrieval rather than silently using compact output. For CLI search, --max-chars caps rendered text; use --json when the complete projected structured result is needed.

Development

Keep npm and the existing Node checks. With Bun installed separately (tested with 1.4.2), optional npm run --silent dev:bun launches TypeScript source and npm run test:bun:fast runs only extraction/assets tests. These are developer shortcuts, not production runtime support or full-suite certification; see scope, local measurements and caveats. Use npm run dev to fall back to Node+tsx and npm run check before shipping.

Documentation

• Product contract and acceptance • Host setup · Configuration • Architecture and code map · Verification and maintenance • All docs · Agent instructions

Report reproducible problems in GitHub Issues, with sanitized input, expected/observed behavior, and runtime version. Never attach credentials or private browsing content.

Package · MCP Registry: io.github.jojo-labs/smart-web · License (proprietary; all rights reserved).

Description from the npm listing.