개발자용 REST API 와 MCP 서버
코드에서 우리 도구를 호출하거나 Claude, ChatGPT, Cursor 같은 AI 비서에 연결할 수 있습니다. 요청은 메모리에서 처리하고 저장하지 않습니다.
파일만 변환·편집하려는 분은 이 페이지가 필요 없습니다. 무료 브라우저 도구를 쓰세요: 가입 없음, 하루 횟수 제한 없음, 파일이 기기 밖으로 나가지 않습니다.
무료 체험 한도: 먼저 읽어 주세요
| 쓸 수 있는 것 | |
|---|---|
| 키 없이 | 계산 API(텍스트, JSON, CSV, 해시, 날짜, 수학, 인코딩, 한국어 도구 등): 공정 사용 범위에서 무료, IP별 요청 속도 제한. 파일 API(PDF 병합·분할·회전·워터마크·메타데이터·추출, HTML·Markdown -> PDF, PDF 표·텍스트 배치): IP당 하루 20회. AI API(번역·요약·OCR): IP당 하루 10회. 네트워크 API(URL 가져오기, DNS, WHOIS, SSL 등): 키 필요. |
| 무료 키 이메일만, 카드 없음 | 월 1,000 크레딧, 그리고 키마다 하루 파일 20회·AI 10회는 크레딧 없이. 호출당 크레딧: 네트워크 20, 하루 허용량을 넘긴 파일 호출 60, AI 번역·요약 50, AI OCR 100, AI 고품질("high") 150, 본인 Claude·ChatGPT 키 사용 5. 계산 API 는 크레딧을 쓰지 않습니다. |
| 한도를 다 쓰면 | 키 없이: HTTP 429 와 Retry-After 헤더. 하루 횟수는 00:00 UTC(한국 시각 오전 9시)에 초기화됩니다.키 사용: 그 달 크레딧을 다 쓰면 HTTP 402. 다음 달 1일(UTC)에 초기화됩니다. 오류 JSON 에 무슨 일이 있었고 다음에 무엇을 하면 되는지 적혀 있습니다. |
| 유료 플랜 | Dev(월 9달러, 월 100,000 크레딧)와 Business(월 49달러, 월 500,000 크레딧)는 해지할 때까지 매월 청구되는 구독이고, 5달러부터 1회 크레딧 팩도 있습니다. 결제는 판매 대행사(Merchant of Record)인 Dodo Payments 가 처리합니다. Dodo Payments 의 계정 심사가 끝나면 결제가 열리며, 그전에는 아무것도 청구되지 않습니다. 가격: API 요금. 플랜 관리·해지: 고객 포털. 환불: 환불·해지 정책. |
자세히: API 요금 · 이용약관 4절. 여러 사용자가 같은 IP 를 쓰는 AI 서비스에서는 익명 하루 한도가 더 빨리 끝날 수 있어 무료 키를 권합니다.
1분 시작
계산 API(키 필요 없음):
curl -s -X POST https://toolsthatdontupload.com/api/uuid -H "Content-Type: application/json" -d '{}'
파일 API. 응답 헤더에 오늘 남은 익명 호출 수가 나옵니다:
curl -i -X POST https://toolsthatdontupload.com/api/pdf-metadata -F "file=@document.pdf" # RateLimit-Limit: 20 # RateLimit-Remaining: 19
네트워크 API(무료 키 필요, 이메일로 발급):
curl -s -X POST https://toolsthatdontupload.com/api/dns-lookup \
-H "Content-Type: application/json" -H "X-API-Key: ttdu_free_..." \
-d '{"domain":"example.com"}'
MCP 서버 연결
주소(Streamable HTTP): https://toolsthatdontupload.com/mcp. 도구 3개(search_tools, run_tool, list_categories)로 전체 카탈로그를 씁니다. MCP 호출도 같은 한도를 씁니다. Claude, Claude Code, Cursor, VS Code, ChatGPT 설정: MCP 연결(영어). Claude Desktop 용 오프라인 번들(도구 20개)은 네트워크 요청을 하지 않습니다.
응답 헤더
| 헤더 | 언제 | 뜻 |
|---|---|---|
RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset(같은 값을 X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset 으로도 보냄) | 키 없는 파일·AI 호출 | 익명 하루 허용량, 남은 횟수, 초기화까지 남은 초 |
X-Free-Daily-Limit, X-Free-Daily-Remaining | 키 사용, 하루 허용량 안의 파일·AI 호출 | 이 키로 오늘 남은 무료 호출 |
X-Credits-Used, X-Credits-Limit, X-Credits-Cost, X-Credits-Remaining | 크레딧을 쓰는 키 호출 | 이번 달 사용 크레딧, 월 크레딧, 이번 호출 비용, 이번 달 남은 크레딧 |
Retry-After | 429 | 하루 횟수 초기화까지 남은 초 |
X-Egress | 모든 API 응답 | 이 호출이 연결한 외부 호스트(대부분 "none") |
오류
| 상태 | 뜻 | 할 일 |
|---|---|---|
| 400 | 입력이 없거나 잘못됨(예: JSON 형식 오류, 파일 API 를 multipart/form-data 없이 호출) | openapi.json 과 요청을 대조 |
| 401 | 키가 필요함(네트워크 도구, AI "high") 또는 잘못된 키 | 무료 키 발급 후 X-API-Key 헤더로 전송 |
| 402 | 이번 달 크레딧을 다 씀 | 다음 달 초기화를 기다리기. 유료 플랜은 아직 판매하지 않으니 더 필요하면 메일로 문의 |
| 404 | 없는 경로이거나 중단된 엔드포인트 | openapi.json 의 현재 목록 확인 |
| 405 | 허용되지 않는 메서드(예: POST 가 필요한 엔드포인트에 GET) | 입력을 POST 본문으로 보내기 |
| 413 | 요청 본문이 너무 큼(JSON 2 MiB, 파일 업로드 15 MiB 까지) | 더 작은 파일로 |
| 422 | 처리할 수 없는 파일(예: 암호가 걸렸거나 손상된 PDF) | 암호를 풀거나 다른 파일로 |
| 429 | 익명 하루 한도 도달 | 00:00 UTC 까지 기다리기(Retry-After) 또는 무료 키 사용 |
401·402·429 응답은 기존 필드를 그대로 두고 developers_url 과 Link: <https://toolsthatdontupload.com/developers/#limits>; rel="help" 헤더를 더합니다. 402·429 에는 next_steps(영어), next_steps_ko(한국어), paid_plans 도 들어 있습니다. 이 헤더들은 브라우저 자바스크립트에서도 읽을 수 있습니다(CORS 노출).
문서와 기계용 파일
문서모든 안내 모음API 키curl, Python, Claude, Cursor, VS Code, ChatGPT 에 키 넣기(한국어 요약 포함)MCP 연결MCP 서버 연결(영어)AI 업그레이드고품질 모드 또는 본인 Claude·ChatGPT 키(한국어 안내 포함)
| 파일 | 내용 |
|---|---|
| openapi.json | 전체 REST 엔드포인트 OpenAPI 3 명세 |
| llms.txt | AI 시스템용 짧은 요약 |
| llms-full.txt | 전체 엔드포인트 목록 |
| catalog.json | 도구 카탈로그(개수·등급) |
| mcp.json | MCP 서버 탐색 파일 |
| ai-plugin.json | ChatGPT Actions 매니페스트 |
| rag-full.txt | RAG 용 통합 텍스트 |
| /api/health | 상태와 개수(JSON) |
데이터가 가는 곳
| 등급 | 처리 위치 |
|---|---|
| Green | 브라우저 도구: 사용자 브라우저 안, 파일 업로드 없음 |
| Yellow | 대부분의 API: Cloudflare Workers 메모리, 요청 본문을 저장·기록하지 않음 |
| Orange | 네트워크 도구: 사용자가 준 URL·도메인에 우리 엣지가 접속, 키 필요 |
| Blue | AI 도구: 입력이 Cloudflare Workers AI 로 전송(본인 키 사용 시 Anthropic 또는 OpenAI) |