- name
- porkbun-domains
- description
- Manage domains and DNS via the Porkbun API. Use when asked to list domains, check domain availability, manage DNS records (A, AAAA, CNAME, MX, TXT, etc.), update nameservers, set up URL forwarding, retrieve SSL certificates, check pricing, or toggle auto-renew. Covers all Porkbun API v3 endpoints. NOT for other registrars (Cloudflare, Namecheap, GoDaddy). Requires PORKBUN_API_KEY and PORKBUN_SECRET_KEY in env or workspace .env file.
Porkbun Domains & DNS
Manage domains and DNS records via the Porkbun API v3.
Setup
API keys: PORKBUN_API_KEY and PORKBUN_SECRET_KEY in environment or ~/.openclaw/workspace/.env.
Get keys at: https://porkbun.com/account/api
Shell Script
All operations via scripts/porkbun.sh. Run with bash <skill-dir>/scripts/porkbun.sh <command>.
Domain Commands
porkbun.sh ping # Test API connection
porkbun.sh list # List all domains (status, expiry, auto-renew)
porkbun.sh check example.com # Check availability + pricing
porkbun.sh ns example.com # Get current nameservers
porkbun.sh ns-update example.com ns1.cf.com ns2.cf.com # Update nameservers
porkbun.sh auto-renew example.com on|off
porkbun.sh pricing # All TLD pricing (no auth needed)DNS Commands
porkbun.sh dns-list example.com # List all records
porkbun.sh dns-create example.com A @ 76.76.21.21 600 # Create A record
porkbun.sh dns-create example.com CNAME www cname.vercel-dns.com
porkbun.sh dns-create example.com MX @ mail.example.com 300
porkbun.sh dns-create example.com TXT @ "v=spf1 include:_spf.google.com ~all"
porkbun.sh dns-delete example.com <record-id>
porkbun.sh dns-delete-type example.com A www # Delete by type+nameURL Forwarding
porkbun.sh forward-add example.com https://target.com # Root forward
porkbun.sh forward-add example.com https://target.com www # Subdomain
porkbun.sh forward-add example.com https://target.com "" permanent
porkbun.sh forward-list example.com
porkbun.sh forward-delete example.com <id>SSL
porkbun.sh ssl example.com # Retrieve SSL cert bundleCommon Workflows
Point domain to Vercel
porkbun.sh dns-create example.com A @ 76.76.21.21
porkbun.sh dns-create example.com CNAME www cname.vercel-dns.comPoint domain to Cloudflare (DNS proxy)
porkbun.sh ns-update example.com adam.ns.cloudflare.com betty.ns.cloudflare.comRedirect domain to another
porkbun.sh forward-add old-domain.com https://new-domain.com "" permanentAPI Details
- Base URL:
https://api.porkbun.com/api/json/v3 - All requests: HTTP POST with JSON body containing
apikey+secretapikey - Rate limits apply — avoid tight loops, serialize requests
- Domain registration via API is supported but use the dashboard for purchases
.dedomains do not support WHOIS privacy (DENIC limitation)
Response Parsing
All responses include "status": "SUCCESS" or "status": "ERROR". Parse with jq:
porkbun.sh list | jq '.domains[] | {domain, status, expireDate}'
porkbun.sh dns-list example.com | jq '.records[] | {id, type, name, content}'