free-web-search-ultimate

<div align="center"> <img src="assets/banner.png" alt="Cross-Validated Search" width="100%"/> <h1>🔍 Cross-Validated Search</h1> <p><strong>The Only Search Skill That Prevents LLM Hallucinations</strong></p> <p><em>Multi-source verification. Zero hallucinations. Free forever.</em></p>

</div>

<br/>

Stop hallucinations. Start verification.

Every LLM hallucinates facts—Claude, GPT-4, Gemini, Llama—all of them. This plugin introduces Cross-Validated Search: every claim is verified against multiple independent sources before being presented as fact.

🏗️ Architecture

<div align="center"> <img src="assets/architecture.png" alt="Architecture Diagram" width="90%"/> </div>

One plugin, every ecosystem. Whether you use Claude Desktop, Cursor, OpenClaw, or a custom LangChain agent, this plugin connects your LLM to verified facts through cross-validation.

🌟 The Cross-Validation Paradigm

Old Paradigm (Standard LLM)	New Paradigm (Cross-Validated Search)
Answers from training data	Answers from real-time web search
May hallucinate facts	Cross-validates facts across sources
Single knowledge source	Multiple independent sources
No confidence score	Confidence score per fact: ✅ 🟢 🟡 🔴
User must trust blindly	Cites all sources for verification

When this plugin is installed, the AI agent:

1. Never Claims Unverified Facts — Every factual claim is checked against multiple sources
2. Cross-Validates — Facts must appear in 2+ sources to be marked as verified
3. Assigns Confidence — Each fact gets a confidence score based on source agreement
4. Cites All Sources — Every claim comes with verifiable URLs

📦 Installation

pip install cross-validated-search

Requirements: Python 3.10+

Or install from source:

git clone https://github.com/wd041216-bit/cross-validated-search.git
cd cross-validated-search
pip install -e .

🚀 Enhanced Version (with API Providers)

Need more search providers? Check out the with-api-providers branch:

# Install enhanced version with Tavily support
pip install git+https://github.com/wd041216-bit/cross-validated-search@with-api-providers

# Or with Tavily extra
pip install "cross-validated-search[tavily] @ git+https://github.com/wd041216-bit/cross-validated-search@with-api-providers"

Enhanced features:

• 🔍 Tavily API — Premium search quality (requires TAVILY_API_KEY)
• 🔄 Parallel execution — Multiple engines running concurrently
• 📊 Better relevance — Advanced search depth options

Note: The enhanced version requires API keys. The main branch remains free and keyless.

🔌 Integration Guide

Claude Desktop & Cursor (via MCP)

Add to your claude_desktop_config.json or Cursor MCP settings:

{
  "mcpServers": {
    "cross-validated-search": {
      "command": "cross-validated-mcp",
      "args": []
    }
  }
}

OpenClaw (via CLI-Anything)

# Install — the skill is auto-discovered from the bundled SKILL.md
pip install cross-validated-search

LangChain / Custom Agents

from langchain.tools import Tool
import subprocess, json

def cross_validate_search(query: str) -> str:
    result = subprocess.run(
        ["cross-validate", query, "--json"],
        capture_output=True, text=True
    )
    data = json.loads(result.stdout)
    return data.get("answer", "No results found.")

search_tool = Tool(
    name="cross_validate_search",
    func=cross_validate_search,
    description="Search the web with cross-validation. Every fact is verified against multiple sources."
)

OpenAI Function Calling

tools = [
    {
        "type": "function",
        "function": {
            "name": "cross_validate_search",
            "description": "Search the web with multi-source cross-validation. Prevents hallucinations by verifying facts across independent sources.",
            "parameters": {
                "type": "object",
                "properties": {
                    "query": {"type": "string", "description": "The search query"},
                    "type": {"type": "string", "enum": ["text", "news", "images", "videos", "books"], "default": "text"}
                },
                "required": ["query"]
            }
        }
    }
]

💻 CLI Usage

cross-validate — Cross-Validated Web Search

# General knowledge (3+ sources, cross-validated)
cross-validate "What is the population of Tokyo?"

# Breaking news (multiple news sources)
cross-validate "OpenAI GPT-5" --type news --timelimit w

# Images (verified sources)
cross-validate "neural network diagram" --type images

# Chinese search
cross-validate "人工智能最新进展" --region zh-cn

# JSON output for programmatic use
cross-validate "quantum computing" --json

browse-page — Deep Page Reading

# Read full page content
browse-page "https://arxiv.org/abs/2303.08774"

# JSON output
browse-page "https://example.com/article" --json

🎯 Confidence Scoring System

Score	Meaning	When to Use
✅ Verified	3+ sources agree, high authority	Cite as fact
🟢 Likely True	2 sources agree, medium confidence	Cite with confidence note
🟡 Uncertain	Single source or minor conflicts	Flag as unverified
🔴 Likely False	Major contradictions or no sources	Do not use

🏆 Why This Over Alternatives?

Feature	Cross-Validated Search	Tavily API	Serper API	Bing Search API
Cost	Free	$0.01/req	$0.001/req	$3/1000 req
Cross-Validation	Yes	No	No	No
Confidence Score	Yes	No	No	No
Hallucination Prevention	Yes	No	No	No
API Key Required	No	Yes	Yes	Yes
MCP Support	Yes	Partial	No	No
CLI-Anything	Yes	No	No	No

📄 License

MIT License — free for personal and commercial use.