Web Search SDK: rewolucja, której potrzebują agenci AI

Problem z zależnością od dostawcy wyszukiwania

Przyznajmy to sobie – podłączanie wyszukiwarki internetowej do agentów AI było zawsze bardziej skomplikowane, niż powinno. Budujesz idealny workflow z Tavily przez kilka tygodni, żeby nagle odkryć, że zmienili cennik, dorzucili limit zapytań, albo pojawiła się lepsza alternatywa. I teraz siedzisz z懊恼ą, bo musisz przepisywać integrację w całej aplikacji. Nikt tego nie lubi robić.

Dokładnie z tym problemem postanowiła sobie poradzić ekipa stojąca za websearch-sdk. Zamiast kleić osobną integrację dla każdego dostawcy, masz teraz jedną, ujednoliconą API, która działa identycznie niezależnie od tego, co w danym momencie napędza wyszukiwanie pod spodem.

Jedna API, wiele dostawców

Cała magia jest zaskakująco prosta: korzystasz z Firecrawl, Tavily, Exa, Brave czy Serper – nie ma znaczenia. Twój kod wywołuje te same metody search() i scrape(), a wyniki dostajesz zawsze w takiej samej strukturze.

// Zmień dostawcę jedną linijką
const provider = createProvider('firecrawl', { apiKey: process.env.FIRECRAWL_KEY });
// albo
const provider = createProvider('tavily', { apiKey: process.env.TAVILY_KEY });

// Kod agenta wygląda dokładnie tak samo
const results = await provider.search({ query: "najnowsze trendy AI 2025" });

To oznacza, że logika wyszukiwania staje się naprawdę przenośna. Chcesz przetestować nowego dostawcę? Podmieniasz jedno wywołanie fabryki. Musisz przenieść się do innego? Zmieniasz jedną konfigurację. Tak powinna wyglądać architektura oprogramowania.

Gotowe narzędzia dla agentów

Dla tych, którzy budują z Vercel AI SDK, websearch-sdk idzie o krok dalej dzięki web.tools() – generuje odpowiednio sformatowany ToolSet z narzędziami web_search i web_scrape, gotowymi do bezpośredniego przekazania modelowi. Żadnego mozolnego definiowania schematów narzędzi czy funkcji formatujących. SDK zajmuje się brudną robotą integracyjną, więc możesz skupić się na tym, co naprawdę ważne – logice agenta.

Lekkie, wszechstronne

Jedna rzecz, którą cenię: SDK korzysta z natywnego fetch zamiast ciągnąć za sobą ciężkie SDK od dostawców. Dzięki temu bundle zostaje szczupły, co ma znaczenie przy deploymencie na edge functions czy środowiskach z ograniczonymi zasobami. Paczka jest dostępna jako dual build ESM i CommonJS z pełną obsługą TypeScripta, więc działa bezproblemowo na Node 18+, Denie czy Bun.

Prawdziwa zaleta: świadome możliwości

Oto przemyślany detal: SDK jest „świadome możliwości". Oznacza to, że narzędzia do scrapowania i powiązane metody są udostępniane tylko wtedy, gdy aktywny dostawca faktycznie je wspiera. Koniec z błędami runtime przy wywoływaniu nieobsługiwanych metod – dostajesz czyste, przewidywalne doświadczenie, które dostosowuje się do tego, co dany dostawca potrafi.

Pierwsze kroki

Instalacja jest prosta – pobierz główną paczkę i dodaj wybranego dostawcę:

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

I tyle. Pierwsze ujednolicone zapytanie wyszukiwania możesz uruchomić w ciągu kilku minut.

Na deser

krajobraz wyszukiwania w sieci ewoluuje błyskawicznie, zwłaszcza że agenci AI stają się mainstreamem. Warstwa abstrakcji niezależna od dostawcy to nie tylko wygoda – staje się koniecznością przy budowaniu odpornych i przyszłościowych aplikacji. websearch-sdk przenosi te same wzorce architektoniczne, których używamy przy bazach danych i autoryzacji, na wyszukiwanie internetowe. I to jest dobra wiadomość dla wszystkich, którzy budują produkty napędzane AI.

Niezależnie od tego, czy jesteś startupem działającym szybko, czy enterprise'em zarządzającym złożonymi workflow agentów, taka warstwa abstrakcji pozwala eksperymentować z różnymi dostawcami bez obstawiania całego kodu na jednego vendora. To właśnie ta elastyczność, która się skaluje.