tavily-best-practices

โดย tavily-ai

สร้างการผสานรวม Tavily ที่พร้อมสำหรับการผลิตด้วยแนวทางปฏิบัติที่ดีที่สุดในตัว เอกสารอ้างอิงสำหรับนักพัฒนาที่ใช้ผู้ช่วยเขียนโค้ด (Claude Code, Cursor, …)

npx skills add https://github.com/tavily-ai/tavily-cursor-plugin --skill tavily-best-practices

Tavily

Tavily is a search API designed for LLMs, enabling AI applications to access real-time web data.

Installation

Python:

pip install tavily-python

JavaScript:

npm install @tavily/core

See references/sdk.md for complete SDK reference.

Client Initialization

from tavily import TavilyClient

# Uses TAVILY_API_KEY env var (recommended)
client = TavilyClient()

#With project tracking (for usage organization)
client = TavilyClient(project_id="your-project-id")

# Async client for parallel queries
from tavily import AsyncTavilyClient
async_client = AsyncTavilyClient()

Choosing the Right Method

For custom agents/workflows:

NeedMethod
Web search resultssearch()
Content from specific URLsextract()
Content from entire sitecrawl()
URL discovery from sitemap()

For out-of-the-box research:

NeedMethod
End-to-end research with AI synthesisresearch()

Quick Reference

search() - Web Search

response = client.search(
    query="quantum computing breakthroughs",  # Keep under 400 chars
    max_results=10,
    search_depth="advanced"
)
print(response)

Key parameters: query, max_results, search_depth (ultra-fast/fast/basic/advanced), include_domains, exclude_domains, time_range

See references/search.md for complete search reference.

extract() - URL Content Extraction

# Simple one-step extraction
response = client.extract(
    urls=["https://docs.example.com"],
    extract_depth="advanced"
)
print(response)

Key parameters: urls (max 20), extract_depth, query, chunks_per_source (1-5)

See references/extract.md for complete extract reference.

crawl() - Site-Wide Extraction

response = client.crawl(
    url="https://docs.example.com",
    instructions="Find API documentation pages",  # Semantic focus
    extract_depth="advanced"
)
print(response)

Key parameters: url, max_depth, max_breadth, limit, instructions, chunks_per_source, select_paths, exclude_paths

See references/crawl.md for complete crawl reference.

map() - URL Discovery

response = client.map(
    url="https://docs.example.com"
)
print(response)

research() - AI-Powered Research

import time

# For comprehensive multi-topic research
result = client.research(
    input="Analyze competitive landscape for X in SMB market",
    model="pro"  # or "mini" for focused queries, "auto" when unsure
)
request_id = result["request_id"]

# Poll until completed
response = client.get_research(request_id)
while response["status"] not in ["completed", "failed"]:
    time.sleep(10)
    response = client.get_research(request_id)

print(response["content"])  # The research report

Key parameters: input, model ("mini"/"pro"/"auto"), stream, output_schema, citation_format

See references/research.md for complete research reference.

Detailed Guides

For complete parameters, response fields, patterns, and examples:

Skills เพิ่มเติมจาก tavily-ai

