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/wigolowigolo是一款面向 AI 编码智能体的本地优先 Web 智能工具搜索、抓取、爬取、提取、缓存、调研全部跑在你自己的机器上无需 API Key、不依赖云、每次查询 $0。它最特别的地方在于接入方式极其灵活——同 10 种集成路径覆盖从 Claude Code、Cursor 等编码智能体到 REST 脚本、TypeScript/Python SDK、LangChain 等 Agent 框架再到 Docker 容器与自托管自动化平台。本文带你一次看全这 10 种玩法。一图速览10 种集成方式怎么选#玩法适合谁一句话说明1一键接入编码智能体Claude Code / Cursor 等init --agents一条命令配好2手动 MCP 配置任意 MCP 客户端复制一段 JSON 即可3远程 MCP 接入跨机器 / 容器客户端HTTP 端点 Bearer Token4REST API任何会发 HTTP 的语言curl 即可调用全部工具5TypeScript SDKNode / 前端 / Edge 应用内嵌本地模式零依赖6Python SDKPython 数据/Agent 项目同步 异步纯标准库7Agent 框架封装LangChain / CrewAI 等开箱即用的工具与检索器8自动化平台n8n自托管工作流指向远程 MCP/REST 即可9Docker 容器化容器环境 / 多客户端一个镜像两种运行模式10CLI、Shell 管道与技能包终端用户与二次开发者一行命令 11 个技能包玩法一一键接入你的编码智能体wigolo 支持9 个主流编码智能体的自动接线Claude Code、Cursor、Codex、Gemini CLI、OpenCode、VS Code、Windsurf、Zed、Antigravity。一条命令完成本地引擎初始化 智能体配置写入npx wigolo init --agentsclaude-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 APIcurl 调通全部 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(querylocal first web search, max_results5)另有AsyncClient提供完全相同的方法面。源码位于 sdks/python/一个约 20 行调用自主agent工具的完整示例在 examples/sdk-python-agent/。玩法七Agent 框架官方封装4 家全覆盖不想自己写胶水代码四个官方封装包直接把 wigolo 的工具滴入你现有的框架框架包你得到什么LangChainwigolo-langchain每个工具一个BaseTool外加基于 search/find_similar 的BaseRetriever可直接进 RAG 管道CrewAIwigolo-crewaiwigolo_tools()一行返回工具集交给任意 crewLlamaIndexwigolo-llamaindexWigoloWebReader把抓取/爬取/搜索的页面变成DocumentVercel AI SDKwigolo-vercel-ai-sdkgenerateText/streamText可用的工具工厂Edge 友好以 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 任选其一表面URL用法MCPStreamable HTTPhttp://HOST:3477/mcpn8n MCP Client 节点n8n ≥ 1.88MCP旧式 SSEhttp://HOST:3477/sse旧版客户端RESThttp://HOST:3477/v1/{tool}HTTP Request 节点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/wigoloHTTP 守护进程模式远程 MCP REST 多客户端配合仓库自带的 packaging/compose.serve.yml 一键起容器精简镜像按需懒加载模型到数据卷full构建目标则预装浏览器引擎。命名卷会持久化本地缓存、模型、浏览器引擎与加密密钥重启不丢状态。玩法十CLI、Shell 管道、技能包与插件命令行与管道——每个工具都是一条终端命令输出可管道化wigolo search ... --json | jq .results[0].title # 单发查询 wigolo shell --json # 交互式 shellNDJSON 每行一个 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 wigolo 集成方式全清单：MCP、REST、SDK 到 Agent 框架的 10 种玩法
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/wigolowigolo是一款面向 AI 编码智能体的本地优先 Web 智能工具搜索、抓取、爬取、提取、缓存、调研全部跑在你自己的机器上无需 API Key、不依赖云、每次查询 $0。它最特别的地方在于接入方式极其灵活——同 10 种集成路径覆盖从 Claude Code、Cursor 等编码智能体到 REST 脚本、TypeScript/Python SDK、LangChain 等 Agent 框架再到 Docker 容器与自托管自动化平台。本文带你一次看全这 10 种玩法。一图速览10 种集成方式怎么选#玩法适合谁一句话说明1一键接入编码智能体Claude Code / Cursor 等init --agents一条命令配好2手动 MCP 配置任意 MCP 客户端复制一段 JSON 即可3远程 MCP 接入跨机器 / 容器客户端HTTP 端点 Bearer Token4REST API任何会发 HTTP 的语言curl 即可调用全部工具5TypeScript SDKNode / 前端 / Edge 应用内嵌本地模式零依赖6Python SDKPython 数据/Agent 项目同步 异步纯标准库7Agent 框架封装LangChain / CrewAI 等开箱即用的工具与检索器8自动化平台n8n自托管工作流指向远程 MCP/REST 即可9Docker 容器化容器环境 / 多客户端一个镜像两种运行模式10CLI、Shell 管道与技能包终端用户与二次开发者一行命令 11 个技能包玩法一一键接入你的编码智能体wigolo 支持9 个主流编码智能体的自动接线Claude Code、Cursor、Codex、Gemini CLI、OpenCode、VS Code、Windsurf、Zed、Antigravity。一条命令完成本地引擎初始化 智能体配置写入npx wigolo init --agentsclaude-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 APIcurl 调通全部 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(querylocal first web search, max_results5)另有AsyncClient提供完全相同的方法面。源码位于 sdks/python/一个约 20 行调用自主agent工具的完整示例在 examples/sdk-python-agent/。玩法七Agent 框架官方封装4 家全覆盖不想自己写胶水代码四个官方封装包直接把 wigolo 的工具滴入你现有的框架框架包你得到什么LangChainwigolo-langchain每个工具一个BaseTool外加基于 search/find_similar 的BaseRetriever可直接进 RAG 管道CrewAIwigolo-crewaiwigolo_tools()一行返回工具集交给任意 crewLlamaIndexwigolo-llamaindexWigoloWebReader把抓取/爬取/搜索的页面变成DocumentVercel AI SDKwigolo-vercel-ai-sdkgenerateText/streamText可用的工具工厂Edge 友好以 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 任选其一表面URL用法MCPStreamable HTTPhttp://HOST:3477/mcpn8n MCP Client 节点n8n ≥ 1.88MCP旧式 SSEhttp://HOST:3477/sse旧版客户端RESThttp://HOST:3477/v1/{tool}HTTP Request 节点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/wigoloHTTP 守护进程模式远程 MCP REST 多客户端配合仓库自带的 packaging/compose.serve.yml 一键起容器精简镜像按需懒加载模型到数据卷full构建目标则预装浏览器引擎。命名卷会持久化本地缓存、模型、浏览器引擎与加密密钥重启不丢状态。玩法十CLI、Shell 管道、技能包与插件命令行与管道——每个工具都是一条终端命令输出可管道化wigolo search ... --json | jq .results[0].title # 单发查询 wigolo shell --json # 交互式 shellNDJSON 每行一个 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考