Web検索機能 - キーワードから検索結果を取得

目的

指定したキーワードでウェブ検索を行い、上位 N 件の結果を取得します。

前提条件

• インターネット接続があること
• 使用する検索APIのキーとエンドポイントが設定されていること

使い方

1. keyword に検索したいキーワードを入力します。
2. 任意で max_results に取得件数を指定します（デフォルト: 5）。

手順

1. 検索APIへリクエストを送信する。
2. 取得したJSONレスポンスからタイトル・URL・スニペットを抽出する。
3. 結果をリスト形式で返す。

期待出力

[
  {
    "title": "ページタイトル",
    "url": "https://example.com",
    "snippet": "ページの抜粋..."
  },
  ...
]

import os
import requests

def web_search(keyword, max_results=5):
    api_key = os.getenv("SEARCH_API_KEY")
    endpoint = "https://api.example.com/search"
    params = {
        "q": keyword,
        "count": max_results
    }
    headers = {
        "Ocp-Apim-Subscription-Key": api_key
    }
    response = requests.get(endpoint, params=params, headers=headers)
    response.raise_for_status()
    data = response.json()
    results = []
    for item in data.get("value", []):
        results.append({
            "title": item.get("name"),
            "url": item.get("url"),
            "snippet": item.get("snippet")
        })
    return results

# 例: print(web_search("OpenAI"))