Websearch (Google)

🚀 ウェブ検索

WebSearchは、ウェブ情報検索用のツールです。MCPプロトコルを通じてモデルとのやり取りをサポートしています。構造化された検索結果を解析し、様々なシナリオのニーズに応えるための複数のカスタマイズオプションを提供します。

🚀 クイックスタート

WebSearchはMCPプロトコルを通じてモデルとやり取りできます。以下は簡単な使用例です。

import { createMCPClient } from '@modelcontextprotocol/sdk';

// MCP クライアントを作成
const client = createMCPClient({
  transport: { type: 'subprocess', command: 'npx websearch-mcp' }
});

// ウェブ検索を実行
const response = await client.request({
  method: 'call_tool',
  params: {
    name: 'web_search',
    arguments: {
      query: 'machine learning trends',
      numResults: 5,
      language: 'en'
    }
  }
});

console.log(response.result);

✨ 主な機能

核心機能

• ウェブ検索: 複数の検索エンジンを通じた情報検索をサポートします。
• 結果解析: タイトル、要約、リンクなどの構造化された検索結果を解析できます。
• 多言語対応: 複数の言語の検索結果を返すことができます。

カスタマイズオプション

• 結果数: 返される結果の数を指定でき、デフォルトは5です。
• 言語フィルター: 検索結果の言語を指定できます。
• ドメイン除外/包含: 特定のドメインの結果を選択的に除外または包含できます。
• キーワードフィルター: 特定のキーワードやフレーズを除外することができます。

応答例

以下は典型的な検索応答の例です。

{
  "query": "machine learning trends",
  "results": [
    {
      "title": "2025年人工智能趋势预测",
      "snippet": "2025年的人工智能发展趋势包括多模态AI、生成式模型和量子人工智能在企业中的应用...",
      "url": "https://example.com/ml-trends-2025",
      "siteName": "AI研究今日",
      "byline": "简·史密斯博士"
    },
    {
      "title": "2020至2025年人工智能演变历程",
      "snippet": "过去五年中，人工智能已经从监督学习方法发展到更复杂的自监督和强化学习范式...",
      "url": "https://example.com/ml-evolution",
      "siteName": "科技见解",
      "byline": "约翰·多伊"
    }
  ]
}

📦 インストール

依存関係としてインストール

npm install websearch-mcp-sdk

リポジトリをクローン

git clone https://github.com/yourusername/websearch.git
cd websearch
npm install

🔧 技術詳細

実行環境要件

• オペレーティングシステム: Linux、Windows、macOSをサポートします。
• Node.jsバージョン: Node.js 14以上が必要です。

プロジェクト構造

websearch/
├── .gitignore
├── .npmignore
├── package.json
├── src/
│   ├── index.ts
│   └── types/
└── dist/
    └── main.js

開発手順

1. リポジトリをローカルにクローンします。
2. プロジェクトの依存関係をインストールします: npm install
3. 開発サーバーを起動します: npm run dev

📚 ドキュメント

よくある問題

• APIにアクセスできない: WebSearchサービスが実行中であり、API_URLが正しく設定されていることを確認してください。
• 検索結果が利用できない: WebSearchサービスのログを確認してエラーを排除してください。

  docker-compose logs crawler
  

• FlareSolverrの問題: Cloudflareの保護に遭遇した場合は、FlareSolverrが正常に動作していることを確認してください。

  docker-compose logs flaresolverr
  

その他のリソース

• MCPプロトコルドキュメント
• TypeScript型定義

📄 ライセンス

このプロジェクトはISCライセンスの下で提供されています。