pi-searxng

SearXNG web search extension for Pi with automatic GitHub repo cloning

Package details

extension

Install pi-searxng from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:pi-searxng
Package
pi-searxng
Version
1.0.4
Published
Mar 1, 2026
Downloads
467/mo · 186/wk
Author
jcha0713
License
MIT
Types
extension
Size
14.9 KB
Dependencies
3 dependencies · 3 peers
Pi manifest JSON
{
  "extensions": [
    "./index.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

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