MớiCheep 0.1.0 đã ra mắt. Cài đặt bằng Homebrew, Go hoặc bản binary dựng sẵn.
Mã nguồn mở · Namecheap CLI không chính thức
Namecheap với tốc độ dòng lệnh.
Kiểm tra tên miền, xem giá của tài khoản bạn và đổi DNS theo kế hoạch đã xem lại, ngay từ terminal hoặc AI agent của bạn.
Cài đặt bằng Homebrew
brew install turushan/tap/cheep macOS, Linux và Windows · Miễn phí theo giấy phép MIT · Cách cài đặt khác
Thử bảng lật
Mọi cái tên trong một lệnh.
Nhập một cái tên, bảng sẽ xếp ra các tên miền cần kiểm tra. Cheep hỏi Namecheap kết quả trực tiếp ngay trên máy của bạn, bằng khóa API của chính bạn.
DOMAINS CHECK
PAPERKITE.COM
PAPERKITE.DEV
PAPERKITE.APP
PAPERKITE.IO
PAPERKITE.CO
PAPERKITE.SH
Trang này không tra cứu gì cả. Cheep hiển thị kết quả trong terminal của bạn.
Chạy lệnh này để kiểm tra
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"}}
Kết quả mẫu từ CLI thật. Cheep luôn hỏi Namecheap để lấy kết quả trực tiếp.
Khi tiêu tiền
Tiền thật cần một cái gật đầu thật.
Trên môi trường production, mọi lệnh gọi có thể trừ tiền tài khoản đều dừng lại cho đến khi bạn thêm đủ ba flag. Mỗi lần, Cheep đều chỉ rõ flag còn thiếu, nên lỡ tay thì bạn chỉ mất một lần chạy lại chứ không mất tiền.
--yesPhê duyệt thay đổi. Hãy chạy --dry-run trước để xem các tham số Cheep sẽ gửi.--productionXác nhận thay đổi dành cho tài khoản thật của bạn, không phải sandbox.--accept-chargeXác nhận bạn đã kiểm tra giá hiện tại trước khi Cheep chi bất kỳ khoản nào.
- Sandbox trước Profile mới bắt đầu trong sandbox của Namecheap, nên không có gì thật bị thay đổi trong lúc bạn làm quen.
- Chạy thử Thêm --dry-run vào bất kỳ thay đổi DNS hay API nào. Cheep cho thấy nó sẽ làm gì và không thay đổi gì cả.
- Khóa nằm trong keychain Cheep giữ khóa API của bạn trong kho thông tin xác thực của hệ điều hành, không bao giờ trong file cấu hình.
DNS
Đổi DNS theo kế hoạch đã duyệt.
Namecheap thay cả vùng DNS trong một lần ghi, nên Cheep coi mọi thay đổi là thay đổi toàn vùng. Bạn xuất vùng ra, sửa file và đọc kế hoạch trước khi áp dụng.
- XuấtToàn bộ vùng, dưới dạng file YAML có phiên bản.
- Lập kế hoạchMọi bản ghi thêm và xóa, trước khi có gì thay đổi.
- Áp dụngLưu snapshot trước, rồi ghi một lần và đọc lại để kiểm tra.
- Khôi phụcĐưa một snapshot trở lại chỉ bằng một lệnh.
Khi áp dụng, Cheep đọc lại vùng đang chạy ngay trước khi ghi, và dừng lại nếu vùng đã thay đổi trong lúc áp dụng. Đọc hướng dẫn DNS (tiếng Anh)
AI agent
Thiết kế cho AI agent.
Agent của bạn chạy đúng các lệnh bạn dùng, với định dạng JSON ổn định. Dữ liệu ra stdout, lỗi ra stderr, và mã thoát đều có tài liệu.
Mã thoát
0 | Thành công |
|---|---|
1 | Lỗi không mong đợi |
2 | Sai cách dùng |
3 | Thiếu hoặc sai thông tin xác thực |
4 | Lỗi mạng hoặc hết thời gian chờ |
5 | Namecheap trả về lỗi |
6 | Xung đột hoặc không rõ kết quả |
7 | Bị chốt an toàn từ chối |
8 | Khoản phí cần --accept-charge |
130 | Bị ngắt |
--jsonJSON có phiên bản, gồm lệnh, kết quả và profile đã dùng.--no-inputKhông bao giờ dừng chờ nhập liệu, nên lần chạy headless không thể bị treo.--readonlyTừ chối mọi thay đổi với tài khoản Namecheap của bạn, kèm mã thoát 7.
Một dòng cho chỉ dẫn của agent
cheep --json --no-input --readonly domains check paperkite.dev API đầy đủ
Đủ cả 59 phương thức API của Namecheap.
Các lệnh chuyên dụng lo phần việc hằng ngày. Với mọi thứ còn lại, cheep api gọi được mọi phương thức trong danh mục chính thức của Namecheap, và mọi thao tác ghi hay tính phí đều chờ đủ flag.
59 trên 59
| Lệnh | Phương thức Namecheap | Loại |
|---|---|---|
cheep api domainprivacy change-email-address | namecheap.whoisguard.changeemailaddress | ghi |
cheep api domainprivacy disable | namecheap.whoisguard.disable | ghi |
cheep api domainprivacy enable | namecheap.whoisguard.enable | ghi |
cheep api domainprivacy get-list | namecheap.whoisguard.getlist | đọc |
cheep api domainprivacy renew | namecheap.whoisguard.renew | tính phí |
cheep api domains check | namecheap.domains.check | đọc |
cheep api domains create | namecheap.domains.create | tính phí |
cheep api domains dns get-email-forwarding | namecheap.domains.dns.getEmailForwarding | đọc |
cheep api domains dns get-hosts | namecheap.domains.dns.getHosts | đọc |
cheep api domains dns get-list | namecheap.domains.dns.getList | đọc |
cheep api domains dns set-custom | namecheap.domains.dns.setCustom | ghi |
cheep api domains dns set-default | namecheap.domains.dns.setDefault | ghi |
cheep api domains dns set-email-forwarding | namecheap.domains.dns.setEmailForwarding | ghi |
cheep api domains dns set-hosts | namecheap.domains.dns.setHosts | ghi |
cheep api domains get-contacts | namecheap.domains.getContacts | đọc |
cheep api domains get-info | namecheap.domains.getInfo | đọc |
cheep api domains get-list | namecheap.domains.getList | đọc |
cheep api domains get-registrar-lock | namecheap.domains.getRegistrarLock | đọc |
cheep api domains get-tld-list | namecheap.domains.getTldList | đọc |
cheep api domains ns create | namecheap.domains.ns.create | ghi |
cheep api domains ns delete | namecheap.domains.ns.delete | ghi |
cheep api domains ns get-info | namecheap.domains.ns.getInfo | đọc |
cheep api domains ns update | namecheap.domains.ns.update | ghi |
cheep api domains reactivate | namecheap.domains.reactivate | tính phí |
cheep api domains renew | namecheap.domains.renew | tính phí |
cheep api domains set-contacts | namecheap.domains.setContacts | ghi |
cheep api domains set-registrar-lock | namecheap.domains.setRegistrarLock | ghi |
cheep api domains transfer create | namecheap.domains.transfer.create | tính phí |
cheep api domains transfer get-list | namecheap.domains.transfer.getList | đọc |
cheep api domains transfer get-status | namecheap.domains.transfer.getStatus | đọc |
cheep api domains transfer update-status | namecheap.domains.transfer.updateStatus | ghi |
cheep api ssl activate | namecheap.ssl.activate | ghi |
cheep api ssl create | namecheap.ssl.create | tính phí |
cheep api ssl edit-dcv-method | namecheap.ssl.editDCVMethod | ghi |
cheep api ssl get-approver-email-list | namecheap.ssl.getApproverEmailList | đọc |
cheep api ssl get-info | namecheap.ssl.getInfo | đọc |
cheep api ssl get-list | namecheap.ssl.getList | đọc |
cheep api ssl parse-csr | namecheap.ssl.parseCSR | đọc |
cheep api ssl purchase-more-sans | namecheap.ssl.purchasemoresans | tính phí |
cheep api ssl reissue | namecheap.ssl.reissue | ghi |
cheep api ssl renew | namecheap.ssl.renew | tính phí |
cheep api ssl resend-approver-email | namecheap.ssl.resendApproverEmail | ghi |
cheep api ssl resend-fulfillment-email | namecheap.ssl.resendfulfillmentemail | ghi |
cheep api ssl revoke-certificate | namecheap.ssl.revokecertificate | ghi |
cheep api users address create | namecheap.users.address.create | ghi |
cheep api users address delete | namecheap.users.address.delete | ghi |
cheep api users address get-info | namecheap.users.address.getInfo | đọc |
cheep api users address get-list | namecheap.users.address.getList | đọc |
cheep api users address set-default | namecheap.users.address.setDefault | ghi |
cheep api users address update | namecheap.users.address.update | ghi |
cheep api users change-password | namecheap.users.changePassword | ghi |
cheep api users create | namecheap.users.create | ghi |
cheep api users create-add-funds-request | namecheap.users.createaddfundsrequest | tính phí |
cheep api users get-add-funds-status | namecheap.users.getAddFundsStatus | đọc |
cheep api users get-balances | namecheap.users.getBalances | đọc |
cheep api users get-pricing | namecheap.users.getPricing | đọc |
cheep api users login | namecheap.users.login | đọc |
cheep api users reset-password | namecheap.users.resetPassword | ghi |
cheep api users update | namecheap.users.update | ghi |
Không có phương thức nào khớp.
Quyền riêng tư
Chỉ giữa bạn và Namecheap.
Cheep chạy trên máy tính của bạn và chỉ trao đổi với API của Namecheap. Không có gì đi qua máy chủ của chúng tôi, và chúng tôi không bao giờ thấy khóa hay tên miền của bạn.
- Không telemetry, không công cụ phân tích, không kiểm tra cập nhật.
- Khóa API của bạn luôn nằm trong kho thông tin xác thực của hệ điều hành.
- Mã nguồn mở theo giấy phép MIT, nên bạn có thể đọc từng yêu cầu mà nó gửi đi.
Cài đặt
Lần kiểm tra đầu tiên chỉ sau ba bước.
- Cài đặt Cheep
Bằng Homebrew trên macOS hoặc Linux, bằng Go 1.26.10 trở lên, hoặc dùng bản binary dựng sẵn cho macOS, Linux hay Windows.
brew install turushan/tap/cheepHoặc dùng Go 1.26.10 trở lên
Tải bản binary dựng sẵngo install github.com/turushan/cheep/cmd/cheep@latest - Kết nối sandbox
Tạo người dùng API, khóa API và đưa một IPv4 công khai vào whitelist trong sandbox của Namecheap. Lưu profile, cất khóa rồi để doctor kiểm tra.
cheep --environment sandbox auth configure sandbox --api-user YOUR_SANDBOX_USER --client-ip YOUR_PUBLIC_IPV4 --defaultcheep auth set-keycheep doctor - Kiểm tra các tên
Hỏi bao nhiêu tên tùy thích chỉ trong một lệnh.
cheep domains check paperkite.dev paperkite.com
Namecheap yêu cầu người dùng API, khóa API và một IPv4 công khai trong whitelist trước khi bất kỳ lệnh nào hoạt động. Đọc hướng dẫn xác thực (tiếng Anh)
Câu hỏi
Cheep có phải công cụ chính thức của Namecheap không?
Không. Cheep là dự án độc lập và mã nguồn mở. Namecheap không làm ra, không bảo trợ và không hỗ trợ Cheep. Cheep dùng API công khai của Namecheap với khóa API của chính bạn.
Tôi cần gì để bắt đầu?
Chính Cheep, cài từ Homebrew, Go hoặc bản binary dựng sẵn, cùng một tài khoản Namecheap có quyền truy cập API: người dùng API, khóa API và một địa chỉ IPv4 công khai trong whitelist. Hãy thử mọi thứ trong sandbox của Namecheap trước.
Khóa API của tôi được lưu ở đâu?
Trong kho thông tin xác thực của hệ điều hành: Keychain trên macOS, Credential Manager trên Windows và Secret Service trên Linux. Trên máy chủ, Cheep đọc CHEEP_API_KEY thay vì dùng kho này. Đừng bao giờ đặt khóa vào tham số dòng lệnh.
Cheep có gửi dữ liệu của tôi đi đâu khác không?
Không. Cheep chỉ trao đổi với API của Namecheap. Không có telemetry, không kiểm tra cập nhật và không có máy chủ nào của chúng tôi.
Cheep có đăng ký, gia hạn và chuyển tên miền được không?
Có, qua cheep api, vốn gọi được cả 59 phương thức trong danh mục của Namecheap. Lệnh gọi có thể trừ tiền tài khoản cần --yes và --accept-charge, cộng thêm --production trên tài khoản thật.
AI agent của tôi có dùng Cheep an toàn được không?
Được. Hãy cho nó --json để nhận JSON có phiên bản, --no-input để nó không bao giờ chờ nhập liệu, và --readonly khi nó không được thay đổi tài khoản của bạn. Thay đổi bị từ chối sẽ thoát với mã 7.
Vì sao Cheep bắt đầu trong sandbox?
Để không có gì thật bị thay đổi trong lúc bạn làm quen. Khi đã sẵn sàng, bạn chuyển profile sang production, và các thay đổi trên production vẫn cần --production.
Cheep chạy trên những hệ điều hành nào?
macOS, Linux và Windows, trên bộ xử lý Intel và ARM. Homebrew cài được Cheep trên macOS và Linux, và mỗi bản phát hành đều có binary cho cả ba hệ điều hành.
Cheep có đổi được DNS không lưu trữ tại Namecheap không?
Không. Cheep chỉ thay đổi DNS cho các tên miền dùng Namecheap DNS, và từ chối phần còn lại.
Tác giả
Chào bạn, mình là turushan
Mình làm ra Cheep để quản lý tên miền của chính mình. Mỗi khi một ứng dụng của mình có trang web mới, Cheep sẽ trỏ tên miền Namecheap của ứng dụng đó về hosting. Cheep miễn phí và mã nguồn mở theo giấy phép MIT, nên cứ lên GitHub cho mình biết bạn muốn nó làm gì tiếp nhé.
Ý tưởng tiếp theo của bạn bắt đầu từ một cái tên.
Kiểm tra ngay từ terminal. Mọi thay đổi đều chờ bạn phê duyệt.
brew install turushan/tap/cheep Các hướng dẫn được viết bằng tiếng Anh, giống như lệnh và kết quả của Cheep.