mcpField
S
serper-search

serper-search

github.com/fanzhidongyzby生産性466 回インストール37 週間前に更新
リポジトリ

serper-search について

serper-searchは、Google Serper APIを使うウェブ検索スキルです。最新情報の確認、テーマの調査、事実検証に向いており、結果数・地域・言語の指定や、検索語の調整と複数回検索の指針を備えています。

主な機能

  1. 01Google Serper APIによるウェブ検索
  2. 02結果数・国・言語の指定
  3. 03検索語と複数回検索のガイド
  4. 04ニュース検索と事実検証

活用シーン

  1. 01最新ニュースや動向の確認
  2. 02技術テーマの調査とドキュメント検索
  3. 03事実確認や製品・案の比較

インストール

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

$npx skills add https://github.com/fanzhidongyzby/openclaw-serper --skill serper-search

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

詳細

Google Serper 検索ツール

Google Serper API に基づくウェブ検索ツールで、リアルタイムかつ正確な検索結果を提供します。

起動するタイミング

ユーザーが以下の内容に言及したとき、自動的に起動します。

検索関連のキーワード
  • 「検索」「検索して」「調べて」「探す」「探して」
  • 「研究」「調査」「知りたい」
  • 「照会」「検索」
  • 「見て」「調べて」
特定のシナリオ
  • 最新のニュースや情報を取得する必要がある
  • 事実やデータを検証する必要がある
  • 技術や概念について調べる必要がある
  • ドキュメントやチュートリアルを探す必要がある
  • 異なる製品やソリューションを比較する必要がある
質問の例
  • 「最新の AI の動向を検索して」
  • 「最新の AI の動向を検索してください」
  • 「Python 3.13 の新機能を調べて」
  • 「自動運転技術の現状について調べて」
  • 「最新のサイバーセキュリティニュースを調べて」
  • 「マイクロサービスに関するチュートリアルをいくつか探して」

ツール

serper_search

用途： ウェブ検索を実行し、検索結果の一覧を返します。

パラメーター：

  • query（必須、string）：検索キーワード
  • num（任意、number）：返す検索結果の数。デフォルトは 5、最大 20
  • gl（任意、string）：国コード。デフォルトは cn
  • 推奨値： cn（中国）、us（米国）、uk（英国）、jp（日本）
  • hl（任意、string）：言語コード。デフォルトは zh-CN
  • 推奨値： zh-CN（簡体字中国語）、en（英語）、ja（日本語）

ベストプラクティス

1. 検索のコツ

具体的なキーワードを使い、範囲が広すぎる検索は避けます。

例：

  • ✅ 「Kimi AI モデル パラメーター 比較 2025」
  • ✅ 「Python 3.13 新機能 公式ドキュメント」
  • ❌ 「Python」（範囲が広すぎて、結果が多すぎます）
2. 期間を指定する

期間を明確にして、最新の情報を取得します。

例：

  • ✅ 「LangChain 最新ドキュメント 2025」
  • ✅ 「Python 3.13 リリース日」
  • ✅ 「AI 人工知能 ニュース 2025年2月」
3. 完全一致検索を使う

引用符で囲んで、フレーズを完全一致で検索します。

例：

  • ✅ ""machine learning" ベストプラクティス"
  • ✅ ""RAG アーキテクチャ" 実装"
4. 技術用語を追加する

検索の精度を高めます。

例：

  • ✅ 「Spring Cloud マイクロサービス 実装」
  • ✅ 「React Hooks useEffect 使い方」
5. 検索結果数を選択する

ニーズに応じて調整します。

  • 簡易検索： num=3（主要な情報をすばやく確認）
  • 詳細な調査： num=10（テーマを包括的に把握）
  • 総合的な調査： num=20（最大限の深さと広い範囲をカバー）
6. 複数回に分けて検索する

複雑なテーマは、複数回検索して掘り下げます。

シナリオ：マイクロサービスアーキテクチャの調査

// 第一轮：基础概念
serper_search({ query: "微服务架构 概念 优势", num: 5 })

// 第二轮：技术实现
serper_search({ query: "微服务 Spring Cloud Kubernetes", num: 8 })

// 第三轮：最佳实践
serper_search({ query: "微服务 最佳实践 常见问题", num: 10 })
7. 検索結果を扱う際の原則
  • 信頼できる情報源を優先： 公式ドキュメント、著名な技術ブログ、学術論文
  • クロスチェック： 複数の情報源を比較
  • 鮮度に注目： 新しい情報（直近 1〜2 年）を優先
  • すばやく選別： スニペットで関連性を判断

