개인 사이트 검색 (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 에이전트를 생성하여 요약된 출력만 반환하도록 합니다.
지원되는 매개변수
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}(신선한 콘텐츠용)