namecheap-dns
by jarekbird
Web & Frontend DevelopmentBrief
Safe DNS record management for Namecheap domains.
Description
What This Skill Does
Wrapper around the Namecheap API for DNS record management. The Namecheap setHosts endpoint replaces all records on a domain, so this skill fetches existing records first and merges changes before writing. Includes dry-run mode, automatic backups, and ghost record detection.
Direct Namecheap API use requires manually fetching all records before every write or risk deleting your entire DNS config; this skill handles that fetch-merge-write pattern automatically.
When to Use It
- Add Mailgun DNS records without wiping email forwarding
- Preview DNS changes before applying them to a live domain
- Roll back a bad DNS change from a timestamped backup
- Audit live DNS against what the Namecheap API can see
- Remove a stale TXT record without touching other records
Example Workflow
User asks: add an SPF TXT record to example.com via Namecheap without breaking existing records
- 1
Run verify to check for ghost records not visible to the API
- 2
Run add with --dry-run to preview the merge diff
- 3
Confirm no unintended deletions in the diff output
- 4
Run add without --dry-run to apply the change
- 5
Check the auto-created backup in the backups directory
SPF TXT record added to example.com; existing records preserved; backup saved as example.com-{timestamp}.json
Requirements
- NAMECHEAP_API_KEY environment variable
- NAMECHEAP_USERNAME environment variable
- Namecheap account with API access enabled
- IP address whitelisted in Namecheap API settings
Installation
clawhub install jarekbird/namecheap-dnsRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.