Tavily Summary#

AI-optimized web search with structured summarization methodology, combining:

• Tavily Search API for clean, relevant search results (AI-native)
• Proven summarization rules extracted from the summarize project
• Output follows consistent formatting rules for readability

Features#

• Search the web with AI optimization (better than plain search engines for AI agents)
• Automatically summarizes results following structured formatting rules:
  • Strict length control, no padding
  • Automatic heading hierarchy for long content
  • Proper citation of key excerpts
  • Ad/sponsor content automatically stripped
  • Consistent Markdown formatting

Usage#

Search#

bash

node {baseDir}/scripts/search.mjs "query"
node {baseDir}/scripts/search.mjs "query" -n 10
node {baseDir}/scripts/search.mjs "query" --deep
node {baseDir}/scripts/search.mjs "query" --topic news
node {baseDir}/scripts/search.mjs "query" --topic news --days 30

Options#

• -n <count>: Number of results (default: 5, max: 20)
• --deep: Use advanced search for deeper research (slower, more comprehensive)
• --topic <topic>: Search topic - general (default) or news
• --days <n>: For news topic, limit to last n days

Extract content from URL#

bash

node {baseDir}/scripts/extract.mjs "https://example.com/article"

Output Summary Rules#

Core Principles#

• Positioning: Extract key points for users, let them quickly grasp core info and decide whether to read in depth
• Authenticity: 100% based on search results, never fabricate information
• Conciseness: Strictly control length, prefer shorter, never pad for no reason
• Formatting: Use Markdown formatting, long content must split into sections with headings

Formatting Rules#

• Content longer than 500 characters equivalent → split with ### prefixed Markdown headings, at least 3 headings
• Short paragraphs, use bullet points only when improves readability, don't force rigid templates
• Include 1-2 short exact excerpts (max 25 words each) as italicized, ignore ads/sponsors/promotions completely, treat them as if they don't exist, don't mention ignoring them

Output Structure (for news search example)#

1. One sentence opening summary of the core conclusion
2. Break into points/events, each with core idea + key data
3. (Optional) 1-2 italicized original excerpts
4. One sentence closing summary

Absolute Prohibitions#

• ❌ Never include ads/sponsors/promotions/CTAs, delete directly
• ❌ Use straight quotes only, no curly quotes
• ❌ Don't add emojis, disclaimers, unfounded speculation
• ❌ Never exceed requested length, finish early if content is short, don't pad
• ❌ Don't fabricate excerpts, omit if no suitable excerpt exists

Requirements#

• TAVILY_API_KEY from https://tavily.com (free plan available: 1,000 searches/month)
• Node.js 18+

Credits#

• Search API provided by Tavily
• Summarization methodology refined from summarize