KARON WEB ACCESS API

AI 에이전트가
공개 지식을 안정적으로 읽게 하는 API

공개 웹 페이지를 가져오고, 본문을 markdown/text/html로 정리하며, 필요할 때 브라우저 fallback과 구조화 추출을 사용합니다. 현재 공개 계약은 프로덕션 코드와 라이브 smoke 결과를 기준으로 유지합니다.

# AI 에이전트용 기본 본문 추출 curl -sS -X POST "https://api.karonlabs.net/v1/agent/browse" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"url":"https://docs.python.org/3/","extract":"markdown"}'

API 키 발급 개발자 문서

현재 프로덕션에서 바로 쓰는 기능

Browse

POST /v1/agent/browse

AI가 바로 읽을 수 있는 text, markdown, html, pruned, json 결과를 반환합니다. 기본 엔드포인트입니다.

Fetch

POST /v1/fetch

원문 HTML과 상태 코드, 헤더, 쿠키 정보를 확인해야 할 때 사용합니다. 세션과 캐시를 지원합니다.

Health

GET /health

서비스 상태를 확인합니다. 운영 모니터링과 배포 smoke check에 사용합니다.

Watch

/v1/watch/*

공개 페이지 스냅샷을 저장하고 이전 결과와 diff를 계산합니다. 문서 변경 감시에 사용합니다.

JSON

extract: "json"

본문에서 원하는 구조를 추출합니다. `json_schema`와 `json_prompt`를 함께 사용할 수 있습니다.

MCP

에이전트 클라이언트 연동

Claude Code, Cursor, Codex 같은 MCP 호환 환경에서 REST API를 도구처럼 사용할 수 있습니다.

예제

curl -sS -X POST "https://api.karonlabs.net/v1/agent/browse" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://docs.python.org/3/","extract":"markdown"}'

curl -sS -X POST "https://api.karonlabs.net/v1/agent/browse" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url":"https://example.com",
    "extract":"json",
    "json_prompt":"문서 제목과 주요 변경점을 추출하세요.",
    "json_schema":{"type":"object","properties":{"title":{"type":"string"},"changes":{"type":"array","items":{"type":"string"}}}}
  }'

curl -sS -X POST "https://api.karonlabs.net/v1/fetch" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.w3.org/TR/"}'

curl -sS -X POST "https://api.karonlabs.net/v1/watch/snapshot" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com","extract":"text","ttl_days":1}'

크레딧 기준

cache/curl 1

캐시 응답과 lightweight fetch/extract 성공은 1크레딧입니다.

browser 10

`full_access`, `wait_selector`, 자동 fallback 등 브라우저 경로 성공은 10크레딧입니다.

구조화 추출 +5

`extract: "json"` 구조화 추출이 성공하면 기본 비용에 5크레딧이 추가됩니다.

Free

5,000 credits

300 req/min · 10,000 req/day

Starter

$29

10,000 credits

60 req/min · 2,000 req/day

Growth

$99

50,000 credits

120 req/min · 10,000 req/day

Scale

$299

200,000 credits

300 req/min · daily unmetered

실제 차감량은 응답의 cost_credits를 기준으로 확인하세요. 실시간 티어 정보는 GET /v1/pricing으로도 확인할 수 있습니다.

공개 지식 접근을 API로 붙이세요

공식 문서, 표준, 논문, 기술 레퍼런스를 AI 에이전트가 읽을 수 있는 형태로 정리합니다.

API 키 발급 문서 보기

AI 에이전트가공개 지식을 안정적으로 읽게 하는 API