Back to Details

pp-namecheap

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese
<!-- GENERATED FILE — DO NOT EDIT. This file is a verbatim mirror of library/developer-tools/namecheap/SKILL.md, regenerated post-merge by tools/generate-skills/. Hand-edits here are silently overwritten on the next regen. Edit the library/ source instead. See AGENTS.md "Generated artifacts: registry.json, cli-skills/". -->
<!-- 生成文件 — 请勿编辑。 此文件是library/developer-tools/namecheap/SKILL.md的精确镜像， 由tools/generate-skills/在合并后重新生成。此处的手动编辑会在下次重新生成时被静默覆盖。请改为编辑library/下的源文件。 参见AGENTS.md中的“生成产物：registry.json、cli-skills/”。 -->

Namecheap — Printing Press CLI

Namecheap — Printing Press CLI

Prerequisites: Install the CLI

前提条件：安装CLI

This skill drives the 
namecheap-pp-cli
binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:
  1. Install via the Printing Press installer:
    bash
    npx -y @mvanhorn/printing-press install namecheap --cli-only
  2. Verify: 
    namecheap-pp-cli --version
  3. Ensure 
    $GOPATH/bin
    (or 
    $HOME/go/bin
    ) is on 
    $PATH
    .
If the 
npx
install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.3 or newer):
bash
go install github.com/mvanhorn/printing-press-library/library/developer-tools/namecheap/cmd/namecheap-pp-cli@latest
If 
--version
reports "command not found" after install, the install step did not put the binary on 
$PATH
. Do not proceed with skill commands until verification succeeds.
Curated OpenAPI description for Namecheap's XML API. The real API uses a single endpoint (
/xml.response
) with a 
Command
query parameter plus Namecheap's query-string authentication parameters (
ApiUser
, 
ApiKey
, 
UserName
, 
ClientIp
). Generation uses command-shaped pseudo paths that are normalized back to 
/xml.response
by the Namecheap printed CLI patch layer.
该技能驱动
namecheap-pp-cli
二进制文件。在调用此技能的任何命令之前，您必须确认CLI已安装。如果未安装，请先进行安装：
  1. 通过Printing Press安装程序安装：
    bash
    npx -y @mvanhorn/printing-press install namecheap --cli-only
  2. 验证：
    namecheap-pp-cli --version
  3. 确保
    $GOPATH/bin
    （或
    $HOME/go/bin
    ）已添加到
    $PATH
    中。
如果
npx
安装失败（无Node环境、离线等），可回退到直接通过Go安装（要求Go 1.26.3或更高版本）：
bash
go install github.com/mvanhorn/printing-press-library/library/developer-tools/namecheap/cmd/namecheap-pp-cli@latest
如果安装后执行
--version
提示“command not found”，说明安装步骤未将二进制文件添加到
$PATH
中。在验证成功前，请不要继续执行技能命令。
针对Namecheap XML API的精选OpenAPI描述。实际API使用单一端点（
/xml.response
），搭配
Command
查询参数以及Namecheap的查询字符串认证参数（
ApiUser
、
ApiKey
、
UserName
、
ClientIp
）。 生成过程使用命令形伪路径，这些路径会被Namecheap打印CLI补丁层标准化回
/xml.response
。

When Not to Use This CLI

何时不应使用此CLI

Do not activate this CLI for requests that require creating, updating, deleting, publishing, commenting, upvoting, inviting, ordering, sending messages, booking, purchasing, or changing remote state. This printed CLI exposes read-only commands for inspection, export, sync, and analysis.
请勿针对需要创建、更新、删除、发布、评论、点赞、邀请、下单、发送消息、预订、购买或更改远程状态的请求激活此CLI。该打印CLI仅暴露用于查看、导出、同步和分析的只读命令。

Command Reference

命令参考

dns — Manage dns
  • namecheap-pp-cli dns get-email-forwarding
    — Runs 
    namecheap.domains.dns.getEmailForwarding
    .
  • namecheap-pp-cli dns get-hosts
    — Runs 
    namecheap.domains.dns.getHosts
    .
  • namecheap-pp-cli dns get-list
    — Get DNS nameserver type and nameservers.
  • namecheap-pp-cli dns set-custom
    — Runs 
    namecheap.domains.dns.setCustom
    .
  • namecheap-pp-cli dns set-default
    — Switch a domain to Namecheap default DNS.
  • namecheap-pp-cli dns set-hosts
    — Runs 
    namecheap.domains.dns.setHosts
    ; HostName1/RecordType1/Address1/TTL1 style parameters can be passed via...
