# OpenClaw: web_fetch 옆에 MCP로 웹페이지 리더 추가하기

> MCP를 통해 OpenClaw에 웹페이지 리더를 추가하세요: openclaw mcp add, doctor --probe, 그리고 read_url이 내장 web_fetch를 어떻게 보완하는지. KYC 없이, 암호화폐로 결제합니다.

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

OpenClaw에는 가벼운 페이지를 위한 `web_fetch` 툴이 이미 있습니다. 저희 MCP 서버를 추가하면 에이전트가 JavaScript 페이지, PDF, 더 긴 문서를 위한 두 번째 리더인 `read_url`을 갖게 됩니다. 설정은 명령 하나면 됩니다.

**빠른 답변 — OpenClaw에 웹페이지 리더 API를 추가하려면 어떻게 하나요?**

**WebReaderAPI** MCP 서버를 저장한 다음 `openclaw mcp add webreaderapi --command … --arg … --env WEBREADER_API_KEY=…`로 등록하고 `openclaw mcp doctor --probe`로 확인하세요. 에이전트는 내장 `web_fetch` 옆에 `read_url` 툴을 갖게 되어 JavaScript를 렌더링하고 PDF를 읽을 수 있습니다. 페이지당 1크레딧이며, 2026년 10월 기준 US$0.07/1K 페이지부터 시작합니다. KYC 없이, 암호화폐로 결제합니다.

## OpenClaw의 web_fetch와 read_url 비교

| 속성 | 값 |
| --- | --- |
| web_fetch (내장) | 로컬에서 실행되며 Readability로 본문을 추출하고 Markdown 또는 텍스트를 반환 |
| web_fetch 제한 | JavaScript 실행 없음, 기본 및 상한 `maxChars` 20,000자 (OpenClaw 문서) |
| read_url (저희 MCP 툴) | 필요 시 JavaScript 렌더링, 최대 100페이지 PDF, 최대 500,000자 |
| read_url 비용 | 1 크레딧 = 브라우저 없이 페이지 1회 읽기, 페이지가 JavaScript를 렌더링하는 데 브라우저가 필요하면 2 크레딧. 실패한 요청이나 사이트의 robots.txt가 거부한 요청은 과금되지 않습니다 |
| 저희 크롤러 | `WebReaderAPI/1.0 (+https://webreaderapi.com/bot/)`, robots.txt 준수 |
| 도구 프로필 | MCP 도구는 `coding` 및 `messaging` 프로필에 나타나며 `minimal`에는 나타나지 않습니다 |

## OpenClaw에 web_fetch가 있는데 왜 리더를 추가해야 하나요?

서로 다른 페이지를 다루기 때문입니다. OpenClaw 문서에 따르면 `web_fetch`는 항상 로컬에서 실행되고, 본문 추출에 Readability를 사용하며, JavaScript를 실행하지 않습니다. JavaScript가 많은 사이트나 로그인이 필요한 사이트에는 Web Browser 도구를 사용하라고 안내합니다. `maxChars` 설정의 기본값은 20,000자이며 그 이상은 제한됩니다.

빠르고 가벼운 페이지에는 `web_fetch`를 그대로 사용하세요. JavaScript로 콘텐츠를 만드는 페이지, PDF, 20,000자보다 긴 문서에는 `read_url`를 추가하세요. OpenClaw 문서는 또한 공식 Firecrawl 플러그인이 현재 `web_fetch`가 대체(fallback)로 사용할 수 있는 유일한 번들 제공자라고 언급합니다.

## OpenClaw에 MCP 서버를 어떻게 등록하나요?

