个人网站搜索 (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}用于获取新鲜内容