ss-web-search

Fetch ranked web search results from a self-hosted SearXNG endpoint.

Updated May 19, 2026
One-click install
npx skills add https://github.com/Emrebener/Sublime-Skills --skill ss-web-search
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ss-web-search
Source: https://github.com/Emrebener/Sublime-Skills/tree/main/skills/web-utilities/ss-web-search
Command: npx skills add https://github.com/Emrebener/Sublime-Skills --skill ss-web-search

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

ss-web-search removes the need for agents to rely on external search services or an MCP search server by returning ranked web results from your own SearXNG instance.

Core Features & Use Cases

  • SearXNG-backed ranked search: Runs a query against a self-hosted SearXNG endpoint and returns a ranked list with titles, URLs, and snippets.
  • Flexible filtering: Supports category (general/news/images/videos), recency constraints (day/week/month/year), and language/region selection.
  • Text or JSON output: Produces human-readable ranked results by default, or JSON arrays for programmatic downstream use.

Quick Start

Configure your SearXNG endpoint via the SEARXNG_URL environment variable, then ask your agent to run: ss-web-search "openai pricing" --count 5 --category general --time month.

Frequently Asked Questions about ss-web-search

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

FAQPage Schema
How do I get ranked web search results from a self-hosted instance without an MCP search server?

You can fetch ranked web search results by querying a self-hosted SearXNG JSON endpoint. This approach removes the need for an MCP search server, returning titles, URLs, and snippets directly to your agent workflow.

Can I filter SearXNG search results by recency and category for agent workflows?

Yes, SearXNG search results can be filtered by category such as general, news, images, or videos. You can also apply recency constraints like day, week, month, or year, and select specific languages or regions.

Does ss-web-search require Node.js to fetch JSON output from SearXNG?

Yes, fetching JSON output from SearXNG requires Node.js 18 or higher with fetch support. The tool reads the SEARXNG_URL environment variable or a local config.json to locate your self-hosted endpoint.

How do I return JSON arrays instead of text from a SearXNG query?

You can return JSON arrays from a SearXNG query by specifying JSON output format in your request. This produces programmatic data for downstream use instead of the default human-readable ranked text list.

What is the best way to use SearXNG for documentation lookup in AI agents?

The best way to use SearXNG for documentation lookup is querying a self-hosted JSON endpoint with category and time filters. This provides up-to-date web sources with ranked titles and snippets for your agents.