# URL to Markdown API 빠른 시작: 2분 만에 첫 페이지 읽기

> URL to Markdown API 빠른 시작: 키를 받고, curl, Python 또는 Node.js로 첫 페이지를 읽고, 크레딧을 확인하세요. US$0.07/1K 페이지부터, KYC 없이.

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

하나의 endpoint, 하나의 parameter: URL을 `/read`으로 보내면 페이지의 본문 추출 결과를 Markdown으로 돌려받습니다. 이 페이지는 잔액이 비어 있는 상태에서 작동하는 호출까지 안내하고, 그다음 다른 모든 내용을 알려줍니다.

**빠른 답변 — API로 URL을 Markdown으로 변환하려면 어떻게 하나요?**

URL을 `Authorization` header에 API 키와 함께 `GET https://webreaderapi.com/api/v1/read`으로 보내세요. **WebReaderAPI**은 페이지를 가져와 본문 추출 결과를 제목, 저자, 날짜, 단어 수와 함께 Markdown으로 반환합니다. 한 페이지에 크레딧 1개(브라우저가 필요하면 2개)가 들며, 2026년 10월 기준 US$0.07/1K 페이지부터입니다. KYC 없이; 암호화폐 결제.

## 한눈에 보는 API 표

| 속성 | 값 |
| --- | --- |
| Base URL | `https://webreaderapi.com/api/v1` |
| 페이지 하나 읽기 | `GET` 또는 `POST https://webreaderapi.com/api/v1/read` |
| 여러 URL 또는 사이트 하나 | `POST https://webreaderapi.com/api/v1/batch` 및 `POST https://webreaderapi.com/api/v1/crawl`, `GET https://webreaderapi.com/api/v1/jobs/{job_id}`부터 결과 |
| 남은 크레딧 | `GET https://webreaderapi.com/api/v1/credits` (무료) |
| 인증 | API 키를 Bearer 토큰으로 Authorization 헤더에 넣거나 api_key 쿼리 파라미터에 넣어 전송하세요 |
| 과금 | 1 크레딧 = 브라우저 없이 페이지 1회 읽기, 페이지가 JavaScript를 렌더링하는 데 브라우저가 필요하면 2 크레딧. 실패한 요청이나 사이트의 robots.txt가 거부한 요청은 과금되지 않습니다 |
| 저희 크롤러 | `WebReaderAPI/1.0 (+https://webreaderapi.com/bot/)`, robots.txt token `WebReaderAPI` |
| 가장 작은 팩 | US$3.75에 10,000페이지; 크레딧은 만료되지 않습니다 |

## API 키는 어떻게 받나요?

세 단계면 되고, 작성할 양식도 없습니다. 가장 오래 걸리는 단계는 충전금의 블록체인 컨펌입니다.

1. **암호화폐로 충전** — BTC, USDT, USDC, ETH, SOL, LTC로 최소 US$25을 보내세요. 계정 번호로 로그인, 이메일은 선택 사항.
2. **크레딧 팩 구매하기** — US$3.75에 대한 10,000페이지이면 본인의 URL로 모든 옵션을 직접 테스트하기에 충분합니다.
3. **키 복사** — 암호화폐 충전이 확인되고 팩을 구매하면 대시보드에서 API 키를 바로 사용할 수 있습니다. WEBREADER_API_KEY라는 이름의 환경 변수에 저장하세요.

## 첫 요청은 어떻게 생겼나요?

페이지 주소를 `url` 파라미터에 담아 보내는 일반 HTTPS GET입니다. 주소 자체에 `:`, `/` 문자가 들어 있으므로 인코딩해야 하는데, curl은 `--data-urlencode`을 쓰면 알아서 처리합니다. 기본 설정은 대부분의 아티클과 문서 페이지에 이미 맞춰져 있습니다: Markdown 출력, 본문만, 페이지가 필요로 할 때만 브라우저 사용.

