Tìm kiếm web trong n8n AI agent với SerpCrypto SERP API

Vì sao dùng node HTTP Request thay vì một node tùy chỉnh?

Tài liệu của n8n cho biết node HTTP Request có thể chạy như một node thường hoặc được gắn vào một AI agent để dùng như công cụ. Điều đó đủ cho một REST API như SerpCrypto, chỉ cần một request GET với một header và vài query parameter. Không có community node nào của chúng tôi để cài hay phải cập nhật, và credential nằm trong kho credential mã hóa của n8n.

Node AI Agent cần một chat model và ít nhất một tool sub-node. Từ n8n 1.82.0, mọi AI Agent hoạt động như Tools Agent, nên agent tự quyết định khi nào gọi công cụ tìm kiếm.

Làm sao lưu khóa API?

Tạo một credential Header Auth. Tài liệu credential của n8n mô tả hai trường, Name của header và Value của nó, và lưu ý rằng bearer token chính là header auth với name Authorization và value Bearer <token>. Điền Authorization vào Name và Bearer cộng khóa SerpCrypto của bạn vào Value.

n8n cũng có kiểu Bearer auth chung; cả hai đều gửi cùng một header. Hãy cấp cho n8n một khóa API riêng, để bạn thấy được mức dùng của nó tách khỏi các script khác và thu hồi riêng khi cần. Khóa API bạn có thể tạo và thu hồi bất cứ lúc nào từ dashboard.

Model điền truy vấn tìm kiếm như thế nào?

Để model tự định nghĩa q. Cạnh một trường parameter đủ điều kiện, n8n hiện nút ngôi sao để giao giá trị cho model. Bạn cũng có thể tự gõ biểu thức $fromAI(), gồm một key, một description, một type và một giá trị mặc định; description cho model biết nên điền gì. n8n ghi rõ rằng $fromAI() chỉ hoạt động với các công cụ được gắn vào node AI Agent.

Giữ cố định gl và hl nếu agent của bạn phục vụ một thị trường. Để model tự đặt chúng nếu người dùng hỏi về các quốc gia khác nhau, và mô tả các mã mong đợi, ví dụ gb hoặc de.

{{ $fromAI("query", "The search query, as a person would type it", "string") }}

Vì sao bật Optimize Response?

Một trang kết quả đầy đủ ở dạng JSON rất dài, và mọi thứ công cụ trả về đều đi vào context của model. Optimize Response là tùy chọn chỉ dành cho công cụ của node HTTP Request, giúp cắt bớt dữ liệu truyền cho model; n8n lưu ý nó có thể giảm chi phí. Với kiểu response JSON, đặt Field Containing Data thành organic_results và chỉ chọn title, link và snippet.

Khi đó agent đọc khoảng mười mục ngắn mỗi lần tìm kiếm thay vì mọi khối của trang. Nếu agent của bạn trả lời câu hỏi địa phương, hãy trỏ Field Containing Data vào local_results trong một công cụ thứ hai.

Làm sao dùng cùng API đó trong một workflow thường?

Không dùng agent, hãy dùng node HTTP Request như một node thường với q cố định, ví dụ trong một workflow Schedule Trigger kiểm tra một từ khóa mỗi sáng. Sau đó thêm node Split Out với Field to Split Out đặt thành organic_results: nó biến danh sách thành một item cho mỗi kết quả, sẵn sàng cho node bảng tính hoặc cơ sở dữ liệu.

Mỗi lần chạy là một lần tìm kiếm cho mỗi từ khóa, nên 50 từ khóa mỗi ngày dùng khoảng 1.500 credit mỗi tháng. Pack 25.000 tìm kiếm (18,75 US$) đủ cho mức đó hơn mười lần, và Credit tìm kiếm trả trước không bao giờ hết hạn: các lượt tìm kiếm chưa dùng vẫn nằm trong tài khoản của bạn cho đến khi bạn dùng.

Làm sao thử request ngoài n8n?

Chạy cùng request đó trong terminal. Nếu chạy được ở đó, mọi vấn đề trong n8n đến từ cài đặt node; nếu lỗi, phần thân lỗi nêu rõ nguyên nhân, như liệt kê trên trang lỗi. Lỗi không bao giờ bị tính phí.

# The request the HTTP Request node sends, for a test in a terminal
curl -sG "https://serpcrypto.com/api/v1/search" \
  -H "Authorization: Bearer $SERPCRYPTO_API_KEY" \
  --data-urlencode "q=n8n self-hosted vs cloud" -d gl=us -d hl=en \
  | jq '.organic_results[]? | {title, link, snippet}'