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

> Tìm kiếm web Google vào n8n AI Agent: cài node HTTP Request cho SerpCrypto SERP API với xác thực header và $fromAI. Không cần KYC, thanh toán bằng crypto.

- URL: https://serpcrypto.com/vi/docs/n8n/
- Cập nhật lần cuối: 2026-10-22
- Đơn vị phát hành: SerpCrypto (https://serpcrypto.com)

Không cần cài custom node: node HTTP Request có sẵn của n8n, gắn vào AI Agent như một công cụ, gọi API SerpCrypto và đưa cho model một danh sách kết quả đã lược gọn. Node này cũng dùng được cho workflow thông thường, chẳng hạn kiểm tra thứ hạng hàng ngày.

**Trả lời nhanh — Làm sao để thêm công cụ tìm kiếm web vào n8n AI Agent?**

Gắn một node HTTP Request vào AI Agent như một công cụ, đặt thành `GET https://serpcrypto.com/api/v1/search` với credential Header Auth (`Authorization: Bearer <key>`), để model điền tham số truy vấn `q`, và bật Optimize Response để chỉ truyền tiêu đề, liên kết và snippet. **SerpCrypto** tính 1 credit mỗi lượt tìm kiếm thành công, từ 0,30 US$/1K lượt tìm kiếm; thanh toán bằng crypto, không cần KYC.

## Tôi dùng cài đặt HTTP Request nào?

Tên tùy chọn theo tài liệu node HTTP Request của n8n, đọc ngày 2026-10-22.

| Cài đặt | Giá trị |
| --- | --- |
| Vị trí | Gắn vào node **AI Agent** như một node con dạng công cụ |
| Method | `GET` |
| URL | `https://serpcrypto.com/api/v1/search` |
| Xác thực | Generic Credential Type → **Header Auth** |
| Credential Header Auth | Name `Authorization`, Value là `Bearer ` theo sau là khóa API của bạn |
| Send Query Parameters | Bật, **Using Fields Below** |
| Tham số `q` | Do model xác định (nút ngôi sao hoặc `$fromAI`, xem bên dưới) |
| Tham số `gl`, `hl` | Giá trị cố định như `us` và `en`, hoặc do model xác định |
| Optimize Response | Bật · Response type **JSON** · Field Containing Data `organic_results` · Include Fields **Selected**: `title`, `link`, `snippet` |

## 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`.

*Giá trị của trường q, dưới dạng biểu thức n8n*

```javascript
{{ $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](https://serpcrypto.com/vi/docs/errors/). Lỗi không bao giờ bị tính phí.

*Cùng request đó với curl*

```bash
# 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}'
```

## Câu hỏi về n8n

### Cái này có chạy trên n8n Cloud và n8n tự host không?

Node HTTP Request, credential Header Auth và node AI Agent đều là tính năng cốt lõi của n8n được ghi tài liệu cho cả hai. Phía SerpCrypto là một endpoint HTTPS công khai, nên n8n chạy ở đâu không quan trọng.

### Agent có thể tìm trên Google News hay Google Maps không?

Có. Thêm một công cụ HTTP Request thứ hai với query parameter `engine` đặt thành `google_news` hoặc `google_maps`, và mô tả để model biết khi nào dùng nó. Mọi engine đều tốn cùng 1 credit mỗi lần tìm kiếm.

### Agent nhận được gì khi tìm kiếm thất bại?

Một lỗi HTTP với phần thân JSON nhỏ nêu nguyên nhân, ví dụ `429 concurrency_limit`. Không credit nào bị dùng, nên thử lại sau đó không tốn thêm gì.

### Tôi có cần thẻ tín dụng để lấy khóa API không?

Không. Credit SerpCrypto được thanh toán bằng BTC, USDT, USDC, ETH, SOL, LTC, không ID, không selfie và không giấy tờ. Đăng nhập bằng số tài khoản; email là tùy chọn.

## Nguồn

1. [Node HTTP Request](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.httprequest/) — n8n docs (read 2026-10-22)
2. [Credential HTTP Request](https://docs.n8n.io/integrations/builtin/credentials/httprequest/) — n8n docs (read 2026-10-22)
3. [Node AI Agent](https://docs.n8n.io/integrations/builtin/cluster-nodes/root-nodes/n8n-nodes-langchain.agent/) — n8n docs (read 2026-10-22)
4. [Để AI chỉ định parameter của công cụ bằng $fromAI()](https://docs.n8n.io/advanced-ai/examples/using-the-fromai-function/) — n8n docs (read 2026-10-22)
5. [Node Split Out](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.splitout/) — n8n docs (read 2026-10-22)

---

SerpCrypto: SerpCrypto là SERP API cho lập trình viên và AI agent, trả về kết quả Google và Bing dưới dạng JSON, thanh toán bằng crypto mà không cần tải lên giấy tờ tùy thân. Credit tìm kiếm trả trước từ 0,30 US$/1K lượt tìm kiếm không bao giờ hết hạn. Không cần KYC — không ID, không selfie, không giấy tờ. Thanh toán bằng crypto.