theYahia

Qsearch — AI skill for Claude Code

AI community

Open-source search API for AI agents — corpus-first hybrid search with x402 micropayments.

How to install Qsearch

This entry records only its repository, not the path inside it, so there is no exact command to give. Open theYahia/qsearch and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Qsearch does

Open-source search API for AI agents — corpus-first hybrid search with x402 micropayments. Self-hosted; bundled MCP server (9 tools) you run from source.

Alternatives in AI

Multica — Make humans and AI agents work as one team — open-source and self-hostable 47.8k ★
WeKnora — Open-source LLM knowledge platform: turn raw documents into a queryable RAG, an autonomous reasoning agent, an 26.9k ★
Chat Ollama — ChatOllama is an open source agentic app for running AI agents across local and hosted models 3.5k ★

README

qsearch

I built this for my own daily research. After running 100+ research sprints, my agent kept hallucinating because it read 200-char snippets. qsearch gives it full content with multi-engine provenance — running locally, owned by me.

![License: Apache-2.0](https://img.shields.io/badge/license-Apache--2.0-blue.svg) ![CI](https://github.com/theYahia/qsearch/actions/workflows/test.yml/badge.svg) ![Status: v0.4.0 live](https://img.shields.io/badge/status-v0.4.0%20live-brightgreen.svg) ![Demo: qsearch.pro](https://img.shields.io/badge/demo-qsearch.pro-ef4444.svg) ![MCP](https://img.shields.io/badge/MCP-ready-8b5cf6.svg) [![MCP Registry](https://img.shields.io/badge/MCP%20Registry-io.github.theYahia%2Fqsearch-8b5cf6.svg)](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.theYahia/qsearch)

AI agents lose **17–33% of facts to hallucination** because they read 200-character snippets, not full pages ([Stanford 2024](https://dho.stanford.edu/wp-content/uploads/Legal_RAG_Hallucinations.pdf)). Existing search APIs hide *which engines agreed* on a result. Existing knowledge graphs are enterprise-priced or vendor-locked.

**qsearch is the open-source search layer that gives agents full content with multi-engine provenance** — running on your machine, owned by you, ready for MCP today.

✅ **v0.4.0 live at [qsearch.pro](https://qsearch.pro).** Multi-engine attribution, trust corpus with per-URL provenance (`engines[]`, `sweep_count`, `trust_score`), corpus viewer at `/ui`, MCP-over-HTTP for Claude Code and any spec-compliant client. 📖 **Architecture:** [ARCHITECTURE.md](./ARCHITECTURE.md) · **Vision:** [docs/VISION.md](./docs/VISION.md) · **Technical spec:** [docs/TRUST_MESH.md](./docs/TRUST_MESH.md) · **Federation deep-dive:** [docs/FEDERATION_ARCHITECTURE.md](./docs/FEDERATION_ARCHITECTURE.md)