中国商标查询 Skill
给 AI Agent 用的商标数据入口 —— 已开源
商标这行有个长期存在的错位：数据是公开的，但拿数据的门槛不低。 CNIPA 的商标状态、专用权期限、续展窗口都是公示信息，可真要在自己的系统或 AI Agent 里用起来，你得处理登录态、翻页、字段口径、到期日推算这一堆脏活。 所以我们把商标监控平台的查询能力，抽成了一个能被 AI Agent 直接调用的 Skill，并全部开源。
这是什么
一个零第三方依赖的 Node CLI，让 OpenClaw / ClawHub 生态里的 AI Agent 能够查询中国商标数据：按权利人检索、看商标详情、批量导出、查点数余额与可用模块。
AI Agent → 本 Skill（Node CLI） → 托管平台 API → 商标数据Skill 本身不含任何商标数据，也不直连上游数据商。它只做一件事：把 Agent 的意图翻译成平台 API 调用，再把结构化 JSON 交回去。鉴权、计费、上游访问全部在平台侧完成 —— 这也意味着它不需要你交出任何上游账号密码，只需要一个你自己的平台 API Key。
能做什么
| 命令 | 作用 |
|---|---|
help | 输出命令帮助（唯一无需配置就能跑的命令） |
bind-help | 未绑定时的引导：注册地址、API Key 生成入口、绑定步骤 |
capabilities | 绑定状态、点数余额、计费提示、已开通模块 |
search | 按权利人名称查询商标，返回前 50 条 |
detail | 单个商标完整档案：申请号 / 注册号 / 国际分类 / 状态 / 专用权期限 / 核定商品 |
export | 发起批量导出任务（Excel） |
export-status | 查询导出任务状态与下载链接 |
modules | 读取当前账号可用的增值模块 |
所有命令统一返回结构化 JSON 到 stdout，错误也是结构化的（带 code / message / httpStatus），Agent 不需要解析人话。
30 秒上手
git clone https://github.com/WillEleven/chinese-trademark-search-skill.git
cd chinese-trademark-search-skill
export CHINA_TM_PLATFORM_BASE_URL="https://tm.zhengquai.com"
export CHINA_TM_USER_TOKEN="tmu_你的APIKey"
node scripts/cli.mjs capabilities
node scripts/cli.mjs search --query "某某科技有限公司"Node.js ≥ 18 即可，没有 npm install 这一步 —— 整个 CLI 只用 Node 内置模块写成，不引入任何第三方包。对一个要跑在别人机器上、还要经手 API Key 的工具来说，依赖树越短越好。
也可以通过 ClawHub 一键安装：openclaw skills install @willeleven/chinese-trademark-search-skill
几个值得说的设计点
幂等防重复扣费
每次收费调用自动带幂等请求头，网络抖动重试不会重复扣点；上游失败自动退点，且退点即释放幂等键，杜绝「失败一次终身免费」的漏洞。
不让 Agent 花冤枉钱
不支持的翻页在本地直接拒绝、不发请求不扣点；参数解析防呆；导出商标号自动去重，避免重复项把你推进更贵的计价档。
Token 安全
API Key 只存在于环境变量和请求头，永不出现在 stdout。强制 HTTPS，明文调试需显式开启并在 stderr 告警。
计费全透明
每次收费动作前告知预计消耗，响应带实扣点数与剩余余额 —— 幂等重放实扣为 0 就如实报 0，不拿报价单糊弄人。
计费说明
- 点价 ¥1 = 5 点，新注册组织赠送 100 点体验点（90 天有效），够把查询 / 详情 / 导出完整走一遍
- 查询失败、详情上游异常、导出任务创建失败都会自动退点
本 Skill 需要一个平台账号才能运行。代码是自由的，数据服务不是免费的 —— 上游数据有实打实的成本。开源的是工具和协议，不是数据。
开源地址
许可证边界（Apache-2.0）
选 Apache-2.0 而不是 MIT，因为多出来的两条恰好都用得上：专利授权条款（明示授权 + 专利报复条款 —— 做知识产权业务的人发一个对专利只字不提的许可证，说不过去）和商标条款（明确声明不授予商标使用权，「争取」等商号与品牌标识不随代码转移）。
一句话概括：代码随便拿，名字和数据不随代码走。你可以自由 fork、修改、商用，但衍生作品不能以暗示「官方出品」的方式命名；调用平台 API 及其返回的数据另受 API 使用条款约束。