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
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
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)
- One sentence opening summary of the core conclusion
- Break into points/events, each with core idea + key data
- (Optional) 1-2 italicized original excerpts
- 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
1---2name: tavily-summary3description: AI-optimized web search with structured summarization, combining Tavily Search API + proven summarization methodology from summarize.4---56# Tavily Summary78AI-optimized web search with **structured summarization methodology**, combining:9- Tavily Search API for clean, relevant search results (AI-native)10- Proven summarization rules extracted from the `summarize` project11- Output follows consistent formatting rules for readability1213## Features1415- Search the web with AI optimization (better than plain search engines for AI agents)16- Automatically summarizes results following structured formatting rules:17 - Strict length control, no padding18 - Automatic heading hierarchy for long content19 - Proper citation of key excerpts20 - Ad/sponsor content automatically stripped21 - Consistent Markdown formatting2223## Usage2425### Search2627```bash28node {baseDir}/scripts/search.mjs "query"29node {baseDir}/scripts/search.mjs "query" -n 1030node {baseDir}/scripts/search.mjs "query" --deep31node {baseDir}/scripts/search.mjs "query" --topic news32node {baseDir}/scripts/search.mjs "query" --topic news --days 3033```3435## Options3637- `-n <count>`: Number of results (default: 5, max: 20)38- `--deep`: Use advanced search for deeper research (slower, more comprehensive)39- `--topic <topic>`: Search topic - `general` (default) or `news`40- `--days <n>`: For news topic, limit to last n days4142## Extract content from URL4344```bash45node {baseDir}/scripts/extract.mjs "https://example.com/article"46```4748## Output Summary Rules4950### Core Principles51- **Positioning**: Extract key points for users, let them quickly grasp core info and decide whether to read in depth52- **Authenticity**: 100% based on search results, never fabricate information53- **Conciseness**: Strictly control length, prefer shorter, never pad for no reason54- **Formatting**: Use Markdown formatting, long content *must* split into sections with headings5556### Formatting Rules57- Content longer than 500 characters equivalent → split with `### ` prefixed Markdown headings, at least 3 headings58- Short paragraphs, use bullet points only when improves readability, don't force rigid templates59- 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 them6061### Output Structure (for news search example)621. One sentence opening summary of the core conclusion632. Break into points/events, each with core idea + key data643. (Optional) 1-2 italicized original excerpts654. One sentence closing summary6667### Absolute Prohibitions68- ❌ Never include ads/sponsors/promotions/CTAs, delete directly69- ❌ Use straight quotes only, no curly quotes70- ❌ Don't add emojis, disclaimers, unfounded speculation71- ❌ Never exceed requested length, finish early if content is short, don't pad72- ❌ Don't fabricate excerpts, omit if no suitable excerpt exists7374## Requirements7576- `TAVILY_API_KEY` from https://tavily.com (free plan available: 1,000 searches/month)77- Node.js 18+7879## Credits8081- Search API provided by [Tavily](https://tavily.com)82- Summarization methodology refined from [summarize](https://github.com/steipete/summarize)
Lord1Egypt