Vernclaw 连接器 CLI - SEO、YouTube、社交媒体和 Web 工具
安装 vernclaw-connect-cli，从终端运行 SEO 指标、YouTube 研究、X/Twitter 读取、Product Hunt 发现、Web 搜索、URL 抽取和 AI 图像生成。
安装
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 密钥 页面生成 API Key（登录 → API 密钥 → 创建 API Key）。
托管连接器访问
大多数 CLI 用户只需要 Vernclaw 登录或 Vernclaw API Key。连接器访问由 Vernclaw 统一托管，不需要每个 CLI 用户单独配置服务凭据。
命令
| 命令 | 说明 |
|---|---|
vernclaw-cli login | 通过浏览器或 API Key 认证 |
vernclaw-cli logout | 移除已存储的凭据 |
vernclaw-cli list | 列出可用连接器 |
vernclaw-cli describe <connectorId> | 查看连接器详情和参数 |
vernclaw-cli invoke <connectorId> [flags] | 运行连接器并输出连接器结果 |
vernclaw-cli job get <jobId> | 查看异步任务状态 |
vernclaw-cli status | 显示当前登录状态、订阅状态与积分余额 |
连接器 Skill 列表
每个连接器都有专用的英文 SKILL.md 文件，供 AI Agent 集成参考：
输出约定
连接器成功结果采用 JSON 优先：默认向 stdout 输出包含 status 和 data 的紧凑 JSON envelope。添加 --pretty 时，CLI 会在本地把同一份 JSON 渲染为便于阅读的终端文本。本地 invoke 参数校验错误默认也返回紧凑 JSON。错误码通过顶层 errorCode 字段以及 API 响应中的 x-error-code header 提供。
连接器输出会优先适配 agent 上下文：默认 invoke 只输出标准化结果，不输出内部路由信息或完整原始响应。指标类工具返回 data.summary 和 data.metrics；列表类工具返回 data.summary、data.stats 和 data.items；趋势类工具返回 data.stats、data.metrics 和 data.series；抽取类工具返回 data.document。结构化目录请使用 vernclaw-cli list --json。
退出码
| 退出码 | 含义 |
|---|---|
0 | 成功 |
1 | 业务拒绝（如积分不足） |
2 | 认证失败 |
3 | 参数错误 |
4 | 上游失败 |
构建、测试与发布
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
- API 密钥：/settings/apikeys
- 连接器设置：/settings/connectors
- npm：vernclaw-connect-cli
- GitHub：hekmon8/vernclaw-connect-cli