# WebReaderAPI로 n8n AI 에이전트에서 웹페이지 읽기

> n8n AI 에이전트에서 웹페이지 읽기: 어떤 URL이든 깔끔한 Markdown으로 변환하는 HTTP Request 도구 설정과 예약 워크플로우입니다. KYC 없이, 암호화폐로 결제하세요.

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

n8n의 HTTP Request 노드는 AI Agent 노드의 도구로 사용할 수 있습니다. `/read`을 가리키게 하고 모델이 URL을 채우도록 하면, 에이전트가 커뮤니티 노드를 설치하지 않고도 모든 공개 페이지를 깔끔한 Markdown으로 읽을 수 있습니다.

**빠른 답변 — n8n AI 에이전트가 웹페이지를 읽게 하려면 어떻게 하나요?**

n8n의 AI Agent에 HTTP Request 노드를 도구로 연결하고, **WebReaderAPI** 키를 담은 Header Auth credential과 함께 `GET https://webreaderapi.com/api/v1/read`로 설정한 뒤, 모델이 `url` 파라미터를 정의하도록 하세요. Optimize Response를 켜서 `title`, `final_url`, `markdown`만 유지하세요. 페이지당 1 크레딧이며, 2026년 10월 기준 US$0.07/1K 페이지부터 시작합니다. KYC 없이, 암호화폐로 결제하세요.

## 어떤 HTTP Request 설정을 사용하나요?

옵션 이름은 2026-10-22에 확인한 n8n의 HTTP Request 노드 문서를 따릅니다.

| 설정 | 값 |
| --- | --- |
| 위치 | **AI Agent** 노드에 도구로 연결 |
| Method | `GET` |
| URL | `https://webreaderapi.com/api/v1/read` |
| 인증 | Generic credentials → **Header Auth** |
| Header Auth credential | Name `Authorization`, Value에 `Bearer `과 함께 API 키 입력 |
| Send Query Parameters | 켜기, **Using Fields Below** |
| Parameter `url` | 모델이 정의(아래 참조) |
| Parameter `max_chars` | `15000`과 같은 고정 값 |
| Optimize Response | 켜기 · response type **JSON** · Include Fields **Selected**: `title`, `final_url`, `markdown` |

## HTTP Request 노드를 도구로 사용하는 이유는 무엇인가요?

이 API에 필요한 모든 것을 이미 처리하기 때문입니다: GET 요청 하나, 헤더 하나, 쿼리 파라미터 두 개. n8n 문서에 따르면 HTTP Request 노드는 일반 노드로 실행되거나 AI 에이전트에 도구로 연결될 수 있으며, 일부 옵션은 도구 형태에서만 존재합니다.

설치하거나 업데이트할 것은 없고, 키는 워크플로우가 아니라 n8n의 credential 저장소에 보관됩니다. n8n에 전용 키를 부여하면 다른 스크립트와 별도로 사용량을 확인할 수 있고 해당 키만 해지할 수 있습니다. 여러 API 키를 만들 수 있습니다. 예를 들어 에이전트나 프로젝트별로 하나씩 만들고, 대시보드에서 원하는 키를 폐기할 수 있습니다.

## 모델은 읽을 URL을 어떻게 선택하나요?

모델이 `url` 파라미터를 정의하도록 하세요. n8n은 입력 가능한 파라미터 필드 옆에 값을 모델에 넘기는 버튼을 표시하며, n8n의 `$fromAI()` 함수로 직접 표현식을 작성할 수도 있습니다. 이 함수는 키, 설명, 유형, 그리고 선택적 기본값을 받습니다. 예를 들어 키 `url`, 설명 "The http or https address of the page to read", 유형 `string`입니다.

n8n 문서에 따르면 `$fromAI()`는 AI Agent 노드에 연결된 도구에서만 작동합니다. 도구 설명도 "Reads a public web page and returns its main content as Markdown"처럼 평이한 말로 작성하여 에이전트가 언제 호출할지 알 수 있게 하세요.

## Optimize Response를 켜는 이유는 무엇인가요?

도구가 반환하는 모든 것이 모델의 컨텍스트로 들어가기 때문입니다. Optimize Response는 모델에 전달되는 데이터를 줄이는 도구 전용 옵션입니다. JSON response type을 사용하면 선택한 필드만 포함할 수 있습니다. `title`, `final_url`, `markdown`만 유지하고 나머지는 버리세요.