使用例

シナリオ 1：技術調査

ユーザーの質問： 「LangChain の主要な概念について調べて」

AI の動作：

// 搜索核心概念
serper_search({
  query: "LangChain 核心概念 官方文档 2025",
  num: 5
})

// 如果需要更多细节，继续搜索
serper_search({
  query: "LangChain Agents Chains 使用示例",
  num: 8
})

回答例：

根据搜索结果，LangChain 的核心概念包括：

1. **Chains（链）**：将多个组件串联成工作流
2. **Agents（智能体）**：自主决策的 AI 代理
3. **Tools（工具）**：LLM 可用的外部能力
4. **Memory（记忆）**：对话上下文管理

📖 详细文档：https://python.langchain.com/
シナリオ 2：ニュースの取得

ユーザーの質問： 「今日はどんな AI ニュースがありますか？」

AI の動作：

serper_search({
  query: "AI 人工智能 新闻 2025年2月6日",
  num: 10
})

回答例：

今日 AI 要闻：

1. **OpenAI 发布新模型**：能力提升 30%
2. **Google DeepMind**：突破蛋白质折叠新算法
3. **中国 AI 监管**：新规发布，促进行业健康发展

🔍 来源：各大科技媒体报道
シナリオ 3：製品の比較

ユーザーの質問： 「Kimi と ChatGPT はどちらが優れていますか？」

AI の動作：

// 搜索对比评测
serper_search({
  query: "Kimi ChatGPT 对比评测 2025",
  num: 5
})

回答例：

根据评测对比：

| 特性 | Kimi | ChatGPT |
|------|------|---------|
| 中文理解 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ |
| 工具调用 | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ |
| 响应速度 | 快 | 中等 |

💡 建议：中文任务用 Kimi，复杂工具调用用 ChatGPT
シナリオ 4：事実の検証

ユーザーの質問： 「Python 4 がリリースされると聞きましたが、本当ですか？」

AI の動作：

serper_search({
  query: "Python 4 发布计划 官方声明",
  num: 5
})

回答例：

经核实：

❌ Python 4 目前没有发布计划
✅ Python 3.13 是最新版本（2024年10月发布）
✅ Python 3.14 计划于 2025 年发布

📊 信息来源：Python 官方 GitHub、PSF 公告
シナリオ 5：すばやく検索

ユーザーの質問： 「React Hooks のチュートリアルを探してください」

AI の動作：

serper_search({
  query: "React Hooks 官方教程 中文",
  num: 3
})

回答例：

推荐教程：

1. 📚 **React 官方文档**（推荐）
   https://react.dev/learn

2. 🎓 **阮一峰 React Hooks 教程**
   https://www.ruanyifeng.com/blog/2019/09/react-hooks.html

3. 📺 **B站 React Hooks 视频教程**
   搜索"React Hooks 入门"

制限事項

  • 検索結果の情報源： Google。地域やパーソナライズの影響を受ける場合があります
  • アクセス制限： 一部のウェブサイトはブロックされているか、ログインが必要な場合があります
  • 検索結果数： 最大 20 件
  • レート制限： API の呼び出し頻度には制限があります。短時間に大量のリクエストを送信しないでください
  • 検索品質： キーワードの正確さやタイミングによって異なります

設定

環境変数の設定（推奨）

~/.openclaw/.env を編集します。

SERPER_API_KEY=your-api-key-here
プラグインの設定

openclaw.plugin.json の configSchema で apiKey を設定します。

API Key の取得

https://serper.dev/ にアクセスして登録し、API Key を取得します。

無料枠：月 2,500 回の呼び出し。

関連ツール

  • web_search： Brave Search API（代替手段）
  • web_fetch： 1 つのウェブページの詳細な内容を取得

バージョン履歴

  • v1.0 (2026-02-06)：初期バージョン。基本的な検索機能

    • Google Serper API に対応
    • 中国語と英語での多言語検索を提供
    • OpenClaw Skill システムと統合

  • v1.1 (2026-02-11)：description を最適化し、起動キーワードを追加

    • 起動キーワードを含むよう description を更新
    • skill の起動メカニズムを最適化

今後の予定

  • 📚 serper-scholar：学術検索への対応
  • 🔍 高度な絞り込み： 期間、ドメインによるフィルター
  • 📊 検索結果のキャッシュ： 繰り返しの検索パフォーマンスを向上
  • 🌍 対応地域の拡大： より多くの国と言語に対応

ヒント： 検索するときは、自然な言葉でニーズを表現してください。AI が適切な検索クエリを自動的に作成します。

コメント

Markdown 対応