mcpField
S
searxng-search

searxng-search

github.com/xyenon生产力154 次安装3 周前更新
代码仓库

关于 searxng-search

searxng-search 是通过 SearXNG 实例的 API 搜索网页的技能。它支持按类别、引擎、语言、时间范围和安全搜索过滤，也可分页并限制结果数量。

主要功能

  1. 01通过 SearXNG API 搜索
  2. 02按类别和引擎筛选
  3. 03设置语言和时间范围
  4. 04控制安全搜索级别
  5. 05支持分页和结果数量限制

适用场景

  1. 01搜索近期新闻
  2. 02限定使用的搜索引擎
  3. 03查找指定语言的结果

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/xyenon/agents --skill searxng-search

安装后在 Claude Code 中输入/searxng-search确认已加载。

附带文件references/configuration.mdscripts/search.py

详细介绍

SearXNG 搜索技能

通过 SearXNG 实例的 API 搜索网络。

配置问题

此技能依赖本地 SearXNG 配置文件。请勿将设置详情放入此文件，仅在需要时加载 references/configuration.md。

如果 scripts/search.py 报告配置、身份验证或实例设置错误，请在重试前阅读 references/configuration.md。常见示例包括：

  • ERROR: Config file not found
  • ERROR: Invalid TOML ... / ERROR: Invalid JSON ...
  • ERROR: base_url is required
  • ERROR: Environment variable ... is not set
  • ERROR: auth.token required for bearer auth
  • ERROR: auth.user and auth.pass required for basic auth
  • ERROR: Unknown auth.type ...
  • ERROR: HTTP 401 / ERROR: HTTP 403

用法

运行搜索脚本：

python3 scripts/search.py [OPTIONS] <query>
选项
标志描述
-c, --categories逗号分隔的类别（general、news、images、videos、music、files、it、science、social media）
-e, --engines逗号分隔的搜索引擎（google、duckduckgo、bing 等）
-l, --language语言代码（en、zh-CN、ja 等）
-p, --page页码（默认值：1）
-t, --time-range时间范围：day、month、year
-n, --max-results要显示的结果数上限（覆盖配置默认值）
-s, --safesearch安全搜索：0（关闭）、1（适中）、2（严格）
示例
# Basic search
python3 scripts/search.py "SearXNG documentation"

# Search news from the last day
python3 scripts/search.py -c news -t day "latest tech news"

# Search with specific engines, page 2
python3 scripts/search.py -e google,duckduckgo -p 2 "rust programming"

# Search in Chinese with more results
python3 scripts/search.py -l zh-CN -n 10 "开源搜索引擎"

最佳实践

  • 技术主题（编程、软件、科学、IT 等）：无论用户使用何种语言，都始终使用英语作为查询语言和搜索语言（-l en）。如有需要，请将查询翻译成英语。对于技术内容，英语搜索结果更全面、更新更及时。
  • 中文生活主题（美食、旅行、购物、本地服务、社会趋势等）：除了默认搜索，还要使用中文查询运行第二次搜索，并添加 -e baidu,sogou -l zh-CN，以获取中国特定的结果。向用户展示前合并并去重结果。

工作流

  1. 用户请求搜索内容
  2. 判断主题类型：
    • 技术主题：如有需要，将查询翻译成英语，并使用 -l en 搜索
    • 中文生活主题：先运行默认搜索，再使用 -e baidu,sogou -l zh-CN 进行额外搜索
  3. 使用查询和任何相关筛选条件运行 scripts/search.py
  4. 以易读的格式向用户展示结果
  5. 如果用户需要更多结果，使用 -p 翻页，或使用 -n 增加每页结果数

评论

支持 Markdown