Unique.domains

Unique Domains MCP 服务

这是 Unique Domains API 的 MCP 服务。它让 AI 助手能够从 Unique Domains 目录中读取域名、单词、顶级域名、注册商价格、域名市场、趋势和行业日程。

每个工具读取的都是截至当天存储的数据。它们都不会注册、购买或更改名称。

• 托管服务，无需安装或密钥：https://mcp.unique.domains/mcp
• 在你的机器上运行：npx -y @uniquedomains/mcp-server

连接你的助手

Claude

在 Claude（网页端或桌面版）中，打开 Settings，然后选择 Connectors，添加自定义连接器并粘贴 https://mcp.unique.domains/mcp。无需登录。

若要改为在你的机器上运行，请将以下内容添加到 Claude Desktop 的 claude_desktop_config.json：

{
  "mcpServers": {
    "uniquedomains": { "command": "npx", "args": ["-y", "@uniquedomains/mcp-server"] }
  }
}

Claude Code

claude mcp add --transport http uniquedomains https://mcp.unique.domains/mcp

或者在你的机器上使用会员密钥：

claude mcp add uniquedomains -e UD_API_KEY=ud_live_your_key -- npx -y @uniquedomains/mcp-server

Cursor

添加到 Cursor（直接链接为 cursor://anysphere.cursor-deeplink/mcp/install?name=uniquedomains&config=eyJ1cmwiOiJodHRwczovL21jcC51bmlxdWUuZG9tYWlucy9tY3AifQ==），或者将以下内容放入 .cursor/mcp.json：

{
  "mcpServers": {
    "uniquedomains": { "url": "https://mcp.unique.domains/mcp" }
  }
}

VS Code

code --add-mcp '{"name":"uniquedomains","type":"http","url":"https://mcp.unique.domains/mcp"}'

或者放入 .vscode/mcp.json：

{
  "servers": {
    "uniquedomains": { "type": "http", "url": "https://mcp.unique.domains/mcp" }
  }
}

ChatGPT

开启开发者模式（Settings、Apps and Connectors、Advanced settings）后，使用 URL https://mcp.unique.domains/mcp 创建连接器，无需身份验证。

任何其他客户端

使用 https://mcp.unique.domains/mcp 进行 Streamable HTTP 连接，或使用 npx -y @uniquedomains/mcp-server 通过 stdio 连接。

免费工具和会员密钥

不使用密钥时，服务会返回 Unique Domains 网站向所有人展示的信息：名称的状态和注册记录、域名后缀信息、注册商价格、市场汇总、趋势和日程。

会员密钥会根据其方案（Founder 或 Investor）启用相应的密钥工具。在 Unique Domains 的 Settings、Account、API 下创建密钥，然后在你的机器上将其传给服务：

UD_API_KEY=ud_live_your_key npx -y @uniquedomains/mcp-server

服务在启动时读取密钥对应的方案，并列出该方案启用的工具。方案详情见 unique.domains/api。

托管连接器仅提供免费工具，且不接受密钥。三个免费工具仅在 npm 服务中提供（ud_get_market_sales_word、ud_get_word_market、ud_list_tld_prices）：每位调用者每天可查询一个单词或一个域名后缀；而托管连接器的所有用户共用一个调用者额度。

答案包含的内容

• structuredContent：API 的 data、meta 和 links，具体格式由工具的输出架构描述。
• content：一行供读者阅读的内容（名称及其主要信息，或行数和前几个名称），然后是相同的 JSON 文本。
• links.details：与主题相关的 Unique Domains 公开页面（托管连接器提供时）。
• 列表默认返回 20 行。设置了 meta.cursor 时，将其作为 cursor 传入以读取下一页。
• 拒绝请求时会返回一句助手可据此采取行动的话：说明问题、可接受的内容，或限制何时重置。

其他位置的相同数据

• API 参考文档：unique.domains/api
• SDK 和命令行工具：UniqueDomains/nodejs（@uniquedomains/sdk、@uniquedomains/cli）
• GitHub 上的开放数据集：单词域名、即将到期的单词域名、每日版本、2026 年新 gTLD 申请以及组织中的其他内容

工具

无需密钥即可使用 56 个工具（托管连接器上为 53 个）；会员密钥可额外启用 25 个工具，其中 Investor 工具仅适用于 Investor 密钥。

