连接器 CLI — 安装和使用 vernclaw-connect-cli
安装 Vernclaw 连接器 CLI，从终端查询 SEO 指标、读取社交媒体内容、生成图像，所有输出采用 Markdown 格式。
安装
npm i -g vernclaw-connect-cli需要 Node.js 20 或更高版本。安装后即可全局使用 vernclaw-cli 命令。
鉴权
浏览器登录（推荐用于交互式使用）：
vernclaw-cli login打开浏览器进行设备码授权。凭据存储在本地 ~/.vernclaw-cli.json。
API Key 登录（用于 CI/CD 和无浏览器环境）：
vernclaw-cli login --api-key YOUR_API_KEY在连接器设置页面生成 API Key（登录 → 连接器设置 → 创建 API Key）。
命令
| 命令 | 说明 |
|---|---|
vernclaw-cli login | 通过浏览器或 API Key 认证 |
vernclaw-cli logout | 移除已存储的凭据 |
vernclaw-cli list | 列出可用连接器 |
vernclaw-cli describe <connectorId> | 查看连接器详情和参数 |
vernclaw-cli invoke <connectorId> [flags] | 运行连接器并输出 Markdown |
vernclaw-cli job get <jobId> | 查看异步任务状态 |
vernclaw-cli status | 显示当前登录状态、订阅状态与积分余额 |
连接器 Skill 列表
每个连接器都有专用的 skill 文件，供 AI Agent 集成参考：
| 连接器 ID | Skill (EN) | Skill (中文) |
|---|---|---|
seo.domain-authority | domain-authority-get.md | domain-authority-get.zh.md |
seo.website-traffic | website-traffic-get.md | website-traffic-get.zh.md |
read.x.post | x-post-read.md | x-post-read.zh.md |
generate.image | image-generate.md | image-generate.zh.md |
输出约定
所有连接器输出采用 Markdown 优先：结构化 Markdown 输出到 stdout。错误元数据以 ERROR_CODE=<code> 格式写入 stderr。
退出码
| 退出码 | 含义 |
|---|---|
0 | 成功 |
1 | 业务拒绝（如积分不足） |
2 | 认证失败 |
3 | 参数错误 |
4 | Provider 失败 |
构建、测试与发布
pnpm build:cli
pnpm vitest run packages/vernclaw-connect-cli/__tests__
pnpm test:e2e:cli:prodpnpm build:cli：将packages/vernclaw-connect-cli/src构建到distpnpm vitest run packages/vernclaw-connect-cli/__tests__：运行 CLI 单元测试pnpm test:e2e:cli:prod：在build:cli后执行生产环境 smoke testpnpm publish:cli：构建并发布 npm 包
相关 URL
- 连接器目录：/connectors
- 连接器文档：/docs/connectors
- 连接器设置：/settings/connectors
- npm：vernclaw-connect-cli
- GitHub：hekmon8/vernclaw-connect-cli