MCP Google Cse

🚀 Googleカスタム検索API

Googleカスタム検索JSON APIを使用すると、開発者はHTTPプロトコルを介してGoogle検索エンジンにクエリを送信し、構造化された検索結果データを取得できます。このガイドでは、このAPIの使用方法を詳しく説明します。

✨ 主な機能

1. JSONレスポンス形式のサポート：APIは標準のJSON形式のデータを返すため、プログラムでの処理が容易です。
2. 豊富なパラメータオプション：検索動作や結果の表示方法を制御するための複数のオプションパラメータを提供しています。
3. 開発者にやさしい設計：シンプルなHTTPリクエストで高品質の検索結果を取得できます。

🚀 クイックスタート

📦 インストール

1. APIキーの取得

まず、Google Cloud Consoleでプロジェクトを作成し、Custom Search JSON APIを有効にしてから、APIキーを生成します。このキーは認証に使用されるため、安全に保管してください。

2. クエリリクエストの構築

標準のHTTP GETリクエストを次のように構築します。

https://www.googleapis.com/customsearch/v1?q={検索キーワード}&key={APIキー}

ここで：

• q：必須パラメータで、検索する内容を表します。
• key：必須パラメータで、認証に使用されます。

3. リクエストの例

「人工知能」を検索する場合、リクエストURLは次のようになります。

https://www.googleapis.com/customsearch/v1?q=人工知能&key=あなたのAPIキー

4. 返却結果の構造

レスポンスのJSONデータは次のような形式になります。

{
  "items": [
    {
      "title": "タイトル", // 記事のタイトル
      "link": "リンク先URL", // URLリンク
      "snippet": "概要" // 概要説明
    },
    ...
  ]
}

5. よく使用するパラメータの説明

• cx：ウェブサイト検索のコンテキストIDで、特定のGoogle Custom Searchエンジンを指定するために使用します。
• num：1ページに返す結果数で、デフォルトは10です。
• start：結果のオフセットで、ページング検索に使用します。
• gl：国コードで、検索対象地域を制限します。
• hl：言語コードで、返却結果の言語を限定します。

💻 使用例

基本的な使用法

import requests

def custom_search(query, api_key):
    url = "https://www.googleapis.com/customsearch/v1"
    params = {
        'q': query,
        'key': api_key
    }
    response = requests.get(url, params=params)
    return response.json()

# 使用例
result = custom_search("人工知能", "あなたのAPIキー")
print(result)

📚 ドキュメント

注意事項

⚠️ 重要提示

GoogleはAPIの呼び出し回数に制限を設けており、具体的な制限は使用するプロジェクトのレベルによって異なります。

💡 使用建议

コードに例外捕捉機構を追加し、プログラムの安定性を確保することをおすすめします。また、このAPIを使用する場合は、Googleの利用規約を遵守する必要があります。

参考資料

詳細な情報については、公式ドキュメントを参照してください。 Custom Search JSON API Documentation