Tavily Summary

AI-optimized web search with structured summarization, combining Tavily Search API + proven summarization methodology from summarize.

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