ultimate-web-search-skill은(는) 무엇을 하나요?
AI 코딩 에이전트를 위한 LLM 중립적인 웹 검색 스킬입니다. 12개의 검색 제공자를 하나의 CLI로 통합한, 크로스 플랫폼이고 표준 라이브러리만 사용하는 Python 기반의 순차적 폴백 체인입니다.
개요
이 스킬은 AI 에이전트가 웹에서 정보를 검색할 수 있는 강력하고 안정적인 방법을 제공합니다. 핵심 특징은 다음과 같습니다:
- 12개의 검색 제공자: Google, Bing, Brave, DuckDuckGo, SerpAPI, Tavily, SearXNG 등
- 순차적 폴백 체인: 기본 제공자가 실패하면 자동으로 다음 제공자로 전환
- 표준 라이브러리만 사용: 추가 종속성 없이 Python 표준 라이브러리로만 구성
- 크로스 플랫폼: 모든 주요 운영 체제(macOS, Linux, Windows)에서 실행 가능
- LLM 중립적: 특정 AI 모델에 종속되지 않음
설치
# 전역 설치
git clone https://github.com/code-yeongyu/ultimate-web-search-skill.git
cd ultimate-web-search-skill
# 또는 pip 패키지로 설치
pip install ultimate-web-search-skill
사용법
기본 검색
# 간단한 검색
ultimate-search "Python 비동기 프로그래밍 가이드"
# JSON 형식으로 결과 출력
ultimate-search --format json "최신 AI 연구 동향"
에이전트 통합
AI 에이전트와 함께 사용하려면 CLI 명령어를 그대로 호출하면 됩니다:
<skill_call>ultimate-search "검색어"</skill_call>
환경 변수
검증된 제공자를 사용하려면 다음 환경 변수를 설정하세요:
| 제공자 | 환경 변수 | 필수 여부 |
|---|---|---|
GOOGLE_API_KEY | 선택 | |
| Bing | BING_API_KEY | 선택 |
| Brave | BRAVE_API_KEY | 선택 |
| SerpAPI | SERPAPI_API_KEY | 선택 |
| Tavily | TAVILY_API_KEY | 선택 |
API 키 없이도 DuckDuckGo, Wikipedia 등 일부 무료 제공자를 사용할 수 있습니다.
설정
폴백 체인의 검색 제공자 순서를 사용자 정의하려면 config.yaml 파일을 생성하세요:
providers:
- tavily
- serpapi
- duckduckgo
- wikipedia
fallback:
enabled: true
max_retries: 3
지원 제공자 목록
- Google Custom Search
- Bing Web Search
- Brave Search
- DuckDuckGo
- SerpAPI
- Tavily
- SearXNG
- Wikipedia
- Yahoo
- Yandex
- Mojeek
- Qwant
라이선스
MIT 라이선스
기여
버그 리포트, 기능 제안, 풀 리퀘스트를 환영합니다.