企业官网建设流程全解析

wigolo 集成方式全清单：MCP、REST、SDK 到 Agent 框架的 10 种玩法

【免费下载链接】wigoloThe go-to web for your AI coding agent — local-first search, fetch, crawl & research over MCP. No API keys, no cloud, $0/query. Public beta.项目地址: https://gitcode.com/GitHub_Trending/wi/wigolo

wigolo是一款面向 AI 编码智能体的本地优先 Web 智能工具：搜索、抓取、爬取、提取、缓存、调研全部跑在你自己的机器上，无需 API Key、不依赖云、每次查询 $0。它最特别的地方在于接入方式极其灵活——同 10 种集成路径，覆盖从 Claude Code、Cursor 等编码智能体，到 REST 脚本、TypeScript/Python SDK、LangChain 等 Agent 框架，再到 Docker 容器与自托管自动化平台。本文带你一次看全这 10 种玩法。

一图速览：10 种集成方式怎么选

玩法一：一键接入你的编码智能体

wigolo 支持9 个主流编码智能体的自动接线：Claude Code、Cursor、Codex、Gemini CLI、OpenCode、VS Code、Windsurf、Zed、Antigravity。一条命令完成本地引擎初始化 + 智能体配置写入：

npx wigolo init --agents=claude-code,cursor

它会自动写好各智能体的 MCP 配置，并在支持时同步写入指令与技能包。要求Node ≥ 20和约 1.5 GB 磁盘空间。想交互式配置可加--interactive（纯文本流程）或--wizard（完整 TUI 向导）。

玩法二：手动 MCP 配置（任意 MCP 客户端）

如果你的智能体不在支持列表里，手动接入也很简单——wigolo 仓库根目录就附了一段标准 MCP 配置 mcp.json：

{ "mcpServers": { "wigolo": { "command": "npx", "args": ["-y", "wigolo"] } } }

把它粘贴进任何 MCP 客户端的配置中即可。stdio 模式下 wigolo 作为本地进程运行，适合单客户端场景。

玩法三：远程 MCP 接入（跨机器与容器）

当智能体和 wigolo 不在同一台机器上，启动守护进程后走 HTTP 传输：

WIGOLO_API_TOKEN=你的令牌 wigolo serve --port 3477 --host 0.0.0.0

• /mcp— StreamableHTTP 远程 MCP（现代客户端首选）
• /sse— 旧式 MCP-over-SSE 传输
• 认证模型是"失败即关闭"：绑定非回环地址而未配置令牌时，服务会拒绝启动，安全默认值开箱即用

详细的网络姿态、Host 头防 DNS 重绑定规则见 docs/rest-api.md 与 docs/self-hosting.md。

玩法四：REST API（curl 调通全部 10 个工具）

wigolo serve默认监听127.0.0.1:3333，每个工具都有一条 REST 路由：

curl -sX POST http://127.0.0.1:3333/v1/search \ -H 'Content-Type: application/json' \ -d '{"query":"local-first software","max_results":5}'

/v1/search、/v1/fetch、/v1/crawl、/v1/research等 POST 端点一一对应search、fetch、crawl、research等工具；GET /openapi.json提供完整的OpenAPI 3.1 契约，可直接生成客户端。没有 MCP 客户端？完全不影响——REST 面与 MCP 面共享同一个进程、同一套本地缓存。可运行的真实示例见 examples/rest-curl/。

玩法五：TypeScript SDK 内嵌（含本地模式）

wigolo-sdk是零依赖的 REST 客户端，可在 Node、Bun、Deno 乃至浏览器 Edge 运行时中运行。最贴心的是内嵌本地模式：不需要手动serve，它会复用健康的守护进程，或自动为你启动一个：

import { createLocalClient } from 'wigolo-sdk/local'; const { client, close } = await createLocalClient(); // 自动复用或拉起守护进程 const res = await client.search({ query: 'local-first web search', max_results: 5 }); await close();

每个工具一个方法（search、fetch、crawl、research、agent……），错误类型化，降级响应不抛异常。源码位于 sdks/typescript/，完整文档见 docs/sdks.md。

