# 웹 리더 API란? URL을 넣으면 읽을 수 있는 Markdown이 나옵니다

> 웹 리더 API가 하는 일: URL을 넣으면 페이지의 본문이 LLM이 쓸 수 있는 깔끔한 Markdown으로 나옵니다. 스크래핑 및 검색 API와 어떻게 다른지 설명합니다.

- URL: https://webreaderapi.com/ko/guides/what-is-a-web-reader-api/
- 마지막 업데이트: 2026-10-22
- 발행자: WebReaderAPI (https://webreaderapi.com)

웹 리더 API는 사람의 눈을 위해 만들어진 페이지를 모델이 쓸 수 있는 텍스트로 바꿉니다. 이 가이드는 무엇을 단계별로 하는지, 스크래핑 및 검색 API 옆에서 어떤 위치를 차지하는지, 시장에서 가격이 어떻게 책정되는지 설명합니다.

**빠른 답변 — 웹 리더 API란 무엇인가요?**

웹 리더 API는 URL을 받아 페이지를 로드하고, 제목, 저자, 날짜 같은 메타데이터와 함께 본문을 깔끔한 텍스트, 보통 Markdown으로 반환하는 서비스입니다. AI 에이전트와 RAG 파이프라인은 raw HTML 대신 이것을 사용합니다. **WebReaderAPI**가 그중 하나입니다: 페이지당 1 크레딧, 2026년 10월 기준 US$0.07/1K 페이지부터 시작하며, robots.txt를 준수하고, KYC 없이 암호화폐로 결제합니다.

## 한 표로 보는 웹 리더 API

| 속성 | 값 |
| --- | --- |
| 입력 | 공개 웹페이지 또는 PDF의 URL |
| 출력 | 본문의 Markdown 또는 일반 텍스트, 그리고 제목, 저자, 날짜, 언어 |
| 제거됨 | 내비게이션, 쿠키 배너, 광고, 사이드바, 푸터, 스크립트, 스타일 |
| JavaScript 페이지 | raw HTML에 텍스트가 너무 적을 때 헤드리스 브라우저에서 렌더링 |
| 일반적인 과금 | 페이지당 또는 크레딧당; 일부 제공업체는 출력 토큰당 과금 |
| 요청 예시 | `GET https://webreaderapi.com/api/v1/read?url=https://example.com/post` |

## 웹 리더 API는 단계별로 무엇을 하나요?

모든 페이지-텍스트 파이프라인에 필요한 다섯 가지 작업을 한 번의 호출로 처리합니다:

1. **권한 확인.** 신중한 리더는 아무것도 가져오기 전에 사이트의 robots.txt에서 자기 이름과 모든 로봇에 대한 항목을 확인합니다.
2. **페이지 가져오기.** HTML을 다운로드하고, 리다이렉트를 따르며, 타임아웃 시 중단합니다.
3. **필요할 때 렌더링.** HTML이 JavaScript로 채워지는 빈 껍데기라면, 헤드리스 브라우저에서 페이지를 로드하고 결과를 읽습니다.
4. **본문 추출.** readability 스타일의 단계가 기사나 문서 본문을 찾아내고 주변의 페이지 장식은 버립니다.
5. **변환 및 설명.** 콘텐츠를 Markdown으로 작성하고 제목, 저자, 발행일, 언어, 단어 수 같은 메타데이터를 추가합니다.

호출자는 Markdown이 담긴 JSON 객체 하나를 받습니다. 모델이 즉시 읽을 수도 있고, 파이프라인이 벡터 스토어용으로 청크로 나눌 수도 있습니다.

## 왜 모델은 HTML 대신 Markdown을 필요로 하나요?

HTML 페이지의 대부분은 콘텐츠가 아니기 때문입니다. 메뉴, script 태그, 추적 코드, 레이아웃 마크업은 모델이 읽어야 하고 당신이 비용을 지불해야 하는 토큰을 사용합니다. Markdown은 의미를 담은 부분만 유지합니다: 제목, 목록, 표, 링크, 강조.

Cloudflare는 2026년 2월 12일 "Markdown for Agents" 기능을 출시할 때 구체적인 예를 들었습니다: 한 페이지가 HTML일 때 16,180 토큰에서 Markdown일 때 3,150 토큰으로 줄어 약 80% 감소했습니다. 결과는 페이지마다 다르지만, 대부분의 기사와 문서 페이지에서 방향은 같습니다.

## 웹 리더 API는 스크래핑 API와 어떻게 다른가요?

스크래핑 API는 서버가 보낸 것을 반환하고, 리더는 사람이 읽을 것을 반환합니다. 스크래핑 API는 대규모로 페이지를 가져오도록 만들어졌고, 종종 가격이나 제품명 같은 특정 필드를 뽑아내며, 보통 raw HTML이나 직접 정의한 구조화된 JSON을 돌려줍니다.

웹 리더는 더 좁고 주관적입니다. 무엇이 본문인지 스스로 판단하고, 나머지를 제거하고, 깔끔한 텍스트를 작성합니다. 다음 소비자가 언어 모델, 검색 인덱스, 또는 요약을 읽는 사람일 때 맞는 도구입니다. 제품 그리드의 모든 필드가 필요할 때는 틀린 도구입니다. 그때는 전체 HTML이나 스키마 기반 추출이 필요합니다.

## 검색 API와는 어떻게 다른가요?

검색 API는 "어떤 페이지가 이것에 대해 이야기하나?"에 답하고, 리더는 "이 페이지는 무엇을 말하나?"에 답합니다. 검색은 검색 쿼리에 대한 제목과 스니펫이 담긴 URL 목록을 반환합니다. 리더는 그 URL 중 하나를 받아 전체 텍스트를 반환합니다.

에이전트는 종종 둘을 연결합니다: 검색으로 후보 페이지를 찾고, 가장 좋은 세 개에서 네 개를 읽어 인용과 함께 답합니다. 단계를 분리해 두면 읽을 페이지 수를 선택할 수 있어 토큰과 크레딧을 절약합니다.

## API 대신 오픈소스 도구를 쓸 수 있나요?

네, 그리고 많은 팀이 그렇게 시작합니다. Mozilla의 Readability는 브라우저 컨텍스트에서 페이지의 본문을 추출하고; Trafilatura는 Python에서 추출합니다; Microsoft의 MarkItDown은 PDF를 포함한 문서를 Markdown으로 변환하고; Crawl4AI는 크롤링과 Markdown 출력을 결합합니다.

라이브러리는 쉬운 부분입니다. 프로덕션에서 운영하려면 JavaScript 페이지를 위한 헤드리스 브라우저 호스팅, robots.txt 확인, 타임아웃, 리다이렉트, 문자 집합 처리, PDF 변환, 그리고 이 모든 것을 패치된 상태로 유지하는 일이 필요합니다. 그 기계를 운영하는 대신 페이지당 비용을 지불하고 싶을 때는 API가 가치 있고, 볼륨이 일정하고 운영할 시간이 있을 때는 라이브러리가 가치 있습니다.

## 웹 리더 API는 어떻게 과금하나요?

2026년에는 세 가지 과금 모델이 일반적입니다. 크레딧 기반 요금제는 페이지당 정해진 크레딧을 청구합니다: Firecrawl의 가격 페이지는 2026년 10월 22일 기준으로 스크래핑한 페이지당 1 크레딧, JSON 형식의 경우 페이지당 4 크레딧 추가로 계산합니다. 토큰 기반 과금은 반환된 텍스트에 대해 청구합니다: Jina Reader는 2025년 5월 6일부터 이 방식으로 가격을 책정하며 새 키마다 1,000만 무료 토큰을 제공합니다. 월간 요금제는 매 주기마다 크레딧이 초기화되지만, 선결제 팩은 크레딧을 유지합니다.

WebReaderAPI는 만료되지 않는 선결제 크레딧을 사용합니다: 1 크레딧 = 브라우저 없이 페이지 1회 읽기, 페이지가 JavaScript를 렌더링하는 데 브라우저가 필요하면 2 크레딧. 실패한 요청이나 사이트의 robots.txt가 거부한 요청은 과금되지 않습니다. 10,000페이지은 US$3.75이고 5,000,000페이지에서 요율이 US$0.07/1K 페이지로 낮아집니다 (2026년 10월 기준).

## 웹 리더 API를 고르기 전에 무엇을 확인해야 하나요?

자신의 URL 스무 개로 테스트하고 여섯 가지를 살펴보세요:

- **추출 품질.** Markdown이 기사는 유지하고 나머지, 즉 표와 코드 블록까지 포함해 나머지를 버리나요?
- **JavaScript.** 브라우저에서 만들어지는 페이지가 텍스트와 함께 돌아오나요, 렌더링 비용은 얼마인가요?
- **PDF.** 지원하나요, 페이지는 어떻게 계산되나요?
- **사이트 소유자의 선택.** 서비스가 robots.txt와 선언된 AI 선호를 준수하고, 문서에 그렇게 명시하나요?
- **실패.** 실패한 페이지와 거부된 페이지에 요금이 부과되나요?
- **예산 통제.** 각 페이지의 길이를 제한할 수 있나요, 크레딧이 만료되나요?

저희 [웹 리더 API 가격 비교](https://webreaderapi.com/ko/compare/web-reader-api-pricing/)는 주요 제공업체를 날짜와 함께 나란히 보여줍니다.

## 웹 리더 API: 자주 묻는 질문

### 웹 리더 API는 브라우저의 리더 모드와 같은 건가요?

같은 아이디어를 따릅니다. 기사는 유지하고 잡동사니는 버리지만, 서버에서 실행되고, Markdown과 메타데이터를 JSON으로 반환하며, 수천 개의 URL에서 작동합니다. 리더 모드는 한 사람이 한 페이지를 읽기 위한 것입니다.

### 웹 리더 API는 어떤 웹사이트든 읽을 수 있나요?

아니요. 허용된 공개 페이지만 읽습니다. 신중한 서비스는 robots.txt에서 차단한 페이지를 건너뛰고, 사이트가 거부하면 사이트의 답변을 반환합니다. 로그인이나 유료 결제 뒤에 있는 페이지는 설계상 접근할 수 없습니다.

### 웹 리더는 이미지를 보관하나요?

보통은 기본적으로 보관하지 않습니다. 모델에는 대부분 텍스트만 필요하기 때문입니다. WebReaderAPI을 사용하면 `include_images=true`이 이미지를 alt 텍스트와 함께 Markdown 이미지 링크로 보관합니다.

### 페이지를 읽는 데 얼마나 걸리나요?

사이트에 따라, 그리고 페이지가 브라우저를 필요로 하는지에 따라 다릅니다. 공개 샘플로 측정하기 전까지는 응답 시간을 공개하지 않습니다. 타임아웃은 최대 60초인 `timeout` 파라미터를 기준으로 설정하세요.

### WebReaderAPI을 쓰려면 ID가 있는 계정이 필요한가요?

아니요. WebReaderAPI은 ID도, 셀피도, 서류도 요구하지 않습니다. 로그인은 계정 번호이고, 결제는 BTC, USDT, USDC, ETH, SOL, LTC로 합니다.

## 출처

1. [Markdown for Agents 소개](https://blog.cloudflare.com/markdown-for-agents/) — Cloudflare (2026-02-12)
2. [Firecrawl 가격](https://www.firecrawl.dev/pricing) — Firecrawl (read 2026-10-22)
3. [리더 API](https://jina.ai/reader/) — Jina AI (Elastic) (read 2026-10-22)

---

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