tavily-summary

# 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](https://tavily.com) - Summarization methodology refined from [summarize](https://github.com/steipete/summarize)