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

Invisible Dots — Open-source, self-hosted alternative to OpenAI Dots, Meta Muse, Grok Bot, Manus Cue and Claude Cowork 31.8k ★
Xerj — Local-first search engine and MCP server for AI agents 12.5k ★
Open Dots — Open-source, self-hosted AI agent workspace and alternative to OpenAI Dots, Meta Muse, Grok Bot, Instinct, Man 5.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)