Manage Domains Portfolio

# Manage Domains Portfolio ## When to use Use this skill when you need to check domain inventory, look up specific domains, check expiry dates, manage auto-renew settings, or sync the portfolio from NameSilo. ## Prerequisites - Access to the domains API at `https://api-production-8e63.up.railway.app/api/v1` - Admin token for authentication ## Instructions ### Authentication ```bash BASE="https://api-production-8e63.up.railway.app/api/v1" AUTH="Authorization: Bearer <admin_token>" ``` ### Get portfolio stats ```bash curl -s -H "$AUTH" "$BASE/domains/stats" | jq . ``` Returns total domains, TLD breakdown, expiry warnings, and auto-renew status counts. ### List domains with filtering ```bash # All .blog domains curl -s -H "$AUTH" "$BASE/domains?tld=.blog&per_page=100" | jq '.data[] | {domain, expires, auto_renew}' # Search by keyword curl -s -H "$AUTH" "$BASE/domains?search=ai&per_page=50" | jq '.data[] | .domain' # Domains expiring soon curl -s -H "$AUTH" "$BASE/domains?expiring_within=30&per_page=100" | jq '.data[] | {domain, expires}' # Paginate through all domains curl -s -H "$AUTH" "$BASE/domains?page=1&per_page=100" | jq . ``` ### Get details for a specific domain ```bash curl -s -H "$AUTH" "$BASE/domains/skynet.ceo" | jq . ``` ### Sync portfolio from NameSilo ```bash curl -s -X POST -H "$AUTH" "$BASE/sync" | jq . ``` This fetches the latest domain list from NameSilo's API and updates the local database. Run this periodically to keep the inventory current. ### Common patterns **Find all domains for a specific TLD:** ```bash for tld in .blog .ceo .ai .dev .com; do count=$(curl -s -H "$AUTH" "$BASE/domains?tld=$tld&per_page=1" | jq '.total') echo "$tld: $count domains" done ``` **Export domains expiring in the next 90 days:** ```bash curl -s -H "$AUTH" "$BASE/domains?expiring_within=90&per_page=500" \ | jq -r '.data[] | [.domain, .expires, .auto_renew] | @csv' ``` **Check if a specific domain is in the portfolio:** ```bash curl -s -H "$AUTH" "$BASE/domains?search=example.com" | jq '.data | length' ``` ## Troubleshooting - **Empty results**: The API paginates. Check `.total` in the response and increase `per_page` or iterate pages. - **Stale data**: Run the sync endpoint to refresh from NameSilo. - **Auth failed**: Verify the admin token is current. - **Domain not found**: It may be on a different registrar. Check NameSilo dashboard directly. ## References - Domains API: `https://api-production-8e63.up.railway.app/api/v1` - Dashboard: `https://domains.skynet.ceo` - NameSilo: `https://www.namesilo.com` - Total domains: ~1,772+