godaddy
GoDaddy Domains API v3 — suggest/check availability, get owned domain details, and manage DNS via a Python CLI (Bearer PAT). Use when the user mentions GoDaddy, domain availability, domain status/expi
SKILL.mdskills/devops/dns/godaddy/SKILL.md
GitHubTO COPY
godaddy
Per-workspace registration slice. Credentials live in {SKILL_PATH}/.env.
Working directory
Placeholders changed by /meta-skills at copy time (NAME => {PLACEHOLDER}):
IS_GLOBAL => {IS_GLOBAL} TYPE_OF_AI_TOOLS => {TYPE_OF_AI_TOOLS} SKILL_PATH => {SKILL_PATH}
Bash / zsh:
export CURRENT_SKILL_DIRECTORY="{SKILL_PATH}"
~/.meta-skills/.venv/bin/python ~/.meta-skills/skills/devops/dns/godaddy/scripts/cli.py env
PowerShell (Windows):
$env:CURRENT_SKILL_DIRECTORY = "{SKILL_PATH}"
& "$HOME/.meta-skills/.venv/Scripts/python.exe" "$HOME/.meta-skills/skills/devops/dns/godaddy/scripts/cli.py" env
END TO COPY
godaddy
GoDaddy Domains API v3 CLI:
Discovery
(suggest / check-availability) +
Domains
(owned domain get) +
DNS records.
Auth: Authorization: Bearer ${GODADDY_PAT} (see ORIGIN.md).
When to use
Trigger phrases: "check if domain is available on GoDaddy", "suggest domains",
"get my GoDaddy domain", "domain expiry / auto-renew", "list GoDaddy DNS",
"add A record", /godaddy_*.
skill_env.py loads .env via SkillCred — do not source it in the shell. CURRENT_SKILL_DIRECTORY is the only required export.
Prefer ~/.meta-skills/.venv/bin/python from ~/.meta-skills/skills/devops/dns/godaddy/.
Credentials — SkillCred .env
| Variable | Notes |
|---|---|
GODADDY_PAT |
Required — Personal Access Token |
BASE_URL |
Default https://api.godaddy.com |
Create a Personal Access Token (PAT)
- Open Personal Access Token and sign in to your GoDaddy account.
- Click + Generate Token.
- Fill Name, Expiration, and Scopes:
domains.domain:read— discovery (suggest/check) +domain getdomains.dns:update— DNS add / delete (optional if you only need read/discovery)- Or pick the Domains & DNS bundle for full domain/DNS access
- Click Generate Token, then copy the token immediately — it is shown only once.
- Store it in the skill
.env(never commit it, never paste it into chat):
cp .env.example "{SKILL_PATH}/.env"
# edit: GODADDY_PAT=<paste token>
python scripts/cli.py env # prints resolved .env path
Docs: How to Authenticate · PAT scopes.
To revoke: same PAT page → trash icon next to the token.
First deps: cd ~/.meta-skills/skills/devops/dns/godaddy && ~/.meta-skills/install.sh pip init .
Discovery (docs)
Prices/availability are indicative; locked price is only at quote time.
| Slash | CLI | API |
|---|---|---|
/godaddy_suggest |
python scripts/cli.py suggest --query "sunrise bakery" [--tlds com,net] [--page-size 10] [--sources EXTENSION,KEYWORD_SPIN] |
GET /v3/domains/suggestions |
/godaddy_check |
python scripts/cli.py check DOMAIN [--optimize-for SPEED|ACCURACY] [--isc-code CODE] |
GET /v3/domains/check-availability |
Domains
List all domains — v1 (docs)
Paginated list of domains owned by the authenticated account.
| Slash | CLI | API |
|---|---|---|
/godaddy_domain_list |
python scripts/cli.py domain list [--statuses …] [--status-groups …] [--limit N] [--marker DOMAIN] [--includes authCode,contacts,nameServers] [--modified-date ISO] [--shopper-id ID] |
GET /v1/domains |
Get one domain — v3 (docs)
Owned domain management view (status, nameservers, privacy, auto-renew, expiry).
| Slash | CLI | API |
|---|---|---|
/godaddy_domain_get |
python scripts/cli.py domain get DOMAIN |
GET /v3/domains/domain-names/{domain-name} |
DNS CLI (docs)
| Slash | CLI | API |
|---|---|---|
/godaddy_dns_list |
python scripts/cli.py dns list ZONE [--type A] [--name @] [--page N] [--page-size N] [--total-required] |
GET /v3/domains/zones/{zone}/dns-records |
/godaddy_dns_add |
python scripts/cli.py dns add ZONE --type A --name @ --data 192.0.2.1 [--ttl 600] [--priority N] |
POST /v3/domains/zones/{zone}/dns-records |
/godaddy_dns_delete |
python scripts/cli.py dns delete ZONE RECORD_ID |
DELETE /v3/domains/zones/{zone}/dns-records/{recordId} |
/godaddy_env |
python scripts/cli.py env |
Resolve SkillCred .env path |
Important — Safety rules
- Confirm with the user before dns add or dns delete.
- Deletes are irreversible — get
recordIdfromdns listfirst. - GoDaddy-managed SOA/NS records are read-only (
409if deleted). - To update a record: delete by
recordId, then add the new one (or confirm with the user). - Discovery does not register domains or charge money; registration/quote is out of scope of this skill.
How to run
- Export
CURRENT_SKILL_DIRECTORY→ registered skill dir (holds.env). cdto library skill folder;install.sh pip init .once.- Run
python scripts/cli.py …; stdout is JSON.
Notes
- Never commit
.env/GODADDY_PAT. - Prefer JSON output from the CLI for agents.