web-search-plus은(는) 무엇을 하나요?
통합 다중 공급자 웹 검색 및 URL 추출 스킬로, Serper, Brave, Tavily, Querit, Linkup, Exa, Firecrawl, Perplexity, You.com, SearXNG, SerpBase 전반에 걸쳐 지능형 자동 라우팅을 제공합니다.
개요
이 스킬은 여러 웹 검색 제공자를 관리하는 복잡성을 추상화하여, AI 에이전트와 개발자에게 단일하고 일관된 인터페이스를 제공합니다. 지원되는 제공자 목록:
| 제공자 | 유형 | 주요 기능 |
|---|---|---|
| Serper | Google 검색 API | 빠르고 안정적인 웹 검색 |
| Brave Search | 독립 검색 엔진 | 개인 정보 보호 중심 검색 |
| Tavily | AI 최적화 검색 | 구조화된 AI 친화적 결과 |
| Exa (구 Metaphor) | 신경 검색 엔진 | 의미론적 콘텐츠 검색 |
| Firecrawl | 웹 스크래핑 API | 전체 페이지 마크다운 추출 |
| Perplexity | AI 검색 엔진 | 상세한 응답이 포함된 검색 |
| You.com | AI 검색 엔진 | 검색 + 생성형 AI |
| SearXNG | 자체 호스팅 메타 검색 | 개인 정보 보호 중심 집계 |
| SerpBase | Google 검색 API | 저비용 Google 검색 결과 |
빠른 시작
- 선호하는 제공자에 대한 환경 변수를 설정합니다:
export SERPER_API_KEY="your-serper-api-key"
export TAVILY_API_KEY="your-tavily-api-key"
export BRAVE_API_KEY="your-brave-api-key"
# (기타 제공자 키도 유사하게 설정)
-
지능형 라우팅이 기본적으로 활성화되어 있습니다. 특정 제공자를 강제로 사용하려면 프롬프트에
provider="tavily"와 같은 매개변수를 전달합니다. -
스킬 사용법:
- 쿼리: "최신 AI 연구 논문을 검색해줘"
- 제공자: tavily
- 추출: true
구성
환경 변수
| 변수 | 설명 | 필수 |
|---|---|---|
SERPER_API_KEY | Serper API 키 | 아니요 |
TAVILY_API_KEY | Tavily API 키 | 아니요 |
BRAVE_API_KEY | Brave Search API 키 | 아니요 |
EXA_API_KEY | Exa API 키 | 아니요 |
FIRECRAWL_API_KEY | Firecrawl API 키 | 아니요 |
PERPLEXITY_API_KEY | Perplexity API 키 | 아니요 |
YOU_API_KEY | You.com API 키 | 아니요 |
SEARXNG_BASE_URL | SearXNG 인스턴스 기본 URL | 아니요 |
SERP_BASE_API_KEY | SerpBase API 키 | 아니요 |
참고: 적어도 하나의 API 키가 설정되어 있어야 스킬이 작동합니다. 여러 키를 설정하면 지능형 라우팅이 최상의 결과를 제공하는 제공자를 동적으로 선택합니다.
스킬 프롬프트 예시
기본 검색 (지능형 라우팅 사용):
사용자: 오늘의 기술 뉴스를 검색해줘
특정 제공자 사용:
사용자: "AI 에이전트에 대한 최신 기사"를 검색해줘, 제공자는 brave 사용
URL 콘텐츠 추출:
사용자: https://example.com/article의 콘텐츠를 추출해줘, 제공자는 firecrawl 사용
고급 검색 + 추출:
사용자: 최신 클라우드 컴퓨팅 동향을 검색하고, 결과에서 추출 플래그를 활성화해줘
지능형 라우팅 작동 방식
- 공급자 가용성 확인: 스킬이 시작되면 설정된 환경 변수를 기반으로 사용 가능한 제공자를 확인합니다.
- 쿼리 분석: 지능형 라우터가 쿼리 유형(예: 일반 검색, 뉴스 검색, URL 추출)을 결정합니다.
- 최적 제공자 선택: 각 제공자의 강점을 기준으로 순위가 매겨집니다:
- Tavily: AI 관련 쿼리 및 구조화된 결과에 우선 적용
- Serper: 일반 웹 검색에 우선 적용
- Brave: 빠른 뉴스 검색에 우선 적용
- Firecrawl: URL 콘텐츠 추출에 주로 사용됨
- Exa: 의미론적 검색에 우선 적용
- 폴백 메커니즘: 기본 제공자가 실패하면 사용 가능한 다음 제공자로 자동 폴백합니다.
API 참조
스킬은 다음 작업을 지원합니다:
search(query, provider?, extract?): 웹 검색 수행. 선택적provider매개변수로 특정 제공자를 강제하거나, 생략 시 지능형 라우팅 사용.extract를 true로 설정하면 결과에서 URL 콘텐츠를 자동으로 추출합니다.extract(url, provider?): 지정된 URL에서 콘텐츠 추출. 선택적으로 사용할 제공자 지정 가능.
각 작업에 대한 자세한 내용은 각 제공자의 API 문서를 참조하세요.
문제 해결
- "사용 가능한 제공자가 없습니다" 오류: 유효한 API 키가 하나 이상 설정되어 있는지 확인하세요.
- 속도 제한: API 속도 제한을 방지하려면 제공자별 문서를 확인하세요.
- 결과 품질: 기본 제공자가 만족스럽지 않은 경우
provider매개변수를 사용하여 다른 제공자를 명시적으로 시도하세요.