# HTTP Request 도구로 n8n AI 에이전트에 웹 검색 연결하기

> n8n AI 에이전트를 위한 웹 검색: HTTP Request 도구 설정, 모델이 채우는 검색 쿼리, Optimize Response로 에이전트가 페이지 텍스트와 함께 출처를 받습니다. KYC 없이, 암호화폐 결제.

- URL: https://llmwebsearch.com/ko/docs/n8n/
- 마지막 업데이트: 2026-10-22
- 발행자: LLMWebSearch (https://llmwebsearch.com)

n8n의 HTTP Request 노드는 AI Agent에 도구로 붙일 수 있습니다. `/search`을 가리키게 하고, 모델이 검색 쿼리를 작성하게 한 뒤, 응답을 제목, URL, 페이지 텍스트로 줄이세요. 커뮤니티 노드는 필요 없습니다.

**빠른 답변 — n8n AI 에이전트에 웹 검색 도구를 어떻게 주나요?**

HTTP Request 노드를 n8n의 AI Agent에 도구로 붙이고, **LLMWebSearch** 키를 담은 Header Auth credential로 `GET https://llmwebsearch.com/api/v1/search`으로 설정한 다음, 모델이 `q` 파라미터를 `$fromAI()`로 채우게 하세요. Optimize Response를 켜고 `title`, `url`, `content`을 유지하세요. 상위 3개 페이지를 읽는 검색은 크레딧 1개이며, 2026년 10월 기준 US$1.20/1K 검색부터 시작합니다. KYC 없이.

## 어떤 HTTP Request 설정을 쓰나요?

n8n의 HTTP Request 노드 문서에 적힌 그대로의 옵션 이름이며, 2026년 10월 22일에 확인했습니다.

| 설정 | 값 |
| --- | --- |
| 위치 | **AI Agent** 노드에 도구로 붙임 |
| 메서드 | `GET` |
| URL | `https://llmwebsearch.com/api/v1/search` |
| 인증 | Generic credential type → **Header Auth** |
| Header Auth credential | Name은 `Authorization`, value는 `Bearer ` 뒤에 키를 붙임 |
| Send Query Parameters | 켜짐, **Using Fields Below** |
| 파라미터 `q` | 모델이 `$fromAI()`로 채움 (아래 참조) |
| 파라미터 `max_results` | `5` |
| 파라미터 `read` | `3` |
| 파라미터 `max_chars` | `4000` |
| 응답 최적화 | 켜짐 · **JSON** · 데이터가 담긴 필드 `results` · 필드 포함 **선택**: `title`, `url`, `content` |

## 커스텀 노드 대신 HTTP Request 노드를 쓰는 이유는 무엇인가요?

헤더 하나와 검색 쿼리 파라미터 네 개가 붙은 GET 요청 하나면 API에 필요한 전부이기 때문입니다. n8n 문서에 따르면 HTTP Request 노드는 일반 노드로 실행하거나 AI 에이전트에 도구로 연결할 수 있으며, 일부 옵션은 도구 형태에서만 제공됩니다.

저희 쪽에서 설치하거나 업데이트할 것은 없고, API 키는 워크플로가 아니라 n8n의 credential 저장소에 남습니다. n8n에는 전용 키를 따로 발급하세요. 에이전트, 앱, 팀원별로 API 키를 하나씩 만들고, 다른 키는 건드리지 않고 대시보드에서 각각 폐기하세요.

## 모델은 검색 쿼리를 어떻게 작성하나요?

n8n의 `$fromAI()` 함수를 `q` 필드 값 안에서 사용합니다. 문서화된 형식은 `$fromAI(key, description, type, defaultValue)`입니다. 키 `query`, "What to search for on the web" 같은 설명, 타입 `string`을 사용하세요. n8n은 `$fromAI()`이 AI Agent 노드에 연결된 도구에서만 동작한다고 안내합니다.

도구 자체도 평문으로 설명하세요. 예를 들어 "웹을 검색해 페이지 텍스트와 함께 소스를 반환합니다. URL을 인용하세요"처럼요. 에이전트는 이 텍스트를 보고 언제 검색할지 판단합니다.

## 응답 최적화를 켜는 이유는 무엇인가요?

도구가 반환하는 모든 내용이 모델의 컨텍스트에 들어가기 때문입니다. 응답 최적화는 모델로 전달되는 양을 줄이는 도구 전용 옵션입니다. JSON 타입에서는 데이터가 담긴 필드를 `results`로 설정한 다음 `title`, `url`, `content`만 포함하세요.

그러면 에이전트는 텍스트와 함께 짧은 소스 목록만 보고, 그 외에는 아무것도 보지 않습니다. API를 떠나기 전에 각 페이지를 잘라내는 `max_chars`로 저희 쪽에서 길이를 제한하세요.

## 에이전트 없이 정해진 일정에 검색을 실행할 수 있나요?

네. HTTP Request 노드를 Schedule Trigger 뒤의 일반 노드로 사용하고 검색 쿼리를 고정하세요. `topic=news`과 `time_range=day`을 추가해 특정 주제의 그날 기사를 모은 다음 제목과 URL을 채팅, 시트 또는 이메일로 보내면 됩니다.

하루 한 번 예약된 뉴스 검색은 한 달에 약 30크레딧을 사용하므로, 검색 5,000회(US$9.25)이면 여러 주제를 오랫동안 커버할 수 있습니다. 검색 크레딧에는 만료일이 없습니다. 이번 달에 사용하지 않은 크레딧은 내년에도 그대로 남아 있습니다.

## 페이지가 거부되면 워크플로는 무엇을 받나요?

검색은 여전히 성공합니다. 거부된 결과는 제목과 URL을 유지하지만 `content`이 없고, `content_status`에 `blocked_by_robots` 같은 사유가 표시됩니다. 저희 리더는 robots.txt를 준수합니다. 자신을 LLMWebSearch로 소개하고, 사이트가 리더를 위해 또는 모든 로봇을 위해 작성한 규칙을 따르며, 읽기가 허용되지 않은 페이지의 콘텐츠는 제외합니다.

HTTP 오류는 다릅니다. 키가 잘못되면 `401`, 잔액이 비면 `402`, 호출이 너무 많으면 `429`을 반환합니다. 에이전트에서는 도구가 오류를 다시 넘기게 해서 모델이 설명할 수 있게 하세요. 예약된 워크플로에서는 오류를 로그로 남기는 분기로 보내세요. [오류 페이지](https://llmwebsearch.com/ko/docs/errors/)에 모든 코드가 나와 있습니다.

## 워크플로를 만들기 전에 호출을 어떻게 테스트하나요?

[curl 레시피](https://llmwebsearch.com/ko/docs/curl/)에서 같은 요청을 curl로 실행해 보세요. 터미널에서는 되는데 n8n에서 실패한다면 원인은 노드 설정에 있습니다. 흔한 원인은 `Bearer ` 접두사가 빠진 credential 값이거나 빈 `q` 필드입니다.

## n8n: 자주 묻는 질문

### LLMWebSearch 커뮤니티 노드가 있나요?

아니요, 필요하지도 않습니다. 기본 제공되는 HTTP Request 노드가 AI Agent용 도구로도, 어떤 워크플로의 일반 노드로도 제 역할을 합니다.

### 요청을 JSON 본문과 함께 POST로 보낼 수 있나요?

네. Send Body를 켜고 JSON 콘텐츠 타입을 선택한 뒤 GET 파라미터와 같은 이름을 사용하세요. `include_domains` 같은 목록을 추가할 때는 POST가 더 편합니다.

### 에이전트가 실행하는 검색 횟수를 어떻게 제한하나요?

에이전트의 시스템 메시지에 "질문당 검색 두 번" 같은 제한을 적고, 각 검색이 1크레딧으로 유지되도록 `read`을 3 이하로 두세요.

### 결제는 어떻게 하나요?

BTC, USDT, USDC, ETH, SOL, LTC에서 US$25으로 충전한 다음 잔액으로 팩을 구매하세요. LLMWebSearch에는 신분증, 셀피, 서류가 필요하지 않습니다.

## 출처

1. [HTTP Request 노드](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.httprequest/) — n8n docs (read 2026-10-22)
2. [HTTP Request credential](https://docs.n8n.io/integrations/builtin/credentials/httprequest/) — n8n docs (read 2026-10-22)
3. [$fromAI()로 AI가 도구 파라미터를 지정하게 하기](https://docs.n8n.io/advanced-ai/examples/using-the-fromai-function/) — n8n docs (read 2026-10-22)

---

LLMWebSearch: LLMWebSearch는 AI 에이전트를 위한 웹 검색 API로, 순위가 매겨진 결과와 함께 상위 페이지의 본문을 Markdown으로 반환하며, 신분증 업로드 없이 암호화폐로 결제합니다. US$1.20/1K 검색부터 시작하는 선불 크레딧은 만료되지 않습니다. KYC 없이 — 신분증도, 셀피도, 서류도 필요 없습니다. 암호화폐로 결제하세요.
