smart-web

io.github.jojo-labsPublished by GitHub account jojo-labsv1.10.19Updated Oct 27, 2026

smartfetch direct-URL fetch, smartsearch web search, smartcrawl, smartbrowser local browser actions.

Overview

AI-generated overview

Local MCP server that gives an assistant web search, single-URL fetching, site crawling, controlled local browser actions, and Korean vertical data lookups.

What you can do
  • Search the web by topic, keywords or site: query, with optional handoff into crawling
  • Fetch and normalize one known URL or shortlink, including browser-rendered pages, social posts, videos and best-effort YouTube transcripts
  • Crawl a known site across multiple pages, optionally writing results to an output directory
  • Run bounded action batches in a task-owned tab of the approved local browser, with an opt-in short-lived session
  • Read a vertical domain's typed schema, then query Korean/local structured data such as places, weather, subway, finance, real estate, law and news
When to use it
Useful when an assistant needs to research the web, pull content from specific URLs, gather several pages from one site, or drive the user's own browser for a defined task. Also suited to Korean local and public data lookups through a single router tool.
Requirements
Runs as a local stdio process installed from the npm package smart-web-mcp, so Node.js is needed. Desktop only; no web executable. No authentication, environment variables or headers are declared. Browser actions require an approved local browser.
Before you install
Browser actions operate on the user's real browser and need an authorized goal and owned tabs; login, MFA, CAPTCHA and consent must be handled by the user. Crawling can write results to an output directory. Fetched pages and vertical queries go to third-party sites and providers.

Installation

In SourceWeft

  1. Open smart-web in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

This repository has no README.

Tools

6

smartbrowser

Smart Browser Actions

Execute an explicit bounded action batch in a task-owned tab of the approved local browser. Default: new tab closed after the batch. Opt-in session preserves top-level read/action/read state for at most 60 seconds and 10 calls in this owning server; resume with its opaque handle and exact current page URL, without navigation or replay. Use for user-authorized search/filter/expand workflows after retrieval alone is insufficient. Verify final evidence; a successful click is not goal completion. Password/MFA/CAPTCHA/consent require the user. Purchases, posting, deletion, uploads and account changes require separate explicit user authorization. No remote browser or credential export.

Parametersurlrequiredstepssessiontimeout_ms

smartsearch

Smart Search

Search the web when the user gave a topic, keywords, or a `site:` query instead of a specific URL. Use this for discovery first; if you already have a direct URL, use smartfetch instead. Can optionally hand off into smartcrawl for same-site exploration. If smart-web returns reproducible incorrect or misleading output, open a GitHub issue on jojo-labs/smart-web with the exact input, arguments, observed output, expected behavior, and version. Skip obvious transient network/auth/rate-limit failures unless smart-web misclassified them.

Parameterstypequeryrequiredcrawl_urlcrawl_modenumResultssite_crawlcrawl_limitcontext_modeoutput_budgetcrawl_max_depthcrawl_max_pagesheadroom_tokens+3 more

smartcrawl

Smart Crawl

Traverse a known site when one page is not enough and you need multiple relevant docs pages, posts, or thread items. Start from a concrete site URL; if you need to discover the site first, use smartsearch, and if you only need one direct URL, use smartfetch. Add `output_dir` when you want the crawl written to a local Markdown folder instead of returned only as a ranked summary; successful exports embed `resource_handle_manifest` in structuredContent with file:// handles for exported documents and metadata files. For LinkedIn profile URLs this is best-effort recent public post discovery, not full archive pagination. If smart-web returns reproducible incorrect or misleading output, open a GitHub issue on jojo-labs/smart-web with the exact input, arguments, observed output, expected behavior, and version. Skip obvious transient network/auth/rate-limit failures unless smart-web misclassified them.

Parametersurlrequiredmodelimitqueryformatmax_depthmax_pagesoutput_dirtimeout_mscontext_modescroll_stepsoutput_budget+6 more

smartfetch

Smart Fetch

Fetch and normalize one known URL or shortlink. Use this first for direct user-supplied URLs, browser-rendered pages, social posts, and videos; YouTube watch/short/embed links get best-effort transcript enrichment when public captions are available. For a blocked commerce URL, pass likely product/title candidates from the conversation as reference_queries; catalog metadata is accepted only after exact URL identifier matching. smartfetch is the unified retrieval kernel: default structuredContent carries pipeline acquire attempt_map, assessment, and research_handoff metadata for downstream evidence/report consumers when results are partial or blocked. Do not use smartsearch when the user already provided the URL, and use smartcrawl only when you need multiple pages from the same site. Use exactly one budget control per call: output_budget, preferred_budget_chars, context_mode, or headroom_tokens. If smart-web returns reproducible incorrect or misleading output, open a GitHub issue on jojo-labs/smart-web with the exact input, arguments, observed output, expected behavior, and version. Skip obvious transient network/auth/rate-limit failures unless smart-web misclassified them.

Parametersurlrequiredformattargetprofiledownloadwait_fortimeout_msexport_bodyresult_viewcontext_modeforce_dynamicoutput_budget+6 more

smartvertical_schema

Vertical Domain Schema

Read the selected smartvertical domain's typed input schema, supported actions and aliases before an unfamiliar call. No provider, browser or network access.

Parametersdomainrequired

smartvertical

Smart Vertical

Korean/local vertical and structured data router. Use domain to access places, weather, subway, finance, DART, real estate, safety, news, commerce, spellcheck, zipcode, law, public restrooms, and GeekNews without exposing every provider as a separate MCP tool. For an unfamiliar domain, first read smartvertical_schema; unsupported domain fields, actions, sorts and incomplete coordinate pairs fail before provider I/O.

Parametersidnxnylatloncodesorttextlimitquerystartaction+39 more

Version history

16
  1. v1.10.19LatestOct 25, 2026
  2. v1.10.16Oct 25, 2026
  3. v1.10.9Oct 24, 2026
  4. v1.10.8Oct 8, 2026
  5. v1.10.6Oct 7, 2026
  6. v1.10.5Oct 7, 2026
  7. v1.9.3Oct 5, 2026
  8. v1.9.1Oct 5, 2026
  9. v1.8.14Oct 4, 2026
  10. v1.8.7Oct 4, 2026
  11. v1.7.8Oct 4, 2026
  12. v1.6.23Oct 4, 2026
  13. v1.6.13Oct 3, 2026
  14. v1.6.1Oct 3, 2026
  15. v1.2.2Oct 3, 2026
  16. v0.44.0Sep 16, 2026

Score

65% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • License10 pts

    Declare a license in the repository or the registry entry.