Communitygithub.com

iamvtor/opencode-setup

Exa 고급 검색을 사용하여 개인 웹사이트와 블로그를 검색합니다. 개인 관점, 포트폴리오 및 개인 블로그를 찾기 위한 전체 필터를 지원합니다. 개인 사이트, 블로그 게시물 또는 포트폴리오 웹사이트를 검색할 때 사용하세요.

opencode-setup란 무엇인가요?

이 스킬은 Exa Python SDK를 활용하여 개인 웹사이트와 블로그를 전문적으로 검색하는 AI 에이전트 기능을 제공합니다. Exa의 'personal site' 카테고리를 사용하여 독립 블로거, 개발자 포트폴리오, 개인 관점의 콘텐츠를 효과적으로 찾을 수 있습니다. Cursor, Claude Code, Codex 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있으며, `ctx_execute(language: "python", code: "...")`를 통해 Python 코드로 Exa 검색을 실행합니다. 주요 기능으로는 검색 쿼리, 결과 수, 검색 유형(auto, fast, instant, deep 등), 도메인 포함/제외, 발행일 및 크롤링일 필터, 텍스트 내용 하이라이트, 요약 생성, 사용자 위치 기반 검색, 추가 쿼리 등 모든 Exa 매개변수를 완벽하게 지원합니다. 또한 중간 콘텐츠 수집기(예: medium.com)를 제외하고 최신 콘텐츠를 우선시하여 보다 진정성 있는 개인 사이트 결과를 제공합니다. 이 스킬은 메인 컨텍스트에서 직접 실행하지 않고 항상 Task 에이전트를 생성하여 결과를 요약된 형태로 반환하도록 설계되었습니다.

지원 대상~Claude Code~Codex CLI~Cursor✓OpenCode
npx skills add https://github.com/iamvtor/opencode-setup/tree/HEAD/skills/exa-personal-site-search

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

개인 사이트 검색 (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_results
  • type ("auto", "fast", "instant", "deep-lite", "deep", "deep-reasoning")
  • include_domains / exclude_domains
  • start_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_location
  • moderation
  • additional_queries
  • contents={"livecrawl_timeout": 10000, "max_age_hours": 0} (신선한 콘텐츠용)

관련 스킬