academic-scientific-research
tavily-ai
ค้นหา คัดกรอง และสังเคราะห์เอกสารวิชาการ วรรณกรรมทางวิทยาศาสตร์ รายงานทางเทคนิค งานวิจัย preprint สิ่งตีพิมพ์ทางคลินิกหรือชีวการแพทย์ และหลักฐานที่เกี่ยวข้องกับ...
crawl
tavily-ai
แยกและบันทึกเนื้อหาเว็บไซต์เป็นไฟล์ markdown เพื่อการเข้าถึงและวิเคราะห์แบบออฟไลน์ รองรับการกำหนดความลึกในการรวบรวมข้อมูล (1-5 ระดับ) ขีดจำกัดความกว้าง และขีดจำกัดหน้าเพื่อปรับสมดุลระหว่างความครอบคลุมและประสิทธิภาพ รวมถึงการกรองเส้นทางด้วยรูปแบบ regex เพื่อเน้นส่วนที่ต้องการและแยกเนื้อหาที่ไม่เกี่ยวข้อง มีสองโหมด: การแยกเนื้อหาทั้งหน้าเพื่อรวบรวมข้อมูล หรือการแบ่งส่วนเชิงความหมายพร้อมคำสั่งภาษาธรรมชาติเพื่อป้อนผลลัพธ์เข้าสู่บริบทของ LLM มี API แผนที่เสริมสำหรับ URL...
extract
tavily-ai
แยกเนื้อหาที่สะอาดจาก URL ที่ระบุโดยใช้ API การสกัดของ Tavily รองรับสูงสุด 20 URL ต่อคำขอ พร้อมการจัดลำดับใหม่ตามคำค้นหาเพื่อเน้นเนื้อหาที่เกี่ยวข้อง โหมดการสกัดสองแบบ: พื้นฐานสำหรับการสกัดข้อความที่รวดเร็ว ขั้นสูงสำหรับหน้าที่เรนเดอร์ด้วย JavaScript และข้อมูลที่มีโครงสร้าง การตรวจสอบสิทธิ์ OAuth อัตโนมัติผ่านเบราว์เซอร์ในครั้งแรกที่ใช้งาน หรือกำหนดค่า API key ด้วยตนเองในการตั้งค่า ส่งคืนรูปแบบ markdown หรือข้อความธรรมดาพร้อม URL รูปภาพที่ไม่บังคับ และกำหนดเวลาหมดอายุได้สูงสุด 60 วินาที
investment-research-briefs
tavily-ai
สร้างสรุปข้อมูลการลงทุนฉบับกระชับ บันทึกบริษัท ภาพรวมรายภาคส่วน อัปเดตการติดตามพอร์ตโฟลิโอ สรุปผลประกอบการ/ข่าวสาร บทสรุปความเสี่ยงและปัจจัยขับเคลื่อน…
product-competitor-intelligence
tavily-ai
วิจัยผลิตภัณฑ์คู่แข่ง SKUs ราคา บรรจุภัณฑ์ การวางตำแหน่ง การเปรียบเทียบคุณสมบัติ แคตตาล็อกผลิตภัณฑ์ หน้าหมวดหมู่ รายการสินค้าจากผู้ค้าปลีก มาร์เก็ตเพลส…
research
tavily-ai
การวิจัยเชิงลึกในทุกหัวข้อ พร้อมการรวบรวมแหล่งข้อมูล วิเคราะห์ และอ้างอิงโดยอัตโนมัติ ดำเนินการวิจัยทางเว็บจากหลายแหล่งพร้อมการอ้างอิงที่ชัดเจน เหมาะสำหรับการเปรียบเทียบ เหตุการณ์ปัจจุบัน การวิเคราะห์ตลาด และรายงานโดยละเอียด มีสามตัวเลือกโมเดล: mini สำหรับการวิจัยหัวข้อเดียวแบบเจาะจง (~30 วินาที), pro สำหรับการวิเคราะห์หลายมุมแบบครอบคลุม (~60-120 วินาที) และ auto สำหรับการตรวจจับความซับซ้อนผ่าน API ยืนยันตัวตนผ่าน OAuth ผ่านเซิร์ฟเวอร์ Tavily MCP พร้อมการเข้าสู่ระบบผ่านเบราว์เซอร์อัตโนมัติบน...
sales-account-intelligence
tavily-ai
สร้างข้อมูลเชิงลึกเกี่ยวกับบัญชีที่พร้อมใช้สำหรับการขาย สำหรับบริษัท ลูกค้าเป้าหมาย ลูกค้าปัจจุบัน พันธมิตร และกลุ่มผู้ซื้อเป้าหมาย ใช้เมื่อผู้ใช้ขอการเตรียมความพร้อมด้านการขาย ข้อมูลสรุปบัญชี…
search
tavily-ai
ค้นหาเว็บด้วยผลลัพธ์ที่ปรับให้เหมาะสมกับ LLM การให้คะแนนความเกี่ยวข้อง และการกรองที่ยืดหยุ่น รองรับโหมดความลึกในการค้นหาสี่โหมด (เร็วพิเศษ เร็ว พื้นฐาน ขั้นสูง) พร้อมการปรับแต่งความหน่วงและความเกี่ยวข้องที่กำหนดค่าได้ รวมถึงการกรองโดเมน ข้อจำกัดช่วงเวลา ช่วงวันที่ การเพิ่มน้ำหนักประเทศ และการดึงเนื้อหาดิบ ส่งคืนผลลัพธ์พร้อมชื่อเรื่อง URL ตัวอย่างเนื้อหา และคะแนนความเกี่ยวข้อง ผลลัพธ์รูปภาพและ favicon แบบเลือกได้ การรับรองความถูกต้อง OAuth อัตโนมัติผ่านเซิร์ฟเวอร์ Tavily MCP หรือการกำหนดค่าคีย์ API...