Spicrawl działa teraz z OpenAI Agents SDK, LangChain, Codex, Claude Code i nie tylko.Zobacz integracje
Przejdź do treści

Wyodrębnij dane strukturalne z dowolnej strony

Wybierz potrzebne pola. Dostań je jako czysty JSON.

example.com/product/1
Poznaj Model X — precyzja w każdym kliknięciu
Wireless Mouse — Model X
Wireless Mouse — Model X
$49.00Dostępny★ 4.6 (1,284)
Odbiornik 2.4 GHz o niskim opóźnieniu, 70 dni pracy na baterii i ciche przełączniki.
SpecyfikacjaWartość
Połączenie2.4 GHz, BT5Bateria70 dni
<script type="application/ld+json">
result.md
# Wireless Mouse — Model X**$49.00** · In stock · 4.6 (1,284 reviews)Low-latency 2.4 GHz receiver, 70-day battery lifei ciche przełączniki.| Spec      | Value        || --------- | ------------ || Connection| 2.4 GHz, BT5 || Battery   | 70 days      |
Czytanie strony
Surowy HTML12,480 tokenów
Markdown0 tokenów

Menu, stopki i reklamy usunięte: od 3% do 24% tokenów surowego HTML. Przykładowa strona.

Jak to działa

  1. Nazwij swoje pola i podaj dla każdego selektor CSS.
  2. Wyślij je w extract z adresem URL strony.
  3. Czytaj JSON. Twoje pola są w data.
curl https://api.spicrawl.com/v1/scrape \
  -H "Authorization: Bearer $SPICRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/products/42",
    "extract": { "title": "h1", "price": ".price", "next_page": "a.next@href" }
  }'
json
{
  "status": 200,
  "data": {
    "title": "Walnut Desk",
    "price": "$349.00"
  },
  "empty_fields": ["next_page"]
}

empty_fields wymienia pola, które niczego nie znalazły. To często pierwszy znak, że witryna zmieniła układ.

Trzy sposoby na dane

SposóbCo wysyłaszCo dostajesz
autoparse"autoparse": trueWłasny JSON-LD, OpenGraph, microdata, metadane i stan aplikacji strony
Mapa selektorówNazwy pól i selektory CSSDokładnie te pola, jako tekst
JSON SchemaSchemat, którego pola mają selektoryTypowane, sprawdzone wartości, więc "$1,234.56" staje się 1234.56

Warto wiedzieć

  • Bez dodatkowych kredytów do ekstrakcji. Płacisz tylko za żądanie: 1 kredyt zwykłe, 3 z JavaScriptem.
  • Wkrótce: ekstrakcja z promptu w zwykłym języku. Dziś używaj selektorów, schematu lub autoparse.
  • Nie w batchu. Ekstrakcja działa tylko w pojedynczych scrape'ach.
  • Twoja odpowiedzialność: wyodrębniaj tylko dane, do których masz prawo. Zobacz nasze regulamin.

Najczęściej zadawane pytania

Jak wyodrębnić dane ze strony jako JSON?

Wyślij extract z mapą nazw pól na selektory CSS, na przykład "title": "h1" i "price": ".price". Wartości wracają w data w odpowiedzi JSON.

Co robi autoparse?

Zwraca to, co strona już mówi o sobie, bez selektorów: JSON-LD, OpenGraph, Twitter Card, microdata, RDFa, metadane head i osadzony stan aplikacji.

Czy może zwracać liczby zamiast tekstu?

Tak. Użyj JSON Schema, której właściwości mają selektor. Wartości są konwertowane do zadeklarowanego typu, więc "$1,234.56" staje się 1234.56, a wynik jest sprawdzany względem schematu.

Skąd mam wiedzieć, że strona zmieniła układ?

Sprawdź empty_fields w odpowiedzi. Wymienia pola, których selektor niczego nie znalazł, co często jest pierwszą oznaką zmiany w kodzie strony.

Czy mogę opisać pola zwykłymi słowami zamiast selektorami?

Jeszcze nie. Ekstrakcja na podstawie promptu modelu jest wkrótce. Dziś użyj selektorów, schematu JSON Schema lub autoparse.