Searxng Search

YPares/agent-skills/searxng-search

作者 YPares69660b8be900d642a5d4da8cbb687ec6cfb14ea5无许可证收录于 2026年10月9日更新于 2026年10月9日

Enhanced web and package repository search using local SearXNG instance

包含脚本Research & Analysis
AI 生成的概览

启动本地 SearXNG 元搜索引擎容器，并通过 HTTP 查询网页与软件包仓库结果。

功能
该技能使用 podman 或 docker 启动本地 SearXNG 元搜索实例，并通过其 JSON 搜索 API 进行查询。它支持通用网页搜索以及 cargo、packages、repos、it、code 等软件包与代码仓库类别，并说明了 JSON 响应结构。它还提供通过 PyPI JSON API 或 qypi 命令行工具搜索 PyPI 的替代方案，并附有 Nushell 辅助函数示例和调试命令。
适用场景
当智能体需要通过本地托管的元搜索引擎进行注重隐私的网页搜索或软件包与仓库查询时使用。适用于查找 crate、npm 包、GitHub 仓库或通用网页结果等任务，并通过统一的 JSON 接口返回。
运行要求
需要 podman 或 docker 来运行 SearXNG 容器，需要 curl 发起 HTTP 请求，并需要网络访问以便容器连接上游搜索引擎。该技能附带可执行脚本（start-searxng 和 searx）。文中提到的可选工具包括 jq、Nushell，以及用于 PyPI 查询的 uvx 与 qypi。

SearXNG Search

SearXNG is a privacy-respecting metasearch engine that you can run locally. It aggregates results from multiple search engines and package repositories, returning clean JSON output.

Quick Start

Start SearXNG:

bash
start-searxng --detach

This will:

  • Auto-detect podman or docker
  • Create a minimal config with JSON output enabled
  • Start SearXNG on http://localhost:8888
  • Wait until ready

Stop SearXNG:

bash
podman stop searxng  # or: docker stop searxng

Custom port:

bash
start-searxng --port 9999 --detach

Quick Reference

TaskCommandCategory
General web searchcurl "http://localhost:8888/search?q=<query>&format=json"general
Search Cargo/crates.iocurl "http://localhost:8888/search?q=<crate>&format=json&categories=cargo"cargo
Search npm packagescurl "http://localhost:8888/search?q=<pkg>&format=json&categories=packages"packages
Search code repositoriescurl "http://localhost:8888/search?q=<query>&format=json&categories=repos"repos
Search IT resourcescurl "http://localhost:8888/search?q=<query>&format=json&categories=it"it
Limit resultsAdd &limit=N to URL-
Multiple categories&categories=cat1,cat2-

Available Categories

Run to see all categories:

bash
curl -s "http://localhost:8888/config" | jq '.categories'

Notable categories:

  • general: General web search (default)
  • cargo: Rust crates from crates.io
  • packages: Multi-repo (npm, rubygems, haskell/hoogle, hex, packagist, metacpan, pub.dev, pkg.go.dev, docker hub, alpine, etc.)
  • it: IT/tech resources (includes GitHub, Docker Hub, crates.io)
  • repos: Code repositories
  • code: Code search
  • scientific publications: Academic papers
  • news, videos, images, books, etc.

See package-engine-status.md [blocked] for comprehensive package search testing results.

JSON Response Structure