먼저 [MCP 페이지](https://webreaderapi.com/ko/docs/mcp/)에서 Python 서버를 설정하세요. 파일 하나에 `mcp`과 `httpx` 패키지가 필요합니다. 그다음 OpenClaw에 `openclaw mcp add`로 저장하세요. OpenClaw의 레지스트리 문서에는 stdio 플래그 `--command`, `--arg`, `--env`, `--cwd`이 설명되어 있으며, 저장된 정의는 설정의 `mcp.servers` 아래에 보관됩니다.

이후 `openclaw mcp doctor --probe`를 실행하세요. `--probe` 없이는 doctor가 저장된 설정만 확인하지만, 함께 사용하면 활성화된 서버가 연결되는지도 확인합니다.

*서버 등록 및 확인*

```bash
openclaw mcp add webreaderapi \
  --command /home/you/webreader/.venv/bin/python \
  --arg /home/you/webreader/webreader_mcp.py \
  --env WEBREADER_API_KEY=your-key

openclaw mcp doctor webreaderapi --probe
```

## 에이전트가 read_url을 볼 수 있나요?

일반적인 프로필에서는 볼 수 있습니다. OpenClaw의 레지스트리 문서에 따르면 내장 OpenClaw는 설정된 MCP 도구를 `coding` 및 `messaging` 프로필에서 노출합니다. `minimal` 프로필은 이 도구를 숨기고 `tools.deny: ["bundle-mcp"]`는 비활성화하므로, 도구가 나타나지 않으면 이 두 설정을 확인하세요.

도구 설명은 모델에게 언제 이 도구를 우선할지 알려줍니다. JavaScript가 필요한 페이지, PDF, 긴 문서가 그 경우입니다. 그 외에는 모델이 `web_fetch`를 계속 사용할 수 있습니다.

## read_url은 읽는 사이트를 어떻게 처리하나요?

우리 API에 대한 모든 호출과 동일한 방식입니다. 우리는 robots.txt를 준수합니다. 크롤러는 WebReaderAPI로 자신을 식별하고, 자신 또는 모든 로봇을 위해 작성된 규칙을 따르며, 사이트가 허용하지 않은 페이지는 읽지 않습니다. 거부된 페이지는 과금되지 않습니다. 사이트가 robots.txt에 Content-Signal: ai-input=no를 선언하면, 해당 페이지를 대신 읽지 않습니다. 사이트가 우리 요청을 거부하면 그 응답을 그대로 반환합니다. 우리는 CAPTCHA를 풀거나, 계정에 로그인하거나, 차단이나 페이월을 우회하려 시도하지 않습니다.

따라서 로그인 뒤에 있는 페이지는 `read_url`의 범위 밖입니다. 로그인한 사이트에는 세션과 함께 실행되는 OpenClaw 자체 브라우저 도구가 적합합니다.

## OpenClaw를 통해 페이지를 읽으면 비용이 얼마인가요?

콘텐츠가 반환된 페이지 하나당 1크레딧, 브라우저가 필요하면 2크레딧, 거부와 오류에는 비용이 없습니다. 채팅 채널 전반에서 하루 30페이지를 읽는 어시스턴트는 월 약 900크레딧을 사용합니다. 10,000페이지(US$3.75)이면 거의 1년 동안 사용할 수 있습니다. 선불 크레딧은 만료되지 않습니다. 사용하지 않은 페이지는 사용할 때까지 계정에 남아 있습니다.

OpenClaw에 별도의 API 키를 부여하여 다른 프로젝트와 사용량이 구분되게 하세요.

## OpenClaw: 자주 묻는 질문

### WebReaderAPI는 OpenClaw의 내장 제공자인가요?

아닙니다. 플러그인 코드 없이도 OpenClaw가 지원하는 MCP 서버로 연결됩니다. MCP 서버는 [MCP 페이지](https://webreaderapi.com/ko/docs/mcp/)의 짧은 Python 파일입니다.

### web_fetch를 비활성화해야 하나요?

그럴 필요 없습니다. 두 도구 모두 켜 둘 수 있으며, 설명이 모델에게 어느 것이 적합한지 알려줍니다. 모든 읽기를 한 곳에서 로깅하려는 경우에만 `web_fetch`를 비활성화하세요.

### OpenClaw 웹 인터페이스에서 서버를 관리할 수 있나요?

OpenClaw 문서에는 Control UI의 MCP 설정이 설명되어 있으며, 이는 명령 줄과 동일한 저장된 정의를 편집합니다. 편한 방법을 사용하세요.

### 샌드박스된 OpenClaw 환경에서도 작동하나요?

MCP 서버는 `https://webreaderapi.com/api/v1/read`에 접속하려면 인터넷 접근이 필요한 로컬 프로세스입니다. 샌드박스가 이 프로세스를 시작하고 해당 HTTPS 호출을 허용하는지 확인하세요.

## 출처

1. [웹 도구](https://docs.openclaw.ai/tools/web) — OpenClaw docs (read 2026-10-22)
2. [Web Fetch](https://docs.openclaw.ai/tools/web-fetch) — OpenClaw docs (read 2026-10-22)
3. [저장된 MCP 서버 관리](https://docs.openclaw.ai/cli/mcp/registry) — OpenClaw docs (read 2026-10-22)
4. [Control UI의 MCP](https://docs.openclaw.ai/cli/mcp/control-ui) — OpenClaw docs (read 2026-10-22)

---

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