LABSCO SUMMARY

Live web search for an agent, with the crawler under your own control.

The single tool is deliberately flexible: an agent can widen or narrow a search by language, region, and domain lists, and steer it toward news or blogs, while the crawler runs on your own infrastructure so the search path is yours rather than a third party's.

What it is

A server that adds a web-search tool to an assistant, backed by a crawler service you run yourself, so the model can look up current information — news, blogs, or general results — with domain and result-type filters.

What you get

web_search searches the web for a query, with options for the number of results, language and region, domain include/exclude lists, term exclusions, and a result type of all, news, or blogs

Requirements

Runs through npx on Node, and needs the companion crawler service running — provided as a Docker Compose setup — reachable at a URL you configure.

Setup effort

Follow the published steps — docker-compose up -d

See installation options

USE CASES

01

Looking up current information

web_search returns fresh results for a query so the model can answer about recent events rather than from memory.

web_search

02

Focusing a search on news or blogs

web_search takes a result type, so an agent can ask specifically for news or blog results.

web_search

03

Scoping results to trusted sources

web_search accepts include and exclude domain lists, keeping results on or off chosen sites.

web_search

1 tool

Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.

`web_search`

Search the web for information. Use this tool when you need to search the web for information. You can use this tool to search for news, blogs, or all types of information. You can also use this tool to search for information about a specific company or product. You can also use this tool to search for information about a specific person. You can also use this tool to search for information about a specific product. You can also use this tool to search for information about a specific company. You can also use this tool to search for information about a specific event. You can also use this tool to search for information about a specific location. You can also use this tool to search for information about a specific thing. If you request search with 1 result number and failed, retry with bigger results number.

BEFORE YOU INSTALL

What to know first

Tools you get

1 tool when we connected.

Requires

Node.js (npx)
Docker and Docker Compose, to run the crawler service
The crawler service reachable at API_URL (default http://localhost:3001)

Where it runs

The documented client runs the server on your machine.

CONTEXT COST

Light Standing cost

Rated by the size of the one tool definition that rides along on every turn

INSTALLATION

Connect your client

Server setup

Start the crawler service this server searches through: save the docker-compose.yml from the README section Starting the Crawler Service (crawler + FlareSolverr; Apple Silicon has its own variant there)

TERMINAL

docker-compose up -d
curl http://localhost:3001/health

MCP Clients

Claude Desktop

CLAUDE DESKTOP · JSON

{
  "mcpServers": {
    "websearch": {
      "command": "npx",
      "args": [
        "websearch-mcp"
      ],
      "env": {
        "API_URL": "http://localhost:3001",
        "MAX_SEARCH_RESULT": "5"
      }
    }
  }
}

API_URL is where the crawler service from the steps above listens (http://localhost:3001 by default); MAX_SEARCH_RESULT sets how many results come back.

WebSearch-MCP

Live web search for an agent, with the crawler under your own control.

What it is

What you get

Requirements

Setup effort

Looking up current information

Focusing a search on news or blogs

Scoping results to trusted sources

1 tool

web_search

What to know first

Tools you get

Requires

Where it runs

Light Standing cost

Connect your client

Server setup

MCP Clients

Claude Desktop

Same category

OpenAI WebSearch

SearXNG MCP by SecretiveShell

Searchpin

SearxNG Simple MCP Server

`web_search`