Minibase API: URL을 Markdown으로

지난 2년 동안 Minibase는 한 가지를 잘해 왔습니다. 지저분한 웹 페이지를 클릭 한 번으로 깔끔한 Markdown으로 바꾸는 일입니다. 오늘부터 그 엔진을 API로도 쓸 수 있습니다.

LLM으로 무언가를 만들어 본 분이라면 이미 아는 문제일 겁니다. 모델이 읽는 것은 Markdown이지 HTML이 아닙니다. 그런데 웹이 실제로 내보내는 것은 내비게이션과 광고, 쿠키 배너, JavaScript로 둘러싸인 HTML입니다. URL 하나를 깨끗한 컨텍스트로 바꾸는 일은 생각보다 훨씬 깊은 문제여서, 대부분의 팀이 결국 잘 깨지는 fetcher와 헤드리스 브라우저, readability 꼼수 더미를 떠안고 유지보수하게 됩니다.

Minibase API는 이 문제를 호출 한 번으로 해결합니다.

요청 한 번, 깔끔한 Markdown

curl -X POST https://api.savemarkdown.co/v1/convert \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/article"}'

문서가 Markdown으로 돌아옵니다. 제목, 목록, 링크, 이미지, 코드는 그대로 살리고 나머지는 걷어냅니다.

{
  "markdown": "📄 Title: Example Article\n🔗 Source: ...\n\n---\n\n## Heading\n\nClean body...",
  "meta": { "tier": 1, "cached": false, "domain": "example.com", "template": "markdown" },
  "usage": { "credits": 1 }
}

번들에 넣을 DOM 라이브러리도, 돌봐야 할 헤드리스 브라우저도, 손봐야 할 readability 휴리스틱도 없습니다.

꼭 필요한 만큼만 쓰는 계층형 엔진

이 API는 모든 페이지를 값비싼 파이프라인에 무작정 밀어 넣지 않습니다. 필요할 때만 단계를 올립니다.

1. Fetch — 실제 브라우저 지문과 엄격한 SSRF 방어를 갖춘 서버 측 요청입니다. 정적 페이지와 서버 렌더링 페이지는 여기서 끝납니다. 웹의 대부분을 처리하는 빠르고 저렴한 경로입니다.
2. Render — 페이지가 알맹이 없는 JavaScript 껍데기로 판명되면 요청이 헤드리스 렌더링으로 올라간 뒤 추출합니다. 저렴한 경로의 결과가 부실할 때만 자동으로 일어납니다.
3. Extract — 내비게이션, 광고, 쿠키 배너, 상용구를 제거합니다. 중요한 본문만 남습니다.

요청마다 render: "always" | "never" | "auto"로 렌더링을 강제하거나 끌 수 있습니다. 응답은 언제나 어느 계층이 해당 페이지를 처리했는지 알려주므로, 요금이 예상을 벗어나는 일이 없습니다.

선택 사항인 AI 포매팅

기본값은 LLM을 거치지 않는 충실한 Markdown 추출입니다. 저렴하고 빠른 이유가 여기에 있습니다. 단순 추출 이상이 필요할 때는 template(clean, summary, outline 등)을 넘기면 API가 LLM을 한 번 태워 내용을 다시 다듬어 줍니다. 이 계층은 Claude API처럼 토큰 단위로 과금되므로, 실제로 사용한 포매팅에 대해서만 비용을 냅니다.

납득이 가는 가격

계층	가격
Markdown (fetch + extract, LLM 없음)	1,000페이지당 $2
Rendered (JavaScript 페이지)	1,000페이지당 $8
AI 포매팅 (템플릿)	입력 100만 토큰당 $3 / 출력 100만 토큰당 $25

500페이지 무료 체험으로 시작한 뒤, 쓴 만큼 내면 됩니다. 좌석 요금도, 최소 사용량도 없습니다.

에이전트가 호출하도록 만들었습니다

Minibase는 늘 에이전트 친화적이었고, API도 같은 방식으로 발견됩니다. llms.txt, 에이전트 스킬 색인(스킬 id save.api.url-to-markdown), API 카탈로그에 모두 실려 있습니다. 에이전트에게 URL을 건네면, 컨텍스트에 담아 둘 만한 토큰이 돌아옵니다.

문서를 읽고 액세스를 신청하세요 →