가이드

Tavily

작성일 2026.03.20 | 수정일 2026.03.20

Tavily

Tavily API를 사용하여 웹 검색, 콘텐츠 추출, 크롤링, 사이트맵 탐색 기능을 수행하는 노드입니다. AI 에이전트를 위한 최적화된 검색 결과를 제공합니다.

주요 기능

Operation

설명

Search

웹 검색 수행 (AI 최적화 결과)

Extract

특정 URL의 콘텐츠 추출

Crawl

웹사이트 크롤링

Map

사이트맵 탐색 (링크 구조 분석)

설정 항목

Search (검색)

항목

타입

기본값

설명

Query

string

-

검색할 쿼리 텍스트 (필수)

검색 옵션

항목

타입

기본값

설명

Auto Parameters

boolean

false

자동 파라미터 최적화 (비용 2크레딧)

Search Depth

options

basic

검색 깊이 (Basic / Advanced)

Topic

options

general

주제 분류 (General / News / Finance)

Time Range

options

없음

기간 필터 (Day / Week / Month / Year)

Start Date

string

-

시작 날짜 (YYYY-MM-DD)

End Date

string

-

종료 날짜 (YYYY-MM-DD)

Max Results

number

5

최대 결과 수 (0~20)

Chunks Per Source

number

3

소스당 청크 수 (Advanced 모드 전용, 1~10)

Include Images

boolean

false

이미지 포함 여부

Include Image Descriptions

boolean

false

이미지 설명 포함 여부

Include Answer

options

none

자동 답변 생성 (None / Basic / Advanced)

Include Raw Content

options

none

원문 콘텐츠 포함 (None / Markdown / Text)

Extract (추출)

항목

타입

설명

URL

string

콘텐츠를 추출할 URL (필수)

Crawl (크롤링)

항목

타입

설명

URL

string

크롤 시작 URL (필수)

Query

string

콘텐츠 필터/검색용 쿼리 (선택)

Map (사이트맵)

항목

타입

기본값

설명

URL

string

-

맵핑 시작 URL (필수)

Map 옵션

항목

타입

기본값

설명

Max Depth

number

1

최대 탐색 깊이 (0~10)

Max Breadth

number

20

레벨당 최대 탐색 너비 (1~200)

Limit

number

50

총 링크 제한 (1~5000)

Instructions

string

-

탐색 지시사항

Select Paths

string

-

포함할 경로 패턴 (정규식, 쉼표/줄바꿈 구분)

Select Domains

string

-

포함할 도메인 패턴

Exclude Paths

string

-

제외할 경로 패턴

Exclude Domains

string

-

제외할 도메인 패턴

Allow External

boolean

true

외부 도메인 허용 여부

Timeout

number

60

타임아웃 (초, 10~300)

인증 정보

Tavily API 키가 필요합니다. 자세한 설정 방법은 Tavily API 인증 설정 가이드를 참고하세요.

사용 예시

AI 기반 리서치 워크플로우

  1. Tavily 노드의 Search 기능으로 특정 주제를 검색합니다.

  2. Include Answer를 Advanced로 설정하면 검색 결과 기반 요약 답변도 함께 받습니다.

  3. AI 노드에서 검색 결과를 활용해 블로그 글이나 리포트를 작성합니다.

경쟁사 웹사이트 분석

  1. Tavily 노드의 Map 기능으로 대상 사이트의 링크 구조를 파악합니다.

  2. Extract 기능으로 주요 페이지의 콘텐츠를 추출합니다.

  3. AI 노드에서 추출된 콘텐츠를 분석합니다.

뉴스 모니터링

  1. Search에서 Topic을 News로, Time Range를 Day로 설정합니다.

  2. 특정 키워드의 최신 뉴스를 검색합니다.

  3. Solapi 노드로 요약된 뉴스를 알림으로 발송합니다.

참고 사항

  • AI 도구(Tool)로 사용 가능합니다 (usableAsTool: true).

  • Search의 basic 모드는 1크레딧, advanced 모드는 2크레딧을 소비합니다.

  • Auto Parameters를 활성화하면 쿼리에 맞춰 파라미터가 자동 최적화되지만, 추가 크레딧이 소비됩니다.

  • Include Raw Content를 markdown으로 설정하면 검색 결과의 전체 본문을 마크다운 형식으로 받을 수 있습니다.

  • Tavily 공식 문서에서 API 사양과 크레딧 정책을 확인할 수 있습니다.