mcpField
G
google-serper-search

google-serper-search

github.com/shuliuzhenhua-sys生産性0243 回インストール32 週間前に更新
リポジトリ

google-serper-search について

google-serper-search は、Python スクリプトから Serper API で検索し、関連する結果を提示するスキルです。複数の検索カテゴリに加え、地域、言語、期間による絞り込みに対応します。

主な機能

  1. 01Serper API 経由の検索
  2. 02ウェブ、ニュース、画像、地図などの検索
  3. 03国、言語、期間による絞り込み
  4. 04JSON 形式での結果取得

活用シーン

  1. 01トピックに関する最新ニュースの検索
  2. 02画像や場所の検索
  3. 03国や言語を指定した結果の絞り込み
  4. 04要約用の構造化結果の取得

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/shuliuzhenhua-sys/google-serper-search --skill google-serper-search

インストール後、Claude Code で/google-serper-searchを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

.gitignore
agents/
openai.yaml
references/
api_response.md
configuration.md
scripts/
serper_search.py

詳細

Google Serper 検索

scripts/serper_search.py を使って Serper API を呼び出し、JSON 検索結果を返します。

設定を確認する

検索する前に、SERPER_API_KEY が利用可能であることを確認します。

次を実行します。

printenv SERPER_API_KEY

変数が空の場合は、続行する前に references/configuration.md を読み、現在のシェルまたはシェルプロファイルに設定します。

検索を実行する

次を使います。

python3 scripts/serper_search.py "query"

リクエストにフィルターが必要な場合は、次を使います。

python3 scripts/serper_search.py "query" --type news --gl us --hl en --tbs "past week"

--type で指定できる値：

  • search
  • images
  • videos
  • places
  • maps
  • reviews
  • news
  • shopping
  • lens
  • scholar
  • patents
  • autocomplete

エイリアス：

  • web -> search
  • image -> images
  • img -> images

--tbs で指定できるショートカット：

  • 過去 1 時間
  • 過去 24 時間
  • 過去 1 週間
  • 過去 1 か月
  • 過去 1 年

地域や言語に特化した結果が必要な場合は、国には --gl、言語には --hl を使います。

結果を解釈する

結果のスキーマが必要な場合は、references/api_response.md を読みます。

ウェブ検索とニュース検索の結果では、次を優先します。

  • knowledgeGraph
  • organic
  • peopleAlsoAsk
  • relatedSearches

画像検索の結果では、次を優先します。

  • 画像タイトル
  • imageUrl
  • thumbnailUrl
  • 寸法
  • ソースページ

回答を提示する

ユーザーが生のレスポンスを求めていない限り、JSON をそのまま出力するのではなく、最も関連性の高い結果を要約します。

最終回答にはソースへのリンクを含めます。

スクリプトから error フィールドが返された場合は、設定の不備や API エラーを明示します。

コメント

Markdown 対応