玩法六：Python SDK（同步 + 异步）

pip install wigolo即得一个纯标准库、完全类型化的客户端，内嵌本地模式与 TS 版行为一致：

from wigolo import local_client with local_client() as client: # 复用健康守护进程，否则自动拉起 res = client.search(query="local first web search", max_results=5)

另有AsyncClient提供完全相同的方法面。源码位于 sdks/python/，一个约 20 行调用自主agent工具的完整示例在 examples/sdk-python-agent/。

玩法七：Agent 框架官方封装（4 家全覆盖）

不想自己写胶水代码？四个官方封装包直接把 wigolo 的工具"滴入"你现有的框架：

以 LangChain 为例，几行就能获得带域名过滤的网络检索器，作为 RAG 的上游来源。这些包均在0.2.0版本与服务端 OpenAPI 契约保持漂移测试对齐，源码见 packages/wigolo-langchain/、packages/wigolo-crewai/、packages/wigolo-llamaindex/、packages/wigolo-vercel-ai-sdk/。

玩法八：接入 n8n 等自托管自动化平台

这是 wigolo 作为"Web 大脑"的杀手级场景：一个wigolo serve进程同时暴露三种表面，n8n 任选其一：

n8n 跑在同机 Docker 里时，--host 0.0.0.0配合容器内的host.docker.internal:3477是最常见搭配。完整配置参考（含 Host 头规则与令牌设置）见 examples/n8n-remote-mcp/，配套工作流文件在 examples/n8n-remote-mcp/workflow.json。

玩法九：Docker 容器化部署

官方镜像ghcr.io/knockoutez/wigolo提供两种运行模式：

• stdio MCP 模式（单客户端）：docker run -i --rm -v wigolo-data:/data ghcr.io/knockoutez/wigolo
• HTTP 守护进程模式（远程 MCP + REST + 多客户端）：配合仓库自带的 packaging/compose.serve.yml 一键起容器

精简镜像按需懒加载模型到数据卷；full构建目标则预装浏览器引擎。命名卷会持久化本地缓存、模型、浏览器引擎与加密密钥，重启不丢状态。

玩法十：CLI、Shell 管道、技能包与插件

命令行与管道——每个工具都是一条终端命令，输出可管道化：

wigolo search "..." --json | jq '.results[0].title' # 单发查询 wigolo shell --json # 交互式 shell，NDJSON 每行一个 JSON 文档

11 个技能包——wigolo skills add给你的编码智能体装上"会用地"的指令包：缓存优先、查询数组、research与agent何时该用、如何读懂证据分数。技能包目录在 skills/wigolo/，规则与说明见 docs/skills.md。

插件扩展——用自己的搜索引擎或站点提取器扩展 wigolo：一个导出searchEngine的普通 Node 模块（不到 100 行）即可加入多引擎调度池，走同样的融合、去重与本地重排序。模板在 examples/plugin-search-engine/，机制说明见 docs/plugins.md，加载逻辑在 src/plugins/。

快速上手：从 0 到可用只需两条命令

npx wigolo init # 初始化本地引擎（任何系统） npx wigolo doctor # 随时体检各组件状态

init默认无人值守，适合放进 CI 或脚本；想给联网问答加上 LLM 合成答案，再配一个免费的 Gemini Key（也可用本地 Ollama 保持全离线）即可。全部环境变量、配置键与限流参数收录在 docs/configuration.md。

写在最后

从编码智能体到自动化平台，从内嵌 SDK 到容器集群，wigolo 的 10 种集成方式背后是同一套本地优先架构：18 个搜索引擎融合、ML 重排与向量检索全部跑在设备上，查询数据不出~/.wigolo/。完整手册入口见 docs/README.md，可运行示例总览见 examples/README.md。

【免费下载链接】wigoloThe go-to web for your AI coding agent — local-first search, fetch, crawl & research over MCP. No API keys, no cloud, $0/query. Public beta.项目地址: https://gitcode.com/GitHub_Trending/wi/wigolo