# WebReaderAPI FAQ

> WebReaderAPI FAQ: 웹 리더 API에 관한 30가지 답변: 페이지당 가격, JavaScript와 PDF, 크롤링, robots.txt, 차단된 사이트, KYC, 암호화폐 결제와 AI 에이전트.

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

개발자, AI 빌더, 사이트 운영자가 WebReaderAPI로 웹페이지를 Markdown으로 변환하는 방법에 대해 가장 많이 묻는 질문에 대한 답변입니다. 각 답변은 결론부터 시작합니다.

**빠른 답변 — WebReaderAPI에 대해 사람들이 가장 많이 묻는 것은 무엇인가요?**

주로 페이지당 가격, JavaScript 페이지와 PDF가 어떻게 계산되는지, 그리고 사이트가 robots를 거부할 때 무슨 일이 일어나는지입니다. 요약하면: **WebReaderAPI**은 페이지를 읽을 때마다 크레딧 1개를 청구하고, 브라우저를 쓰면 2개를 청구하며, 2026년 10월 기준 US$0.07/1K 페이지부터 시작합니다. 거부되거나 실패한 페이지는 비용이 들지 않습니다. robots.txt는 항상 준수합니다. KYC 없이 암호화폐로 결제할 수 있습니다.

## 가격과 크레딧

### WebReaderAPI 요금은 얼마인가요?

