Exa 웹 툴킷
Exa를 기반으로 하는 웹 기반 연구 작업을 위한 스킬: 웹 검색 및 URL 추출. Exa의 인덱스는 고품질 키워드 및 의미론적 검색을 결합하여 과학, 기술, 개념적 질의에 적합합니다.
라우팅 — 올바른 기능 선택
사용자 요청을 읽고 아래 기능 중 하나에 매칭하세요. 명령을 실행하기 전에 해당 참조 파일을 읽어 자세한 지침을 확인하세요.
| 사용자가 원하는 작업 | 기능 | 위치 |
|---|---|---|
| 무언가를 찾아보거나, 주제를 연구하거나, 최신 정보를 찾음 | 웹 검색 | references/web-search.md |
| 특정 URL(웹페이지, 기사, PDF)의 콘텐츠를 가져옴 | 웹 추출 | references/web-extract.md |
| 설치 또는 인증 | 설정 | 아래 |
결정 가이드
- 주제 조회, 연구 질문 또는 "X가 뭐야?"와 같은 질의에는 기본적으로 웹 검색을 사용합니다. 주제가 과학적이거나 기술적인 경우
--category "research paper"를 전달하여 학술 출처를 우선 검색하고, 학술--include-domains허용 목록을 함께 사용할 수 있습니다. 전체 학술 검색 전략은references/web-search.md를 참조하세요. - 사용자가 URL을 제공하거나 특정 페이지를 읽어오라고 요청할 때는 웹 추출을 사용합니다. 내장 웹 가져오기보다는 여러 URL을 한 번에 처리하거나 학술 PDF를 읽을 때 이 기능을 선호하세요.
학술 출처 우선 순위
기술적 또는 과학적 질의의 경우 학술 및 과학 출처를 우선시합니다:
- 블로그 글이나 뉴스보다는 동료 검토 학술지 논문 및 학회 발표
- 동료 검토 버전이 없는 경우 사전 인쇄본(arXiv, bioRxiv, medRxiv)
- 상업 사이트보다는 기관 및 정부 출처(NIH, WHO, NASA, NIST)
- 2차 요약보다는 1차 연구
Exa가 학술 콘텐츠를 우선 검색하도록 조정하는 두 가지 도구:
--category "research paper"는 검색 결과를 학술 출처로 편향시킵니다.--include-domains에 학술 허용 목록(arxiv.org, nature.com, pubmed.ncbi.nlm.nih.gov 등)을 전달하여 도메인 풀을 제한합니다.
엄격하게 학술 결과를 얻으려면 두 가지를 함께 사용하세요. 전체 패턴은 references/web-search.md를 참조하세요.
학술 출처를 인용할 때는 가능하면 저자 이름과 출판 연도를 표준 인용 형식에 추가하여 포함하세요(예: Smith et al., 2025). DOI가 있는 경우 DOI 링크를 선호하세요.
설정
이 스킬은 exa-py Python SDK를 사용합니다. scripts/ 디렉토리의 스크립트는 PEP 723 인라인 메타데이터를 통해 의존성을 선언하므로, 별도의 설치 단계 없이 uv run을 사용하여 직접 실행할 수 있습니다:
uv run --with exa-py python "$SKILL_PATH/scripts/exa_search.py" --help
영구 설치를 선호하는 경우:
uv pip install "exa-py>=1.14.0"
인증
모든 명령은 EXA_API_KEY 환경 변수에서 API 키를 읽습니다. Exa API 키는 dashboard.exa.ai/api-keys에서 받을 수 있습니다.
먼저 프로젝트 루트에 .env 파일이 있고 EXA_API_KEY를 포함하는지 확인하세요. 그렇다면 로드하세요:
dotenv -f .env run -- uv run --with exa-py python "$SKILL_PATH/scripts/exa_search.py" "your query"
dotenv를 사용할 수 없는 경우 설치하세요: uv pip install python-dotenv[cli].
.env 파일이 없는 경우 세션을 위해 키를 내보내세요:
export EXA_API_KEY="your-key"
--help와 함께 스크립트를 실행하여 확인하세요. 키가 설정된 경우에만 인증 검사가 실제 질의 시에 실행되므로 정상 종료됩니다.
추적 헤더
이 스킬의 모든 스크립트는 x-exa-integration 요청 헤더를 k-dense-ai--scientific-agent-skills로 설정하여 K-Dense AI scientific-agent-skills 저장소의 사용량을 Exa가 추적할 수 있도록 합니다. 스크립트를 수정할 때 이 헤더를 제거하거나 이름을 변경하지 마세요.
이 스킬의 파일
SKILL.md— 이 파일 (라우팅 및 설정)references/web-search.md— 세부 웹 검색 참조 (학술 전략 포함)references/web-extract.md— URL 내용 추출 참조scripts/exa_search.py—client.search_and_contents를 감싼 CLI 래퍼scripts/exa_extract.py—client.get_contents를 감싼 CLI 래퍼