Vernclaw Connect Cli

本地服务

vernclaw.com商业与营销03 周前更新

关于 Vernclaw Connect Cli

Vernclaw Connect Cli 是供 AI Agent 和自动化脚本发现并调用 Vernclaw 连接器的命令行工具。它采用 JSON 优先输出，并提供涵盖 SEO、社交与视频研究、网页搜索、URL 提取和图像生成的 Agent Skills。

主要功能

01列出并查看连接器信息
02通过命令行调用连接器
03面向 Agent 的 JSON 优先输出
04浏览器或 API 密钥登录
05连接器对应的 Agent Skills
06查看异步任务状态

适用场景

01获取域名 SEO 指标
02研究视频和社交帖子
03搜索网页并提取 URL 内容
04通过 Agent 执行图像生成

MCP 相关

README 将 MCP Servers 列为 Agent Skill 生态的一部分，但未说明 MCP 服务连接方式或专属功能。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "vernclaw-connect-cli-dc369e": {
      "command": "npx",
      "args": [
        "-y",
        "skills"
      ]
    }
  }
}

启动命令npx -y skills

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmskillsstdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

vernclaw-connect-cli

Vernclaw Connectors 的官方命令行界面。Vernclaw Connect CLI 为 AI Agent 和自动化脚本提供 JSON 优先的访问方式，可获取 SEO 指标、YouTube 研究、X/Twitter 读取器、Product Hunt 发现、网页搜索、URL 提取和 AI 图像生成。

安装

npm i -g vernclaw-connect-cli

用作 Agent Skills

每个连接器都以 Agent Skill 的形式提供（skills/ 下的 SKILL.md）。将它们直接安装到你的 AI Agent 中：

npx skills add hekmon8/vernclaw-connect-cli

已收录于 Agent Skill 生态： skills.sh · AgentSkillsHub · MCP Servers。

身份验证

浏览器登录（推荐用于交互式使用）：

vernclaw-cli login

打开浏览器进行设备代码授权。凭据会存储在本地的 ~/.vernclaw-cli.json 中。

API 密钥登录（适用于 CI/CD 和无头环境）：

vernclaw-cli login --api-key YOUR_API_KEY

在 vernclaw.com/settings/connectors 生成 API 密钥（登录 → Connector Settings → Create API Key）。

默认情况下，CLI 使用 https://vernclaw.com。对于本地或可自托管环境，请传入 --api-base-url 或设置 VERNCLAW_CLI_API_BASE_URL。

托管连接器访问

大多数 CLI 用户只需进行 Vernclaw 身份验证。连接器访问由 Vernclaw 管理，因此 CLI 用户无需配置单独的服务凭据。

在本地 Vernclaw 应用上进行本地开发

pnpm dev:connectors:local
pnpm install:cli:local
vernclaw-cli login --api-base-url http://localhost:3000 --api-key YOUR_API_KEY
vernclaw-cli list

login 命令会将本地 apiBaseUrl 存储在 ~/.vernclaw-cli.json 中，因此后续命令会继续指向本地应用，直到你针对其他环境重新登录。

命令

命令	说明
`vernclaw-cli login`	通过浏览器或 API 密钥进行身份验证
`vernclaw-cli logout`	删除已存储的凭据
`vernclaw-cli list`	列出可用的连接器
`vernclaw-cli describe <connectorId>`	显示连接器详情和参数
`vernclaw-cli invoke <connectorId> [flags]`	运行连接器并打印连接器输出
`vernclaw-cli job get <jobId>`	检查异步任务的状态
`vernclaw-cli status`	显示当前登录、订阅和额度状态

默认情况下，list 会输出易于阅读的连接器表格。当 Agent 或脚本需要结构化目录数据时，请使用 vernclaw-cli list --json。

可用连接器

Connector ID	Category	Mode	Skill
`generate.image`	AI	async	Skill
`seo.website-traffic`	SEO	sync	Skill
`seo.backlinks`	SEO	sync	Skill
`seo.serp-google-organic`	SEO	sync	Skill
`seo.google-trends`	SEO	sync	Skill
`seo.keyword-search-volume`	SEO	sync	Skill
`seo.keyword-suggestions`	SEO	sync	Skill
`seo.site-keywords`	SEO	sync	Skill
`seo.site-technologies`	SEO	sync	Skill
`seo.backlinks-summary`	SEO	sync	Skill
`seo.domain-rank-overview`	SEO	sync	Skill
`seo.domain-whois`	SEO	sync	Skill
`seo.domain-authority`	SEO	sync	Skill
`read.x.post`	Social	sync	Skill
`read.x.replies`	Social	sync	Skill
`read.x.article`	Social	sync	Skill
`search.x`	Social	sync	Skill
`search.tiktok`	Social	sync	Skill
`read.tiktok.video`	Social	sync	Skill
`search.instagram`	Social	sync	Skill
`read.instagram.post`	Social	sync	Skill
`social.tiktok`	Social	sync	Skill
`social.douyin`	Social	sync	Skill
`social.instagram`	Social	sync	Skill
`social.linkedin`	Social	sync	Skill
`social.reddit`	Social	sync	Skill
`social.threads`	Social	sync	Skill
`social.wechat`	Social	sync	Skill
`social.weibo`	Social	sync	Skill
`social.xiaohongshu`	Social	sync	Skill
`social.youtube`	Social	sync	Skill
`social.zhihu`	Social	sync	Skill
`search.youtube`	Video	sync	Skill
`read.youtube.video`	Video	sync	Skill
`search.producthunt`	Product	sync	Skill
`list.producthunt.launches`	Product	sync	Skill
`search.web`	Search	sync	Skill
`extract.url`	Extract	sync	Skill

