SearXNG 隐私搜索引擎：本地部署、多源聚合、JSON 输出，支持软件包和代码搜索

searxng-search by ypares/agent-skills

363 周安装量

23 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/ypares/agent-skills --skill searxng-search

开发自动化开源项目

🇨🇳中文介绍

SearXNG 搜索

SearXNG 是一款尊重隐私的元搜索引擎，可在本地运行。它聚合来自多个搜索引擎和软件包仓库的结果，返回简洁的 JSON 输出。

快速开始

启动 SearXNG：

start-searxng --detach

这将：

自动检测 podman 或 docker
创建启用 JSON 输出的最小配置
在 http://localhost:8888 上启动 SearXNG
等待直到就绪

停止 SearXNG：

podman stop searxng  # 或：docker stop searxng

自定义端口：

start-searxng --port 9999 --detach

快速参考

任务	命令	类别
通用网页搜索

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

1. 软件包仓库搜索

Cargo/Rust crate：

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

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

PyPI 包（变通方法 - 见下文）：

# PyPI 引擎已启用但在当前 SearXNG 配置中未返回结果
# 请改用直接 API 或 qypi CLI（参见 PyPI 变通方法部分）

2. 带过滤的网页搜索

IT/技术搜索：

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

GitHub 仓库：

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

3. 提取特定信息

获取前 3 个结果：

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

检查哪些引擎返回了结果：

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

获取答案框/信息框：

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

由于 PyPI 在 SearXNG 中未返回结果（尽管已启用），请使用以下替代方案：

选项 1：直接 PyPI JSON API

# 搜索（仅限于简单的包名匹配）
curl -s "https://pypi.org/pypi/<package>/json" | jq '.info | {name, summary, version, home_page}'

# 示例：
curl -s "https://pypi.org/pypi/requests/json" | jq '.info.summary'

选项 2：qypi CLI 工具

# 安装
uvx qypi search pandas --json

# 获取包信息
uvx qypi info requests --json

# 列出发布版本
uvx qypi releases flask --json

更多详情请参阅 references/pypi-direct-search.md。

创建辅助函数：

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
}

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

检查 SearXNG 配置：

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

检查引擎错误：

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

测试特定引擎：

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

PyPI 引擎已启用但无法工作 ：使用直接 API 或 qypi CLI 作为变通方法
Cargo 类别有时返回空结果 ：尝试使用 categories=packages 或 categories=it，它们也包含 crates.io
速率限制 ：如果短时间内请求过多，SearXNG 可能会进行速率限制

使用辅助脚本（推荐）

start-searxng 脚本会自动创建最小配置：

start-searxng --help

默认配置包括：

use_default_settings: true（继承所有 SearXNG 默认值）
启用 JSON 格式
禁用速率限制（供本地使用）
密钥（生产环境中请更改！）

使用您自己的配置

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

您的配置目录应包含 settings.yml。

# 创建配置
mkdir -p /tmp/searxng-config
cat > /tmp/searxng-config/settings.yml << 'EOF'
use_default_settings: true
search:
  formats:
    - html
    - json
server:
  secret_key: "change-me-in-production"
  bind_address: "0.0.0.0"
  port: 8080
EOF

# 使用 podman 启动
podman run --rm -d --name searxng \
  -p 8888:8080 \
  -v /tmp/searxng-config:/etc/searxng:Z \
  docker.io/searxng/searxng:latest

# 或使用 docker
docker run --rm -d --name searxng \
  -p 8888:8080 \
  -v /tmp/searxng-config:/etc/searxng \
  docker.io/searxng/searxng:latest

podman logs searxng  # 或：docker logs searxng

所有选项请参阅 SearXNG 设置文档。

向默认配置添加 JSON 输出的最小配置：

use_default_settings: true
search:
  formats:
    - html
    - json

2026 年 1 月 24 日

🇺🇸English

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:

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:

podman stop searxng  # or: docker stop searxng

Custom port:

start-searxng --port 9999 --detach

Quick Reference

Task	Command	Category
General web search	`curl "http://localhost:8888/search?q=<query>&format=json"`	`general`
Search Cargo/crates.io	`curl "http://localhost:8888/search?q=<crate>&format=json&categories=cargo"`	`cargo`
Search npm packages	`curl "http://localhost:8888/search?q=<pkg>&format=json&categories=packages"`	`packages`
Search code repositories	`curl "http://localhost:8888/search?q=<query>&format=json&categories=repos"`

Available Categories

Run to see all categories:

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.

Seepackage-engine-status.md for comprehensive package search testing results.

JSON Response Structure

{
  "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:

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

npm packages:

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):

# 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:

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

GitHub repositories:

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:

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

Check which engines returned results:

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

Get answer boxes/infoboxes:

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

# 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

# Install
uvx qypi search pandas --json

# Get package info
uvx qypi info requests --json

# List releases
uvx qypi releases flask --json

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

Integration with Nushell

Create a helper function:

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:

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

Debugging

Check SearXNG config:

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

Check for engine errors:

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

Test specific engine:

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:

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

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

Your config directory should contain settings.yml.

Manual Container Start

# Create config
mkdir -p /tmp/searxng-config
cat > /tmp/searxng-config/settings.yml << 'EOF'
use_default_settings: true
search:
  formats:
    - html
    - json
server:
  secret_key: "change-me-in-production"
  bind_address: "0.0.0.0"
  port: 8080
EOF

# Start with podman
podman run --rm -d --name searxng \
  -p 8888:8080 \
  -v /tmp/searxng-config:/etc/searxng:Z \
  docker.io/searxng/searxng:latest

# Or with docker
docker run --rm -d --name searxng \
  -p 8888:8080 \
  -v /tmp/searxng-config:/etc/searxng \
  docker.io/searxng/searxng:latest

Check Logs

podman logs searxng  # or: docker logs searxng

Advanced Config

See SearXNG Settings Documentation for all options.

Minimal config to add JSON output to defaults:

use_default_settings: true
search:
  formats:
    - html
    - json

Weekly Installs

363

Repository

ypares/agent-skills

GitHub Stars

First Seen

Jan 24, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykWarn

Installed on

opencode339

gemini-cli334

codex332

github-copilot331

amp326

kimi-cli326

agent-browser 浏览器自动化工具 - Vercel Labs 命令行网页操作与测试

140,500 周安装