核心用法
Gandi Skill 是一个针对 Gandi 域名注册商的综合性 API 集成工具,专为 Moltbot 平台设计。用户通过个人访问令牌(PAT)完成身份验证后,可实现以下核心功能:
读取操作(Phase 1 已上线)
- 列出账户下的所有域名,查看过期时间、自动续费状态和服务信息
- 获取指定域名的 DNS 记录详情(A、CNAME、MX 等记录类型)
- 检查域名可用性及定价信息
- 智能域名建议:基于用户输入的名称生成 TLD 变体和名称变体(连字符、前缀、后缀、缩写等)
- SSL 证书状态检查
配置管理
- 支持通过
~/.config/gandi/api_token存储访问令牌(推荐权限 600) - 可选的联系人信息配置,用于域名注册(
~/.config/gandi/contact.json) - 支持沙盒环境测试
显著优点
1. 隐私友好设计:提供"保留"与"自动清除"两种联系人数据管理模式,隐私敏感用户可选择注册后自动删除
2. 智能域名发现:内置 13+ 种 TLD 支持和 5 种名称变体算法,大幅提升可用域名发现效率
3. API 公民意识:内置速率限制配置(默认 3 并发、200ms 延迟、100 请求/分钟),避免对 Gandi API 造成压力
4. 模块化架构:核心 API 客户端可独立导入,脚本工具与 Moltbot 集成分离,便于二次开发
潜在缺点与局限性
1. 功能不完整:当前为 Phase 1 MVP,关键功能如域名注册、DNS 修改、续费管理等尚未实现
2. 单组织限制:暂不支持多组织/多令牌管理(Phase 4 规划中)
3. 令牌管理依赖文件系统:令牌存储于本地文件,多设备场景需要手动同步
4. 无 Gateway Console 配置:YAML 配置支持仍在开发中(Issue #3)
适合人群
- 已使用或计划使用 Gandi 作为域名注册商的技术用户
- 需要通过 CLI 或聊天机器人快速查询域名信息、检查可用性的开发者
- 重视隐私、希望最小化联系人数据留存的用户
- 需要批量检查域名可用性、生成域名变体建议的产品经理或创业者
常规风险
- 令牌泄露风险:虽然文档强调 600 权限和 git 排除,但文件系统存储仍存在被其他进程读取的可能
- API 权限升级风险:Phase 2+ 需要 write 权限,当前 read-only 令牌需更换,权限扩大增加潜在影响面
- 沙盒/生产环境混淆:手动切换 API URL 文件配置容易误操作
- 联系人数据残留:即使选择"自动清除"模式,注册过程中仍存在临时数据暴露窗口
- 速率限制误触发:默认 100 请求/分钟限制低于 Gandi 官方 1000,高频率场景可能不必要受限