domains — Manage domains
  • namecheap-pp-cli domains check
    — Check domain availability for one or more domains.
  • namecheap-pp-cli domains create
    — Runs 
    namecheap.domains.create
    . This is a mutating paid operation; use dry-run unless intentionally registering.
  • namecheap-pp-cli domains get-contacts
    — Runs 
    namecheap.domains.getContacts
    .
  • namecheap-pp-cli domains get-info
    — Runs 
    namecheap.domains.getInfo
    for a domain.
  • namecheap-pp-cli domains get-list
    — Runs 
    namecheap.domains.getList
    with paging and optional filters.
  • namecheap-pp-cli domains get-registrar-lock
    — Runs 
    namecheap.domains.getRegistrarLock
    .
  • namecheap-pp-cli domains get-tld-list
    — Runs 
    namecheap.domains.getTldList
    .
  • namecheap-pp-cli domains renew
    — Runs 
    namecheap.domains.renew
    . Mutating paid operation.
  • namecheap-pp-cli domains set-registrar-lock
    — Runs 
    namecheap.domains.setRegistrarLock
    .
ssl — Manage ssl
  • namecheap-pp-cli ssl get-info
    — Get SSL certificate information.
  • namecheap-pp-cli ssl get-list
    — Runs 
    namecheap.ssl.getList
    .
  • namecheap-pp-cli ssl parse-csr
    — Parse a certificate signing request.
users — Manage users
  • namecheap-pp-cli users address-get-info
    — Runs 
    namecheap.users.address.getInfo
    .
  • namecheap-pp-cli users address-get-list
    — Runs 
    namecheap.users.address.getList
    .
  • namecheap-pp-cli users get-balances
    — Runs 
    namecheap.users.getBalances
    .
  • namecheap-pp-cli users get-pricing
    — Runs 
    namecheap.users.getPricing
    .
dns — 管理DNS
  • namecheap-pp-cli dns get-email-forwarding
    — 执行
    namecheap.domains.dns.getEmailForwarding
    。
  • namecheap-pp-cli dns get-hosts
    — 执行
    namecheap.domains.dns.getHosts
    。
  • namecheap-pp-cli dns get-list
    — 获取DNS域名服务器类型和域名服务器。
  • namecheap-pp-cli dns set-custom
    — 执行
    namecheap.domains.dns.setCustom
    。
  • namecheap-pp-cli dns set-default
    — 将域名切换为Namecheap默认DNS。
  • namecheap-pp-cli dns set-hosts
    — 执行
    namecheap.domains.dns.setHosts
    ；可通过...传递HostName1/RecordType1/Address1/TTL1格式的参数。
domains — 管理域名
  • namecheap-pp-cli domains check
    — 检查一个或多个域名的可用性。
  • namecheap-pp-cli domains create
    — 执行
    namecheap.domains.create
    。这是一项会修改状态的付费操作；除非有意注册，否则请使用dry-run模式。
  • namecheap-pp-cli domains get-contacts
    — 执行
    namecheap.domains.getContacts
    。
  • namecheap-pp-cli domains get-info
    — 针对某个域名执行
    namecheap.domains.getInfo
    。
  • namecheap-pp-cli domains get-list
    — 执行带分页和可选过滤器的
    namecheap.domains.getList
    。
  • namecheap-pp-cli domains get-registrar-lock
    — 执行
    namecheap.domains.getRegistrarLock
    。
  • namecheap-pp-cli domains get-tld-list
    — 执行
    namecheap.domains.getTldList
    。
  • namecheap-pp-cli domains renew
    — 执行
    namecheap.domains.renew
    。这是一项会修改状态的付费操作。
  • namecheap-pp-cli domains set-registrar-lock
    — 执行
    namecheap.domains.setRegistrarLock
    。
ssl — 管理SSL证书
  • namecheap-pp-cli ssl get-info
    — 获取SSL证书信息。
  • namecheap-pp-cli ssl get-list
    — 执行
    namecheap.ssl.getList
    。
  • namecheap-pp-cli ssl parse-csr
    — 解析证书签名请求。
users — 管理用户
  • namecheap-pp-cli users address-get-info
    — 执行
    namecheap.users.address.getInfo
    。
  • namecheap-pp-cli users address-get-list
    — 执行
    namecheap.users.address.getList
    。
  • namecheap-pp-cli users get-balances
    — 执行
    namecheap.users.getBalances
    。
  • namecheap-pp-cli users get-pricing
    — 执行
    namecheap.users.getPricing
    。

Finding the right command

查找合适的命令

When you know what you want to do but not which command does it, ask the CLI directly:
bash
namecheap-pp-cli which "<capability in your own words>"
which
resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code 
0
means at least one match; exit code 
2
means no confident match — fall back to 
--help
or use a narrower query.
当您知道要执行的操作但不知道对应的命令时，可直接询问CLI：
bash
namecheap-pp-cli which "<用您自己的语言描述功能>"
which
会将自然语言的功能查询解析为该CLI精选功能索引中最匹配的命令。退出码
0
表示至少找到一个匹配项；退出码
2
表示没有可信匹配项 — 请回退使用
--help
或缩小查询范围。

