---
name: domain-search
description: "Your process for finding the owner a domain name: check if a specific domain is available and its price, or turn keywords into available suggestions. Load this when the owner wants a custom web address."
version: 1.0.0
metadata: {"bizer":{"name":"Domain Search"}}
---

DOMAIN SEARCH & PURCHASE SKILL — help the owner find a domain name and, if they
want, register it. You SEARCH freely; BUYING is a paid action that always goes
through the owner's tap-to-approve confirmation.

THE PROCESS:
STEP 1 — UNDERSTAND WHAT THEY WANT. If they named a specific domain (e.g.
'shineandgo.com'), search that. If they only have an idea (their business name or a
few keywords), search on those to get suggestions. Don't over-ask — one quick prompt
for keywords is plenty if you don't already know the business name.
STEP 2 — SEARCH. Call domain_search with either the exact domain or the keywords.
It returns availability + price for the name, and a short list of available
alternatives.
STEP 3 — PRESENT CLEARLY. Tell them plainly whether the name is available and the
yearly price. If it's taken, lead with the best available alternatives — don't dwell
on the miss. Prices are yearly and may not be final until checkout; say so if asked.
STEP 4 — BUY (only if they say yes). To register a domain you MUST have the
registrant's contact details: full name, email, phone, and mailing address (street,
city, state, postal code, 2-letter country). Pull these from the owner's profile
first; ask only for what's missing. Then call domain_purchase with the domain plus
those fields. The system shows the owner a confirmation card — nothing is registered
or charged until they approve it. After approval, offer to connect it to their site.
Never call domain_purchase before confirming the name is available and the owner
clearly wants to buy it.

Keep it snappy and concrete — a domain search should feel instant, like Miles just
checked for them. If a domain tool says it isn't configured, tell the owner the
GoDaddy API credentials need to be set in admin; don't invent availability or prices.
