KYC 없음 — 신분증도, 셀피도, 서류도 없습니다. 암호화폐로 결제하세요: BTC, USDT, USDC, ETH, SOL, LTC
언어: 한국어
API 키 발급받기

문서 · MCP

Claude, Cursor 및 기타 MCP 클라이언트용 웹 페이지 리더 MCP 서버

모든 MCP 클라이언트에 링크를 깔끔한 Markdown으로 변환하는 read_url 도구를 제공합니다. 서버는 직접 실행하는 짧은 Python 파일 하나이며, API 키는 해당 환경에 보관됩니다.

마지막 업데이트: · 4 분 읽기

빠른 답변

MCP로 Claude Desktop이나 Cursor에 웹 페이지 리더를 어떻게 추가하나요?

WebReaderAPI를 호출하는 read_url 도구를 노출하는 작은 MCP 서버를 실행한 다음, env에 키를 넣어 클라이언트의 MCP 설정에 등록하세요. 그러면 모델이 모든 공개 페이지를 깔끔한 Markdown으로 읽을 수 있습니다. 페이지 읽기 한 건당 1크레딧, 브라우저 사용 시 2크레딧이며, 2026년 10월 기준 US$0.07/1K 페이지부터 시작합니다. KYC 없이 암호화폐로 결제하세요.

MCP 서버 한눈에 보기

언어Python 3.10+, mcp 및 httpx 패키지 사용
전송stdio: 클라이언트가 서버를 로컬 프로세스로 시작
도구read_url(url, max_chars) → 제목, 소스 URL, 그다음 페이지의 Markdown
web_fetch를 쓰지 않는 이유Claude Code와 OpenClaw에는 이미 그 이름의 내장 도구가 있습니다
키서버 환경의 WEBREADER_API_KEY에서 읽음
과금1 크레딧 = 브라우저 없이 페이지 1회 읽기, 페이지가 JavaScript를 렌더링하는 데 브라우저가 필요하면 2 크레딧. 실패한 요청이나 사이트의 robots.txt가 거부한 요청은 과금되지 않습니다

read_url 도구를 쓰고 web_fetch를 쓰지 않는 이유는 무엇인가요?

같은 이름의 도구 두 개는 클라이언트와 모델 모두를 혼란스럽게 하기 때문입니다. Claude Code와 OpenClaw에는 이미 web_fetch라는 도구가 포함되어 있습니다. read_url이라는 별개의 이름과 명확한 설명이 있으면, 모델은 JavaScript 페이지와 PDF를 포함한 페이지의 본문 추출이 필요할 때 우리 도구를 선택할 수 있습니다.

이 도구는 JSON이 아니라 텍스트를 반환합니다. 모델은 중첩된 필드보다 짧은 헤더와 Markdown을 더 잘 처리하며, 헤더 덕분에 소스 URL이 계속 보이므로 답변이 출처를 인용할 수 있습니다.

webreader_mcp.py
import os

import httpx
from mcp.server.fastmcp import FastMCP

API = "https://webreaderapi.com/api/v1/read"
KEY = os.environ["WEBREADER_API_KEY"]
mcp = FastMCP("webreaderapi")


@mcp.tool()
def read_url(url: str, max_chars: int = 20000) -> str:
    """Read a public web page and return its main content as Markdown.

    Use it when the user gives a link or when a page must be read to answer.
    max_chars caps the length of the returned text (1,000 to 500,000).
    """
    params = {"url": url, "max_chars": max(1000, min(int(max_chars), 500000))}
    try:
        resp = httpx.get(API, params=params, headers={"Authorization": "Bearer " + KEY}, timeout=75)
    except httpx.HTTPError as exc:
        return "Network error while reading the page: " + str(exc)
    body = resp.json()
    if resp.status_code != 200:
        err = body.get("error", {})
        return "Could not read the page: " + err.get("code", str(resp.status_code)) + ". " + err.get("message", "")
    title = body.get("title") or url
    return "# " + title + "\nSource: " + body.get("final_url", url) + "\n\n" + body.get("markdown", "")


if __name__ == "__main__":
    mcp.run()

서버를 어떻게 설치하고 테스트하나요?

가상 환경을 만들고 mcp와 httpx를 설치한 뒤 위 파일을 저장하세요. mcp 패키지는 Model Context Protocol의 공식 Python SDK이고, FastMCP는 docstring을 설명으로 사용해 타입이 지정된 Python 함수를 도구로 바꿔 줍니다.

