AI导哈

域名可用性检查服务

一个基于GoDaddy OTE API的域名可用性及价格检查服务，支持批量查询和多种TLD后缀。

  • by OriShmila
  • Python
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 orishmila/mcp-domain-availability

使用说明

MCP域可用性服务器

一种模型上下文协议（MCP）服务器，用于使用GoDaddy OTE（操作测试环境）API检查域可用性和定价。

特性

  • 通过GoDaddy OTE沙盒查看域名可用性和定价
  • 支持多个TLD后缀
  • 快速和全面检查模式
  • 支持批量域检查
  • 速率限制（每分钟60次通话）
  • 以美元为单位的标准化定价，保留两位小数
  • 一致的字段命名和数据结构
  • 周期标准化（以月为单位存储，以年为单位显示）

安装

使用紫外线（推荐）

# Install dependencies
uv add "mcp[cli]"

# Run with MCP Inspector for testing
DOMAIN_API_KEY="your-key:your-secret" mcp dev domain_availability/server.py

手动安装

pip install -e .

配置

环境变量

  • DOMAIN_API_KEY：您的GoDaddy OTE API证书格式 "key:secret" （必填）

备注：服务器默认使用GoDaddy OTE（沙箱）API： https://api.ote-godaddy.com

GoDaddy OTE设置

  1. 注册GoDaddy开发者帐户
  2. 获取OTE（沙箱）API证书
  3. 设置环境变量： DOMAIN_API_KEY="your-ote-key:your-ote-secret"

MCP配置

将此添加到您的MCP客户端配置中（例如，Claude Desktop的 claude_desktop_config.json):

{
  "mcpServers": {
    "domain-availability": {
      "command": "uv",
      "args": ["run", "mcp-domain-availability"],
      "env": {
        "DOMAIN_API_KEY": "your-ote-key:your-ote-secret"
      }
    }
  }
}

用法

开发与测试

# Start MCP Inspector for testing
DOMAIN_API_KEY="your-key:your-secret" mcp dev domain_availability/server.py

这将在以下时间启动MCP检查器 http://localhost:6274 用于交互式测试。

可用工具

服务器提供了一个工具： check_domain_availability

参数

选项1：直接域列表

  • domains：要检查的域名数组（例如。， ["example.com", "example.org"])

选项2：带TLD后缀的基本名称

  • base_name：基本域名（例如。， "example")
  • tld_suffixesTLD后缀数组（例如。， [".com", ".org", ".net", ".io"])

可选的

  • checkType: "FAST" 或 "FULL" （默认值： "FAST")
    • FAST：针对速度进行了优化
    • FULL：针对准确性进行了优化

例子

检查特定域

{
  "domains": ["example.com", "example.org", "example.net"],
  "checkType": "FAST"
}

检查具有多个TLD的基名称

{
  "base_name": "myawesomesite",
  "tld_suffixes": [".com", ".org", ".net", ".io", ".dev", ".app"],
  "checkType": "FULL"
}

响应格式

文本响应：

Domain Availability Check Results:

✅ AVAILABLE DOMAINS:
  • example.com - $12.99 USD for 1 year (Definitive)
  • example.org - $8.99 USD for 2 years (Preliminary)

❌ UNAVAILABLE DOMAINS:
  • example.net - Not available - Domain already registered

JSON响应（规范化字段）：

{
  "domains": [
    {
      "domain_name": "example.com",
      "is_available": true,
      "price_dollars": 12.99,
      "currency_code": "USD",
      "is_definitive": true,
      "registration_period_months": 12
    },
    {
      "domain_name": "example.net",
      "is_available": false,
      "price_dollars": 0.00,
      "currency_code": "USD",
      "is_definitive": true,
      "registration_period_months": 12,
      "error_message": "Domain already registered"
    }
  ],
  "errors": []
}

数据规范化

价格正常化

  • 输入：GoDaddy API以微单位（货币的1/100000）返回价格
  • 输出：转换为美元，保留两位小数
  • 示例: 12000000 微型单位→ $12.00 USD

周期标准化

  • 存储：为保持一致性，以月为单位存储的期间
  • 显示：转换为年份，便于用户显示
  • 示例: 12 months → "1 year", 24 months → "2 years"

字段命名

一致、明确的字段名称：

  • domain_name （而不是 domain)
  • is_available （而不是 available)
  • price_dollars （而不是 price)
  • currency_code （而不是 currency)
  • is_definitive （而不是 definitive)
  • registration_period_months （而不是 period)
  • error_message （而不是 error)

API集成

此服务器与GoDaddy OTE API集成：

  • 基本URL: https://api.ote-godaddy.com
  • 端点: GET /v1/domains/available?domain={domain}
  • 标头: Authorization: sso-key {key}:{secret}
  • 速率限制：每分钟60个请求

身份验证格式

Authorization: sso-key your-key:your-secret

错误处理

服务器处理各种错误情况：

  • 缺少API密钥
  • 无效域
  • API速率限制（429）-带重试指导
  • 部分回复（203）
  • 身份验证错误（401403）
  • 服务器错误（500）
  • 网络超时

发展

设置开发环境

# Clone and setup
git clone <repository>
cd mcp-free-domain
uv add "mcp[cli]"

# Run tests
pytest

# Start development server
DOMAIN_API_KEY="test-key:test-secret" mcp dev domain_availability/server.py

MCP检验员测试

  1. 设置您的OTE凭据： DOMAIN_API_KEY="your-key:your-secret"
  2. 运行： mcp dev domain_availability/server.py
  3. 打开浏览器 http://localhost:6274
  4. 如果出现提示，请使用终端中显示的会话令牌
  5. 测试 check_domain_availability 工具

许可证

MIT许可证

支持

对于问题和疑问，请在存储库中创建问题。

相关 MCP