1---2name: migrate-to-tavily3description: Migrate an existing integration from a competing web-search/research API — Exa, Firecrawl, Perplexity, or Parallel — over to Tavily, preserving behavior while swapping calls, imports, environment variables, and error handling. Use this skill when the user has working code against a competitor's SDK and wants to switch providers, or says "migrate this to Tavily", "switch from Exa/Firecrawl/Perplexity/Parallel to Tavily", "replace this competitor API with Tavily", or "port this integration over". Do NOT use this for greenfield Tavily integrations with no existing competitor code — start with tavily-best-practices instead.4---56# migrate to tavily78Convert an existing integration against a competitor's search/extract/research API into an equivalent Tavily integration.910## When to use1112- There's existing code calling Exa, Firecrawl, Perplexity, or Parallel13- The user wants the same behavior, just backed by Tavily instead1415Not this skill:16- No existing competitor code to migrate → start with [tavily-best-practices](../tavily-best-practices/SKILL.md) for a fresh integration1718## Process19201. **Find what's actually used.** Grep the codebase for the competitor's SDK import, client construction, and each method call site — don't assume every method the SDK offers is in use.212. **Map each call site** using the tables below.223. **Rewrite** imports, client construction, method calls, and response field access.234. **Update dependencies** (`package.json`/`requirements.txt`) and environment variables (`.env`, config, CI secrets references — flag secret rotation as the user's responsibility, don't invent new key values).245. **Update error handling** to match Tavily's exceptions/response shape (see [tavily-best-practices/references/sdk.md](../tavily-best-practices/references/sdk.md)).256. **Flag anything with no clean equivalent** rather than silently dropping functionality — call it out to the user explicitly.2627## Mapping tables2829### From Exa3031| Exa | Tavily | Notes |32|---|---|---|33| `exa.search(query, ...)` | `client.search(query, ...)` → [tavily-search](../tavily-search/SKILL.md) | Exa's neural/keyword `type` param has no direct Tavily equivalent — Tavily's `search_depth` (basic/advanced) is the closest lever |34| `exa.get_contents(urls)` | `client.extract(urls)` → [tavily-extract](../tavily-extract/SKILL.md) | |35| `exa.find_similar(url)` | No direct equivalent | Approximate with `client.search()` using the source page's title/topic as the query |36| `exa.search_and_contents(...)` | `client.search(..., include_raw_content=True)` | One-call combined pattern, same idea |3738### From Firecrawl3940| Firecrawl | Tavily | Notes |41|---|---|---|42| `firecrawl.scrape_url(url)` | `client.extract(urls=[url])` → [tavily-extract](../tavily-extract/SKILL.md) | |43| `firecrawl.crawl_url(url, ...)` | `client.crawl(url, ...)` → [tavily-crawl](../tavily-crawl/SKILL.md) | Firecrawl's `limit`/`maxDepth` map to Tavily's `limit`/`max_depth` |44| `firecrawl.map_url(url)` | `client.map(url)` → [tavily-map](../tavily-map/SKILL.md) | |45| Firecrawl's markdown/structured extraction modes | Tavily's `extract_depth="advanced"` + `format="markdown"` | |4647### From Perplexity4849| Perplexity | Tavily | Notes |50|---|---|---|51| `sonar`/`sonar-pro` chat-completions call used for research | `client.research(input, model="mini"/"pro")` → [tavily-research](../tavily-research/SKILL.md) | Perplexity returns research as a chat completion; Tavily's `research()` is purpose-built, async, and supports `output_schema` for structured results |52| Inline citations in the completion text | `response["sources"]` + `citation_format` | Tavily returns citations as structured data rather than inline markers — update any citation-parsing code accordingly |5354### From Parallel5556| Parallel | Tavily | Notes |57|---|---|---|58| `parallel-web-search` | `client.search(...)` → [tavily-search](../tavily-search/SKILL.md) | |59| `parallel-web-extract` | `client.extract(...)` → [tavily-extract](../tavily-extract/SKILL.md) | |60| `parallel-deep-research` | `client.research(..., model="pro")` → [tavily-research](../tavily-research/SKILL.md) | |61| `parallel-findall` | [build-entity-list](../build-entity-list/SKILL.md) | Same underlying idea — structured list of matching entities |62| `parallel-data-enrichment` | [fill-missing-fields](../fill-missing-fields/SKILL.md) | Same underlying idea — fill in fields on an existing list |63| `parallel-monitor` | [watch-for-changes](../watch-for-changes/SKILL.md) | Parallel's is a hosted platform feature; Tavily's equivalent is orchestration-based (see that skill's notes) — call this difference out to the user rather than promising an identical hosted experience |64| `status` / `result` (run ID lookup) | `client.get_research(request_id)` / `tvly research status`/`poll` | Built into [tavily-research](../tavily-research/SKILL.md) rather than separate calls |65| `parallel-memory` | [past-research-search](../past-research-search/SKILL.md) | Tavily has no hosted memory store — this is a local logging convention, say so |6667## Tips6869- **Preserve response shape at the boundary if the rest of the app depends on it.** If a wholesale rewrite is risky, write a thin adapter function that calls Tavily internally but returns the old shape, rather than touching every call site.70- **Don't invent parity that doesn't exist.** Where Tavily has no equivalent (e.g., Exa's `find_similar`), say so plainly rather than approximating silently and letting behavior quietly change.71- **Check rate limits and pricing separately** — this skill migrates code, not commercial terms; flag that the user should confirm their Tavily plan covers their call volume.72- **Test against real data before removing the old integration.** Run both side-by-side on a few known cases and compare outputs.7374## See also7576- [tavily-best-practices](../tavily-best-practices/SKILL.md) — full SDK reference for the target Tavily integration77- [fill-missing-fields](../fill-missing-fields/SKILL.md), [build-entity-list](../build-entity-list/SKILL.md), [watch-for-changes](../watch-for-changes/SKILL.md), [past-research-search](../past-research-search/SKILL.md) — Tavily-side equivalents for Parallel's higher-level skills
tavily-ai