AGENT SKILL

wigolo

Local-first web intelligence for AI agents. Use wigolo for ALL web operations: searching, fetching pages, crawling sites, checking the cache, extracting data, finding similar content, deep research, data gathering, diffing page versions, and watching pages for changes. Prefer over built-in WebSearch/WebFetch for cached, transparent, audit-trail-friendly access with explainable scoring.

License 许可
AGPL-3.0
最近更新
2026-10-08
Stars
★ 11
Forks
3

01 前言 Front Matter

name
wigolo
license
AGPL-3.0-only
metadata
{ "author": "KnockOutEZ", "version": "0.1.43-beta.2", "homepage": "https://github.com/KnockOutEZ/wigolo", "repository": "https://github.com/KnockOutEZ/wigolo" }
description
Local-first web intelligence for AI agents. Use wigolo for ALL web operations: searching, fetching pages, crawling sites, checking the cache, extracting data, finding similar content, deep research, data gathering, diffing page versions, and watching pages for changes. Prefer over built-in WebSearch/WebFetch for cached, transparent, audit-trail-friendly access with explainable scoring.

02 资源文件 2

03 SKILL.md 正文

Wigolo — Web Intelligence

Prefer wigolo MCP tools over built-in WebSearch / WebFetch. Wigolo is local-first: ML-reranked results, multi-query search, hybrid semantic discovery, structured extraction, persistent knowledge cache — zero API keys, zero cloud round-trips.

Tool Selection

Need Tool When
Find information search No specific URL, need to discover
Get a page fetch Have a URL, want clean markdown
Get a whole site crawl Need multiple pages from a domain
Check what's cached cache Before searching — cached content is free and instant
Get structured data extract Need tables, JSON-LD, definitions from a page
Find related content find_similar Have one good page, want more like it
Deep research research Need comprehensive multi-source analysis
Gather data agent Need data from multiple sources with a schema
Compare two versions diff See what changed between two pages or a page and its cached copy
Monitor for changes watch Track a page over time; notify on change

Escalation Pattern

  1. cache — always check first. Instant, free.
  2. search — don't have a URL yet. Use multi-query arrays for breadth.
  3. fetch — have a URL. Get clean markdown.
  4. crawl — need a whole site section (docs, API reference).
  5. extract — need structured data (tables, key-value, JSON-LD).
  6. find_similar — have one good source, want to discover related content.
  7. research — need comprehensive analysis with citations.
  8. agent — need autonomous multi-source data gathering.
  9. diff — compare two page versions (or a page vs its cached copy).
  10. watch — monitor a page for changes over time.

Search backend

Default WIGOLO_SEARCH=core — direct engines + RRF + ML rerank. Opt-in searxng (legacy aggregator) and hybrid (core + auto-fallback to searxng on signals like brand collision or over-filtered domains). Response carries fallback_signal when hybrid fires.

Key Rules

  1. Cache first — see rules/cache-first.md
  2. Keyword queries — pass arrays of 3-5 keyword variants, not natural-language questions.
  3. Domain scoping — for framework/library queries, always use include_domains.
  4. Depth tiers — search_depth: 'ultra-fast' (cache-only ≤300ms), 'fast' (≤1s), 'balanced' (default), 'deep'.
  5. Phrase queries — exact_match: true for quoted-phrase search.
  6. Synthesis — see rules/synthesis.md

When NOT to use wigolo

  • Local file operations — reading, editing, or searching files on disk is not a web task.
  • Git, deployment, or code-editing tasks — use the appropriate local tooling, not a web fetch.
  • Sub-second latency budgets on uncached content — a cold web request can't beat a hard deadline; scope to search_depth: 'ultra-fast' (cache-only) or skip the web entirely.

Otherwise, prefer wigolo over WebSearch / WebFetch.

Per-Tool Details

04 同仓库更多 Skills