*curl: 페이지 하나 읽기*

```bash
curl -sG "https://webreaderapi.com/api/v1/read" \
  -H "Authorization: Bearer $WEBREADER_API_KEY" \
  --data-urlencode "url=https://example.com/blog/first-post"
```

*Python: 페이지 하나 읽고 저장하기*

```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/first-post"},
    timeout=70,
)
resp.raise_for_status()
page = resp.json()
print(page["title"], "-", page["word_count"], "words,", page["credits_used"], "credit(s)")
with open("first-post.md", "w", encoding="utf-8") as f:
    f.write(page["markdown"])

```

*Node.js 18+: 페이지 하나 읽기*

```javascript
const params = new URLSearchParams({ url: 'https://example.com/blog/first-post' });
const res = await fetch(`https://webreaderapi.com/api/v1/read?${params}`, {
  headers: { Authorization: `Bearer ${process.env.WEBREADER_API_KEY}` },
});
const page = await res.json();
if (!res.ok) throw new Error(`${page.error.code}: ${page.error.message}`);
console.log(page.title, page.word_count, 'words');
console.log(page.markdown.slice(0, 500));

```

## 무엇이 반환되나요?

`markdown` 필드에 Markdown이, 그 옆에 페이지 메타데이터가 담긴 JSON 객체입니다: `title`, `description`, `author`, `published_at`, `language`, `site_name`, `word_count`. 무슨 일이 있었는지 확인하는 데 도움이 되는 필드가 두 개 있습니다: `final_url`는 리다이렉트 후의 주소이고, `rendered`은 브라우저가 필요했는지 알려줍니다.

`credits_used`은 호출 비용을 보여줍니다: 일반 페이지면 1, `rendered`가 `true`이면 2, `country`를 선택했다면 1이 더해집니다. [response format](https://webreaderapi.com/ko/docs/response/) 페이지에 모든 필드와 예시가 나와 있습니다.

## 어떤 옵션을 가장 많이 쓰게 되나요?

다섯 개 파라미터면 대부분의 요구를 커버합니다. 모두 선택 사항입니다.

| 파라미터 | 용도 |
|---|---|
| `format` | `markdown` 대신 `text` 또는 정리된 `html` 받기 |
| `main_content` | `false`을 설정해 메뉴까지 포함한 페이지 전체를 변환 |
| `render` | 브라우저를 강제(`true`)하거나 금지(`false`); `auto`이 결정 |
| `include_links` | 페이지의 링크를 별도 목록으로 받기 |
| `max_chars` | 긴 페이지를 모델의 컨텍스트 예산에 맞게 자르기 |

[read reference](https://webreaderapi.com/ko/docs/read/)에 `country`, `include_images`, `timeout`을 포함한 모든 파라미터가 설명되어 있습니다.

## 남은 크레딧은 어떻게 확인하나요?

같은 키로 `GET https://webreaderapi.com/api/v1/credits`를 호출하세요. `credits_remaining`, `credits_used_today`, `concurrency_limit`을 반환하며 비용은 들지 않습니다. 긴 작업을 시작할 때 실행하면 작업이 중간에 `402 insufficient_credits` 오류로 실패하는 대신 깔끔하게 멈출 수 있습니다.

선불 크레딧은 만료되지 않습니다. 사용하지 않은 페이지는 사용할 때까지 계정에 남아 있습니다이므로, 한 프로젝트를 위해 구매한 팩은 다음 프로젝트에서도 가치를 유지합니다.

## 사이트에서 robots를 허용하지 않으면 어떻게 되나요?

해당 페이지는 읽지 않으며, 요금도 청구되지 않습니다. 저희 크롤러는 `WebReaderAPI/1.0 (+https://webreaderapi.com/bot/)`으로 자신을 알리고 사이트의 robots.txt를 따릅니다. 허용되지 않은 페이지는 `403 blocked_by_robots`를 반환하고, 다른 방식으로 요청을 거부하는 사이트는 사이트 자체의 상태 코드와 함께 `502 target_refused`를 반환합니다.

