個人網站搜尋 (Exa Python SDK)
必要條件
uv pip install exa-py
設定 EXA_API_KEY 環境變數。取得金鑰請至 https://dashboard.exa.ai/api-keys
方法
使用 ctx_execute(language: "python", code: "...") 來呼叫 Exa。切勿在主脈絡中直接執行 Exa 搜尋——一律產生只回傳濃縮輸出的 Task Agent。
支援的參數
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}(用於取得即時內容)