# web-shooter

> web-shooter is an open-source MCP server for web search and scraping. Fast local web and PDF reader that returns ranked passages instead of whole pages. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, Linux, Windows, CLI
- **Repository:** https://github.com/heyyviv/web-shooter
- **MCP Registry name:** io.github.heyyviv/web-shooter
- **Categories:** [web search and scraping](https://ai-powered.com/categories/web-search-and-scraping)
- **Listing updated:** 2026-11-18

## About

web-shooter is a Rust MCP server that runs on your machine and keeps nothing. Given URLs or local PDF paths and a question, it returns only the passages that answer it, grouped by page. JavaScript-built pages load in headless Chrome automatically.

The README reports a 32-question benchmark dated 31 October 2026: median 793 ms and about 1,081 tokens returned, against roughly 25,000 for Firecrawl and Jina Reader, with the answer present in 29 of 32 cases. These are the author's numbers, with caveats in the docs.

It installs with a shell or PowerShell script or via cargo, runs over stdio, and downloads a 30 MB embedding model on first query. Chrome is needed for script-rendered pages.

## Features

- **Ranked passages:** Returns the best matches, not full pages.
- **PDF support:** Reads PDFs and local paths.
- **Focused crawling:** Follows links toward a goal.
- **Link ranking:** Ranks a page's links by a query.
- **Headless Chrome:** Loads JavaScript-built pages.
- **Runs locally:** Nothing is stored.

## Good for

- Answer a question from a long document with few tokens
- Pick which page to read next
- Crawl a docs site for a topic
- Read a local PDF

## Install

### Claude Code (Terminal)

```sh
claude mcp add web-shooter -- npx -y web-shooter
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "web-shooter": {
      "command": "npx",
      "args": [
        "-y",
        "web-shooter"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "web-shooter": {
      "command": "npx",
      "args": [
        "-y",
        "web-shooter"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "web-shooter": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "web-shooter"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "web-shooter": {
      "command": "npx",
      "args": [
        "-y",
        "web-shooter"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "web-shooter": {
      "command": "npx",
      "args": [
        "-y",
        "web-shooter"
      ]
    }
  }
}
```

## Tools

- `fetch`: Best passages for a query from URLs or PDFs.
- `links`: A page's links ranked by a query.
- `crawl`: Most relevant pages from a start page and goal.

## FAQ

### What does it return?

Relevant passages grouped by page.

### What are the requirements?

Chrome for JS pages; Rust 1.88+ only to build from source.

### Which platforms?

macOS on Apple silicon, Linux and Windows.

### Licence?

Apache 2.0 or MIT, at your option.

### Is web-shooter free?

Yes. web-shooter is open source, so you can use and self-host it for free.

### How do I add web-shooter to Claude Code?

Run this command in your terminal: claude mcp add web-shooter -- npx -y web-shooter

### What are the best alternatives to web-shooter?

The closest alternatives to web-shooter are Scrapling MCP Server, Firecrawl MCP Server, Douyin_TikTok_Download_API, SearXNG Search and machine_internet.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [Firecrawl MCP Server](https://ai-powered.com/mcp/firecrawl-mcp-server): Firecrawl MCP Server is a freemium MCP server for web search and scraping.
- [Douyin_TikTok_Download_API](https://ai-powered.com/mcp/douyin-tiktok-download-api): Douyin_TikTok_Download_API is an open-source MCP server for web search and scraping.
- [SearXNG Search](https://ai-powered.com/mcp/searxng-search): SearXNG Search is an open-source MCP server for web search and scraping.
- [machine_internet](https://ai-powered.com/mcp/machine-internet): machine_internet is an open-source MCP server for web search and scraping.
- [acrawl](https://ai-powered.com/mcp/acrawl): acrawl is an open-source MCP server for browser automation.
- [Countries](https://ai-powered.com/mcp/countries): Countries is a freemium MCP server for web search and scraping.
- [Listen Notes](https://ai-powered.com/mcp/listen-notes): Listen Notes is a freemium MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/web-shooter