工具	读取内容	需求
ud_get_name	某个域名的已存储答案	免费
ud_batch_names	一次调用中最多 100 个域名的键控名称资源	Investor 密钥
ud_check_name	从注册局和注册商实时读取一个域名	member 密钥
ud_get_name_prices	某个域名的所有已存储注册商报价	member 密钥
ud_get_name_registry	某个域名最新的已存储注册局记录	免费
ud_get_name_registry_history	某个域名已存储的注册局记录版本及其变动	Investor 密钥
ud_get_name_dns	某个域名最新的已存储 DNS 读取结果	免费
ud_list_name_changes	某个域名的变更事件，按时间从新到旧排列	Investor 密钥
ud_get_name_history	某个域名的网络历史，按我们的区间呈现	Investor 密钥
ud_get_name_value	某个域名已存储的价值估算及最近 20 次估算	member 密钥
ud_appraise_name	对一个已存储但缺少估值的域名执行估值	Investor 密钥
ud_get_name_comps	某个域名的相似销售汇总，以及其词语售出的后缀	免费
ud_get_name_auction	某个域名的在售拍卖（如有）	免费
ud_resolve_word	将调用者输入的内容转换为其指代的目录词语	免费
ud_list_word_categories	目录中的词语类别，按名称排列	免费
ud_batch_words	一次调用中最多 100 个词语档案	Investor 密钥
ud_list_words	按文本和筛选条件搜索目录中的词语	member 密钥
ud_get_word	某个词语的档案	member 密钥
ud_get_word_endings	夜间更新中记录的某个词语后缀	免费
ud_list_word_names	某个词语在有销售记录的后缀上的目录域名，按名称排列	member 密钥
ud_get_word_trademarks	某个词语的商标数量及其完全匹配商标	Investor 密钥
ud_get_word_notability	某个词语的 Wikipedia 和 Wikidata 信息	免费
ud_get_word_market	夜间更新中的某个词语销售和拍卖汇总	免费，仅限 npm
ud_list_related_words	某个词语的同义词及相关词语	Investor 密钥
ud_list_word_fits	某个词语与各个关键词列表中包含它的后缀的匹配程度	Investor 密钥
ud_request_word	将某个词语加入目录	Investor 密钥
ud_get_word_request	某个词语申请的状态	Investor 密钥
ud_list_domains	筛选条件下的单词目录域名	免费
ud_get_domain	一个目录域名，可按名称或 ID 查询	免费
ud_list_expiring_domains	即将到期或已过期的目录域名，按到期日排列	Investor 密钥
ud_get_domain_drops	某一天即将释放的域名	免费
ud_list_domain_hacks	域名组合词	免费
ud_list_domain_changes	目录变更动态，按时间从新到旧排列	Investor 密钥
ud_get_catalog_stats	最新一天的目录关键总量	免费
ud_list_tlds	所有根级 TLD 及其注册局信息和发布阶段	免费
ud_get_tld	某个 TLD 的完整信息	免费
ud_get_tld_stats	某个后缀最新的市场数据	免费
ud_list_tld_phases	某个后缀所有有日期的发布阶段，按时间顺序排列	免费
ud_list_tld_changes	某个后缀公开的注册局变更，按时间从新到旧排列	免费
ud_list_tld_keywords	目录关联到某个后缀的关键词，按类型排列	免费
ud_list_tld_applications	ICANN 发布的 2026 年新 gTLD 轮次信息	免费
ud_list_tld_application_changes	该轮次所有记录在案的状态或争议变更	免费
ud_get_tld_application_string	一个申请中的字符串	免费
ud_list_registrars	每日价格清单纳入比较的九家注册商	免费
ud_list_registrar_prices	某家注册商的标价，按后缀字母顺序排列	免费
ud_list_registrar_changes	某家注册商已确认的标价变更，按时间从新到旧排列	免费
ud_get_registrar_footprint	最新覆盖统计日中该注册商名下受追踪的域名	member 密钥
ud_list_tld_prices	某个后缀在所有注册商处的标价	免费，仅限 npm
ud_list_tld_price_history	某个后缀仅包含价格变更的记录，按时间从新到旧排列	Investor 密钥
ud_list_price_changes	九家注册商已确认的价格变更	免费
ud_list_price_traps	首年最便宜、续费却为陷阱价的后缀	免费
ud_list_cheapest_prices	最多 100 个后缀中每个后缀价格最低的注册商	member 密钥
ud_list_venues	提供档案及四舍五入后覆盖规模的停放和交易市场平台	免费
ud_get_venue	某个平台的档案及其已验证的挂牌条款	免费
ud_list_iana_registrars	注册局同步记录的 IANA 注册商列表	免费
ud_get_iana_registrar	按 ID 查询某个 IANA 注册商	免费
ud_get_market_sales	域名销售概况的关键汇总数据	免费
ud_list_market_sales_series	某个销售序列，按日、周或月排列，从最早到最近	免费
ud_list_market_sales_endings	各后缀 12 个月和 30 天的销售数据	免费
ud_get_market_sales_lengths	.com、.ai、.io 和 .co 按标签长度统计的销售数据	免费
ud_list_market_sales_movers	最近 30 天销售情况发生变化的最多 10 个词语	免费
ud_get_market_sales_word	某个词语过去 12 个月的销售市场数据	免费，仅限 npm
ud_get_market_auctions	今日各个平台的域名拍卖	免费
ud_list_market_auctions_sample	当日固定样本中最多 20 个正在拍卖的单词域名	免费
ud_list_market_auction_venues	七个拍卖平台及其已验证规则和今日数量	免费
ud_list_market_auction_outcomes	各平台已确认的拍卖结果	Investor 密钥
ud_list_trends	所有已发布趋势及其最新一期数据和首末期日期	免费
ud_get_trend	某个趋势	免费
ud_list_trend_categories	趋势类别，即 GET /trends 的 category 筛选条件	免费
ud_list_trend_pool	各期所选用的已纳入趋势候选项	member 密钥
ud_list_events	某个月的行业活动	免费
ud_get_event	某个行业活动及其主办方	免费
ud_get_agenda	某个月的完整公开日程	免费
ud_get_latest_edition	某个页面最新发布的每日版本	免费
ud_get_edition	某个页面指定日期发布的版本	免费
ud_get_meta_enums	从代码目录读取的所有载荷所用枚举值	免费
ud_get_meta_freshness	扫描器各轮扫描的最新程度	免费
ud_list_meta_datasets	GitHub 数据集及提供相同记录的 API 路径	免费
ud_list_meta_trademark_classes	商标注册所依据的 45 个尼斯分类	免费
ud_get_meta_providers	注册商身份信息、拍卖平台目录和停放服务目录	免费
ud_get_key	调用密钥自身的套餐、额度和月份	member 密钥

