searxng-web-search

Search the web privately via a self-hosted SearXNG metasearch engine returning structured JSON results.

1|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/timeplus-io/AgentSkills --skill searxng-web-search
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: searxng-web-search
Source: https://github.com/timeplus-io/AgentSkills/tree/main/searxng-web-search
Command: npx skills add https://github.com/timeplus-io/AgentSkills --skill searxng-web-search

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

Enables agents to search the web privately via a self-hosted SearXNG metasearch engine, providing current information without tracking.

Core Features & Use Cases

  • Privacy-first: SearXNG aggregates search results from many sources without tracking users.
  • Self-hosted: Maintains full control over your search infrastructure and data.
  • Multi-category: Supports general web, images, news, IT, science, and more.
  • Structured output: Returns JSON results with title, url, snippet, engines, and score for easy consumption by agents.
  • Agent-ready: Works with PulseBot, Claude Code, OpenClaw, GitHub Copilot, and other agentskills.io-compatible agents.
  • Robust error handling: Provides clear error payloads and health checks when the service is unavailable.

Quick Start

Ask the AI to perform a web search using your SearXNG endpoint and return JSON results.

Frequently Asked Questions about searxng-web-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I enable AI agents to perform private web searches?

To enable private web search for AI agents, you can use a self-hosted SearXNG metasearch engine that aggregates results from multiple sources without tracking users, returning structured JSON with titles, URLs, and snippets.

How does a SearXNG metasearch engine return results to AI agents?

A SearXNG metasearch engine returns structured JSON format results to AI agents, including fields for title, url, snippet, engines, and score, allowing easy consumption by agent frameworks for current information retrieval.

Do I need a self-hosted SearXNG instance to get untracked search results in JSON?

Yes, a self-hosted SearXNG instance is required to maintain full control over your search infrastructure and data, ensuring privacy-first web searches that return structured JSON results without tracking.

Can I use SearXNG web search JSON results with Claude Code and GitHub Copilot?

Yes, SearXNG web search JSON results are agent-ready and work with Claude Code, GitHub Copilot, PulseBot, OpenClaw, and other agentskills.io-compatible agents for retrieving current online context.

What categories of web search results does SearXNG support for agents?

SearXNG supports multi-category web searches for agents, including general web, images, news, IT, and science, providing structured JSON output for each category without user tracking.

What happens when the SearXNG service is unavailable during an agent web search?

When the SearXNG service is unavailable during a web search, the skill provides robust error handling with clear error payloads and health checks to inform the agent of the service status.