새 소식Cheep 0.1.0 버전이 나왔어요. Homebrew, Go 또는 미리 빌드된 바이너리로 설치하세요.
오픈 소스 · 비공식 Namecheap CLI
Namecheap을 터미널에서 빠르게.
터미널이나 AI 에이전트에서 도메인을 확인하고, 내 계정의 가격을 조회하고, 검토한 계획대로 DNS를 바꾸세요.
보드 써 보기
모든 이름을 명령어 하나로.
이름을 입력하면 확인할 도메인이 보드에 줄지어 나타나요. Cheep은 내 컴퓨터에서, 내 API 키로 Namecheap에 실시간 결과를 물어봐요.
DOMAINS CHECK
PAPERKITE.COM
PAPERKITE.DEV
PAPERKITE.APP
PAPERKITE.IO
PAPERKITE.CO
PAPERKITE.SH
이 페이지는 아무것도 조회하지 않아요. 결과는 Cheep이 터미널에 보여 줘요.
이 명령어로 확인하세요
cheep domains check paperkite.com paperkite.dev paperkite.app paperkite.io paperkite.co paperkite.sh $ cheep domains check paperkite.dev paperkite.com paperkite.app paperkite.co DOMAIN AVAILABLE PREMIUM PREMIUM REGISTRATION paperkite.dev yes no 0.00 paperkite.com no no 0.00 paperkite.app yes no 0.00 paperkite.co yes yes 1288.00
$ cheep --json domains check paperkite.dev paperkite.com {"schema_version":"v1","command":"domains.check","ok":true,"data":[{"domain":"paperkite.dev","available":true,"premium":false,"premium_registration_price":0},{"domain":"paperkite.com","available":false,"premium":false,"premium_registration_price":0}],"meta":{"profile":"live","environment":"production"}}
실제 CLI의 샘플 출력이에요. Cheep은 항상 Namecheap에 실시간 결과를 물어봐요.
돈이 드는 작업
진짜 돈에는 확실한 Yes를.
프로덕션에서는 계정에 요금이 청구될 수 있는 호출이 플래그 세 개를 붙일 때까지 멈춰요. Cheep이 빠진 플래그를 매번 짚어 주니, 실수해도 돈 대신 한 번 더 실행하면 그만이에요.
--yes변경을 승인해요. 먼저 --dry-run을 실행하면 Cheep이 보낼 매개변수를 볼 수 있어요.--production샌드박스가 아니라 실제 계정에 대한 변경임을 확인해요.--accept-chargeCheep이 결제하기 전에, 현재 가격을 확인했음을 밝혀요.
- 샌드박스부터 새 프로필은 Namecheap 샌드박스에서 시작해요. 익히는 동안 실제로 바뀌는 건 없어요.
- 드라이 런 DNS나 API 변경에는 언제든 --dry-run을 붙일 수 있어요. Cheep은 무엇을 할지 보여 줄 뿐, 아무것도 바꾸지 않아요.
- 키는 키체인에 Cheep은 API 키를 운영 체제의 자격 증명 저장소에 보관하고, 설정 파일에는 절대 넣지 않아요.
DNS
DNS 변경은 검토한 계획대로.
Namecheap은 한 번 쓸 때 DNS 영역 전체를 교체해요. 그래서 Cheep은 모든 변경을 영역 전체의 변경으로 다뤄요. 영역을 내보내고, 파일을 고치고, 계획을 읽은 뒤에 적용하세요.
- 내보내기영역 전체를 버전이 붙은 YAML 파일로.
- 계획바뀌기 전에 모든 추가와 삭제를 미리.
- 적용먼저 스냅샷, 그다음 한 번의 쓰기와 다시 읽어 확인.
- 복원명령어 하나로 스냅샷을 되돌려요.
적용할 때는 쓰기 직전에 실제 영역을 다시 읽고, 적용 중에 영역이 바뀌었다면 멈춰요. DNS 가이드 읽기 (영어)
AI 에이전트
AI 에이전트를 위한 설계.
에이전트도 내가 쓰는 명령어를 그대로 실행하고, 결과는 형식이 고정된 JSON으로 받아요. 데이터는 stdout으로, 오류는 stderr로 나가고, 종료 코드는 문서에 정리돼 있어요.
종료 코드
0 | 성공 |
|---|---|
1 | 예기치 않은 오류 |
2 | 사용법 오류 |
3 | 자격 증명이 없거나 잘못됨 |
4 | 네트워크 오류 또는 시간 초과 |
5 | Namecheap이 오류를 반환함 |
6 | 충돌 또는 알 수 없는 결과 |
7 | 안전장치가 거부함 |
8 | 결제에는 --accept-charge가 필요함 |
130 | 중단됨 |
--json명령어, 결과, 사용한 프로필을 담은 버전 붙은 JSON을 돌려줘요.--no-input입력을 기다리지 않으니, 헤드리스 실행이 멈춰 버릴 일이 없어요.--readonlyNamecheap 계정에 대한 모든 변경을 거부하고, 종료 코드 7을 돌려줘요.
전체 API
Namecheap API 메서드 59개 전부.
일상적인 작업은 전용 명령어로 충분해요. 나머지는 cheep api로 Namecheap 공식 카탈로그의 모든 메서드를 호출할 수 있고, 쓰기와 결제는 모두 필요한 플래그가 붙을 때까지 기다려요.
59개 중 59개
| 명령어 | Namecheap 메서드 | 유형 |
|---|---|---|
cheep api domainprivacy change-email-address | namecheap.whoisguard.changeemailaddress | 쓰기 |
cheep api domainprivacy disable | namecheap.whoisguard.disable | 쓰기 |
cheep api domainprivacy enable | namecheap.whoisguard.enable | 쓰기 |
cheep api domainprivacy get-list | namecheap.whoisguard.getlist | 읽기 |
cheep api domainprivacy renew | namecheap.whoisguard.renew | 결제 |
cheep api domains check | namecheap.domains.check | 읽기 |
cheep api domains create | namecheap.domains.create | 결제 |
cheep api domains dns get-email-forwarding | namecheap.domains.dns.getEmailForwarding | 읽기 |
cheep api domains dns get-hosts | namecheap.domains.dns.getHosts | 읽기 |
cheep api domains dns get-list | namecheap.domains.dns.getList | 읽기 |
cheep api domains dns set-custom | namecheap.domains.dns.setCustom | 쓰기 |
cheep api domains dns set-default | namecheap.domains.dns.setDefault | 쓰기 |
cheep api domains dns set-email-forwarding | namecheap.domains.dns.setEmailForwarding | 쓰기 |
cheep api domains dns set-hosts | namecheap.domains.dns.setHosts | 쓰기 |
cheep api domains get-contacts | namecheap.domains.getContacts | 읽기 |
cheep api domains get-info | namecheap.domains.getInfo | 읽기 |
cheep api domains get-list | namecheap.domains.getList | 읽기 |
cheep api domains get-registrar-lock | namecheap.domains.getRegistrarLock | 읽기 |
cheep api domains get-tld-list | namecheap.domains.getTldList | 읽기 |
cheep api domains ns create | namecheap.domains.ns.create | 쓰기 |
cheep api domains ns delete | namecheap.domains.ns.delete | 쓰기 |
cheep api domains ns get-info | namecheap.domains.ns.getInfo | 읽기 |
cheep api domains ns update | namecheap.domains.ns.update | 쓰기 |
cheep api domains reactivate | namecheap.domains.reactivate | 결제 |
cheep api domains renew | namecheap.domains.renew | 결제 |
cheep api domains set-contacts | namecheap.domains.setContacts | 쓰기 |
cheep api domains set-registrar-lock | namecheap.domains.setRegistrarLock | 쓰기 |
cheep api domains transfer create | namecheap.domains.transfer.create | 결제 |
cheep api domains transfer get-list | namecheap.domains.transfer.getList | 읽기 |
cheep api domains transfer get-status | namecheap.domains.transfer.getStatus | 읽기 |
cheep api domains transfer update-status | namecheap.domains.transfer.updateStatus | 쓰기 |
cheep api ssl activate | namecheap.ssl.activate | 쓰기 |
cheep api ssl create | namecheap.ssl.create | 결제 |
cheep api ssl edit-dcv-method | namecheap.ssl.editDCVMethod | 쓰기 |
cheep api ssl get-approver-email-list | namecheap.ssl.getApproverEmailList | 읽기 |
cheep api ssl get-info | namecheap.ssl.getInfo | 읽기 |
cheep api ssl get-list | namecheap.ssl.getList | 읽기 |
cheep api ssl parse-csr | namecheap.ssl.parseCSR | 읽기 |
cheep api ssl purchase-more-sans | namecheap.ssl.purchasemoresans | 결제 |
cheep api ssl reissue | namecheap.ssl.reissue | 쓰기 |
cheep api ssl renew | namecheap.ssl.renew | 결제 |
cheep api ssl resend-approver-email | namecheap.ssl.resendApproverEmail | 쓰기 |
cheep api ssl resend-fulfillment-email | namecheap.ssl.resendfulfillmentemail | 쓰기 |
cheep api ssl revoke-certificate | namecheap.ssl.revokecertificate | 쓰기 |
cheep api users address create | namecheap.users.address.create | 쓰기 |
cheep api users address delete | namecheap.users.address.delete | 쓰기 |
cheep api users address get-info | namecheap.users.address.getInfo | 읽기 |
cheep api users address get-list | namecheap.users.address.getList | 읽기 |
cheep api users address set-default | namecheap.users.address.setDefault | 쓰기 |
cheep api users address update | namecheap.users.address.update | 쓰기 |
cheep api users change-password | namecheap.users.changePassword | 쓰기 |
cheep api users create | namecheap.users.create | 쓰기 |
cheep api users create-add-funds-request | namecheap.users.createaddfundsrequest | 결제 |
cheep api users get-add-funds-status | namecheap.users.getAddFundsStatus | 읽기 |
cheep api users get-balances | namecheap.users.getBalances | 읽기 |
cheep api users get-pricing | namecheap.users.getPricing | 읽기 |
cheep api users login | namecheap.users.login | 읽기 |
cheep api users reset-password | namecheap.users.resetPassword | 쓰기 |
cheep api users update | namecheap.users.update | 쓰기 |
일치하는 메서드가 없어요.
개인정보 보호
나와 Namecheap 사이에서만.
Cheep은 내 컴퓨터에서 실행되고 Namecheap API하고만 통신해요. 저희 서버를 거치는 건 하나도 없고, 저희가 키나 도메인을 볼 일도 없어요.
- 텔레메트리도, 분석 도구도, 업데이트 확인도 없어요.
- API 키는 운영 체제의 자격 증명 저장소에 그대로 있어요.
- MIT 라이선스의 오픈 소스라서, Cheep이 보내는 모든 요청을 직접 읽어 볼 수 있어요.
설치
세 단계면 첫 확인까지.
- Cheep 설치
macOS나 Linux에서는 Homebrew로, 아니면 Go 1.26.10 이상으로, 또는 macOS, Linux, Windows용 미리 빌드된 바이너리로 설치하세요.
brew install turushan/tap/cheep또는 Go 1.26.10 이상으로
미리 빌드된 바이너리 다운로드go install github.com/turushan/cheep/cmd/cheep@latest - 샌드박스 연결
Namecheap 샌드박스에서 API 사용자와 키를 만들고, 공인 IPv4를 화이트리스트에 등록하세요. 프로필을 저장하고 키를 보관한 뒤 doctor로 점검하세요.
cheep --environment sandbox auth configure sandbox --api-user YOUR_SANDBOX_USER --client-ip YOUR_PUBLIC_IPV4 --defaultcheep auth set-keycheep doctor - 이름 확인
원하는 만큼 이름을 넣고 명령어 하나로 물어보세요.
cheep domains check paperkite.dev paperkite.com
어떤 명령어든 동작하려면 Namecheap의 API 사용자, API 키, 화이트리스트에 등록된 공인 IPv4가 먼저 있어야 해요. 인증 가이드 읽기 (영어)
자주 묻는 질문
Cheep은 Namecheap 공식 도구인가요?
아니요. Cheep은 독립적인 오픈 소스 도구예요. Namecheap이 만들거나 보증하거나 지원하지 않아요. 내 API 키로 Namecheap의 공개 API를 사용해요.
시작하려면 무엇이 필요한가요?
Homebrew, Go 또는 미리 빌드된 바이너리로 받은 Cheep과, API 접근이 켜진 Namecheap 계정이 필요해요. 계정에는 API 사용자, API 키, 화이트리스트에 등록된 공인 IPv4 주소가 있어야 해요. 먼저 Namecheap 샌드박스에서 전부 시험해 보세요.
API 키는 어디에 저장되나요?
운영 체제의 자격 증명 저장소에 들어가요. macOS는 키체인, Windows는 자격 증명 관리자, Linux는 Secret Service예요. 서버에서는 대신 CHEEP_API_KEY를 읽어요. 키를 명령어 인수에는 절대 넣지 마세요.
Cheep이 내 데이터를 다른 곳으로 보내나요?
아니요. Cheep은 Namecheap API하고만 통신해요. 텔레메트리도, 업데이트 확인도, 저희 서버도 없어요.
도메인 등록, 갱신, 이전도 되나요?
네, Namecheap 카탈로그의 59개 메서드를 모두 호출하는 cheep api로 할 수 있어요. 계정에 요금이 청구될 수 있는 호출에는 --yes와 --accept-charge가 필요하고, 실제 계정에서는 --production도 있어야 해요.
내 AI 에이전트가 Cheep을 안전하게 쓸 수 있나요?
네. 버전이 붙은 JSON을 받으려면 --json을, 입력을 기다리며 멈추지 않게 하려면 --no-input을, 계정을 바꾸면 안 될 때는 --readonly를 주세요. 거부된 변경은 종료 코드 7로 끝나요.
Cheep은 왜 샌드박스에서 시작하나요?
익히는 동안 실제로 바뀌는 게 없도록요. 준비가 되면 프로필을 프로덕션으로 바꾸면 되고, 그래도 프로덕션 변경에는 여전히 --production이 필요해요.
어떤 운영 체제에서 실행되나요?
macOS, Linux, Windows에서 실행되고, Intel과 ARM 프로세서를 모두 지원해요. macOS와 Linux에서는 Homebrew로 설치할 수 있고, 모든 릴리스에 세 운영 체제용 바이너리가 있어요.
Namecheap에서 호스팅하지 않는 DNS도 바꿀 수 있나요?
아니요. Cheep은 Namecheap DNS를 쓰는 도메인의 DNS만 바꾸고, 나머지는 거부해요.
개발자
안녕하세요, turushan이에요
Cheep은 제 도메인을 관리하려고 만들었어요. 제 앱에 새 웹사이트가 생기면 Cheep이 그 앱의 Namecheap 도메인을 호스팅에 연결해요. MIT 라이선스의 무료 오픈 소스니까, 다음엔 무엇을 하면 좋을지 GitHub에서 알려 주세요.
다음 아이디어는 이름에서 시작된다.
터미널에서 확인해 보세요. 모든 변경은 내 승인을 기다려요.
brew install turushan/tap/cheep 가이드는 Cheep의 명령어와 출력처럼 영어로 되어 있어요.