공개 지식 읽기, 한 요청부터 시작합니다

권장 기본값: /v1/agent/browse

공식 문서, 레퍼런스, 공개 연구 자료처럼 본문 품질이 중요한 페이지는 markdown 또는 text로 읽는 것이 좋습니다.

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://www.rfc-editor.org/rfc/rfc9110",
    "extract": "markdown",
    "readability": true
  }'

원문이 필요할 때: /v1/fetch

본문 정리보다 status code, headers, HTML 원문이 중요하면 /v1/fetch를 사용합니다.

curl -sS -X POST "https://api.karonlabs.net/v1/fetch" \
  -H "Authorization: Bearer __YOUR_API_KEY__" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

extract: "json"

AI 에이전트가 문서를 읽은 뒤 필요한 필드만 가져가야 한다면 extract: "json"을 사용합니다. 성공 시 구조화 추출 +5 크레딧이 추가됩니다.

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://quotes.toscrape.com/",
    "extract": "json",
    "json_prompt": "첫 번째 인용문과 저자를 추출해 주세요.",
    "json_schema": {
      "type": "object",
      "properties": {
        "quote": { "type": "string" },
        "author": { "type": "string" }
      }
    }
  }'

Watch API

공개 문서나 릴리스 노트의 변화를 감시하려면 snapshot과 diff를 사용합니다. 내부적으로 browse 흐름을 쓰므로 비용은 browse 정책을 따릅니다.

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}'

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