個人サイト検索(Exa Python SDK)
前提条件
uv pip install exa-py
EXA_API_KEY 環境変数を設定します。APIキーは https://dashboard.exa.ai/api-keys から取得できます。
アプローチ
ctx_execute(language: "python", code: "...") を使用して Exa を呼び出します。Exa 検索をメインコンテキストで実行せず、常にタスクエージェントを生成し、抽出した出力のみを返すようにします。
サポートされるパラメータ
personal site カテゴリは、利用可能なすべてのパラメータをサポートします:
from exa_py import Exa
import os, json
exa = Exa(os.environ["EXA_API_KEY"])
response = exa.search(
"building side projects indie hacking journey 2025",
num_results=15,
category="personal site",
type="auto",
exclude_domains=["medium.com"], # アグリゲーターを除外し、独立したブログを取得
contents={"highlights": True}
)
results = []
for r in response.results:
results.append({
"title": r.title,
"url": r.url,
"highlights": getattr(r, 'highlights', [])
})
print(json.dumps(results, indent=2))
完全なパラメータ一覧
query(必須)num_resultstype("auto", "fast", "instant", "deep-lite", "deep", "deep-reasoning")include_domains/exclude_domainsstart_published_date/end_published_date(ISO 8601)start_crawl_date/end_crawl_date(ISO 8601)include_text/exclude_text(単一要素の配列のみ;複数要素の場合は 400 エラー)contents={"text": {"max_characters": N}}contents={"highlights": True}/contents={"highlights": {"query": "..."}}contents={"summary": True}/contents={"summary": {"query": "..."}}user_locationmoderationadditional_queriescontents={"livecrawl_timeout": 10000, "max_age_hours": 0}(最新コンテンツ用)