# 웹 페이지 to Markdown API: 모델이 바로 쓸 수 있는, 어떤 URL의 본문 추출

> LLM과 AI 에이전트를 위한 웹 페이지 to Markdown API: 어떤 URL이든 제목, 저자, 날짜를 포함한 깔끔한 Markdown으로, US$0.07/1K 페이지부터. KYC 없이, 암호화폐.

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

URL을 전달하면 기사를 Markdown으로 돌려받습니다. 제목, 문단, 목록, 표, 링크는 유지하고 메뉴, 쿠키 배너, 광고, 푸터는 제거합니다. 페이지의 제목, 저자, 날짜, 언어도 함께 제공합니다.

**빠른 답변 — LLM을 위해 웹페이지를 깔끔한 Markdown으로 변환하는 API는 무엇인가요?**

웹 페이지 to Markdown API는 페이지를 가져와 본문을 유지한 채 Markdown으로 반환합니다. **WebReaderAPI**은(는) 한 번의 요청으로 처리합니다. `GET https://webreaderapi.com/api/v1/read?url=…`은(는) 제목, 목록, 표, 링크와 함께 제목, 저자, 날짜, 단어 수를 포함한 기사를 반환하며, 2026년 10월 기준 US$0.07/1K 페이지부터 페이지당 1크레딧입니다. robots.txt를 준수합니다. KYC 없이, 암호화폐로 결제.

## 한눈에 보는 URL to Markdown API

| 속성 | 값 |
| --- | --- |
| 엔드포인트 | `GET https://webreaderapi.com/api/v1/read?url=…` (또는 JSON 바디를 쓰는 `POST`) |
| 출력 | 페이지 본문의 깔끔한 Markdown (또는 일반 텍스트, 또는 정리된 HTML)과 함께 제목, 설명, 작성자, 게시 날짜, 언어, 단어 수를 제공하며, 링크와 이미지는 요청 시 제공합니다 |
| JavaScript | 페이지에 필요할 때 헤드리스 브라우저에서 JavaScript 렌더링 (render=auto), 또는 항상, 또는 절대 하지 않습니다 |
| 과금 | 1 크레딧 = 브라우저 없이 페이지 1회 읽기, 페이지가 JavaScript를 렌더링하는 데 브라우저가 필요하면 2 크레딧. 실패한 요청이나 사이트의 robots.txt가 거부한 요청은 과금되지 않습니다 |
| 토큰 예산 | `max_chars`은(는) 모델이 감당할 수 있는 길이로 Markdown을 줄입니다 |
| robots.txt | 우리는 robots.txt를 준수합니다. 크롤러는 WebReaderAPI로 자신을 식별하고, 자신 또는 모든 로봇을 위해 작성된 규칙을 따르며, 사이트가 허용하지 않은 페이지는 읽지 않습니다. 거부된 페이지는 과금되지 않습니다 |
| 가격 | US$3.75은(는) 10,000페이지, US$21.75은(는) 100,000페이지, US$0.07/1K 페이지부터 5,000,000페이지에 |
| 결제 | BTC, USDT, USDC, ETH, SOL, LTC, US$25 충전부터; KYC 없이 |

## 웹페이지를 모델에 넘기기 전에 왜 Markdown으로 변환해야 하나요?

Markdown은 모델에 필요한 구조를 유지하고 필요 없는 마크업은 걷어냅니다. 일반적인 글 페이지는 본문 몇백 단어를 둘러싸고 내비게이션, 스크립트, 추적 태그, 쿠키 안내, 관련 글 위젯이 붙어 있습니다. 원본 HTML로 보내면 지불하는 토큰의 대부분이 마크업에 쓰입니다.

Markdown은 제목을 `#`로, 목록을 `-`로, 표를 파이프로, 링크를 `[text](url)`으로 유지합니다. 모델은 어떤 문장이 어느 섹션에 속하는지 보고, 출처 링크를 인용하고, 제목 기준으로 텍스트를 청크로 나눌 수 있습니다. 같은 텍스트를 평범한 산문으로 두면 이 구조가 사라지고, HTML로 두면 토큰이 훨씬 더 듭니다.

## API는 무엇을 유지하고 무엇을 제거하나요?

기본값인 `main_content=true`에서는 API가 독자가 보려던 페이지 부분을 남기고 나머지를 제거합니다.

