oc-domain-check_skill

Overview

This skill checks domain availability and pricing through Vercel and streamlines buying and managing domains via the Vercel CLI or API. It surfaces purchase and renewal prices, shows taken vs available status, and supports interactive purchases and programmatic workflows. Use it to research TLD costs and operate domains within a Vercel team account.

How this skill works

Availability checks call the Vercel Registrar price endpoint for each queried name and TLD; a null purchasePrice means the name is taken, a numeric purchasePrice means it is available. The Vercel CLI wraps interactive flows for buying, listing, inspecting, adding, moving, transferring-in, and removing domains. For automation, the skill uses the Vercel API with a VERCEL_TOKEN and optional teamId to query prices or create purchase requests.

When to use it

• Research name availability and compare prices across TLDs quickly.
• Automate domain price checks in scripts or CI using the Vercel API and token.
• Purchase domains interactively from the same machine that has Vercel CLI auth.
• Add or attach owned domains to Vercel projects or move domains between teams.
• Transfer domains into Vercel or out to another registrar when consolidating management.

Best practices

• Use the price API for availability checks rather than domains inspect (inspect only works for owned domains).
• Keep your Vercel CLI authenticated on the machine that performs interactive buys; the token is typically in ~/.local/share/com.vercel.cli/auth.json.
• When calling the CLI programmatically for purchases, run with pty:true so the confirmation prompt works.
• Include teamId when querying or buying if you operate under a Vercel team to get correct pricing and ownership.
• Double-check high-cost TLDs (for example .ai) before confirming purchases to avoid unexpected charges.

Example use cases

• Quickly scan myproject across common TLDs to find an available domain and reasonable renewal price.
• Script nightly checks for a brand name and notify when a desired TLD becomes available.
• Purchase a domain interactively with npx vercel domains buy from an authenticated workstation.
• Add a newly purchased domain to a Vercel project with npx vercel domains add mydomain.com my-project.
• Transfer an externally registered domain into Vercel with npx vercel domains transfer-in mydomain.com.