Auth Setup

认证设置

Run 
namecheap-pp-cli auth setup
to print the URL and steps for getting a key (add 
--launch
to open the URL). Then set:
bash
export NAMECHEAP_API_KEY="<your-key>"
Or persist it in 
~/.config/namecheap-pp-cli/config.toml
.
Run 
namecheap-pp-cli doctor
to verify setup.
执行
namecheap-pp-cli auth setup
以打印获取密钥的URL和步骤（添加
--launch
可打开该URL）。然后设置：
bash
export NAMECHEAP_API_KEY="<您的密钥>"
或者将其持久化到
~/.config/namecheap-pp-cli/config.toml
中。
执行
namecheap-pp-cli doctor
以验证设置是否正确。

Agent Mode

Agent模式

Add 
--agent
to any command. Expands to: 
--json --compact --no-input --no-color --yes
.
  • Pipeable — JSON on stdout, errors on stderr
  • Filterable — 
    --select
    keeps a subset of fields. Dotted paths descend into nested structures; arrays traverse element-wise. Critical for keeping context small on verbose APIs:
    bash
    namecheap-pp-cli dns get-email-forwarding --agent --select id,name,status
  • Previewable — 
    --dry-run
    shows the request without sending
  • Offline-friendly — sync/search commands can use the local SQLite store when available
  • Non-interactive — never prompts, every input is a flag
  • Read-only — do not use this CLI for create, update, delete, publish, comment, upvote, invite, order, send, or other mutating requests
在任何命令后添加
--agent
。这会展开为：
--json --compact --no-input --no-color --yes
。
  • 可管道传输 — 标准输出为JSON，错误输出到标准错误
  • 可过滤 — 
    --select
    保留字段子集。点路径可深入嵌套结构；数组会遍历每个元素。对于冗长的API，这对缩小上下文至关重要：
    bash
    namecheap-pp-cli dns get-email-forwarding --agent --select id,name,status
  • 可预览 — 
    --dry-run
    显示请求但不发送
  • 离线友好 — 同步/搜索命令在可用时可使用本地SQLite存储
  • 非交互式 — 从不提示，所有输入均为标志参数
  • 只读 — 请勿使用此CLI执行创建、更新、删除、发布、评论、点赞、邀请、下单、发送或其他会修改状态的请求

Response envelope

响应信封

Commands that read from the local store or the API wrap output in a provenance envelope:
json
{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}
Parse 
.results
for data and 
.meta.source
to know whether it's live or local. A human-readable 
N results (live)
summary is printed to stderr only when stdout is a terminal AND no machine-format flag (
--json
, 
--csv
, 
--compact
, 
--quiet
, 
--plain
, 
--select
) is set — piped/agent consumers and explicit-format runs get pure JSON on stdout.
从本地存储或API读取数据的命令会将输出包装在来源信封中：
json
{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <数据>
}
解析
.results
获取数据，通过
.meta.source
判断数据是实时的还是本地的。仅当标准输出为终端且未设置机器格式标志（
--json
、
--csv
、
--compact
、
--quiet
、
--plain
、
--select
）时，才会将人类可读的
N results (live)
摘要打印到标准错误 — 管道/Agent消费者和显式格式运行时，标准输出仅为纯JSON。

Agent Feedback

Agent反馈

When you (or the agent) notice something off about this CLI, record it:
namecheap-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
namecheap-pp-cli feedback --stdin < notes.txt
namecheap-pp-cli feedback list --json --limit 10
Entries are stored locally at 
~/.namecheap-pp-cli/feedback.jsonl
. They are never POSTed unless 
NAMECHEAP_FEEDBACK_ENDPOINT
is set AND either 
--send
is passed or 
NAMECHEAP_FEEDBACK_AUTO_SEND=true
. Default behavior is local-only.
Write what surprised you, not a bug report. Short, specific, one line: that is the part that compounds.
当您（或Agent）发现此CLI存在问题时，请记录下来：
namecheap-pp-cli feedback "--since标志是包含性的，但文档说是排他性的"
namecheap-pp-cli feedback --stdin < notes.txt
namecheap-pp-cli feedback list --json --limit 10
反馈条目存储在本地
~/.namecheap-pp-cli/feedback.jsonl
中。除非设置了
NAMECHEAP_FEEDBACK_ENDPOINT
且传递了
--send
或设置了
NAMECHEAP_FEEDBACK_AUTO_SEND=true
，否则反馈绝不会被POST提交。默认行为仅存储在本地。
请写下让您感到意外的内容，而非正式的错误报告。简短、具体、单行描述：这才是有价值的部分。

Output Delivery

输出交付