사이트가 우리 요청을 거부하면 그 응답을 그대로 반환합니다. 우리는 CAPTCHA를 풀거나, 계정에 로그인하거나, 차단이나 페이월을 우회하려 시도하지 않습니다. [errors page](https://webreaderapi.com/ko/docs/errors/)에 어떤 오류를 재시도할 만하고 어떤 오류가 최종적인지 설명되어 있습니다.

## 다음은 어디로 가면 되나요?

- [엔드포인트 레퍼런스 읽기](https://webreaderapi.com/ko/docs/read/) — /read의 모든 파라미터와 예시
- [배치 및 크롤링](https://webreaderapi.com/ko/docs/crawl/) — 배치당 최대 100개 URL, 또는 사이트 전체
- [응답 형식](https://webreaderapi.com/ko/docs/response/) — 응답의 모든 필드
- [오류 및 robots.txt](https://webreaderapi.com/ko/docs/errors/) — 코드, 원인, 재시도 규칙
- [Python](https://webreaderapi.com/ko/docs/python/) — requests, async httpx, RAG 청킹
- [Node.js](https://webreaderapi.com/ko/docs/node/) — fetch, 작은 풀, 크롤 폴링
- [curl과 jq](https://webreaderapi.com/ko/docs/curl/) — 터미널용 레시피
- [MCP 서버](https://webreaderapi.com/ko/docs/mcp/) — Claude와 Cursor용 read_url 도구
- [LangChain 및 LlamaIndex](https://webreaderapi.com/ko/docs/langchain/) — RAG용 로더와 도구
- [OpenAI 함수 호출](https://webreaderapi.com/ko/docs/openai/) — read_url 도구 스키마와 루프
- [n8n](https://webreaderapi.com/ko/docs/n8n/) — AI Agent용 HTTP Request 도구
- [OpenClaw](https://webreaderapi.com/ko/docs/openclaw/) — web_fetch 옆에 MCP 서버 추가

## 빠른 시작: 자주 묻는 질문

### 설치할 SDK가 있나요?

없습니다. WebReaderAPI은 일반 HTTPS API라서 어떤 HTTP 클라이언트든 작동합니다. 문서에는 Python, Node.js, curl용 복사-붙여넣기 코드와 MCP, LangChain, LlamaIndex, OpenAI function calling용 도구 정의가 있습니다. 패키지로 배포되는 것은 없습니다.

### 헤더 대신 URL에 키를 넣어 보낼 수 있나요?

네, `api_key` 쿼리 파라미터로 가능합니다. `Authorization: Bearer` 헤더가 더 안전한데, URL은 흔히 로그와 브라우저 기록에 남기 때문입니다. 여러 API 키를 만들 수 있습니다. 예를 들어 에이전트나 프로젝트별로 하나씩 만들고, 대시보드에서 원하는 키를 폐기할 수 있습니다.

### 실패한 페이지도 크레딧을 쓰나요?

아니요. 1 크레딧 = 브라우저 없이 페이지 1회 읽기, 페이지가 JavaScript를 렌더링하는 데 브라우저가 필요하면 2 크레딧. 실패한 요청이나 사이트의 robots.txt가 거부한 요청은 과금되지 않습니다. 콘텐츠와 함께 반환된 페이지에만 요금이 청구됩니다.

### 구매 전에 사용해 볼 수 있나요?

무료 플랜은 없습니다. 무료 티어는 없습니다. 가장 작은 팩이 테스트하는 방법이며, 최소 충전 금액에서 결제합니다. 최소 금액에 도달하기 위해서만 추가한 금액은 사용하지 않은 상태에서 30일 이내에 요청 시 USDT 또는 USDC로 돌려보낼 수 있습니다.

---

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