pi-searxng

SearXNG web search extension for Pi with automatic GitHub repository cloning.

Features

• Web Search - Search the web via SearXNG instance
• Content Fetching - Extract article content from URLs (converts HTML to Markdown)
• Auto GitHub Cloning - Automatically clones GitHub repos when fetching GitHub URLs

Installation

pi install npm:pi-searxng

Or try without installing:

pi -e npm:pi-searxng

Configuration

Create ~/.pi/searxng.json:

{
  "searxngUrl": "http://localhost:8080",
  "timeoutMs": 30000,
  "maxResults": 10
}

Or use environment variable:

export SEARXNG_URL=http://localhost:8080

Tools

web_search

Search the web using SearXNG.

Parameters:

• query (string, required) - Search query
• limit (number, optional) - Max results (default: 10)

fetch_content

Fetch URL content. Automatically clones GitHub repositories.

Parameters:

• url (string, required) - URL to fetch

For GitHub URLs, the repo is cloned to a temp directory and file listings are returned.

get_search_results

Retrieve cached search results by ID.

Parameters:

• searchId (string, required) - Search ID from previous web_search call

System Requirements

• Node.js 18+
• git command (for GitHub cloning)
• SearXNG instance (for web search)

License

MIT