Spicrawl nay hoạt động với OpenAI Agents SDK, LangChain, Codex, Claude Code và nhiều hơn nữa.Xem các tích hợp
Chuyển đến nội dung
Hành động trên trình duyệtClick, nhập và cuộn trước

Click, nhập và cuộn trước khi bạn scrape

Mở menu, điền biểu mẫu và tải thêm. Rồi đọc trang.

  1. 1NhấpMở một menu hoặc nhấn “Load more”
  2. 2GõĐiền một biểu mẫu hoặc ô tìm kiếm
  3. 3CuộnTải phần còn lại của feed
  4. 4ĐọcLấy trang dưới dạng Markdown
Gửi một request
actions.sh
curl -X POST https://api.spicrawl.com/v1/scrape \  -H "Authorization: Bearer spicrawl_live_…" \  -H "Content-Type: application/json" \  -d '{    "url": "https://example.com",    "js_render": true,    "response_format": "markdown",    "actions": [      { "click": "#accept" },      { "fill": { "selector": "#search", "value": "shoes" } },      { "scroll": { "y": 800 } }    ]  }'

Cách hoạt động

  1. Bật render bằng js_render: true. Hành động cần có trình duyệt.
  2. Liệt kê các bước của bạn trong actions. Chúng chạy theo thứ tự sau khi trang tải xong.
  3. Lấy trang như nó hiển thị sau bước cuối cùng, theo định dạng bạn chọn.
curl https://api.spicrawl.com/v1/scrape \
  -H "Authorization: Bearer $SPICRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/products?category=lamps",
    "js_render": true,
    "response_format": "markdown",
    "actions": [
      {"click": "button.load-more"},
      {"wait_for": ".product-card:nth-child(40)"}
    ]
  }'

Các bước bạn có thể dùng

BướcNó làm gì
wait_forChờ một phần tử, hoặc chờ một khoảng thời gian cố định
clickClick một nút hoặc liên kết
fillGõ vào một ô nhập. Thêm secret: true để ẩn giá trị khỏi log
selectChọn một tùy chọn trong danh sách
scrollCuộn trang, cho các feed tải thêm khi bạn cuộn
evaluateChạy JavaScript của riêng bạn trên trang
screenshotLưu ảnh của trang tại bước đó

Nên biết

  • Tối đa 50 bước cho mỗi request. Toàn bộ danh sách được kiểm tra trước khi tiêu bất kỳ credit nào.
  • Chỉ trình duyệt. Chỉ dùng được với trình duyệt. Thiếu js_render, request bị từ chối với lỗi 400.
  • Không có trên batch. Hành động chỉ chạy trên scrape đơn.
  • Đăng nhập: chỉ đăng nhập vào tài khoản bạn sở hữu hoặc được phép sử dụng. Để duy trì đăng nhập, hãy dùng session.
  • Giá: miễn phí trong thời gian beta. Hành động chạy bằng render trình duyệt đầy đủ, tốn 8 credit.

Câu hỏi thường gặp

Hành động trên trình duyệt làm được gì?

Chờ một phần tử, chờ điều hướng, click, điền một ô input, chọn một tùy chọn, cuộn, chạy JavaScript và chụp ảnh màn hình. Các bước chạy theo thứ tự sau khi trang tải xong.

Một request có thể có bao nhiêu bước?

Tối đa 50. Toàn bộ danh sách được kiểm tra trước khi request chạy, nên một lỗi sẽ thất bại sớm và không tốn gì.

Hành động trên trình duyệt có cần render JavaScript không?

Có. Actions chạy trong trình duyệt, nên hãy đặt js_render là true. Nếu không, request bị từ chối với lỗi 400.

Tôi có thể điền mật khẩu một cách an toàn không?

Có. Đánh dấu bước fill với secret đặt là true, và giá trị sẽ bị ẩn khỏi log. Chỉ đăng nhập vào các tài khoản bạn sở hữu hoặc được phép sử dụng.

Tôi có thể lấy ảnh chụp màn hình sau các bước không?

Có. Thêm một bước screenshot. Phản hồi khi đó trở thành JSON envelope, với các ảnh nằm trong screenshots.