mirror of
https://github.com/hanzoskill/web-search-plus.git
synced 2026-10-30 21:07:58 +00:00
5.3 KiB
5.3 KiB
Changelog - Web Search Plus
[2.1.0] - 2026-01-23
๐ง Intelligent Multi-Signal Routing
Completely overhauled auto-routing with sophisticated query analysis:
Intent Classification
- Shopping Intent: Detects price patterns ("how much", "cost of"), purchase signals ("buy", "order"), deal keywords, and product+brand combinations
- Research Intent: Identifies explanation patterns ("how does", "why does"), analysis signals ("pros and cons", "compare"), learning keywords, and complex multi-clause queries
- Discovery Intent: Recognizes similarity patterns ("similar to", "alternatives"), company discovery signals, URL/domain detection, and academic patterns
Linguistic Pattern Detection
- "How much" / "price of" โ Shopping (Serper)
- "How does" / "Why does" / "Explain" โ Research (Tavily)
- "Companies like" / "Similar to" / "Alternatives" โ Discovery (Exa)
- Product + Brand name combos โ Shopping (Serper)
- URLs and domains in query โ Similar search (Exa)
Query Analysis Features
- Complexity scoring: Long, multi-clause queries get routed to research providers
- URL detection: Automatic detection of URLs/domains triggers Exa similar search
- Brand recognition: Tech brands (Apple, Samsung, Sony, etc.) with product terms โ shopping
- Recency signals: "latest", "2026", "breaking" boost news mode
Confidence Scoring
- HIGH (70-100%): Strong signal match, very reliable routing
- MEDIUM (40-69%): Good match, should work well
- LOW (0-39%): Ambiguous query, using fallback provider
- Confidence based on absolute signal strength + relative margin over alternatives
Enhanced Debug Mode
python3 scripts/search.py --explain-routing -q "your query"
Now shows:
- Routing decision with confidence level
- All provider scores
- Top matched signals with weights
- Query analysis (complexity, URL detection, recency focus)
- All matched patterns per provider
๐ง Technical Changes
QueryAnalyzer Class
New QueryAnalyzer class with:
SHOPPING_SIGNALS: 25+ weighted patterns for shopping intentRESEARCH_SIGNALS: 30+ weighted patterns for research intentDISCOVERY_SIGNALS: 20+ weighted patterns for discovery intentLOCAL_NEWS_SIGNALS: 25+ patterns for local/news queriesBRAND_PATTERNS: Tech brand detection regex
Signal Weighting
- Multi-word phrases get higher weights (e.g., "how much" = 4.0 vs "price" = 3.0)
- Strong signals: price patterns (4.0), similarity patterns (5.0), URLs (5.0)
- Medium signals: product terms (2.5), learning keywords (2.5)
- Bonus scoring: Product+brand combo (+3.0), complex query (+2.5)
Improved Output Format
{
"routing": {
"auto_routed": true,
"provider": "serper",
"confidence": 0.78,
"confidence_level": "high",
"reason": "high_confidence_match",
"top_signals": [{"matched": "price", "weight": 3.0}],
"scores": {"serper": 7.0, "tavily": 0.0, "exa": 0.0}
}
}
๐ Documentation Updates
- SKILL.md: Complete rewrite with signal tables and confidence scoring guide
- README.md: Updated with intelligent routing examples and confidence levels
- FAQ: Updated to explain multi-signal analysis
๐งช Test Results
| Query | Provider | Confidence | Signals |
|---|---|---|---|
| "how much does iPhone 16 cost" | Serper | 68% | "how much", brand+product |
| "how does quantum entanglement work" | Tavily | 86% HIGH | "how does", "what are", "implications" |
| "startups similar to Notion" | Exa | 76% HIGH | "similar to", "Series A" |
| "companies like stripe.com" | Exa | 100% HIGH | URL detected, "companies like" |
| "MacBook Pro M3 specs review" | Serper | 70% HIGH | brand+product, "specs", "review" |
| "Tesla" | Serper | 0% LOW | No signals (fallback) |
| "arxiv papers on transformers" | Exa | 58% | "arxiv" |
| "latest AI news 2026" | Serper | 77% HIGH | "latest", "news", "2026" |
[2.0.0] - 2026-01-23
๐ Major Features
Smart Auto-Routing
- Automatic provider selection based on query analysis
- No need to manually choose provider - just search!
- Intelligent keyword matching for routing decisions
- Pattern detection for query types (shopping, research, discovery)
- Scoring system for provider selection
User Configuration
- config.json: Full control over auto-routing behavior
- Configurable keyword mappings: Add your own routing keywords
- Provider priority: Set tie-breaker order
- Disable providers: Turn off providers you don't have API keys for
- Enable/disable auto-routing: Opt-in or opt-out as needed
Debugging Tools
- --explain-routing flag: See exactly why a provider was selected
- Detailed routing metadata in JSON responses
- Shows matched keywords and routing scores
๐ Documentation
- README.md: Complete auto-routing guide with examples
- SKILL.md: Detailed routing logic and configuration reference
- FAQ section: Common questions about auto-routing
- Configuration examples: Pre-built configs for common use cases
[1.0.x] - Initial Release
- Multi-provider search: Serper, Tavily, Exa
- Manual provider selection with
-pflag - Unified JSON output format
- Provider-specific options (--depth, --category, --similar-url, etc.)
- Domain filtering for Tavily/Exa
- Date filtering for Exa