Searxng Search Skill

# SearXNG Advanced Search Skill

```markdown
---
name: searxng-skill
description: Advanced Python library for SearXNG metasearch with retry logic, timeout handling, and comprehensive search patterns.
homepage: https://github.com/yourusername/searxng-skill
metadata: {"clawdbot":{"emoji":"🔍","requires":{"python":">=3.8","packages":["requests","urllib3","python-dotenv"]},"install":[{"id":"pip","kind":"pip","package":"searxng-skill","label":"Install searxng-skill (pip)"},{"id":"local","kind":"local","command":"pip install -e .","label":"Install from source"}]}}
---

# searxng-skill

Use `searxng-skill` for privacy-focused metasearch with local/remote SearXNG instances. Supports retry logic, timeout handling, and advanced search patterns.

## Setup (once)

**Environment variables (recommended)**
```bash
# Create .env file
cat > .env << EOF
SEARXNG_URL=http://localhost:8080
SEARXNG_TIMEOUT=10
SEARXNG_MAX_RETRIES=3
SEARXNG_RETRY_DELAY=1.0
SEARXNG_BACKOFF_FACTOR=2.0
SEARXNG_VERIFY_SSL=true
SEARXNG_LANGUAGE=en
EOF
```

**Or configuration file**
```bash
# Create config.json
cat > config.json << EOF
{
  "instance_url": "http://localhost:8080",
  "default_timeout": 10,
  "max_retries": 3,
  "retry_delay": 1.0,
  "backoff_factor": 2.0,
  "verify_ssl": true,
  "default_language": "en"
}
EOF
```

**Initialize in code**
```python
from searxng_skill import SearXNGSkill, SearXNGConfig

# From environment
config = SearXNGConfig.from_env()
skill = SearXNGSkill(config=config)

# From file
config = SearXNGConfig.from_file("config.json")
skill = SearXNGSkill(config=config)

# Direct
skill = SearXNGSkill(instance_url="http://localhost:8080")
```

## Common Commands

**Basic search**
```python
from searxng_skill import SearXNGSkill

skill = SearXNGSkill(instance_url="http://localhost:8080")
results = skill.search("Python programming")

# Access results
for result in results["results"][:10]:
    print(f"{result['title']} - {result['url']}")
```

**Category search**
```python
from searxng_sk...

# SearXNG Advanced Search Skill

A comprehensive Python library for interacting with SearXNG instances with advanced features including retry logic, timeout handling, and support for both local and remote instances.

## Features

- ✅ Comprehensive retry logic with exponential backoff
- ✅ Timeout handling
- ✅ Local and remote instance support
- ✅ Multiple search categories
- ✅ Advanced search operators
- ✅ Structured result objects
- ✅ Health checking
- ✅ Autocomplete support
- ✅ Engine-specific searches
- ✅ Multi-category searches
- ✅ Safe search filtering
- ✅ Time range filtering

## Installation

```bash
pip install searxng-skill # Not yet ready
```

## Or install from source:

```bash
git clone https://github.com/mouaad-ops/searxng-search-skill.git
cd searxng-skill
pip install -e .
```

## Quick Start

```python
from searxng_skill import SearXNGSkill, SearchCategory, TimeRange

# Initialize with local instance
skill = SearXNGSkill(instance_url="http://localhost:8080")

# Basic search
results = skill.search("Python programming")

# Category search
news = skill.news_search("AI", time_range=TimeRange.DAY)

# Advanced search
advanced = skill.advanced_search(
    query="machine learning",
    exact_phrase="deep learning",
    exclude_words=["tutorial"],
    site="github.com"
)
```