🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί Searxng Search
πŸ¦€ ClawHub

Searxng Search

by @zfanmy

Web search using SearXNG instance via MCP. Provides web search capability for agents with configurable SearXNG endpoint.

Versionv0.1.2
Downloads2,537
Stars⭐ 1
#api#legal
TERMINAL
clawhub install searxng-search-2

πŸ“– About This Skill

name: searxng-search description: Web search using SearXNG instance via MCP. Provides web search capability for agents with configurable SearXNG endpoint. author: zfanmy-ζ’¦ζœˆε„Ώ version: 1.0.1 homepage: license: MIT keywords: - search - searxng - web - mcp - internet requires: bins: - python3 - curl - jq

SearXNG Search

Web search using SearXNG instance via MCP protocol.

Features

  • πŸ” Web search with multiple result formats
  • πŸ”§ MCP server for standard tool integration
  • βš™οΈ Configurable SearXNG endpoint
  • πŸ“Š JSON, Markdown, and text output formats

    • Configuration

    Set your SearXNG URL:

    export SEARXNG_URL="http://your-searxng-instance:port"

    Or configure in mcporter:

    {
  "mcpServers": {
    "searxng": {
      "command": "python3",
      "args": ["./mcp-server.py"],
      "env": {
        "SEARXNG_URL": "http://your-searxng-instance:port"
      }
    }
  }
}

    Installation

    1. Configure MCP Server

    Copy config.json to your mcporter config:

    cp config.json ~/.config/mcporter/config.json

    2. Install mcporter

    npm install -g mcporter

    Usage

    Via mcporter

    # List servers
mcporter list
    Search web
    
mcporter call searxng.web_search query="OpenClaw features" limit=5

    Via Script

    # Configure first
export SEARXNG_URL="http://your-searxng-instance:port"
    Basic search
    
./searxng_search.sh "your search query"
    With options
    
./searxng_search.sh "query" --limit 5 --format markdown

    Direct API

    curl "${SEARXNG_URL}/search?q=OpenClaw&format=json"

    Output Formats

  • text (default): Human-readable format
  • json: Raw JSON output
  • markdown: Markdown formatted results

    • Files

  • mcp-server.py - MCP server implementation
  • searxng_search.sh - Bash search script
  • config.json - MCP configuration template

    • Requirements

  • Python 3.8+
  • mcporter CLI
  • curl, jq (for bash script)

    • Author

    zfanmy-ζ’¦ζœˆε„Ώ

    πŸ’‘ Examples

    Via mcporter

    # List servers
mcporter list
    Search web
    
mcporter call searxng.web_search query="OpenClaw features" limit=5

    Via Script

    # Configure first
export SEARXNG_URL="http://your-searxng-instance:port"
    Basic search
    
./searxng_search.sh "your search query"
    With options
    
./searxng_search.sh "query" --limit 5 --format markdown

    Direct API

    curl "${SEARXNG_URL}/search?q=OpenClaw&format=json"

    βš™οΈ Configuration

    Set your SearXNG URL:

    export SEARXNG_URL="http://your-searxng-instance:port"

    Or configure in mcporter:

    {
  "mcpServers": {
    "searxng": {
      "command": "python3",
      "args": ["./mcp-server.py"],
      "env": {
        "SEARXNG_URL": "http://your-searxng-instance:port"
      }
    }
  }
}