Google Search

🚀 谷歌検索ツール使用ガイド

このツールはGoogle検索を行うためのツールで、開発、テスト、運用などの一連の流れをサポートしています。

🚀 クイックスタート

📦 インストール

プロジェクトのルートディレクトリで以下のコマンドを実行してください。

# 依存関係のインストール
pnpm install

# Playwrightブラウザのインストール
pnpm run postinstall

# TypeScriptコードのコンパイル
pnpm build

# コンパイル出力のクリーンアップ
pnpm clean

💻 使用例

基本的な使用法

すべてのコマンドはプロジェクトのルートディレクトリで実行できます。

# 開発モードで実行
pnpm dev "検索キーワード"

# デバッグモードで実行（ブラウザ画面を表示）
pnpm debug "検索キーワード"

# コンパイル後のコードを実行
pnpm start "検索キーワード"

# 検索機能のテスト
pnpm test

高度な使用法

# MCPサーバーを開発モードで実行
pnpm mcp

# コンパイル後のMCPサーバーを実行
pnpm mcp:build

🔧 技術詳細

このツールには強力なエラー処理メカニズムが組み込まれています。

• ブラウザの起動に失敗した場合、分かりやすいエラーメッセージが表示されます。
• ネットワーク接続に問題がある場合、自動的にエラー状態が返されます。
• 検索結果の解析に失敗した場合、詳細なログが記録されます。
• タイムアウトの場合は、エレガントに終了し、有用な情報が提供されます。

📚 ドキュメント

⚠️ 重要提示

• このツールは学習および研究目的のみで使用してください。
• Googleのサービス条項およびポリシーを遵守してください。
• 頻繁にリクエストを送信しないでください。そうしないと、Googleによってブロックされる可能性があります。
• 一部の地域では、Googleにアクセスするためにプロキシを使用する必要がある場合があります。
• Playwrightは自動的にブラウザをダウンロードします。初回使用時には帯域幅を消費する場合があります。

💡 使用建议

状態ファイルに関する注意事項

• 状態ファイルにはブラウザのCookiesとストレージデータが含まれています。適切に保管してください。
• 状態ファイルを使用することで、Googleの反ロボット検出を回避し、検索成功率を向上させることができます。

MCPサーバーに関する注意事項

• MCPサーバーはNode.js v16以上が必要です。
• Claudeデスクトップ版を構成する際には、最新バージョンを使用してください。
• Claude Desktopを構成する際には、MCPサービスファイルの絶対パスを使用してください。

Windows固有の注意事項

• Windows環境では、Playwrightブラウザをインストールするために管理者権限が必要な場合があります。
• 権限の問題が発生した場合は、管理者としてコマンドプロンプトまたはPowerShellを実行してみてください。
• WindowsファイアウォールがPlaywrightブラウザのネットワーク接続をブロックする場合があります。表示されたらアクセスを許可してください。
• ブラウザの状態ファイルはユーザーのホームディレクトリに.google-search-browser-state.jsonという名前で保存されます。
• ログファイルはシステムの一時ディレクトリ内のgoogle-search-logsフォルダに保存されます。

📄 ライセンス

このプロジェクトは、有料の検索エンジン結果APIサービス（SerpAPIなど）と比較して、以下の利点があります。

• 完全無料：API呼び出し料金がかかりません。
• ローカル実行：すべての検索はローカルで実行され、サードパーティのサービスに依存しません。
• プライバシー保護：検索クエリはサードパーティに記録されません。
• カスタマイズ性が高い：完全にオープンソースであり、必要に応じて変更および拡張できます。
• 使用制限がない：API呼び出し回数や頻度の制限がありません。
• MCP統合：Claudeなどのツールとの統合をサポートしています。