exa-migration-deep-dive

# Exa Migration Deep Dive ## Current State !`npm list exa-js 2>/dev/null | grep exa-js || echo 'exa-js not installed'` !`npm list 2>/dev/null | grep -E '(google|bing|tavily|serper|serpapi)' || echo 'No competing search SDK found'` ## Overview Migrate from traditional search APIs (Google Custom Search, Bing Web Search, Tavily, Serper) to Exa's neural search API. Key differences: Exa uses semantic/neural search instead of keyword matching, returns content (text/highlights/summary) in a single API call, and supports similarity search from a seed URL. ## API Comparison | Feature | Google/Bing | Tavily | Exa | |---------|-------------|--------|-----| | Search model | Keyword | AI-enhanced | Neural embeddings | | Content in results | Snippets only | Full text | Text + highlights + summary | | Similarity search | No | No | `findSimilar()` by URL | | AI answer | No | Yes | `answer()` + `streamAnswer()` | | Categories | No | No | company, news, research paper, tweet, people | | Date filtering | Limited | Yes | `startPublishedDate` / `endPublishedDate` | | Domain filtering | Yes | Yes | `includeDomains` / `excludeDomains` (up to 1200) | ## Instructions ### Step 1: Install Exa SDK ```bash set -euo pipefail npm install exa-js # Remove old SDK if replacing # npm uninstall google-search-api tavily serpapi ``` ### Step 2: Create Adapter Layer ```typescript // src/search/adapter.ts import Exa from "exa-js"; // Define a provider-agnostic search interface interface SearchResult { tit...