Every command accepts 
--deliver <sink>
. The output goes to the named sink in addition to (or instead of) stdout, so agents can route command results without hand-piping. Three sinks are supported:
SinkEffect
stdout
Default; write to stdout only
file:<path>
Atomically write output to 
<path>
(tmp + rename)
webhook:<url>
POST the output body to the URL (
application/json
or 
application/x-ndjson
when 
--compact
)
Unknown schemes are refused with a structured error naming the supported set. Webhook failures return non-zero and log the URL + HTTP status on stderr.
每个命令都接受
--deliver <sink>
参数。输出会除了（或代替）标准输出外发送到指定的sink，以便Agent无需手动管道即可路由命令结果。支持三种sink：
Sink效果
stdout
默认值；仅写入标准输出
file:<path>
原子性地将输出写入
<path>
（临时文件+重命名）
webhook:<url>
将输出体POST到指定URL（当使用
--compact
时为
application/json
或
application/x-ndjson
格式）
未知的scheme会被拒绝，并返回结构化错误，列出支持的类型。Webhook失败时会返回非零退出码，并在标准错误中记录URL和HTTP状态码。

Named Profiles

命名配置文件

A profile is a saved set of flag values, reused across invocations. Use it when a scheduled agent calls the same command every run with the same configuration - HeyGen's "Beacon" pattern.
namecheap-pp-cli profile save briefing --json
namecheap-pp-cli --profile briefing dns get-email-forwarding
namecheap-pp-cli profile list --json
namecheap-pp-cli profile show briefing
namecheap-pp-cli profile delete briefing --yes
Explicit flags always win over profile values; profile values win over defaults. 
agent-context
lists all available profiles under 
available_profiles
so introspecting agents discover them at runtime.
配置文件是一组保存的标志值，可在多次调用中重复使用。当定时Agent每次运行都使用相同配置调用同一命令时，可使用此功能 — 即HeyGen的“Beacon”模式。
namecheap-pp-cli profile save briefing --json
namecheap-pp-cli --profile briefing dns get-email-forwarding
namecheap-pp-cli profile list --json
namecheap-pp-cli profile show briefing
namecheap-pp-cli profile delete briefing --yes
显式标志始终优先于配置文件值；配置文件值优先于默认值。
agent-context
会在
available_profiles
下列出所有可用配置文件，以便自省Agent在运行时发现它们。

Exit Codes

退出码

CodeMeaning
0Success
2Usage error (wrong arguments)
3Resource not found
4Authentication required
5API error (upstream issue)
7Rate limited (wait and retry)
10Config error
代码含义
0成功
2使用错误（参数错误）
3资源未找到
4需要认证
5API错误（上游问题）
7速率限制（请等待并重试）
10配置错误

Argument Parsing

参数解析

Parse 
$ARGUMENTS
:
  1. Empty, 
    help
    , or 
    --help
     → show 
    namecheap-pp-cli --help
    output
  2. Starts with 
    install
     → ends with 
    mcp
    → MCP installation; otherwise → see Prerequisites above
  3. Anything else → Direct Use (execute as CLI command with 
    --agent
    )
解析
$ARGUMENTS
：
  1. 为空、
    help
    或
    --help
     → 显示
    namecheap-pp-cli --help
    输出
  2. 以
    install
    开头     → 若结尾为
    mcp
    → MCP安装；否则 → 参见上方的前提条件部分
  3. 其他情况 → 直接使用（以
    --agent
    标志执行CLI命令）

MCP Server Installation

MCP服务器安装

Install the MCP binary from this CLI's published public-library entry or pre-built release, then register it:
bash
claude mcp add namecheap-pp-mcp -- namecheap-pp-mcp
Verify: 
claude mcp list
从此CLI已发布的公共库条目或预构建版本安装MCP二进制文件，然后注册：
bash
claude mcp add namecheap-pp-mcp -- namecheap-pp-mcp
验证：
claude mcp list

Direct Use

直接使用

  1. Check if installed: 
    which namecheap-pp-cli
    If not found, offer to install (see Prerequisites at the top of this skill).
  2. Match the user query to the best command from the Unique Capabilities and Command Reference above.
  3. Execute with the 
    --agent
    flag:
    bash
    namecheap-pp-cli <command> [subcommand] [args] --agent
  4. If ambiguous, drill into subcommand help: 
    namecheap-pp-cli <command> --help
    .
  1. 检查是否已安装：
    which namecheap-pp-cli
    若未找到，提供安装选项（参见顶部前提条件部分）。
  2. 将用户查询与上述独特功能和命令参考中最匹配的命令进行匹配。
  3. 带
    --agent
    标志执行：
    bash
    namecheap-pp-cli <命令> [子命令] [参数] --agent
  4. 若存在歧义，查看子命令帮助：
    namecheap-pp-cli <命令> --help
    。",