快速示例

# Check domain authority
vernclaw-cli invoke seo.domain-authority --domain example.com

# Estimate website traffic
vernclaw-cli invoke seo.website-traffic --domain example.com

# Expand a seed keyword
vernclaw-cli invoke seo.keyword-suggestions --keywords "openai" --market us --language english
vernclaw-cli invoke seo.keyword-suggestions --keywords "openai" --market us --limit 20

# Review a domain's keyword footprint
vernclaw-cli invoke seo.site-keywords --target openai.com --market us --language english
vernclaw-cli invoke seo.site-keywords --target openai.com --market us --all

# Inspect live Google organic results
vernclaw-cli invoke seo.serp-google-organic --keyword "openai" --market us --language english --device desktop --os windows --depth 5

# Inspect keyword trend trajectory
vernclaw-cli invoke seo.google-trends --keywords "openai" --market us --language english
vernclaw-cli invoke seo.google-trends --keywords "openai" --market us --points 50
vernclaw-cli invoke seo.google-trends --keywords "translator" --market us --language english --time-range past_7_days --type web --item-types google_trends_queries_list
vernclaw-cli invoke seo.google-trends --keywords "mcp server,translator" --market us --language english --time-range past_30_days --item-types google_trends_graph

# Fetch backlink summary snapshot
vernclaw-cli invoke seo.backlinks-summary --target openai.com

# Check domain rank overview
vernclaw-cli invoke seo.domain-rank-overview --target openai.com --market us

# Detect public technologies
vernclaw-cli invoke seo.site-technologies --target openai.com

# Inspect Whois timestamps
vernclaw-cli invoke seo.domain-whois --target openai.com

# Read an X/Twitter post
vernclaw-cli invoke read.x.post --url "https://x.com/user/status/123"

# Search YouTube videos
vernclaw-cli invoke search.youtube --query "AI agent workflows" --limit 5 --order date --region-code US

# Read YouTube video metadata; replace VIDEO_ID_HERE before running
vernclaw-cli invoke read.youtube.video --url "https://www.youtube.com/watch?v=VIDEO_ID_HERE"

# Search Product Hunt launches
vernclaw-cli invoke search.producthunt --query "AI agents" --limit 5

# Search the web or extract a URL
vernclaw-cli invoke search.web --query "Vernclaw connector CLI" --limit 5
vernclaw-cli invoke extract.url --url "https://vernclaw.com/connectors"

# Generate an image (async — returns a job ID)
vernclaw-cli invoke generate.image --prompt "sunset over mountains"
vernclaw-cli job get img_abc123

# Check account status
vernclaw-cli status

输出约定

连接器成功响应和提供方响应均以 JSON 为先：默认会将包含 status 和 data 的精简 JSON 封装输出到 stdout。添加 --pretty 可改为输出易读的终端文本。本地 invoke 参数验证错误默认也会返回精简 JSON。错误代码通过顶层 errorCode 字段公开；对于 API 响应，还会通过 x-error-code 标头公开。

连接器输出针对 Agent 进行了优化：默认情况下，invoke 响应会省略连接器元数据、回显的输入、提供方名称和完整的上游 raw 负载。指标工具会返回 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`	提供方故障

开发

npm install
npm run build

将 src 编译到 dist。

测试

npm test
VERNCLAW_E2E_RUN=1 VERNCLAW_E2E_API_KEY=your_key npx vitest run __tests__/e2e.production.test.ts
VERNCLAW_E2E_RUN=1 VERNCLAW_E2E_API_KEY=your_key pnpm test:e2e:cli:local
VERNCLAW_E2E_API_KEY=your_key pnpm test:e2e:cli:prod

将 VERNCLAW_E2E_RUN=1 与 VERNCLAW_E2E_API_KEY 一起使用，并可选地设置 VERNCLAW_E2E_API_BASE_URL，以启用实时 e2e 冒烟测试。pnpm test:e2e:cli:local 假定本地应用已在 http://127.0.0.1:3000 上运行，建议通过 pnpm dev:connectors:local 启动。

pnpm test:e2e:cli:prod 现在会作为生产成功门禁运行：它会强制设置 VERNCLAW_E2E_RUN=1，默认设置 VERNCLAW_E2E_EXPECT_SUCCESS=1，并在缺少 VERNCLAW_E2E_API_KEY 时快速失败。

发布 / 部署

npm pack --dry-run
npm publish

npm publish 会触发 prepack，在发布前重新构建 dist。dist 被视为生成的发布产物，不会纳入 git 跟踪。

链接

网站：https://vernclaw.com
连接器目录：https://vernclaw.com/connectors
连接器文档：https://vernclaw.com/docs/connectors
CLI 文档：https://vernclaw.com/docs/connectors/cli
npm：https://www.npmjs.com/package/vernclaw-connect-cli
GitHub：https://github.com/hekmon8/vernclaw-connect-cli

许可证

MIT

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。