# Local Web Intelligence

Searches, fetches, crawls and watches web pages through a local cache with no API keys.

- Repository: https://github.com/KnockOutEZ/wigolo (5517 stars)
- Category: AI and agents
- License: AGPL-3.0-only
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add KnockOutEZ/wigolo --skill wigolo -g -a claude-code -y`
Codex: `npx skills add KnockOutEZ/wigolo --skill wigolo -g -a codex -y`
Cursor: `npx skills add KnockOutEZ/wigolo --skill wigolo -g -a cursor -y`
Gemini CLI: `npx skills add KnockOutEZ/wigolo --skill wigolo -g -a gemini-cli -y`

## Description

Local-first web intelligence MCP server for AI coding agents. Ten tools for search, fetch, crawl, cache, extract, find similar, research, agent-driven data gathering, page diffing, and change watching. No API keys. Results cached in a local knowledge store.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# wigolo

Local-first web intelligence MCP server for AI coding agents. Ships ten tools over stdio. All network results land in a local knowledge cache.

## Host-LLM synthesis (read me first)

Wigolo has no internal LLM. It returns *structured evidence* so the calling model (you) writes the final answer. Fold structure into your reply rather than collapsing it away:

- `search` with `format: "highlights"`, ML-scored passages + `citations`. Quote and cite [N].
- `research`, when MCP sampling is unavailable (common), the output carries a `brief` with `topics`, `highlights`, `key_findings`. Use it as the scaffold for the report you write.
- `find_similar`, may return a `cold_start` string. Pass it to the user; it explains why results came from the web and how to warm the cache.
- `extract` with `mode: "structured"`, one call for tables + `<dl>` definitions + JSON-LD + chart hints + key-value pairs.
- `fetch` metadata, surfaces `og_type`, `canonical_url`, and `og_image`; use `canonical_url` to dedupe tracked/canonical URLs.

## Quick Setup

**Claude Code:**
```bash
claude mcp add wigolo -- npx wigolo
```

**Cursor / VS Code / any MCP client:**
```json
{
  "mcpServers": {
    "wigolo": {
      "command": "npx",
      "args": ["wigolo"]
    }
  }
}
```

**Warmup (recommended, one-time):**
```bash
npx wigolo warmup          # installs browser engine + bootstraps search engine
npx wigolo warmup --all    # also installs Firefox, WebKit, ML reranker, and embeddings
npx wigolo warmup --force  # wipe search engine state and rebuild
```

Warmup flags: `--force`, `--all`, `--reranker`, `--firefox`, `--webkit`, `--embeddings`, `--no-searxng`, `--verify`.

## Tools

### fetch

Fetch a single URL and return clean markdown. Use when you already have a specific URL.

The rest: https://github.com/KnockOutEZ/wigolo/blob/HEAD//SKILL.md