feat: Add SearxNG search tool for privacy-focused web searches

- Implement SearxNG search tool following PraisonAI patterns
- Add comprehensive documentation with setup instructions
- Include working examples for both tools and agents
- Support configurable SearxNG URL and search parameters
- Integrate with existing tools registry and documentation
- Provide privacy-focused alternative to traditional search engines

Addresses issue #337

Co-authored-by: MervinPraison <MervinPraison@users.noreply.github.com>

Author: claude[bot]

docs/tools/searxng.mdx

@@ -0,0 +1,248 @@
+---
+title: "SearxNG Search"
+description: "Search the web using your local SearxNG instance for privacy-focused web searches"
+---
+
+# SearxNG Search Tool
+
+The SearxNG search tool allows you to perform web searches using your local SearxNG instance, providing privacy-focused search capabilities as an alternative to traditional search engines like Google or DuckDuckGo.
+
+## Overview
+
+SearxNG is a privacy-respecting metasearch engine that aggregates results from multiple search engines without storing your data. This tool integrates with your local SearxNG instance to provide secure, private web searches for your AI agents.
+
+## Installation
+
+First, install the required dependency:
+
+```bash
+pip install requests
+```
+
+You'll also need a running SearxNG instance. You can set it up using Docker:
+
+```bash
+# Run SearxNG locally on port 32768
+docker run -d --name searxng -p 32768:8080 searxng/searxng
+```
+
+## Usage
+
+### Basic Usage
+
+```python
+from praisonaiagents.tools import searxng_search
+
+# Basic search
+results = searxng_search("AI news")
+
+# With custom parameters
+results = searxng_search(
+    query="Python programming", 
+    max_results=10,
+    searxng_url="http://localhost:32768/search"
+)
+
+# Display results
+for result in results:
+    print(f"Title: {result['title']}")
+    print(f"URL: {result['url']}")
+    print(f"Snippet: {result['snippet']}")
+    print("-" * 50)
+```
+
+### Using the Alias
+
+```python
+from praisonaiagents.tools import searxng
+
+# Same functionality as searxng_search
+results = searxng("machine learning tutorials")
+```
+
+### Integration with Agents
+
+```python
+from praisonaiagents import Agent, Task
+from praisonaiagents.tools import searxng_search
+
+# Create an agent with SearxNG search capability
+search_agent = Agent(
+    name="Search Agent",
+    instructions="You are a search assistant that helps users find information using SearxNG.",
+    tools=[searxng_search]
+)
+
+# Create a task
+task = Task(
+    description="Search for the latest developments in artificial intelligence",
+    agent=search_agent
+)
+
+# Execute the task
+result = task.execute()
+print(result)
+```
+
+## Function Parameters
+
+### `searxng_search(query, max_results=5, searxng_url=None)`
+
+**Parameters:**
+
+- `query` (str, required): The search query string
+- `max_results` (int, optional): Maximum number of results to return. Default: 5
+- `searxng_url` (str, optional): URL of your SearxNG instance. Default: "http://localhost:32768/search"
+
+**Returns:**
+
+- `List[Dict]`: List of search results, each containing:
+  - `title`: The title of the search result
+  - `url`: The URL of the search result
+  - `snippet`: A brief snippet/description of the content
+  - `error`: Error message if the search fails
+
+## Configuration
+
+### Environment Variables
+
+You can set a default SearxNG URL using environment variables:
+
+```python
+import os
+
+# Set default SearxNG URL
+os.environ['SEARXNG_URL'] = 'http://my-searxng-server:8080/search'
+
+# The tool will use this URL if none is provided
+results = searxng_search("AI research")
+```
+
+### SearxNG Setup
+
+For production use, consider:
+
+1. **Custom SearxNG Configuration**: Configure engines, categories, and settings
+2. **Authentication**: Set up authentication if needed
+3. **Rate Limiting**: Configure appropriate rate limits
+4. **SSL/TLS**: Use HTTPS for secure connections
+
+## Advanced Usage
+
+### Multi-Agent Search System
+
+```python
+from praisonaiagents import Agent, Task, Process
+from praisonaiagents.tools import searxng_search
+
+# Research agent
+researcher = Agent(
+    name="Researcher",
+    instructions="Search for academic and technical information",
+    tools=[searxng_search]
+)
+
+# News agent
+news_agent = Agent(
+    name="News Agent", 
+    instructions="Search for latest news and current events",
+    tools=[searxng_search]
+)
+
+# Tasks
+research_task = Task(
+    description="Find recent research papers on quantum computing",
+    agent=researcher
+)
+
+news_task = Task(
+    description="Find latest news about AI developments",
+    agent=news_agent
+)
+
+# Process
+process = Process(
+    agents=[researcher, news_agent],
+    tasks=[research_task, news_task]
+)
+
+result = process.run()
+```
+
+### Custom SearxNG Configuration
+
+```python
+from praisonaiagents.tools import searxng_search
+
+# Search with specific SearxNG instance
+results = searxng_search(
+    query="sustainable energy",
+    max_results=15,
+    searxng_url="https://my-private-searxng.com/search"
+)
+```
+
+## Error Handling
+
+The tool includes comprehensive error handling:
+
+```python
+results = searxng_search("test query")
+
+for result in results:
+    if "error" in result:
+        print(f"Search error: {result['error']}")
+    else:
+        print(f"Found: {result['title']}")
+```
+
+## Common Error Messages
+
+- **Connection Error**: "Could not connect to SearxNG at {url}. Ensure SearxNG is running."
+- **Timeout Error**: "SearxNG search request timed out"
+- **Missing Dependency**: "SearxNG search requires requests package. Install with: pip install requests"
+- **Parsing Error**: "Error parsing SearxNG response: {error}"
+
+## Best Practices
+
+1. **Local Instance**: Use a local SearxNG instance for better privacy and performance
+2. **Rate Limiting**: Be mindful of search frequency to avoid overwhelming your instance
+3. **Error Handling**: Always check for errors in the response
+4. **Custom URLs**: Use environment variables for different deployment environments
+5. **Result Validation**: Validate search results before using them in your application
+
+## Comparison with Other Search Tools
+
+| Feature | SearxNG | DuckDuckGo | Google |
+|---------|---------|------------|--------|
+| Privacy | ✅ High | ⚡ Medium | ❌ Low |
+| Local Control | ✅ Yes | ❌ No | ❌ No |
+| Multi-Engine | ✅ Yes | ❌ No | ❌ No |
+| Customization | ✅ High | ❌ Limited | ❌ None |
+
+## Troubleshooting
+
+### SearxNG Not Responding
+
+```bash
+# Check if SearxNG is running
+curl http://localhost:32768/search?q=test&format=json
+
+# Restart SearxNG container
+docker restart searxng
+```
+
+### Connection Issues
+
+```python
+# Test connection before using
+import requests
+
+try:
+    response = requests.get("http://localhost:32768/search", timeout=5)
+    print("SearxNG is accessible")
+except requests.exceptions.ConnectionError:
+    print("Cannot connect to SearxNG")
+```
+
+For more information about SearxNG setup and configuration, visit the [official SearxNG documentation](https://docs.searxng.org/).

docs/tools/tools.mdx

@@ -404,6 +404,9 @@ praisonai agents.yaml
   <Card title="DuckDuckGo Tools" icon="duck" href="/tools/duckduckgo_tools">
     Web search functionality using DuckDuckGo's API
   </Card>
+  <Card title="SearxNG Tools" icon="search" href="/tools/searxng">
+    Privacy-focused web search using local SearxNG instance
+  </Card>
   <Card title="Calculator Tools" icon="calculator" href="/tools/calculator_tools">
     Perform mathematical calculations and conversions
   </Card>

examples/python/agents/searxng-agent.py

@@ -0,0 +1,80 @@
+#!/usr/bin/env python3
+"""
+SearxNG Search Agent Example
+
+A simple example showing how to create an agent that uses SearxNG for web searches.
+This provides privacy-focused search capabilities as an alternative to traditional search engines.
+
+Prerequisites:
+1. Install dependencies: pip install requests
+2. Run SearxNG: docker run -d --name searxng -p 32768:8080 searxng/searxng
+"""
+
+from praisonaiagents import Agent, Task
+from praisonaiagents.tools import searxng_search
+
+def main():
+    """Create and run a SearxNG-enabled search agent"""
+    
+    # Create a search agent with SearxNG capabilities
+    search_agent = Agent(
+        name="Privacy Search Agent",
+        instructions="""You are a privacy-focused search assistant that uses SearxNG to find information.
+        
+        Your capabilities:
+        - Search the web using SearxNG for privacy-focused results
+        - Analyze and summarize search findings
+        - Provide relevant links and sources
+        - Respect user privacy by using local SearxNG instance
+        
+        When searching:
+        1. Use relevant keywords to get the best results
+        2. Analyze the search results for quality and relevance
+        3. Provide a clear summary with key points
+        4. Include important URLs for further reading
+        5. If search fails, explain the issue and suggest alternatives""",
+        tools=[searxng_search]
+    )
+    
+    # Create search tasks
+    tasks = [
+        Task(
+            description="Search for information about renewable energy technologies and provide a comprehensive summary",
+            agent=search_agent
+        ),
+        Task(
+            description="Find the latest news about artificial intelligence developments in 2024",
+            agent=search_agent
+        ),
+        Task(
+            description="Research privacy-focused alternatives to mainstream social media platforms",
+            agent=search_agent
+        )
+    ]
+    
+    print("Privacy Search Agent - Using SearxNG")
+    print("=" * 50)
+    
+    # Execute each task
+    for i, task in enumerate(tasks, 1):
+        print(f"\n🔍 Task {i}: {task.description}")
+        print("-" * 50)
+        
+        try:
+            result = task.execute()
+            print(f"Result:\n{result}")
+        except Exception as e:
+            print(f"❌ Task failed: {e}")
+            print("Make sure SearxNG is running at http://localhost:32768")
+        
+        print("\n" + "=" * 50)
+    
+    print("\n✅ All search tasks completed!")
+    print("\nSearxNG Benefits:")
+    print("• Privacy-focused: No tracking or data collection")
+    print("• Multi-engine: Aggregates results from multiple sources")
+    print("• Self-hosted: Full control over your search infrastructure")
+    print("• Customizable: Configure engines and settings as needed")
+
+if __name__ == "__main__":
+    main()