클라이언트에 연결하기 전에, 키를 설정한 상태로 터미널에서 파일을 한 번 실행해 보세요. stdin에서 클라이언트를 조용히 기다리면 올바르게 시작된 것이며, Ctrl+C로 중지할 수 있습니다.

설치
python -m venv .venv
. .venv/bin/activate
pip install "mcp[cli]" httpx
WEBREADER_API_KEY="your-key" python webreader_mcp.py

Claude Desktop에 어떻게 등록하나요?

Claude Desktop의 개발자 설정을 열고 claude_desktop_config.json을 편집한 뒤 mcpServers 아래에 항목을 추가하세요. 가상 환경의 Python과 서버 파일에 절대 경로를 사용하세요. 키는 env에 넣어 도구 인자나 대화에 절대 나타나지 않게 하세요. Claude Desktop을 재시작하면 도구 목록에 read_url가 나타납니다.

Cursor는 자체 MCP 구성 파일에서 동일한 mcpServers 구조를 읽으며, Claude Code는 claude mcp add 명령으로 동일한 명령을 등록할 수 있습니다. OpenClaw는 OpenClaw 페이지를 참고하세요.

claude_desktop_config.json
{
  "mcpServers": {
    "webreaderapi": {
      "command": "/home/you/webreader/.venv/bin/python",
      "args": ["/home/you/webreader/webreader_mcp.py"],
      "env": { "WEBREADER_API_KEY": "your-key" }
    }
  }
}

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

max_chars을 낮추세요. 기본값인 20,000자는 대부분의 글에 충분하며 긴 페이지가 컨텍스트를 채우는 것을 막아 줍니다. 한 답변에서 여러 페이지를 읽는 모델은 페이지당 8,000~12,000자가 더 적합합니다.

모델에게 보이는 모든 링크가 아니라 필요한 페이지만 읽으라고 요청하세요. "질문당 최대 세 페이지만 읽기" 같은 짧은 문장을 프로젝트 지침에 넣으면 비용과 컨텍스트를 모두 관리할 수 있습니다.

사이트가 읽기를 거부하면 어떻게 되나요?

도구는 blocked_by_robots나 target_refused 같은 오류 코드와 함께 짧은 메시지를 반환하며, 청구되는 금액은 없습니다. 우리는 robots.txt를 준수합니다. 크롤러는 WebReaderAPI로 자신을 식별하고, 자신 또는 모든 로봇을 위해 작성된 규칙을 따르며, 사이트가 허용하지 않은 페이지는 읽지 않습니다. 거부된 페이지는 과금되지 않습니다. 사이트가 우리 요청을 거부하면 그 응답을 그대로 반환합니다. 우리는 CAPTCHA를 풀거나, 계정에 로그인하거나, 차단이나 페이월을 우회하려 시도하지 않습니다. 그러면 모델은 해당 페이지를 자동 리더가 사용할 수 없다고 안내하고 다른 소스를 사용할 수 있습니다.

MCP 서버: 자주 묻는 질문

공식 WebReaderAPI MCP 패키지가 있나요?

아니요. 이 페이지의 파일이 바로 통합입니다: 직접 읽고, 수정하고, 실행할 수 있는 40줄입니다. 저희 쪽에서 설치할 것은 없으며, API 호출을 제외하면 키는 여러분의 기기에서 벗어나지 않습니다.

이 서버로 모델이 웹을 검색할 수 있나요?

아니요. read_url는 여러분이나 모델이 이미 주소를 알고 있는 페이지를 읽습니다. 클라이언트가 제공하는 검색 도구와 함께 사용하세요. 모델이 검색한 뒤 중요한 페이지를 읽습니다.

이 도구로 어시스턴트를 운영하는 비용은 얼마인가요?

페이지 읽기 한 건당 1크레딧, 브라우저가 필요하면 2크레딧입니다. 하루에 50페이지를 읽는 어시스턴트는 한 달에 약 1,500크레딧을 사용하며, 10,000페이지(US$3.75)는 약 6개월분을 충당합니다.

서버가 오프라인에서 작동하나요?

아니요. 모든 페이지마다 https://webreaderapi.com/api/v1/read를 호출하므로 인터넷 연결과 유효한 키가 필요합니다.

US$0.07/1K 페이지부터 · KYC 없이

API 키 발급받기