smart-web

A web MCP that works.

smart-web bundles smartsearch and smartfetch into one local MCP server for Claude Code, OpenCode, and other MCP clients.

• npm: https://www.npmjs.com/package/smart-web-mcp
• MCP Registry: io.github.rich-jojo/smart-web
• GitHub: https://github.com/rich-jojo/smart-web

Install

npx -y smart-web-mcp

If your team uses Bun:

bunx smart-web-mcp

Quick start

Claude Code:

claude mcp add smart-web -- npx -y smart-web-mcp

OpenCode:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "smart-web": {
      "type": "local",
      "command": ["npx", "-y", "smart-web-mcp"],
      "enabled": true
    }
  }
}

What it includes

• smartsearch: fallback web search with Exa, Brave, SearXNG, DuckDuckGo, and Brave HTML
• smartsearch: plus direct site-native fallbacks for Velog and StackExchange-style sites when that is more reliable
• smartfetch: browser-aware fetch with special handling for Reddit, X, YouTube, DCInside, and Naver Blog
• smartfetch: includes discovered media and attachment download URLs in structured output
• sensible safety defaults: private-network blocking, local-only mode, provider toggles

Docs

• docs/getting-started.md
• docs/configuration.md
• docs/providers.md
• docs/architecture.md
• docs/composition.md
• docs/releasing.md
• CHANGELOG.md

Status

• npm package is published
• MCP Registry metadata is published
• GitHub Actions verify package, registry metadata, and MCP wiring

License

MIT