设置

变量	配置文件	作用
UD_API_KEY	local	会员密钥：添加其套餐包含的密钥工具。
UD_MCP_PROFILE	both	local（默认值）或 hosted。
UD_API_BASE	both	用于本地运行 API 的另一个 API 基址。
UD_CONNECTOR_SECRET	hosted	Connector 的共享密钥，以 X-UD-Connector-Secret 发送。
UD_WELLKNOWN_FILES	hosted	以 JSON 对象形式提供在 /.well-known/ 下的文件（见下文）。
PORT	hosted	HTTP 端口，默认为 8080。

hosted 配置文件仅注册免费工具；无论 UD_API_KEY 的值是什么，都不会发送 Authorization 标头；会从回答中移除 register 和 product 链接，并添加 links.details。没有密钥时（使用 hosted 配置文件，或未设置 UD_API_KEY 的 npm 服务），仅密钥用户可发送的输入（例如 sort 或 prefix）不会列出。

UD_WELLKNOWN_FILES 将文件名映射到文件内容（以纯文本形式提供），或映射到 { "body": "...", "contentType": "..." }。因此，目录的验证文件只需更改变量，无需部署：

{
  "openai-apps-challenge": "<the token from OpenAI's portal>",
  "mcp-registry-auth": "v=MCPv1; k=ed25519; p=<public key>",
  "glama.json": { "body": "{\"$schema\":\"https://glama.ai/mcp/schemas/connector.json\",\"claim\":\"<token>\"}", "contentType": "application/json" }
}

自行运行托管 Connector

docker build -t uniquedomains-mcp-server .
docker run -p 8080:8080 uniquedomains-mcp-server

此镜像以 UD_MCP_PROFILE=hosted 运行 node dist/http.js：提供 POST /mcp（无状态的 Streamable HTTP，纯 JSON 回答）、GET /healthz 以及 well-known 文件。所有回答均设置 Cache-Control: no-store，且 /mcp 允许任何来源。

对于以这种方式检查服务的目录，同一镜像在提供 stdio 入口时也支持 stdio：

docker run -i --rm -e UD_MCP_PROFILE=local uniquedomains-mcp-server dist/stdio.js

开发

npm ci
npm run build
npm test
npm run smoke

• npm run generate 根据 @uniquedomains/sdk 附带的 API 文档，重新生成 src/generated/tools.ts、openapi/v1.json 和上方的工具列表；-- --check 会在文件过期时失败，-- --live 会与实时文档进行比较。
• npm run smoke 使用 MCP Inspector 针对 fixture API 测试两种传输方式；-- --live 使用实时 API。
• npm run plugin 会构建 dist/chatgpt-plugin.zip 并根据 OpenAI 的限制对其进行检查；若 plugin/review.json 中仍包含占位文本，则会拒绝构建（npm run plugin:test 会照常构建，供 CI 使用）。
• 每晚运行的 contract 工作流会使用工作流令牌创建拉取请求，该令牌需要在仓库设置中启用“Allow GitHub Actions to create and approve pull requests”（Settings、Actions、General）。

许可证

MIT