agieth.ai API Skill
Interact with agieth.ai domain registration and management API.
Requirements
This skill requires an agieth.ai API key and email address:
| Variable | Required | Description |
|---|
| INLINECODE0 | Yes | Your agieth.ai API key |
| INLINECODE1 |
Yes | Email associated with your API key |
|
ETH_WALLET_PRIVATE_KEY | Only for payments | Ethereum private key — only needed for
send_payment. You can also use any external wallet instead. |
|
ETH_RPC_PRIMARY | No | Ethereum RPC endpoint — defaults to
https://ethereum.publicnode.com |
|
ETH_RPC_FALLBACK | No | Fallback RPC — defaults to
https://eth.drpc.org |
|
cloudflared | No | Only needed for Cloudflare Tunnel hosting. If you have a static IP, you can point DNS A records at it instead — no tunnel needed. |
API base URL is hardcoded to https://api.agieth.ai — no configuration needed.
How Payments Work
Domain registration payments are made on the Ethereum blockchain — the agieth API generates a unique payment address and ETH amount for each quote. You can pay using any Ethereum wallet (MetaMask, Rabby, hardware wallet, etc.) by sending the exact ETH amount to the address returned by the API — no private key needs to be provided to this skill.
The send_payment method is included as a convenience for fully-automated workflows. If you prefer manual payment or a different wallet, simply use the payment_address and price_eth from the quote response in your own wallet.
Summary:
- - Payments are ETH transfers on the Ethereum blockchain
- No tokens, no smart contracts, no third-party custody of funds
- Payment address and amount are unique per quote and expire with the quote
- External RPC endpoints used:
https://ethereum.publicnode.com and INLINECODE14
Installation
- 1. Get an API key from api.agieth.ai
- Set environment variables:
CODEBLOCK0
Or create a .env file in your workspace:
CODEBLOCK1
Quick Start
CODEBLOCK2
All Methods
Domain Operations
CODEBLOCK3
DNS Management
CODEBLOCK4
Cloudflare Integration (FREE)
CODEBLOCK5
Cloudflare Tunnel Hosting (optional — cloudflared not required)
CODEBLOCK6
Alternative: If you have a static IP, you can skip cloudflared entirely. Just add an A record pointing to your static IP instead.
Balance & Credits
CODEBLOCK7
Pricing
| Service | Cost |
|---|
| Domain registration | Registrar price + markup |
| Cloudflare DNS |
FREE |
| Cloudflare Tunnel | FREE |
| SSL Certificates | FREE |
Cloudflare Authorization
The tunnel feature uses agieth.ai's Cloudflare account — not yours. Agieth creates the tunnel, gives you a token, and Cloudflare sees all traffic as agieth's. You do NOT need your own Cloudflare API token for this skill to work.
Security Notes
- - API keys should be treated as secrets
- Only provide keys with minimum required permissions
- Always verify the
payment_address returned by the API before sending crypto — the skill surfaces the address from the server response - The skill sends the API key via the
Authorization: Bearer HTTP header exclusively (no query parameters) - This skill makes network requests to:
-
https://api.agieth.ai (main API)
-
https://ethereum.publicnode.com and
https://eth.drpc.org (Ethereum blockchain RPC — for ETH balance checks and transaction broadcasting)
-
https://cloudflare.com (via cloudflared tunnel, when tunnel feature is used — optional)
API Documentation
Full API documentation: https://api.agieth.ai/api/v1/manifest
Links
- - API Docs: https://api.agieth.ai/api/v1/manifest
- Homepage: https://agieth.ai
- Skill Guide: https://github.com/larkins/oneshotsite
- Support: support@agieth.ai
agieth.ai API 技能
与 agieth.ai 域名注册和管理 API 进行交互。
要求
此技能需要 agieth.ai API 密钥和电子邮件地址：
| 变量 | 必需 | 描述 |
|---|
| AGIETHAPIKEY | 是 | 您的 agieth.ai API 密钥 |
| AGIETH_EMAIL |
是 | 与您的 API 密钥关联的电子邮件 |
| ETH
WALLETPRIVATE
KEY | 仅用于支付 | 以太坊私钥 — 仅 sendpayment 需要。您也可以使用任何外部钱包代替。 |
| ETH
RPCPRIMARY | 否 | 以太坊 RPC 端点 — 默认为 https://ethereum.publicnode.com |
| ETH
RPCFALLBACK | 否 | 备用 RPC — 默认为 https://eth.drpc.org |
| cloudflared | 否 | 仅 Cloudflare Tunnel 托管需要。如果您有静态 IP，可以直接指向 DNS A 记录 — 无需隧道。 |
API 基础 URL 已硬编码为 https://api.agieth.ai — 无需配置。
支付方式
域名注册支付在以太坊区块链上进行 — agieth API 为每个报价生成唯一的支付地址和 ETH 金额。您可以使用任何以太坊钱包（MetaMask、Rabby、硬件钱包等）支付，只需将准确的 ETH 金额发送到 API 返回的地址 — 无需向此技能提供私钥。
sendpayment 方法作为全自动工作流的便捷方式提供。如果您更喜欢手动支付或使用不同的钱包，只需使用报价响应中的 paymentaddress 和 price_eth 在您自己的钱包中操作。
总结：
- - 支付是以太坊区块链上的 ETH 转账
- 无需代币、智能合约或第三方资金托管
- 支付地址和金额每个报价唯一，并随报价过期
- 使用的外部 RPC 端点：https://ethereum.publicnode.com 和 https://eth.drpc.org
安装
- 1. 从 api.agieth.ai 获取 API 密钥
- 设置环境变量：
bash
export AGIETHAPIKEY=agiethyourkey_here
export AGIETHEMAIL=youremail@example.com
仅自动支付需要（可选 — 参见上方支付方式）：
export ETH
WALLETPRIVATE_KEY=0x...
或者在工作区创建 .env 文件：
AGIETHAPIKEY=agiethyourkey_here
AGIETHEMAIL=youremail@example.com
仅自动支付需要：
ETH
WALLETPRIVATE_KEY=0x...
可选的 RPC 覆盖：
ETH
RPCPRIMARY=https://your-preferred-rpc
ETH
RPCFALLBACK=https://your-fallback-rpc
快速开始
python
from skill import AgiethClient
使用环境变量初始化
client = AgiethClient()
或直接传递凭据
client = AgiethClient(
api
key=agiethyour
keyhere,
email=your_email@example.com
)
检查域名可用性
result = client.check_availability(example.com)
{available: True, price_usd: 12.99}
所有方法
域名操作
python
检查可用性
client.check_availability(example.com)
创建报价（开始注册）
quote = client.create_quote(
domain=example.com,
years=1,
registrar=namecheap
)
获取报价状态
client.get
quote(quoteid)
检查支付状态
client.check
payment(quoteid)
获取域名信息
client.get
domaininfo(example.com)
DNS 管理
python
列出 DNS 记录
client.list
dnsrecords(example.com)
添加 DNS 记录
client.add
dnsrecord(
domain=example.com,
record_type=A,
name=www,
value=192.168.1.1
)
删除 DNS 记录
client.delete
dnsrecord(example.com, record_id)
Cloudflare 集成（免费）
python
创建 Cloudflare 区域
zone = client.create
cloudflarezone(example.com)
列出区域
zones = client.list
cloudflarezones()
在 Cloudflare 中创建 DNS 记录
client.create
cloudflaredns_record(
zone
id=zone[zoneid],
record_type=A,
name=@,
content=192.168.1.1
)
创建页面规则（www 重定向）
client.create
pagerule(
zone
id=zone[zoneid],
target_url=www.example.com/*,
forward_url=https://example.com/$1
)
Cloudflare Tunnel 托管（可选 — 不需要 cloudflared）
python
创建隧道（无需公共 IP）
result = client.create
tunnel(example.com, localport=3000)
返回 tunnel_token
运行：cloudflared tunnel run --token
替代方案： 如果您有静态 IP，可以完全跳过 cloudflared。只需添加指向您静态 IP 的 A 记录即可。
余额与积分
python
检查余额
balance = client.get_balance()
检查积分
credits = client.get_credits()
定价
| 服务 | 费用 |
|---|
| 域名注册 | 注册商价格 + 加价 |
| Cloudflare DNS |
免费 |
| Cloudflare Tunnel | 免费 |
| SSL 证书 | 免费 |
Cloudflare 授权
隧道功能使用 agieth.ai 的 Cloudflare 账户 — 而非您的。Agieeth 创建隧道，为您提供令牌，Cloudflare 将所有流量视为 agieth 的。您无需自己的 Cloudflare API 令牌即可使用此技能。
安全说明
- - API 密钥应视为机密
- 仅提供具有最低必要权限的密钥
- 在发送加密货币之前，始终验证 API 返回的 payment_address — 该技能从服务器响应中获取地址
- 该技能仅通过 Authorization: Bearer HTTP 标头发送 API 密钥（无查询参数）
- 此技能会向以下地址发起网络请求：
- https://api.agieth.ai（主 API）
- https://ethereum.publicnode.com 和 https://eth.drpc.org（以太坊区块链 RPC — 用于 ETH 余额检查和交易广播）
- https://cloudflare.com（通过 cloudflared 隧道，使用隧道功能时 — 可选）
API 文档
完整 API 文档：https://api.agieth.ai/api/v1/manifest
链接
- - API 文档： https://api.agieth.ai/api/v1/manifest
- 主页： https://agieth.ai
- 技能指南： https://github.com/larkins/oneshotsite
- 支持： support@agieth.ai
