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

  • Open Science — Open Science Desktop — local-first, model-agnostic AI research workbench for macOS, Windows & Linux 1.5k ★
  • Room — Open-source earning-focused swarm intelligence engine 838 ★
  • Codeseek — Rust-powered code intelligence CLI for AI coding agents 764 ★

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)

Demo

![qsearch terminal demo — quickstart, multi-engine search, citation verify](assets/demo.gif)

60-second tour: `/health` (it's up, local) → `/s