Słownik Web Search API

Interfejs, który na żądanie wykonuje wyszukiwanie w sieci i zwraca wyniki jako dane strukturalne, zwykle JSON, zamiast strony przygotowanej dla ludzkiego oka.

Strona wyników wyszukiwania: to, co wyszukiwarka pokazuje dla zapytania. SERP API zwraca tę stronę jako dane, bez czytania stron, które wymienia.

Lista stron zwróconych przez wyszukiwanie, w kolejności uznanej przez wyszukiwarkę za najbardziej istotną. LLMWebSearch zachowuje tę kolejność i numeruje każdy wynik za pomocą position.

Krótki fragment pod tytułem każdego wyniku. Przydatny przy wyborze tego, co czytać, zbyt krótki, by samodzielnie odpowiedzieć na większość pytań.

Słowa wysyłane do wyszukiwarki. Agenci często przepisują pytanie użytkownika na jedno lub więcej krótszych zapytań przed wyszukiwaniem.

Specjalny token w zapytaniu, na przykład cudzysłowy dla dokładnej frazy czy site:, by pozostać w jednej domenie. Parametr q przekazuje je bez zmian.

Wyszukiwanie uruchamiane w momencie zapytania, w przeciwieństwie do odczytu z indeksu zbudowanego wcześniej. Wyniki pochodzą z wyszukiwania w sieci na żywo, uruchamianego w momencie Twojego wywołania, w kolejności, w jakiej szereguje je wyszukiwarka; nic nie jest serwowane ze starego indeksu.

Wyszukiwanie ograniczone do artykułów informacyjnych, zwykle z datami. Ustaw topic na news i dodaj time_range, by zachować tylko najnowsze materiały.

Reguła, która ogranicza wyniki do niektórych witryn lub usuwa inne. Parametry include_domains i exclude_domains przyjmują po maksymalnie 20 domen.

Część usługi, która otwiera najwyżej ocenione strony wyników i wyodrębnia z nich tekst. Nasza przedstawia się jako LLMWebSearch/1.0 (+https://llmwebsearch.com/bot/); strona o czytniku stron opisuje to szczegółowo.

Nazwa, którą klient wysyła z każdym żądaniem sieciowym. Czytnik, który podaje swoją prawdziwą nazwę, pozwala właścicielom witryn go rozpoznać i ustanowić dla niego reguły.

Plik tekstowy w katalogu głównym witryny, który mówi robotom, do których ścieżek mogą wchodzić. Standardem jest RFC 9309. Nasz czytnik respektuje robots.txt: przedstawia się jako LLMWebSearch, przestrzega reguł, które witryna zapisuje dla niego lub dla wszystkich robotów, i pomija treść każdej strony, której nie wolno mu czytać.

Wiersze w robots.txt, które określają, jak można wykorzystywać treści, na przykład ai-input=no, by odmówić użycia jako danych wejściowych dla AI. Witryna, która ustawia Content-Signal: ai-input=no w swoim robots.txt, trzyma treść swoich stron poza treścią Twoich wyników.

Zachowanie tekstu artykułu lub dokumentacji strony i odrzucenie menu, stopek, banerów cookie i reklam, aby model czytał to, co istotne.

Lekki format tekstowy, w którym # oznacza nagłówek, a - element listy. Modele czytają go dobrze, a dla tej samej strony kosztuje mniej tokenów niż HTML.

Przeglądarka bez okna, sterowana kodem. Pozwala czytnikowi zobaczyć tekst stron, które pojawiają się dopiero po uruchomieniu JavaScript.

Bramka, która zatrzymuje treść dla płacących subskrybentów. Czytnik nigdy się nie loguje i nigdy nie obchodzi paywalla; takie strony wracają bez treści.

Pole, które mówi, czy strona wyniku została odczytana, a jeśli nie, to dlaczego: ok, not_requested, blocked_by_robots, target_refused i inne wymienione w dokumentacji.

Duży model językowy: model wytrenowany na tekście, który pisze tekst. Jego wiedza kończy się na dacie treningu, dlatego do wszystkiego, co najnowsze, potrzebuje wyszukiwania.

Dawanie modelowi źródeł, na których ma oprzeć odpowiedź, i proszenie go o ich cytowanie. Wyniki wyszukiwania z tekstem strony to najczęstszy sposób ugruntowania w sieci.

Nazywane też function calling. Model prosi o uruchomienie narzędzia, takiego jak web_search, z argumentami, które sam wybiera; Twój kod je uruchamia i zwraca wynik.

Model Context Protocol: otwarty standard udostępniania narzędzi klientom AI, takim jak Claude Desktop czy Cursor. Mały serwer MCP może opakować search API jako narzędzie.

Program, w którym model decyduje o następnym kroku, wywołuje narzędzia, czyta ich wyniki i powtarza, aż zadanie zostanie wykonane. Wyszukiwanie w sieci jest często jego pierwszym narzędziem.

Retrieval-augmented generation: najpierw pobierz odpowiedni tekst, umieść go w prompcie, a potem generuj. W przypadku web search API etap pobierania to bieżący internet.

Wzorzec agenta, który planuje wiele zapytań, czyta wiele stron i pisze raport z cytowaniami. Dla jednego pytania może wykonać dziesiątki wyszukiwań.

Ilość tekstu, jaką model może przyjąć naraz, mierzona w tokenach. Ustaw max_chars, aby ograniczyć, ile z każdej strony trafia do tego okna.

Jednostka, w której modele czytają i rozliczają, w przybliżeniu krótkie słowo lub jego część. Czysty Markdown zużywa mniej tokenów niż surowy HTML.

Link od stwierdzenia w odpowiedzi do źródła, z którego pochodzi. Zwracanie źródeł zamiast napisanej odpowiedzi pozwala Twojemu modelowi zacytować dokładnie to, co przeczytał.

Pewne siebie stwierdzenie, które model wymyśla. Ugruntowanie na świeżych źródłach i proszenie o cytowania to ogranicza; nie usuwa tego.

To, co zużywa każde wywołanie. Jeden kredyt opłaca jedno wyszukiwanie: do 20 wyników z rankingiem, przy czym strony z pierwszych 3 są odczytywane i zwracane jako Markdown. Odczyt od 4 do 10 stron to 2 kredyty. Wywołanie zakończone błędem nic nie kosztuje.

Opłacona z góry partia kredytów, od 5 000 wyszukiwań do 1 000 000 wyszukiwań. Kredyty na wyszukiwanie nie mają daty ważności: to, czego nie wykorzystasz w tym miesiącu, będzie tam jeszcze w przyszłym roku.

Płatność kryptowalutą, która zasila Twoje saldo, co najmniej 25 USD. Pakiety kupuje się następnie z salda.

Liczba wywołań, jakich konto może dokonać na minutę. Każde konto ma limit wywołań na minutę, widoczny w dashboardzie; poproś support, a można go podnieść.

Protokół, który pozwala klientowi zapłacić za jedno zapytanie HTTP stablecoinem, bez konta. Niektóre search API go akceptują; LLMWebSearch jest opłacany z salda przedpłaconego.

Know your customer: kontrole tożsamości, takie jak dokument tożsamości lub selfie. LLMWebSearch nie wymaga żadnych; strona bez KYC wyjaśnia, co nadal obowiązuje.