MCP Google Cse

🚀 Google自定義搜索API

Google自定義搜索JSON API允許開發者通過HTTP協議向Google搜索引擎提交查詢請求，並獲取結構化的搜索結果數據。本指南將詳細介紹如何使用該API。

✨ 主要特性

• 支持JSON響應格式：API返回標準的JSON格式數據，便於程序處理。
• 豐富參數選項：提供多個可選參數來控制搜索行為和結果展示方式。
• 開發者友好設計：通過簡單的HTTP請求即可獲取高質量的搜索結果。

📦 安裝指南

此API無需安裝，僅需獲取API密鑰即可使用。

💻 使用示例

基礎用法

以下是使用該API的基本步驟：

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鏈接
      "snippet": "摘要" // 摘要描述
    },
    ...
  ]
}

5. 常用參數說明

• cx：網站搜索上下文ID，用於指定特定的Google Custom Search引擎。
• num：每頁返回的結果數，默認為10。
• start：結果偏移量，用於分頁查詢。
• gl：國家代碼，限制搜索區域。
• hl：語言代碼，限定返回結果的語言。

高級用法

以下是一個簡單的Python調用示例：

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)

📚 詳細文檔

如需瞭解更多詳細信息，請參閱官方文檔： Custom Search JSON API Documentation

🔧 技術細節

速率限制

Google會對API調用次數進行限制，具體取決於使用的項目級別。

錯誤處理

建議在代碼中添加異常捕捉機制，確保程序健壯性。

遵守條款

使用該API必須遵守Google的Terms of Service。

⚠️ 重要提示

API密鑰用於身份驗證，請妥善保管。

💡 使用建議

建議在代碼中添加異常捕捉機制，確保程序健壯性。同時，注意Google對API調用次數的限制。