mcpField
S
searxng-search

searxng-search

github.com/xyenon生産性154 回インストール3 週間前に更新
リポジトリ

searxng-search について

searxng-searchは、SearXNGインスタンスのAPIを使ってウェブ検索するスキルです。カテゴリ、エンジン、言語、期間、安全検索で絞り込み、ページ指定や結果数の制限もできます。

主な機能

  1. 01SearXNG 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 検索スキル

API を介して SearXNG インスタンスを使用し、ウェブを検索します。

設定に関する問題

このスキルはローカルの 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 で2 回目の検索を実行してください。結果を統合して重複を除いてから、ユーザーに提示します。

ワークフロー

  1. ユーザーが検索を依頼します
  2. トピックの種類を判断します。
    • 技術的なトピック:必要に応じてクエリを英語に翻訳し、-l en で検索します
    • 中国のライフスタイルに関するトピック:まずデフォルトの検索を行い、次に -e baidu,sogou -l zh-CN で追加検索を行います
  3. クエリと関連するフィルターを指定して scripts/search.py を実行します
  4. 読みやすい形式で検索結果をユーザーに提示します
  5. ユーザーがさらに結果を求めた場合は、ページ送りに -p を使用するか、1 ページあたりの件数を増やすために -n を使用します

コメント