Claude Code 快速参考:wigolo 本地优先 Web 智能工具的 10 个 MCP 工具实战指南

Claude Code 快速参考:wigolo 本地优先 Web 智能工具的 10 个 MCP 工具实战指南 Claude Code 快速参考wigolo 本地优先 Web 智能工具的 10 个 MCP 工具实战指南【免费下载链接】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 为 Claude Code 提供的命令速查文档仓库中对应assets/blocks/claude-code/wigolo-command.md的深度展开。该命令块面向在 Claude Code 中开发、调试、调研的场景无需任何 API Key、不经过云端、零成本地完成搜索、抓取、爬站、缓存、结构化提取、相似内容发现、深度研究与页面变化监控。读完本文你将掌握 wigolo 10 个 MCP 工具的选型逻辑、核心参数、常见调用模式以及这些工具在仓库源码中的真实实现位置可直接在 Claude Code 中按需取用。命令块在 Claude Code 中的角色wigolo-command.md会被安装为 Claude Code 的 slash command/wigolo源码在 src/cli/agents/claude-code.ts 中把该文件写入~/.claude/commands/wigolo.mdasync function installCommand(): Promisevoid { const content readAsset(blocks/claude-code/wigolo-command.md); const commandsDir join(claudeDir(), commands); mkdirSync(commandsDir, { recursive: true }); writeFileSync(join(commandsDir, wigolo.md), content, utf-8); }与之配套安装的还有三件事见同一文件的installMcp/installInstructions/installSkillsMCP 服务注册claude mcp add wigolo --scope user -- command--scope user保证只写入一次用户级配置避免每个目录重复写入脏行全局指令块~/.claude/CLAUDE.md中注入assets/blocks/claude-code/CLAUDE.md.block引导 Agent 对 Web 操作优先使用 wigolo 而非内置 WebSearch/WebFetchSkills由技能引擎安装skills/目录下的全套技能包如 skills/wigolo/SKILL.md。10 个 MCP 工具一览wigolo 提供 10 个 MCP 工具覆盖本地优先 Web 访问的完整闭环。下表是命令块中的选型速查表本文按列展开需求工具核心参数搜索searchquery数组、include_domains、category、time_range、exact_match、search_depth、format: answer抓取页面fetchurl、section、force_refresh爬取网站crawlurl、strategy: sitemap、max_pages、include_patterns检查缓存cachequery、url_pattern、stats提取数据extracturl、mode: structured查找相似find_similarurl或concept、include_domains深度研究researchquestion、depth、include_domains收集数据agentprompt、schema、max_pages版本对比diffold、new、output、granularity变化监控watchaction、url、interval_seconds、notification十个工具在仓库中的对应实现为 src/tools/ 目录下的同名处理函数handleSearch、handleFetch、handleCrawl、handleCache、handleExtract、handleFindSimilar、handleResearch、handleDiff、handleWatch参数校验、默认值与错误提示都能在源码中直接核实。工具详解与源码佐证search多查询、可排序、带直接答案的搜索search是最核心的工具query接受字符串或字符串数组数组形式用于广度召回。完整参数见命令块配套的CLAUDE.md.blockquery字符串或字符串数组数组传 3-5 个关键词变体可获得更广召回include_domains/exclude_domains限定/排除站点官方库框架查询如[react.dev, nextjs.org]必传category、time_rangeday/week/month/year、from_date/to_date、country时效与地域约束exact_match短语精确匹配search_depthultra-fast仅走缓存、亚秒级预算/fast≤1s/balanced默认/deep最大增强include_images/include_favicon富媒体字段formatanswer或stream_answer触发合成式直接答案默认返回带证据形状的结果供引用。在源码 src/search/core/core-provider.ts 中可以看到search_depth的实际语义默认balanced当depth ultra-fast且未命中缓存时会给出 cache-miss 提示data.notice cache miss, retry with search_depthfast or higher而fast档会短路内容抓取阶段deep档才会走完整增强链路。入口 handler 位于 src/tools/search.ts按WIGOLO_SEARCH环境变量选择 provider。fetch单页抓取支持段落提取与强制刷新fetch抓取单页并转换为 Markdown核心参数url、section按标题提取指定段落、use_auth、render_js默认auto、max_content_chars、force_refresh。源码 src/tools/fetch.ts 揭示了完整的执行链路请求先经过 URL 预校验拒绝 localhost 非法端口例如localhost:99999与 SSRF 防护默认阻断内网段与云元数据端点WIGOLO_FETCH_ALLOW_PRIVATE1可放行家庭局域网设备随后优先查缓存force_refresh或缓存过期时才走实时抓取抓取成功后写入缓存并异步生成 embedding。响应体还包含content_hash全文 sha256 指纹、http_status、fetch_methodcache/http/tls/playwright等路由层选中的通道、changed/diff_summary变化信号以及site_dataReddit、YouTube、Amazon 等站点的结构化 JSON见 src/extraction/site-extractors/。值得注意的两个防静默失败设计代码注释中有明确说明section未命中时不会返回整页兜底而是清空正文并置section_matched: false供调用方分支处理纯文本端点raw.githubusercontent.com等返回 4xx/5xx 时直接把 HTTP 错误上抛避免把错误体当成正文喂给抽取器。crawl整站爬取四种策略crawl的strategy支持sitemap优先 sitemap/bfs/dfs/map四种配合max_depth、max_pages、include_patterns使用。源码 src/tools/crawl.ts 显示map是轻量分支——只做 URL 发现返回urls、total_found、sitemap_found不走完整爬取管线其余策略由 src/crawl/crawler.ts 驱动逐页复用handleFetch抓取后还会做跨页内容去重deduplicatePages见 src/crawl/dedup.ts。响应默认带整页 Markdowninclude_full_markdown默认true并受max_total_chars默认 100000 字符与随页数缩放的平均 token 预算约束每页约 2000 token上限 60000见PER_PAGE_TOKENS/MAX_TOKENS_OUT_CEILING常量超预算的页面会被截断并统计在dropped_over_budget中而不是悄悄丢失。cache本地持久化知识缓存永远先查cache是本地优先理念的基石query、url_pattern如*auth0.com*、since、stats返回缓存统计、limit、clear、check_changes。源码 src/tools/cache.ts 展示了query搜索的默认返回上限为5 条DEFAULT_CACHE_QUERY_LIMIT防止缓存表里成千上万行数据撑爆 token 预算mode: hybrid时走 FTS5 全文检索 向量检索的混合路径用 Reciprocal Rank Fusionk60融合后返回见 src/tools/cache.ts。check_changes则对匹配条目重新抓取并运行detectChange把 200→404 这类状态码变化也识别为变更。规则第一条就是先 cache 后 search——命中时零延迟返回完整 Markdown且不消耗任何外部请求。extract六种抽取模式的结构化数据提取extract的mode支持metadata默认、structured、schema、tables、selector、brand另有named_schema命名模式。源码 src/tools/extract.ts 中可以看到每个模式的真实行为structuredextractStructured生成结构化 JSONsrc/extraction/structured.tstables合并table与 div/flex 网格卡片detectDivGridTables因此纯 div 布局的定价页也能抽出表格空结果会返回no_tables_detected并提示可重试execution_mode: stealthschema按 JSON Schema 抽取有required字段时走extractWithSchemaDetailed可配合本地 LLM 补全缺字段但补全值会经过 evidence-only 过滤器——凡在原文中找不到依据的模型猜测字段会被置为null并在warnings中点名杜绝幻觉数据selector需同时传css_selector支持multiplebrandJSON-LD/OG/favicon/CSS 变量 图片 k-means 调色板src/extraction/brand.ts。所有模式都支持max_tokens_out超限时表格按行优先裁剪保留表头结构、数组保留前部、超长字符串就地截断并用warnings明确列出每次裁剪保证没有静默的数据丢失。find_similar、research、agent发现、研究、收集find_similar传url或concept找相关内容threshold控制相似度门槛。源码 src/tools/find-similar.ts 显示一个贴心细节当传入 URL 且该域名缓存不足 5 条时会自动用末路径段 主域名构造种子查询触发一次搜索来预热缓存冷启动cache_seeded: truemax_results上限 50researchquestiondepthquick/standard/comprehensiveschemamax_sources上限 50src/tools/research.ts由 src/research/pipeline.ts 驱动分解、检索、来源验证与综合agent用promptschemaurls/max_pages/max_time_ms让 Agent 自主收集数据。diff与watch版本对比与变化监控diff的old/new各接受url、markdown或content_hash三种输入形态output支持unified/hunks/summarygranularity支持line/word/section默认unifiedline。源码 src/tools/diff.ts 显示 URL 形态会从本地缓存取内容缓存未命中时明确报cache_miss并提示先fetch/crawl填充缓存或直接传 markdown。watch的action为create/list/checkinterval_seconds最小 60 秒MIN_INTERVAL_SECONDS支持urls批量创建上限 1000 条与 webhooknotification。值得注意的实现模型src/tools/watch.ts 注释watch 是惰性执行的没有常驻后台守护进程——检查只在显式调用check、或任意其他工具执行后发现任务逾期scheduleOverdueCheck时触发。SSRF 防护在注册时就已施加坏 URL 永远不会落进持久化状态。常用调用模式原命令块示例完整解读命令块给出的 6 个典型模式每一行都对应一种高频实战场景// 1) 缓存优先查询先查本地缓存命中秒回未命中再落到 search cache({ query: oauth2 pkce, url_pattern: *auth0.com* }) // → 若为空再执行搜索兜底 // 2) 多查询广度搜索 直接答案合成 search({ query: [react hooks 2026, useEffect patterns, react state management], format: answer }) // 3) 亚秒级纯缓存搜索search_depth 最低档命中即回 search({ query: react hooks, search_depth: ultra-fast }) // 4) 短语精确错误检索排错场景字面量匹配 code 分类 search({ query: Cannot read properties of undefined, exact_match: true, category: code }) // 5) 定向文档段落抓取只取 Parameters 一节响应更紧凑 fetch({ url: https://react.dev/reference/react/useState, section: Parameters }) // 6) 站点索引以 sitemap 策略爬取前 30 页为后续 find_similar 预热本地缓存 crawl({ url: https://docs.example.com, strategy: sitemap, max_pages: 30 })模式 3 依赖ultra-fast档只查缓存、不触网的设计见前文core-provider中 251 行附近的 cache-miss 提示逻辑模式 6 之所以推荐crawl后紧跟find_similar正是因为相似度检索在本地缓存预热后效果最佳。使用规则与响应字段配套的 assets/blocks/claude-code/CLAUDE.md.block 给出了 Agent 侧的 8 条使用规则是命令块的最佳实践补充先查缓存再搜索cache命中即返回完整 Markdown用关键词而非问句query传 3-5 个关键词变体保证广度召回库/框架查询必须限定官方域名始终传include_domains按预算选深度档ultra-fast亚秒、fast≤1s、balanced默认、deep最大增强短语查询用exact_match: true直接答案用format: answer/stream_answer引用工作用默认证据形状新闻/价格/状态要新鲜度设force_refresh: true配time_range/from_date/to_date限定时间窗crawl 后紧跟 find_similar本地缓存温热时效果最佳。处理响应时建议向用户呈现以下字段evidence_score证据得分拆解相关度、域名质量、词法对齐、新鲜度、query_understanding意图/实体/日期提示/语言/品牌冲突风险的分类视图、brand_collision_warning品牌-域名冲突 Top-3 及改写建议、freshness_signal发布日期与置信度、response_time_ms、engines_used/engine_telemetry各引擎延迟与去重统计、fallback_signal仅 hybrid 模式指明触发的回退信号。搜索后端core / searxng / hybrid默认WIGOLO_SEARCHcore即直连搜索引擎 RRF 融合 ML 重排核心编排在 src/search/core/。两个可选模式searxng遗留聚合器需显式开启长尾召回更高但冷启动更慢hybrid先跑core当信号触发brand_collision_suspect、include_domains_over_filter、all_engines_failed、top1_high_score_low_overlap时回退到searxng并做 RRF 融合响应携带fallback_signal指明触发原因。在 Claude Code 中的安装与卸载安装由wigolo install完成对应 src/cli/agents/claude-code.ts 的installMcp/installInstructions/installSkills/installCommand四步卸载由uninstall完成claude mcp remove wigolo --scope user、移除~/.claude/CLAUDE.md中的指令块、删除~/.claude/commands/wigolo.md。技能目录的清理由技能引擎按 receipts 处理避免误删用户改过的文件。完整文档与逐工具技能说明位于~/.claude/skills/wigolo/SKILL.md与各工具技能中仓库内的源文件可参考 skills/wigolo/SKILL.md、skills/wigolo-agent/SKILL.md、skills/wigolo-cache/SKILL.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),仅供参考