---
title: "Deploy Wigolo Web Search for AI Agents"
description: "Self-hosted web search, fetch & crawl for AI agents via MCP and REST"
category: "AI/ML"
url: https://railway.com/deploy/wigolo-web-search-for-ai-agents
---

# Deploy Wigolo Web Search for AI Agents

Self-hosted web search, fetch & crawl for AI agents via MCP and REST

**[Deploy Wigolo Web Search for AI Agents on Railway](https://railway.com/template/wigolo-web-search-for-ai-agents)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/wigolo-web-search-for-ai-agents/manifest.json

- **Creator:** My Projects
- **Category:** AI/ML

## Template content

### wigolo https://raw.githubusercontent.com/KnockOutEZ/wigolo/main/assets/brand/wigolo-icon.png

- **Image:** ghcr.io/knockoutez/wigolo:latest
- **Start command:** `node dist/index.js serve --host 0.0.0.0 --port 3333`
- **Health check:** /health
- **Public domain:** Yes

## Documentation

# Deploy and Host Wigolo Web Search for AI Agents on Railway

[Wigolo](https://github.com/KnockOutEZ/wigolo) is "the web for your AI coding agent": a self-hosted search, fetch, crawl and extraction engine with on-device ranking and embeddings. It exposes everything as a **remote MCP server** (StreamableHTTP + SSE) and a **REST API with an OpenAPI contract**, so Claude Code, Cursor, Codex, n8n, LangChain, CrewAI, LlamaIndex or your own services can search and read the web without per-query search-API fees.

## About Hosting Wigolo

This template runs the official `ghcr.io/knockoutez/wigolo` image in HTTP server mode (`wigolo serve`) on port 3333 with:

- a persistent volume at `/data` for the model cache, browser engine and page cache
- a randomly generated **`WIGOLO_API_TOKEN`** — Wigolo is fail-closed, so every MCP/REST request must send `Authorization: Bearer YOUR_TOKEN` (only `/health` is open, for the Railway healthcheck)
- a public HTTPS domain

**After deploy:**
1. Copy `WIGOLO_API_TOKEN` from the service's *Variables* tab.
2. MCP clients: add a remote MCP server at `https://YOUR-RAILWAY-DOMAIN/mcp` with header `Authorization: Bearer YOUR_TOKEN` (legacy clients: `/sse`).
3. REST: `POST https://YOUR-RAILWAY-DOMAIN/v1/search` with a JSON body like `{"query": "..."}`; the full contract is at `/openapi.json`.

The first requests are slower while models and the browser engine download into the volume.

## Common Use Cases

- Give coding agents (Claude Code, Cursor, Codex, OpenCode…) real web search and page reading via MCP
- Web research nodes in n8n / Make / custom automations through the REST API
- Retrieval for RAG pipelines (search, find-similar, crawl and extract to clean content)
- A shared, team-wide search backend instead of paying per query for a hosted search API

## Dependencies for Wigolo Hosting

- Docker image `ghcr.io/knockoutez/wigolo`
- Persistent volume (≈1–2 GB for models, browser and cache)

### Deployment Dependencies

- Source: https://github.com/KnockOutEZ/wigolo
- Self-hosting guide: https://github.com/KnockOutEZ/wigolo/blob/main/docs/self-hosting.md
- REST API reference: https://github.com/KnockOutEZ/wigolo/blob/main/docs/rest-api.md

### Implementation Details

Optional: add `GEMINI_API_KEY` (free tier is enough) to enable LLM-assisted features described in the Wigolo docs. Some challenge-protected sites score IP reputation, so datacenter IPs may be blocked where a home connection is not; see the self-hosting guide for the opt-in proxy setting.

## Why Deploy Wigolo on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying Wigolo on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.


## Similar templates

- [Chat Chat](https://railway.com/deploy/-WWW5r) — Chat Chat, your own unified chat and search to AI platform.
- [Weaviate](https://railway.com/deploy/weaviate-1) — Vector database with hybrid search and an API key-protected API
- [Möbius Personal AI OS](https://railway.com/deploy/mobius-v01-personal-ai-os) — Self-hosted AI agent that builds and runs apps for you, with memory.

Open this page in a browser: https://railway.com/deploy/wigolo-web-search-for-ai-agents