| 유지 | 제거 |
|---|---|
| 제목과 소제목 | 사이트 내비게이션과 메뉴 |
| 문단, 인용, 목록 | 쿠키 및 동의 배너 |
| 표(Markdown 표로) | 광고 및 프로모션 위젯 |
| 코드 블록(표시된 경우 언어 포함) | 사이드바 및 관련 글 목록 |
| 본문 안의 링크 | 푸터 및 법적 고지 |
| 이미지(`include_images=true`일 때만) | 공유 버튼 및 댓글 양식 |

페이지 전체를 변환하려면 `main_content=false`를 설정하세요. 예를 들어 홈페이지나 모든 요소가 중요한 상품 목록이 그렇습니다. Markdown 없는 일반 텍스트는 `format=text`, 본문의 정리된 HTML은 `format=html`로 설정하세요.

*curl: 한 페이지를 Markdown으로, 20,000자로 자르기*

```bash
curl -G "https://webreaderapi.com/api/v1/read" \
  -H "Authorization: Bearer $WEBREADER_API_KEY" \
  --data-urlencode "url=https://example.com/blog/pour-over-coffee" \
  -d format=markdown -d max_chars=20000
```

*Python: 페이지를 읽고 메타데이터와 Markdown 출력하기*

```python
import os

import requests

resp = requests.get(
    "https://webreaderapi.com/api/v1/read",
    headers={"Authorization": "Bearer " + os.environ["WEBREADER_API_KEY"]},
    params={"url": "https://example.com/blog/pour-over-coffee", "format": "markdown"},
    timeout=90,
)
resp.raise_for_status()
page = resp.json()
print(page["title"], "|", page.get("author"), "|", page.get("published_at"))
print(page["word_count"], "words,", page["credits_used"], "credit(s)")
print(page["markdown"][:500])

```

## JavaScript로 만든 페이지는 어떻게 하나요?

많은 페이지가 첫 HTML에 거의 텍스트를 담지 않고 브라우저에서 콘텐츠를 구성합니다. 기본값인 `render=auto`에서는 API가 먼저 원본 HTML을 읽고, 텍스트가 너무 적으면 헤드리스 브라우저에서 페이지를 열어 결과를 읽습니다. 응답의 `rendered` 필드가 어느 쪽이었는지 알려줍니다.

브라우저가 필요했던 페이지는 크레딧이 하나가 아니라 두 개 듭니다. 어떤 사이트가 항상 필요하다는 걸 안다면 `render=true`를 설정하세요. 서버가 보내는 것만 원한다면 `render=false`을 설정해 두 번째 크레딧을 절대 내지 않아도 됩니다.

## 사이트가 읽히기를 원하지 않으면 어떻게 되나요?

사이트의 선택을 존중하며 요금을 청구하지 않습니다. 저희 크롤러는 `WebReaderAPI`으로 자신을 밝히고 매 읽기 전에 robots.txt를 확인합니다. 저희 토큰에 대해, 또는 모든 로봇에 대해 허용되지 않은 페이지는 `403 blocked_by_robots`를 반환합니다. `Content-Signal: ai-input=no`를 선언한 사이트는 `403 blocked_by_site_policy`를 반환합니다.

