작동 원리 및 구조
결정론적 POSIX 셸 렉서가 작은따옴표 문자열, 이스케이프가 포함된 큰따옴표 문자열, ANSI-C `$\x27...$\x27` 인용 및 줄 바꿈 백슬래시(`\`)를 토큰화합니다. 파싱된 플래그(`--request`, `--header`, `--data*`, `--user`, `--json`)는 타입이 지정된 HTTP 요청 AST로 변환된 뒤 Fetch, Axios, Python `requests`, Go `net/http` 스니펫으로 출력됩니다.
단계별 사용 방법
Chrome 개발자 도구(DevTools), Postman 또는 API 문서에서 복사한 `curl ...` 명령어를 붙여넣습니다.
파싱 요약 칩(HTTP 메서드, URL, 헤더 개수, Basic Auth, Body 유형)을 확인합니다.
원하는 출력 언어/런타임(`JavaScript Fetch`, `Axios`, `Python requests`, `Go net/http`)을 선택합니다.
필요 시 헤더 가리기 보기를 확인하거나 생성된 코드를 프로젝트에 바로 복사합니다.
주요 기능 및 장점
- 100% 오프라인 실행 — 실제 `Authorization: Bearer` 토큰, 세션 쿠키, API 키를 안전하게 보호
- 여러 줄 `\` 연속 구문과 `-H`, `-X`, `-d`, `--data-raw`, `--data-binary`, `--json`, `-u user:pass` 완벽 처리
- 4개 타깃(Fetch, Axios, Python, Go)에 대해 외부 의존성 최소화된 깔끔한 코드 생성
- 쿼리 파라미터 자동 추출 및 JSON 요청 본문(Body) 보기 좋은 포맷팅
- 외부 API 호출 전혀 없음
계산 방식, 공식 및 기술 표준
셸 토큰화는 임의의 셸 평가(`eval`)를 실행하지 않고 POSIX sh 인용 경계를 그대로 따릅니다. `-X` 없이 `-d`/`--data*`가 전달되면 실제 `curl` 동작과 동일하게 기본 HTTP 메서드를 `POST`로 설정하며, `--json` 플래그가 있으면 `Content-Type: application/json` 및 `Accept: application/json` 헤더를 자동으로 붙입니다.
실제 활용 사례
- Chrome 네트워크 탭의 'Copy as cURL'(실제 로그인 세션 쿠키 포함)을 Node/Browser `fetch()` 코드로 안전하게 변환
- Stripe, OpenAI, 웹훅 문서의 cURL 예제를 Go `http.NewRequest` 또는 Python `requests` 상용구 코드로 변환
- 복잡한 여러 줄 셸 명령어 속에 섞인 헤더, URL 파라미터, 원본 JSON 페이로드를 한눈에 파악
- 스테이징 API 엔드포인트를 온라인에 노출하지 않고 백엔드 스크립트를 빠르게 작성
입출력 예시 및 엣지 케이스
cURL with Bearer Token & JSON Body
curl -X POST https://api.example.com/v1/items -H "Authorization: Bearer tok_123" -d '{"name":"widget"}' fetch("https://api.example.com/v1/items", { method: "POST", headers: { "Authorization": "Bearer tok_123", "Content-Type": "application/x-www-form-urlencoded" }, body: JSON.stringify(...) }) Explicit `-H "Content-Type: application/json"` or `--json` signals JSON serialization in Axios/Python.
Basic Auth (-u)
curl -u admin:secret https://status.internal/health
Python: requests.get("https://status.internal/health", auth=("admin", "secret")) Translates `-u` cleanly to native `auth` parameters in Python/Axios/Go or `Authorization: Basic` in Fetch.
제한 사항 및 정확도 안내
- • 멀티파트 파일 업로드(`-F file=@/path`)의 경우 브라우저가 cURL 텍스트만으로 임의의 OS 로컬 파일 경로를 읽을 수 없으므로 주석 처리된 플레이스홀더 힌트로 출력됩니다.
- • Windows `cmd`/`curl.exe`의 캐럿(`^`)이나 PowerShell 백틱(`` ` ``) 이스케이프는 bash용 `Copy as cURL (bash)`와 약간 다를 수 있습니다.
브라우저 로컬 처리 및 개인정보 보호
일반 웹 변환기는 문서나 미디어 파일을 원격 서버에 업로드합니다. cURL → Fetch · Axios · Python · Go 코드 변환기 도구는 현재 브라우저 탭 내부에서만 실행됩니다:
입력 텍스트와 파일은 외부 서버로 전송되지 않고 기기 내에서 로컬로 계산됩니다.
도구에 붙여넣은 파일이나 데이터를 서버에 기록하거나 저장하지 않습니다.
작업 결과는 브라우저 탭 메모리에만 유지되며 탭을 닫거나 초기화하면 즉시 해제됩니다.
자주 묻는 질문 (FAQ)
일반 온라인 변환 사이트에 cURL을 붙여넣으면 왜 보안 위험이 있나요?
Chrome 개발자 도구의 'Copy as cURL'에는 현재 로그인된 실제 `Cookie`와 `Authorization` 헤더가 그대로 들어 있습니다. 이를 서버 기반 변환 사이트에 붙여넣으면 살아 있는 세션 토큰이 외부 서버로 전송될 수 있습니다. Microdeck은 브라우저 RAM 내부에서만 로컬로 파싱합니다.
Chrome 개발자 도구에서 어떤 cURL 형식으로 복사하는 것이 좋나요?
macOS, Linux, Windows 환경 모두에서 완전한 POSIX 인용 호환성을 보장하는 'Copy as cURL (bash)'를 선택하시는 것을 권장합니다.
-d 플래그를 넘길 때 -X POST를 생략하면 어떻게 처리되나요?
실제 `curl`과 마찬가지로 명시적인 `-X` 메서드가 없더라도 본문 플래그(`-d`, `--data-raw`, `--json`)가 포함되면 자동으로 `POST` 요청으로 추론합니다.
이 도구가 실제로 HTTP 요청을 서버로 전송해 실행하나요?
아니요. 어떠한 네트워크 요청도 보내지 않고 순수하게 텍스트를 파싱해 코드만 생성합니다.