SlopSearX

SlopSearX is a horizontally scalable meta search engine designed for AI agent consumption. It fans out queries to 48 engines in parallel, deduplicates and ranks results, and returns structured output in SearXNG-compatible JSON or agent-native YAML+Markdown.

How to Use

Starting the Server

# From the project root
uvicorn slopsearx.server:app --host 0.0.0.0 --port 8080

Using the CLI (ssx)

The ssx CLI wraps all API endpoints in an agent-friendly way:

# Search across all engines (YAML output by default)
python ssx search "your query"

# Search with category filter
python ssx search "your query" --categories science

# Search specific engines
python ssx search "your query" --engines arxiv,wikipedia

# List all engines with status
python ssx engines

# Health check
python ssx health

# Show engine config/categories
python ssx config

# Output as JSON (for programmatic use)
python ssx search "your query" --json

Direct API Usage

Example: Agent-Native Search

curl 'http://localhost:8080/search?q=quantum+computing+breakthroughs+2025&format=yaml'

Returns YAML-frontmatter with structured results followed by a Markdown summary - ideal for AI agent processing.

Engine Categories

Engines are organized by categories. Use ?categories= to narrow scope:

• general — Brave, DuckDuckGo, Google, Wikipedia, Reddit, Hacker News
• science — arXiv, Semantic Scholar, OpenAlex, PubMed, PubChem, HuggingFace
• security — NVD, CVE, Shodan, Censys, VirusTotal, AbuseIPDB, OTX, URLhaus
• reference — Wikipedia, Stack Exchange, GitHub, Open Library, MITRE ATT&CK
• it — NVD, CVE, Shodan, Censys, CRT.sh, npm, PyPI, Crates.io
• news — Brave, DuckDuckGo, Google, Hacker News
• finance — FRED, SEC EDGAR
• medical — PubMed, PubChem, ClinicalTrials.gov, openFDA
• music — MusicBrainz
• movies — TMDB
• geography — Nominatim
• social — Reddit
• books — Open Library
• legal — Oyez
• packages — npm, PyPI, Crates.io, RubyGems, Docker Hub, Repology

Engine-Specific Sub-Categories

Some engines support sub-categories for fine-grained routing:

• github:code — GitHub code search
• github:issues — GitHub issues/PRs search
• huggingface:datasets — HuggingFace dataset search
• huggingface:papers — HuggingFace paper search
• reddit:subreddit — Reddit subreddit-scoped search
• stackexchange:code — Stack Overflow code search
• stackexchange:serverfault — Server Fault search

Configuration

Engines are configured via three-layer priority (env vars > config file > defaults):

# Required API keys as env vars
export ENGINE_BRAVE_API_KEY="your_key"
export ENGINE_GITHUB_TOKEN="ghp_..."
export ENGINE_SHODAN_API_KEY="your_key"

# Category overrides
export ENGINE_BRAVE_CATEGORIES="general,news,science"
export ENGINE_WIKIPEDIA_CATEGORIES_ADD="education"

A mounted YAML config file at /etc/slopsearx/config.yaml provides per-engine tuning.

References

General / Web

Developer / Package Registries

Science & Research

Medical / Health

Security / Threat Intelligence

Finance / Economics

Media & Entertainment

Geography / GIS

Legal