---
name: domain-watch
description: Watch domains for the user. Their own domains (expiry dates, auto-renew, failed renewals, DNS changes) and names they want (alert the moment a taken name drops, or new Drop Radar matches). Finishes with a renewal or a one-click buy link (card or USDC). Free, no key needed for public checks and drop alerts. Use when the user asks "when does my domain expire?", "tell me if my renewal fails", "watch this name", "alert me when X.com drops" or wants expiring-domain deals.
license: MIT
metadata:
  author: StableDomains
  homepage: https://stabledomains.net/skills/domain-watch
  version: "1.0.0"
---

# Domain Watch

Keep an eye on domains: the ones the user owns, and the ones they want.

API base: `https://stabledomains.net/api/v1` (JSON). Add `utm_source=skill-domain-watch` to every call and link.
Same tools on the MCP server `https://stabledomains.net/api/mcp`: `whois_lookup`, `is_domain_dropping`, `watch_domain`, `drop_radar`, `radar_alert`, `list_domains`, `renew_domain`, `set_notification_webhook`.

## 1. Expiry check for any domain (free, no key)
```bash
curl -s "https://stabledomains.net/api/v1/tools/whois?domain=example.com&utm_source=skill-domain-watch"
```
Read `expires`, `status` and `registered`. Flag anything expiring within 30 days. Statuses like `redemption period` or `pending delete` mean the domain has already expired.

Is an expired name about to free up?
```bash
curl -s "https://stabledomains.net/api/v1/tools/dropping?domain=example.com&utm_source=skill-domain-watch"
```
`status` (registered, expired_grace, redemption, pending_delete, available), `verdict`, `drops_at`.

## 2. Alert me when a wanted name drops (free, no key)
```bash
curl -s -X POST "https://stabledomains.net/api/v1/watch?utm_source=skill-domain-watch" \
  -H "content-type: application/json" \
  -d '{"domain":"wanted.com","email":"you@example.com"}'
```
- `email` gets a confirm link first (double opt-in). A `webhook_url` (public https) is active at once.
- Status is re-checked about hourly. Events: `domain.status_changed`, `domain.available` (includes a ready order body).
- Up to 50 watches per email or webhook. Several names: one call per name.

## 3. Drop Radar: expiring and just-dropped names worth having (free)
```bash
curl -s "https://stabledomains.net/api/v1/radar?preset=short-brandable&limit=10&utm_source=skill-domain-watch"
curl -s "https://stabledomains.net/api/v1/radar?tld=com,io&q=ai&available_only=1&limit=10&utm_source=skill-domain-watch"
```
Filters: `preset`, `tld` (comma list), `q` (keyword), `status` (available, pending_delete, redemption, expired_grace), `min_len`, `max_len`, `min_quality`, `max_price`, `drops_within_days`, `available_only=1`, `sort`, `order`, `limit`, `cursor` (use `next_cursor`).
Presets: short-brandable, ai-names, dictionary-com, real-history, cheap-good, dropping-this-week. In the browser: https://stabledomains.net/radar
Each item has `quality`, `quality_reasons`, `value_usd`, `price_usd` and `drops_at`.

Save the search and get new matches pushed:
```bash
curl -s -X POST "https://stabledomains.net/api/v1/radar/alerts?utm_source=skill-domain-watch" \
  -H "content-type: application/json" \
  -d '{"name":"short .com","filters":{"tld":"com","max_len":6,"min_quality":50},"email":"you@example.com"}'
```
Free: 3 alerts per IP (25 with an API key), up to 20 events per alert per day. Webhooks are signed: `X-StableDomains-Signature` = sha256 HMAC of the body with the returned `secret` (shown once).
Feeds: https://stabledomains.net/radar/rss.xml · https://stabledomains.net/radar/feed.json

## 4. The user's own domains on StableDomains (needs their API key)
Auth: `Authorization: Bearer sd_live_…` (from https://stabledomains.net/dashboard).
```bash
curl -s https://stabledomains.net/api/v1/domains -H "Authorization: Bearer $SD_KEY"          # expiry + status for each domain
curl -s https://stabledomains.net/api/v1/autorenew -H "Authorization: Bearer $SD_KEY"        # auto-renew state + renewal balances
```
Get pushed events instead of polling (signed webhook; returns a secret once):
```bash
curl -s -X PUT https://stabledomains.net/api/v1/account/notifications \
  -H "Authorization: Bearer $SD_KEY" -H "content-type: application/json" \
  -d '{"webhook_url":"https://your.app/hooks/domains"}'
```
Events: `domain.expiring` (includes `days_left`, `auto_renew` and `auto_renew_error` when an automatic renewal failed), `domain.renewed`, `dns.changed` (any DNS change made through StableDomains, with the new records), plus registration and transfer events.

DNS change check for any domain, no key: save `GET /api/v1/tools/dns?domain=example.com` and compare `a`, `mx`, `ns` and `spf` with the last run. Report any difference.

## 5. Finish with an action
- **Wanted name is available:** buy link `https://stabledomains.net/basket?add=wanted.com&utm_source=skill-domain-watch` (card, Apple Pay or USDC/USDT, guest checkout).
- **Own domain expiring:** preview first, nothing charged:
  ```bash
  curl -s -X POST https://stabledomains.net/api/v1/domains/example.com/renew -H "Authorization: Bearer $SD_KEY" \
    -H "content-type: application/json" -d '{"years":1,"dry_run":true}'
  ```
  After the user says yes, repeat without `dry_run` (with an `Idempotency-Key` header). The 402 answer is the payment request: pay with x402 or USDC, or give the person its `checkout_url`.
- **Auto-renew off or underfunded:** `POST /api/v1/domains/{domain}/autorenew {"enabled":true}`. Or the user can turn it on from the dashboard.

## Report format
```
| Domain | Expires | Days | Auto-renew | Note |
|---|---|---|---|---|
| example.com | 2027-03-02 | 111 | on | ok |
| wanted.com | — | — | — | pending delete, drops ~Nov 18 · watching |
```
Then one line per action with its link.

## Rules
1. Never renew, buy or change settings without the user's explicit yes to the exact domain and price.
2. Confirm an email watch only tells them after they click the opt-in link.
3. Don't invent expiry dates: quote `expires` from the lookup you just made.
4. Keep webhook secrets out of chat logs; store them where the user's app reads them.