선불 팩은 2026년 10월 기준 10,000페이지에 US$3.75, 100,000페이지에 US$21.75, 1,000,000페이지에 US$74.25입니다. 5,000,000페이지 팩에서는 단가가 US$0.07/1K 페이지로 내려갑니다. [가격 페이지](https://webreaderapi.com/ko/pricing/)에서 모든 팩을 확인할 수 있습니다.

### 크레딧 1개로 무엇을 살 수 있나요?

브라우저 없이 페이지 1개를 읽을 수 있습니다. JavaScript 렌더링이 필요한 페이지는 크레딧 2개를 사용하고, 특정 국가에서 읽으면 1개가 추가됩니다. 응답은 `credits_used`에 무엇이 사용되었는지 알려주므로, 직접 로그에서 페이지당 비용을 추적할 수 있습니다.

### 크레딧은 만료되나요?

아니요. 선불 크레딧은 만료되지 않습니다. 사용하지 않은 페이지는 사용할 때까지 계정에 남아 있습니다. 일회성 크롤링을 위해 구매한 팩은 사용하지 않은 페이지를 다음 프로젝트를 위해 그대로 보관합니다.

### 페이지를 읽을 수 없을 때도 요금이 청구되나요?

아니요. 오류는 우리 쪽, 네트워크, 또는 웹사이트 중 어느 것이 원인이든 크레딧을 사용하지 않습니다. robots.txt, `ai-input=no` 신호, 또는 사이트 자체의 응답으로 거부된 페이지도 마찬가지입니다.

### 무료 플랜이 있나요?

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

### 최소 결제 금액은 얼마인가요?

최소 충전 금액은 US$25입니다. 가장 작은 팩인 10,000페이지은 US$3.75이며, 충전금의 나머지는 이후 팩을 위해 잔액에 남아 있거나, 사용하지 않은 경우 30일 이내에 환불을 요청할 수 있습니다.

## API가 읽고 반환하는 것

### WebReaderAPI는 JavaScript로 만든 페이지를 읽을 수 있나요?

네. 페이지에 필요할 때 헤드리스 브라우저에서 JavaScript 렌더링 (render=auto), 또는 항상, 또는 절대 하지 않습니다. `render=auto`을 사용하면 원시 HTML에 텍스트가 너무 적을 때만 브라우저를 사용하므로, 단순한 페이지는 크레딧 1개로 유지됩니다.

### PDF 파일도 변환할 수 있나요?

네. 최대 20 MB, 100페이지까지의 PDF 파일이 Markdown으로 변환되며, 시작된 10페이지 블록당 1 크레딧입니다. PDF의 URL을 동일한 `/read` endpoint로 보내면 텍스트가 Markdown으로 반환됩니다.

### 웹사이트 전체를 읽을 수 있나요?

네, 크롤링 작업으로 가능합니다. 작업당 웹사이트 하나를 크롤링하며, 최대 10,000페이지까지 사이트맵, robots.txt 및 Crawl-delay를 따릅니다. `/docs/*` 같은 경로로 제한할 수 있으며, 각 페이지 읽기는 단일 요청과 마찬가지로 크레딧을 사용합니다.

### 한 번에 몇 개의 URL을 보낼 수 있나요?

배치 작업당 최대 100개의 URL. 배치는 작업(job)으로 실행됩니다: 목록을 보내면 `job_id`을 받고, 작업이 완료되면 모든 결과를 수집합니다.

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

`max_chars`을 설정하세요. Markdown은 1,000자에서 500,000자 사이의 해당 길이에서 잘립니다. `main_content=true`과 함께 사용하면 긴 페이지를 예측 가능한 토큰 예산 내로 유지할 수 있습니다.

### Markdown에 표, 코드 블록, 링크가 유지되나요?

네. 제목, 목록, 표, 코드 블록, 링크는 Markdown 형식을 유지합니다. 링크는 인라인으로 표시되며, `include_links=true`을 추가하면 별도 목록으로도 받을 수 있고, `include_images=true`을 사용하면 이미지도 유지됩니다.

### "본문 추출"이란 무엇인가요?

독자가 보러 온 페이지의 부분, 즉 기사, 문서 또는 제품 설명입니다. 기본값인 `main_content=true`을 사용하면 메뉴, 쿠키 배너, 광고, 사이드바, 푸터가 제거됩니다. `false`로 설정하면 전체 페이지를 변환합니다.

### 다른 국가에서 보이는 대로 페이지를 읽을 수 있나요?

네, `country` parameter와 두 글자 국가 코드를 사용하면 됩니다. 페이지를 읽는 국가를 선택하면 10 크레딧이 추가됩니다. 이 경우 해당 국가의 주거용 연결을 통해 페이지를 읽기 때문입니다. 일부 사이트는 국가에 따라 가격, 언어 또는 콘텐츠를 변경합니다.

## robots.txt와 거부된 페이지

### WebReaderAPI는 robots.txt를 준수하나요?

항상 준수합니다. 우리는 robots.txt를 준수합니다. 크롤러는 WebReaderAPI로 자신을 식별하고, 자신 또는 모든 로봇을 위해 작성된 규칙을 따르며, 사이트가 허용하지 않은 페이지는 읽지 않습니다. 거부된 페이지는 과금되지 않습니다. [bot 페이지](https://webreaderapi.com/ko/bot/)에서 user agent와 사이트 소유자가 이를 허용하거나 거부하는 방법을 확인할 수 있습니다.

### Cloudflare 또는 다른 봇 필터로 보호되는 사이트는 어떻게 되나요?

사이트가 저희 크롤러를 통과시키면 페이지를 정상적으로 읽습니다. 사이트가 거부하거나 챌린지 페이지로 응답하면 그 응답을 `target_refused`로 반환하며 비용을 청구하지 않습니다. 저희는 챌린지를 우회하려고 시도하지 않습니다.

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

아니요, 절대 읽을 수 없습니다. 제공하신 자격 증명이 있어도 마찬가지입니다. 계정이나 구독이 필요한 콘텐츠는 범위를 벗어나며, 이를 요청하면 [허용 사용 정책](https://webreaderapi.com/ko/acceptable-use/)을 위반합니다.

### ai-input=no 신호란 무엇인가요?

일부 사이트가 robots.txt에 추가하는 줄로, Content Signals Policy에서 해당 페이지를 AI 답변의 입력으로 사용하는 것을 거부하기 위한 것입니다. 사이트가 robots.txt에 Content-Signal: ai-input=no를 선언하면, 해당 페이지를 대신 읽지 않습니다. API는 `blocked_by_site_policy`을 무료로 반환합니다.

### AI를 위해 웹페이지를 읽는 것은 합법인가요?

이는 콘텐츠, 국가, 그리고 텍스트를 어떻게 사용하는지에 따라 달라집니다. robots.txt를 준수하고 개인 데이터와 페이월을 피하면 위험이 줄어듭니다. [규칙 개요](https://webreaderapi.com/ko/guides/is-reading-web-pages-for-ai-legal/)에서 주요 사항을 요약하고 있으며, 이는 법률 자문이 아닙니다.

## 계정, 결제 및 개인정보

### 본인 확인을 해야 하나요?

아니요. WebReaderAPI는 신분증, 셀피, 회사 서류, 카드를 요구하지 않습니다. 계정 번호로 로그인, 이메일은 선택 사항. [no-KYC 페이지](https://webreaderapi.com/ko/no-kyc-web-reader-api/)에서 여전히 적용되는 사항을 설명합니다.

### 어떤 암호화폐로 결제할 수 있나요?

BTC, USDT, USDC, ETH, SOL, LTC. USDT는 TRC-20 또는 ERC-20로, USDC는 ERC-20로 사용할 수 있습니다. 표시된 정확한 금액을 보내고 "I've sent the payment"를 클릭하면, 확인되는 즉시 충전이 반영됩니다.

### 환불을 받을 수 있나요?

네, 잔액으로 환불받을 수 있습니다. 20% 미만으로 사용된 pack은 구매 후 72시간 이내에 반환되며, 전혀 작동하지 않은 pack은 전액 크레딧됩니다. [환불 정책](https://webreaderapi.com/ko/refunds/)에 정확한 규칙과 세 가지 예시가 있습니다.

### API 키는 어떻게 작동하나요?

여러 API 키를 만들 수 있습니다. 예를 들어 에이전트나 프로젝트별로 하나씩 만들고, 대시보드에서 원하는 키를 폐기할 수 있습니다. API 키를 Bearer 토큰으로 Authorization 헤더에 넣거나 api_key 쿼리 파라미터에 넣어 전송하세요. 애플리케이션 또는 에이전트마다 키를 하나씩 두면 다른 키를 중단하지 않고 하나만 폐기하기 쉽습니다.

### 제 요청에 대해 어떤 정보를 기록하나요?

각 페이지의 호스트 이름만 기록하며, 전체 URL이나 콘텐츠는 기록하지 않습니다. 여기에 시간, 상태, 크레딧을 30일간 보관합니다. 읽으신 페이지의 사본은 보관하지 않습니다. [개인정보 처리방침](https://webreaderapi.com/ko/privacy/)에 자세한 내용이 있습니다.

## 개발자 및 AI 에이전트

### Python과 Node.js용 코드가 있나요?

네. [Python](https://webreaderapi.com/ko/docs/python/) 및 [Node.js](https://webreaderapi.com/ko/docs/node/) 가이드에서 단일 읽기, 배치, 크롤링, 재시도를 보여 주며, [퀵 스타트](https://webreaderapi.com/ko/docs/)에는 curl 예제가 있습니다. SDK 패키지는 필요 없습니다. API는 JSON을 사용하는 일반 HTTPS입니다.

### Claude, Cursor 또는 다른 MCP 클라이언트가 WebReaderAPI를 사용할 수 있나요?

네, 직접 실행하는 작은 MCP 서버를 통해 가능하며, [MCP 페이지](https://webreaderapi.com/ko/docs/mcp/)에 문서화되어 있습니다. URL을 받아 페이지를 Markdown으로 반환하는 도구를 제공합니다.

### LangChain 및 LlamaIndex와 함께 작동하나요?

네. [LangChain 및 LlamaIndex 페이지](https://webreaderapi.com/ko/docs/langchain/)에서 URL을 메타데이터와 함께 문서로 변환하여 청킹과 임베딩에 바로 사용할 수 있게 하는 document loader를 보여 줍니다.

### 동시에 몇 개의 페이지를 읽을 수 있나요?

모든 계정에는 동시에 읽는 페이지 수에 대한 한도가 있으며, 대시보드에 표시됩니다. 지원팀이 이를 높일 수 있습니다. 또한 크롤링은 각 사이트의 `Crawl-delay`을 따르므로, 하나의 도메인에 대한 대규모 크롤링은 페이지 수가 시사하는 것보다 오래 걸릴 수 있습니다.

### WebReaderAPI는 누가 운영하나요?

SerpGoat LLC. 서비스 작동 방식과 담당자에게 연락하는 방법은 [about 페이지](https://webreaderapi.com/ko/about/)를 참고하세요. 이메일 지원팀은 주 7일, 매일 12시간 이내에 답변하며, 크롤링 및 연동 관련 지원도 포함합니다.

### 읽기 속도는 얼마나 빠른가요?

주로 웹사이트와 브라우저가 필요한지 여부에 따라 달라집니다. 공개 샘플을 대상으로 측정하기 전까지는 속도 수치를 공개하지 않으며, 측정이 완료되면 방법과 날짜와 함께 [상태 페이지](https://webreaderapi.com/ko/status/)에 표시됩니다.

---

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