HTML:Tools
lastmod 2026-11-16created 2025-12-152 edits
HTML tools는 Simon Willison 이 HTML·JavaScript·CSS 를 한 파일에 담아 만든 작은 웹 도구들을 부르는 이름이다. 2025년 12월 블로그 글 "Useful patterns for building HTML tools"에서 2년 동안 150개 넘게 만든 도구의 경험을 패턴으로 정리했다. 도구 코드는 거의 모두 LLM 이 썼고, 빌드 단계 없이 정적 호스팅에 올려 쓰는 것을 전제로 한다.
About
- 도구 모음은 tools.simonwillison.net, 소스는 GitHub
simonw/tools저장소. 커밋에 만들 때 쓴 프롬프트나 트랜스크립트 링크를 남김 - 입출력은 복사·붙여넣기, URL, localStorage, 파일 열기·다운로드로 처리하고 서버는 두지 않음
HTML tools 개념과 사례
- 예: SVG 를 PNG·JPEG 로 내려받는 svg-render, PyPI 릴리스 간 diff 를 만드는 pypi-changelog, Bluesky 스레드 뷰어 bluesky-thread
HTML tool의 기본 구조
- 한 파일, React 등 빌드 단계 없음, 의존성은 CDN, 몇백 줄 이내. 이 크기면 LLM 이 몇 분 만에 다시 짤 수 있어 유지보수성이 크게 중요하지 않음
Canvas·Artifacts 기반 프로토타이핑
- ChatGPT·Gemini 의 Canvas, Claude 의 Artifacts 로 시작. React 로 만들면 느리고 오류가 잦아 프롬프트에 "No React" 를 붙임
더 복잡해지면 코딩 에이전트로 전환
- Claude Code·Codex CLI 는 Playwright 로 직접 테스트함. 웹 버전 에이전트는
simonw/tools에 PR 로 도구를 올림
CDN 기반 의존성 관리
- cdnjs·jsDelivr 에서 버전이 박힌 URL 로 불러옴. npm 빌드 단계는 고치기와 셀프 호스팅을 번거롭게 함
외부 정적 호스팅
- LLM 플랫폼 호스팅은 샌드박스 제약·경고 화면·장애 의존이 있어 GitHub Pages 에 올림
복사·붙여넣기 중심 입출력
- 붙여넣은 내용을 변환해 클립보드로 돌려줌. paste 이벤트에서 리치 텍스트 등 여러 포맷을 읽을 수 있음
디버깅 도구
- clipboard-viewer 로 클립보드의 모든 데이터 형식을 확인하며 다른 도구의 재료를 찾음
URL에 상태 저장
- 서버 DB 대신 URL 에 상태를 담아 북마크·공유함 (icon-editor)
localStorage 활용
- 큰 상태와 API 키는 localStorage 에 저장. 정적 호스트라도 서버 로그에 남을 수 있기 때문
CORS 가능한 API 활용
- iNaturalist, PyPI, GitHub(raw.githubusercontent.com), Bluesky, Mastodon, GitHub Gist 를 꼽음
LLM API 직접 호출
- OpenAI·Anthropic·Gemini API 는 CORS 로 바로 호출됨. 키는 HTML 에 넣지 않고 사용자에게 받아 localStorage 에 둠
파일 열기 두려워하지 않기
- <input type="file"> 로 연 파일을 업로드 없이 읽음. ocr 은 PDF.js·Tesseract.js 로 브라우저에서 PDF 를 OCR 함
다운로드 파일 제공하기
- 브라우저에서 파일을 만들어 내려받게 함 (svg-render 의 PNG·JPEG, open-sauce-2025 의 ICS)
Pyodide와 WebAssembly
- Pyodide는 WebAssembly 로 컴파일한 Python. CDN 에서 불러오고 micropip 으로 순수 Python 패키지를 추가함
WebAssembly로 더 넓히기
- 다른 언어 소프트웨어도 브라우저로 옮김 (Perl·C 로 된 SLOCCount 를 옮긴 sloccount)
이전 도구 재조합
- 기존 도구 소스가 LLM 에게 주는 예제가 됨. pypi-changelog 는 zip-wheel-explorer 를 먼저 읽힌 뒤 만들게 했음
프롬프트·트랜스크립트 기록
- share 링크나 terminal-to-html 로 만든 Gist 로 트랜스크립트를 남기고 커밋 메시지에 링크함
마무리
- GitHub 저장소에 GitHub Pages 를 켜고 .html 파일을 넣으면 시작할 수 있음