websearch

name	websearch
display_name	Tavily 검색
description	Search the internet for up-to-date information and fetch web page content via Tavily. Use for: 검색해줘, 찾아줘, 최신 정보, 인터넷 검색, 뉴스, 요즘, web search, latest news, current information
version	1.0.0
emoji	🔍
category	search
enabled_by_default	true
requires_api_key	true
platforms	web, telegram, api
api_key_provider	tavily
api_key_label	Tavily API Key
uses_provider	false
allowed-tools	["Bash","exec"]
triggers	{"keywords":["검색해줘","찾아줘","최신 정보","인터넷에서","웹에서","뉴스","요즘","지금","알려줘","search","look up","find online","latest","current news","web search","internet"],"when_to_use":["User asks for up-to-date information that may have changed recently","User asks to search the internet for news or current events","User asks to fetch or read the content of a specific web page URL","User says \"검색해줘\", \"찾아줘\", or \"최신 정보 알려줘\""],"not_for":["Searching within knowledge base documents (use documents skill)","Korea-specific searches where Naver would be better (use naver-search skill)"]}

Tavily 검색 (websearch)

Always pass --user-id {user_id}.

API Key

TAVILY_API_KEY is automatically injected as an environment variable when configured in the web UI. Always attempt to run the script — it will report if credentials are missing.

Commands

웹 검색

python3 websearch/scripts/websearch.py \
  --user-id {user_id} search \
  --query "{검색 키워드나 질문}" \
  --max-results 5

고급 검색 (Tavily 전용)

python3 websearch/scripts/websearch.py \
  --user-id {user_id} search \
  --query "{검색 쿼리}" \
  --search-depth advanced \
  --topic news \
  --time-range week \
  --include-answer \
  --max-results 5

URL 컨텐츠 추출

python3 websearch/scripts/websearch.py \
  --user-id {user_id} fetch \
  --url "{https://...}" \
  --max-length 8000

Options

search 공통

• --max-results N: 결과 개수 (기본: 5, 최대: 10)

search Tavily 전용 (키 설정 시에만 유효)

• --search-depth basic|advanced: 검색 깊이 (기본: basic)
  • basic: 빠른 일반 검색
  • advanced: 심층 연구 수준, 가장 관련성 높은 결과
• --topic general|news|finance: 검색 주제 (기본: general)
  • news: 최신 뉴스·실시간 업데이트
  • finance: 주식·금융 정보
• --time-range day|week|month|year: 기간 필터
• --include-answer: AI 생성 요약 답변 포함
• --include-domains domain1,domain2: 특정 도메인으로 제한
• --exclude-domains domain1,domain2: 특정 도메인 제외

fetch

• --max-length N: 최대 텍스트 길이 (기본: 8000, 최대: 50000)

Output

search: 결과 목록 (제목, URL, 요약 포함) fetch: 웹페이지 텍스트 내용 (HTML → 가독성 있는 텍스트 변환)

When to use

User intent	Command	Options
Latest news or current events	search	--topic news --time-range day
Fact-checking or general information	search	(default)
Deep research with comprehensive results	search	--search-depth advanced --include-answer
Summarize or extract content from a specific URL	fetch	—
Get full content of a search result	fetch	use URL from search result

Examples

User: "오늘 뉴스 알려줘"

python3 websearch/scripts/websearch.py \
  --user-id abc123 search \
  --query "오늘 주요 뉴스" \
  --topic news \
  --time-range day \
  --max-results 5

User: "비트코인 현재 가격"

python3 websearch/scripts/websearch.py \
  --user-id abc123 search \
  --query "bitcoin price today" \
  --topic finance \
  --max-results 3

User: "이 기사 내용 요약해줘: https://..."

python3 websearch/scripts/websearch.py \
  --user-id abc123 fetch \
  --url "https://..." \
  --max-length 8000

Notes

• Tavily 키 없을 경우 기본 DuckDuckGo 검색으로 fallback (검색 품질 제한)
• --search-depth advanced와 고급 옵션은 Tavily 키 설정 시에만 유효
• PDF·이미지·바이너리 URL은 fetch 미지원