403 상태, 챌린지 페이지, 로그인 장벽 등 다른 방식으로 사이트가 요청을 거부하면 사이트 자체의 상태와 함께 `502 target_refused`을 받습니다. 사이트가 우리 요청을 거부하면 그 응답을 그대로 반환합니다. 우리는 CAPTCHA를 풀거나, 계정에 로그인하거나, 차단이나 페이월을 우회하려 시도하지 않습니다. 저희 [크롤러 페이지](https://webreaderapi.com/ko/bot/)에서 사이트 소유자를 위해 정확한 User-Agent와 함께 이 모든 것을 설명합니다.

## 내 프로젝트에는 페이지가 몇 개나 필요할까요?

페이지당 크레딧 하나, 브라우저가 필요한 페이지는 두 개로 계산하세요. 몇 가지 일반적인 규모는 다음과 같습니다:

- **AI 에이전트**가 작업당 5페이지를 읽고 하루에 100개 작업을 실행하면 한 달에 약 15,000페이지를 읽습니다: 50,000페이지(US$14.25)이면 세 달 넘게 씁니다.
- 2,000페이지씩 있는 문서 사이트 세 개의 **RAG 인덱스**는 6,000페이지이고, 이후 매주 변경된 페이지를 갱신합니다.
- 뉴스와 블로그 글 400,000건의 **연구 코퍼스**는 500,000페이지(US$50)에 들어갑니다.

크레딧은 만료되지 않으므로, 일회성 크롤링을 위해 산 팩도 이후 작업에 남은 가치를 그대로 유지합니다.

## URL to Markdown API는 얼마인가요?

2026년 10월 기준으로 10,000페이지은 US$3.75, 100,000페이지는 US$21.75, 1,000,000페이지는 US$74.25입니다. 실패한 페이지와 robots.txt에서 거부된 페이지는 무료입니다. [모든 팩 보기](https://webreaderapi.com/ko/pricing/).

| 플랜 | 수량 | 가격 | 단가 |
| --- | --- | --- | --- |
| 테스트 | 10,000페이지 | US$3.75 | US$0.38/1K 페이지 |
| 스타터 | 50,000페이지 | US$14.25 | US$0.28/1K 페이지 |
| 구축 | 100,000페이지 | US$21.75 | US$0.22/1K 페이지 |
| 볼륨 | 1,000,000페이지 | US$74.25 | US$0.07/1K 페이지 |

모든 플랜에 포함: 본문 추출 · 필요 시 JavaScript 렌더링 · 실패 및 거부된 페이지는 과금되지 않음 · 크레딧은 만료되지 않음

**결제 전 확인 사항**

- 최소 충전 US$25. 암호화폐로 한 번 충전한 뒤 잔액으로 모든 플랜을 구매하세요.
- 잔액에는 만료 기한이 없으며 언제든지 페이지 크레딧을 구매할 수 있습니다. 팩 가격이 최소 충전 금액보다 낮은 경우, 최소 금액을 채우기 위해 추가로 충전한 금액에 한해 결제일로부터 30일 이내에 요청 시 USDT 또는 USDC로 돌려받을 수 있으며, 해당 금액을 사용하지 않은 경우에만 가능합니다. 그 외의 잔액은 법령에서 달리 정하지 않는 한 환불되지 않습니다.
- 블록체인에서 결제가 확인되면 잔액에 반영됩니다. 일반적인 네트워크 확인 시간: BTC ≈ 20분 · USDT TRC-20 ≈ 1분 · USDT ERC-20 ≈ 5분 · USDC ERC-20 ≈ 5분 · ETH ≈ 5분 · SOL ≈ 1분 · LTC ≈ 15분

## URL to Markdown API: 자주 묻는 질문

### Markdown에 표와 코드 블록이 유지되나요?

네. HTML 표는 Markdown 표가 되고, 코드 블록은 페이지가 언어를 표시한 경우 그 언어와 함께 펜스로 유지됩니다. 병합된 셀이 있는 표처럼 아주 복잡한 표는 행 단위로 평탄화됩니다.

### 본문 대신 페이지 전체를 받을 수 있나요?

네. `main_content=false`을 설정하면 API가 내비게이션과 푸터를 포함해 페이지의 모든 요소를 변환합니다. 본문 감지기가 유용한 부분을 버릴 홈페이지, 카테고리 페이지, 상품 목록에 적합합니다.

### 모델의 컨텍스트 윈도 안에 페이지를 어떻게 유지하나요?

`max_chars`에 1,000에서 500,000 사이의 값을 넣어 Markdown을 지정한 길이로 자르세요. `word_count` 필드가 전체 글의 길이를 알려주므로 에이전트가 더 읽을지 판단할 수 있습니다.

### 로그인이나 페이월 뒤의 페이지를 읽을 수 있나요?

아니요. WebReaderAPI은 공개 페이지만 읽습니다. 계정에 로그인하지 않고 페이월이나 차단을 우회하려고 시도하지도 않습니다. 그런 페이지는 사이트의 거부를 반환하며 요금을 청구하지 않습니다.

### 키를 받으려면 신분증이나 카드가 필요한가요?

아니요. WebReaderAPI은 신분증, 셀피, 회사 서류, 카드를 요구하지 않습니다. 계정 번호로 로그인, 이메일은 선택 사항. BTC, USDT, USDC, ETH, SOL, LTC로 US$25에서 충전합니다.

---

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