json
{  "query": "search term",  "number_of_results": 0,  "results": [    {      "url": "https://example.com",      "title": "Result Title",      "content": "Snippet of content...",      "publishedDate": "2025-01-01T00:00:00",      "engine": "duckduckgo",      "engines": ["duckduckgo", "startpage"],      "score": 3.0,      "category": "general"    }  ],  "answers": [],          // Direct answers/infoboxes  "suggestions": [],      // Search suggestions  "corrections": [],      // Query corrections  "infoboxes": [],       // Knowledge panels  "unresponsive_engines": []}

Common Usage Patterns

1. Package Repository Searches

Cargo/Rust crates:

bash
curl -s "http://localhost:8888/search?q=tokio&format=json&categories=cargo" | \  jq '.results[] | {title, url, content}'

npm packages:

bash
curl -s "http://localhost:8888/search?q=express&format=json&categories=packages" | \  jq '.results[] | select(.engines[] == "npm") | {title, url, content}'

PyPI packages (workaround - see below):

bash
# PyPI engine is enabled but not returning results in current SearXNG config# Use direct API or qypi CLI instead (see PyPI Workaround section)

2. Web Search with Filtering

IT/Tech search:

bash
curl -s "http://localhost:8888/search?q=rust+async&format=json&categories=it" | \  jq '.results[0:5] | .[] | {title, url, engines}'

GitHub repositories:

bash
curl -s "http://localhost:8888/search?q=machine+learning&format=json&categories=repos" | \  jq '.results[] | select(.engines[] == "github") | {title, url}'

3. Extracting Specific Information

Get top 3 results:

bash
curl -s "http://localhost:8888/search?q=rust+ownership&format=json" | \  jq '.results[0:3] | .[] | {title, url, content}'

Check which engines returned results:

bash
curl -s "http://localhost:8888/search?q=python&format=json" | \  jq '.results[0].engines'

Get answer boxes/infoboxes:

bash
curl -s "http://localhost:8888/search?q=rust+language&format=json" | \  jq '.infoboxes, .answers'

PyPI Workaround

Since PyPI is not returning results in SearXNG (despite being enabled), use these alternatives:

Option 1: Direct PyPI JSON API

bash
# Search (limited to simple package name matching)curl -s "https://pypi.org/pypi/<package>/json" | jq '.info | {name, summary, version, home_page}'
# Example:curl -s "https://pypi.org/pypi/requests/json" | jq '.info.summary'

Option 2: qypi CLI tool

bash
# Installuvx qypi search pandas --json
# Get package infouvx qypi info requests --json
# List releasesuvx qypi releases flask --json

See references/pypi-direct-search.md for more details.

Integration with Nushell

Create a helper function:

nu
def searx [  query: string,  --category (-c): string = "general",  --limit (-l): int = 10] {  http get $"http://localhost:8888/search?q=($query | url encode)&format=json&categories=($category)"  | get results  | first $limit  | select title url content engines}

Usage:

nu
searx "tokio async" --category cargo --limit 5searx "flask tutorial" --category general

Debugging

Check SearXNG config:

bash
curl -s "http://localhost:8888/config" | jq '.engines[] | select(.name == "pypi")'

Check for engine errors:

bash
curl -s "http://localhost:8888/search?q=test&format=json" | jq '.unresponsive_engines'

Test specific engine:

bash
curl -s "http://localhost:8888/search?q=flask&format=json&engines=pypi" | jq .

Known Issues

  • PyPI engine enabled but not working: Use direct API or qypi CLI as workaround
  • Cargo category sometimes returns empty: Try categories=packages or categories=it which also include crates.io
  • Rate limiting: SearXNG may rate-limit if too many requests in quick succession

Configuration

Using the Helper Script (Recommended)

The start-searxng script creates a minimal configuration automatically:

bash
start-searxng --help

Default config includes:

  • use_default_settings: true (inherits all SearXNG defaults)
  • JSON format enabled
  • Rate limiting disabled (for local use)
  • Secret key (change in production!)

Using Your Own Config

bash
start-searxng --config /path/to/your/config/dir

Your config directory should contain settings.yml.

Manual Container Start

bash
# Create configmkdir -p /tmp/searxng-configcat > /tmp/searxng-config/settings.yml << 'EOF'use_default_settings: truesearch:  formats:    - html    - jsonserver:  secret_key: "change-me-in-production"  bind_address: "0.0.0.0"  port: 8080EOF
# Start with podmanpodman run --rm -d --name searxng \  -p 8888:8080 \  -v /tmp/searxng-config:/etc/searxng:Z \  docker.io/searxng/searxng:latest
# Or with dockerdocker run --rm -d --name searxng \  -p 8888:8080 \  -v /tmp/searxng-config:/etc/searxng \  docker.io/searxng/searxng:latest

Check Logs

bash
podman logs searxng  # or: docker logs searxng

Advanced Config

See SearXNG Settings Documentation for all options.

Minimal config to add JSON output to defaults:

yaml
use_default_settings: truesearch:  formats:    - html    - json

来源与署名

来源：YPares/agent-skills位于searxng-search提交69660b8

许可证： 无许可证

内容归原作者所有。SourceWeft 从公开仓库中收录这些内容。

举报或申请下架

更多Research & Analysis技能

Sector Overview

anthropics

精选

生成行业与板块全景报告，涵盖市场规模、竞争定位、估值与投资启示。

Research & Analysis39K2周前更新

Sector Overview

anthropics

精选

生成行业与板块全景报告，涵盖市场规模、竞争定位、估值与投资启示。

Research & Analysis39K2周前更新

Idea Generation

anthropics

精选

通过量化筛选、主题研究和模式识别，系统性地筛选股票并挖掘投资想法。

Research & Analysis39K2周前更新

Competitive Analysis

anthropics

精选

构建竞争格局演示文稿：市场定位、竞争对手深度分析、对比表格与战略综合。

Research & Analysis39K2周前更新

Equity Research

anthropics

精选

根据分析师一致预期、公司基本面、历史价格与宏观数据，生成结构化的股票研究快照。

Research & Analysis39K2周前更新

Sector Overview

anthropics

精选

生成行业与板块全景报告，涵盖市场规模、竞争定位、估值与投资启示。

Research & Analysis39K2周前更新