wigolo: tìm kiếm web MCP local-first cho AI agent

wigolo là gì và giải quyết vấn đề gì

wigolo là một MCP (Model Context Protocol) server, REST API và SDK, cho AI agent một cửa ngõ duy nhất để search, fetch, crawl, extract, cache, find-similar và research. wigolo dành cho developer muốn kết nối coding agent như Claude Code hay Cursor vào web mà không trả phí theo query cho Firecrawl, Exa hay Tavily. Mọi thứ nằm trong `~/.wigolo/`, dùng 18 adapter tìm kiếm trực tiếp và rank fusion thay vì một API aggregator trả phí.

The 10 tools: search, fetch, crawl, extract, cache, and more

• ✓search — 18 adapter công cụ tìm kiếm trực tiếp với rank fusion và ML reranking, cùng điểm số per-result có thể giải thích được; truyền một mảng query để chạy song song
• ✓fetch — một router phân tầng, chỉ leo thang từ HTTP thuần lên headless browser khi gặp anti-bot challenge hoặc SPA shell, trả về markdown, metadata và link sạch
• ✓crawl — một API-free web crawler: BFS, DFS, sitemap, hoặc chỉ map, với rate limit theo từng domain và tôn trọng robots.txt
• ✓extract — lấy table, metadata, JSON-LD, brand identity, hoặc schema có tên như Article/Recipe/Product từ một trang, hoặc bất kỳ JSON Schema tùy chỉnh nào bạn cung cấp
• ✓cache và find_similar — truy vấn mọi thứ wigolo đã index bằng keyword hoặc hybrid semantic search, hoặc tìm trang tương tự một URL qua 3-way fusion
• ✓research — chia nhỏ một câu hỏi thành các sub-query, fetch nguồn, và tổng hợp thành báo cáo có trích dẫn khi đã cấu hình LLM key
• ✓agent — một vòng lặp đầy đủ plan → search → fetch → extract → synthesize, có step log, time budget và output schema tùy chọn
• ✓diff và watch — xem chính xác điều gì đã thay đổi trên một trang kể từ lần ghé thăm trước, kiểm tra lại theo yêu cầu, và gửi thay đổi qua webhook

Cài đặt wigolo chỉ với một lệnh

Chạy `npx wigolo init` để thiết lập engine local trên macOS, Linux hoặc Windows — cần Node 20 trở lên và khoảng 1.5 GB dung lượng trống, lệnh này tải browser engine và model chạy on-device, rồi báo cáo tình trạng từng thành phần. Thêm `--agents=claude-code,cursor` (hoặc bất kỳ tổ hợp nào trong codex, gemini-cli, opencode, vscode, windsurf, zed, antigravity) để kết nối MCP config của coding agent ngay trong cùng một lệnh. `init` mặc định chạy unattended nên an toàn khi dùng trong CI, và `--no-warmup` sẽ hoãn tải model tới lần dùng đầu tiên. Kiểm tra kết quả bất cứ lúc nào bằng `npx wigolo doctor`, và gỡ sạch mọi thứ bằng `npx wigolo config --uninstall --yes`. Image Docker được publish tại `ghcr.io/knockoutez/wigolo`, và bản mirror trên Docker Hub là `towhid69420/wigolo`.

Kết nối wigolo vào AI agent hoặc framework của bạn

Với một coding agent, `npx wigolo init --agents=<name>` ghi thẳng MCP config. Bất kỳ MCP client, agent framework hay self-hosted agent nào khác thì tự đăng ký `npx -y wigolo` trong MCP config riêng của nó. Chạy `wigolo serve` để expose cùng mười công cụ đó dưới dạng REST API JSON thuần trên `127.0.0.1:3333` — bind ra ngoài loopback thì bắt buộc phải có bearer token — với `/mcp` và `/sse` phục vụ MCP client từ xa trên cùng port đó. Để nhúng wigolo trực tiếp, `npm install wigolo-sdk` hoặc `pip install wigolo` cho một client có type (`createLocalClient()` / `local_client()`) tự tìm hoặc tự spawn daemon local, không cần bước `serve` riêng. LangChain, CrewAI, LlamaIndex và Vercel AI SDK mỗi framework đều có package wrapper riêng — `wigolo-langchain` thêm một `BaseRetriever` trên search/find_similar cho RAG retrieval, `wigolo-crewai` đưa cả bộ công cụ cho một crew, và `wigolo-llamaindex` load các trang đã fetch thành document. `research`, `agent` và `search format=answer` chỉ viết câu trả lời tổng hợp khi `WIGOLO_LLM_PROVIDER` trỏ tới một key đã cấu hình.

wigolo so với Firecrawl, Exa và Tavily

Câu hỏi thường gặp

Vấn đề mà wigolo giải quyết

Developer khi kết nối một AI coding agent vào web thật thường phải chọn giữa một API tính phí theo lượt như Firecrawl, Exa, Tavily, hoặc một vòng lặp WebSearch tuần tự có sẵn không thể chạy song song nhiều query cùng lúc. wigolo giải quyết bằng cách chạy toàn bộ search, fetch, crawl và extract ngay trên máy — không cần API key, không tính phí theo lượt — và trả về bằng chứng gắn với đúng vị trí byte trong nguồn, thay vì một khối văn bản không có cấu trúc.

Trường hợp sử dụng tốt nhất

• •Thiết lập quy trình wigolo AI research trả về báo cáo có trích dẫn thay vì một danh sách link tìm kiếm thô
• •Cấp quyền truy cập web cho một self-hosted agent — một flow n8n, một pipeline LangChain tự viết — mà không cần trả phí subscription cho Firecrawl hay Tavily
• •Nhúng search local thẳng vào ứng dụng qua wigolo-sdk thay vì phải dựng riêng một REST server
• •Theo dõi một trang docs hoặc trang giá của đối thủ khi có thay đổi bằng diff/watch và webhook

Ai nên dùng — và ai nên bỏ qua

Đáng dùng nếu bạn đang kết nối một coding agent hoặc một pipeline self-hosted vào web thật và không muốn trả phí search theo lượt — cài đặt chỉ mất một lệnh `npx wigolo init`, và các công cụ cốt lõi không cần cấu hình gì thêm sau đó. Bỏ qua nếu bạn cần một dependency đã trưởng thành, ra khỏi beta ngay hôm nay, hoặc nếu sự tinh xảo của một vendor trả phí cụ thể — như các trang comparison được Exa render — quan trọng với bạn hơn là chi phí.

Repo liên quan