A Web Search SDK, ami átírja az AI ügynökök játékszabályait

Search provider váltás: miért kellene ez nekünk?

Ha valaha is építettél AI agentet, tudod, miről beszélek. Bekonfigurálod a Tavily-t, minden működik, aztán jön egy hír, hogy változik az árszabás. Vagy elkezded elárasztani a kérésekkel, és jön a rate limit. Esetleg发现自己 kint egy jobb alternatíva, de a teljes integrációt át kell írnod.

A websearch-sdk pont ezt a problémát célozza. Nem kell minden providerhez külön integrációt írni – egyetlen API, ami mindegyik mögött ugyanúgy működik.

Egy API, bármelyik provider fölé

A megoldás meglepően egyszerű. Firecrawl, Tavily, Exa, Brave, Serper – mindegy, mit használsz, a search() és scrape() metódusok ugyanúgy működnek, és ugyanolyan formátumú eredményt kapsz.

// Provider váltás egyetlen sor módosításával
const provider = createProvider('firecrawl', { apiKey: process.env.FIRECRAWL_KEY });
// vagy
const provider = createProvider('tavily', { apiKey: process.env.TAVILY_KEY });

// Az agent kód változatlan marad
const results = await provider.search({ query: "legújabb AI trendek 2025" });

Ez azt jelenti, hogy a search logikád teljesen hordozható. Új provider tesztelése? Cseréld ki a factory hívást. Szolgáltatóváltás? Egy konfigurációs sor. Ilyen lenne az ideális szoftverarchitektúra.

Agent-ready, dobozból kivéve

Ha a Vercel AI SDK-val dolgozol, a websearch-sdk tovább megy a web.tools() funkcióval. Generál egy megfelelően formázott ToolSet-et web_search és web_scrape toolokkal, amit közvetlenül átadhatsz a modellnek. Nincs több schema küzdelem vagy formázó függvények írogatása – az SDK elintézi helyetted a csúnya részeket.

Könnyű, mindenhol fut

Azt szeretem benne, hogy native fetch-et használ, nem akar rá húzni nehéz vendor SDK-kat. Ez a bundle mélyén számít, főleg edge functionöknél vagy korlátozott erőforrású környezetekben. Dual ESM és CommonJS build, teljes TypeScript támogatás – megy Node 18+, Deno és Bun alatt is.

A valódi előny: capability-aware eszközök

Ez egy okos megoldás: a SDK "tudja", mit tud az aktív provider. A scraping metódusok csak akkor érhetők el, ha az adott szolgáltató támogatja őket. Elfelejtheted a runtime hibákat nem támogatott metódusok hívásakor – tiszta, kiszámítható élményt kapsz.

Hogyan kezdj hozzá?

Parancssor, és már megy is:

npm install websearch-sdk
npm install @websearch/firecrawl-provider

Ennyi. Pár perc alatt futhat az első egységes keresési lekérdezésed.

Végső gondolatok

A web keresés világa gyorsan változik, főleg ahogy az AI agentek mainstreammé válnak. Egy provider-független absztrakciós réteg ma már nem csak kényelmi kérdés – létfontosságú a hosszú távon is működő alkalmazásokhoz.

A websearch-sdk ugyanazokat az architekturális mintákat hozza a web keresésbe, amiket már évek óta használunk adatbázisoknál és autentikációnál. És ez mindenkinek jó, aki AI-alapú termékeket épít.

Akár startup vagy, akár nagyvállalat, ez a fajta absztrakciós réteg lehetővé teszi, hogy kísérletezz különböző providerokkal anélkül, hogy mindened egyetlen vendor-ra tennéd fel. Ez az a rugalmasság, ami skálázódik.