API 측에서 `max_chars`으로 길이를 제한하면 Markdown이 API를 떠나기 전에 잘립니다. 노드의 HTML 및 Text response type에는 각자의 Truncate Response 옵션이 있지만, JSON 응답에서는 `max_chars`가 더 간단한 제어 방법입니다.

## 예약 워크플로우에서 API를 어떻게 사용하나요?

HTTP Request 노드를 도구가 아닌 일반 노드로 Schedule Trigger 뒤에 사용하세요. 팔로우하는 변경 로그나 가격 페이지처럼 고정된 `url`을 지정하고, `markdown` 필드를 다음 노드로 보내세요: 파일, 데이터베이스, 채팅 메시지 또는 이전 실행과의 비교 등입니다.

각 실행은 URL당 한 페이지를 읽습니다. 하루 한 번 20개 페이지를 모니터링하면 브라우저가 없는 페이지 기준 월 약 600 크레딧을 사용하므로, 10,000페이지(US$3.75)은 1년 이상 사용할 수 있습니다. 선불 크레딧은 만료되지 않습니다. 사용하지 않은 페이지는 사용할 때까지 계정에 남아 있습니다.

## 사이트가 읽기를 거부하면 어떻게 되나요?

노드가 `blocked_by_robots` 또는 `target_refused`과 같은 코드의 오류 응답을 받으면 아무것도 청구되지 않습니다. 우리는 robots.txt를 준수합니다. 크롤러는 WebReaderAPI로 자신을 식별하고, 자신 또는 모든 로봇을 위해 작성된 규칙을 따르며, 사이트가 허용하지 않은 페이지는 읽지 않습니다. 거부된 페이지는 과금되지 않습니다. 에이전트에서는 도구가 오류를 반환하도록 하여 모델이 이를 설명하거나 다른 출처를 시도할 수 있게 하고, 예약 워크플로우에서는 오류를 로그하는 분기로 라우팅하세요. [errors 페이지](https://webreaderapi.com/ko/docs/errors/)에 모든 코드가 나열되어 있습니다.

## 워크플로우를 만들기 전에 호출을 시도해 볼 수 있나요?

[curl 레시피](https://webreaderapi.com/ko/docs/curl/)에 나온 대로 터미널에서 동일한 호출을 실행해 보세요. 거기서는 되는데 n8n에서 실패한다면 원인은 노드 설정에 있습니다. 대부분 credential 값에 `Bearer ` 접두사가 빠졌거나 `url` 파라미터가 비어 있는 경우입니다.

## n8n: 자주 묻는 질문

### WebReaderAPI를 사용하려면 커뮤니티 노드가 필요한가요?

아니요. 내장 HTTP Request 노드만으로 충분합니다. AI Agent의 도구로 사용하거나, 어떤 워크플로우에서든 일반 노드로 사용할 수 있습니다.

### 에이전트가 JavaScript 페이지나 PDF를 읽을 수 있나요?

네. API가 브라우저가 필요한 시점을 스스로 판단하며(`render=auto`), PDF도 텍스트로 읽습니다. 렌더링된 페이지는 2 크레딧을 사용합니다. 최대 20 MB, 100페이지까지의 PDF 파일이 Markdown으로 변환되며, 시작된 10페이지 블록당 1 크레딧입니다.

### 에이전트가 너무 많은 페이지를 읽지 않게 하려면 어떻게 하나요?

에이전트의 system 메시지에 읽어도 되는 페이지 수를 명시하고 `max_chars`을 적당히 유지하세요. 읽기 한 번이 툴 호출 한 번이므로, 에이전트의 툴 호출에 설정한 제한이 페이지 수도 제한합니다.

### 크레딧은 어떻게 결제하나요?

BTC, USDT, USDC, ETH, SOL, LTC에서 US$25으로 충전한 뒤 팩을 구매하세요. WebReaderAPI는 신분증, 셀카, 회사 서류를 요구하지 않습니다.

## 출처

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

---

WebReaderAPI: WebReaderAPI는 AI 에이전트를 위한 웹 리더 API로, 모든 공개 웹페이지를 깔끔한 Markdown으로 변환하며 신분증 업로드 없이 암호화폐로 결제합니다. US$0.07/1K 페이지부터 시작하는 선불 크레딧은 만료되지 않으며, robots.txt를 준수합니다. KYC 없음 — 신분증도, 셀피도, 서류도 없습니다. 암호화폐로 결제하세요.