Vernclaw Connect Cli

ローカル

Vernclaw Connect Cli について

Vernclaw Connect Cli は、AI エージェントや自動化スクリプトが Vernclaw コネクターを検索・実行するためのコマンドラインツールです。JSON 中心の出力と Agent Skills を備え、SEO、ソーシャル・動画調査、ウェブ検索、URL 抽出、画像生成を扱います。

主な機能

01コネクターの一覧と詳細表示
02コマンドラインからの実行
03エージェント向け JSON 出力
04ブラウザーまたは API キーでログイン
05コネクター用 Agent Skills
06非同期ジョブの状態確認

活用シーン

01ドメインの SEO 指標取得
02動画やソーシャル投稿の調査
03ウェブ検索と URL コンテンツの抽出
04エージェントからの画像生成実行

MCP 対応

README では Agent Skill エコシステムの一つとして MCP Servers に触れていますが、MCP サーバーへの接続や 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 エージェントや自動化スクリプトから、SEO 指標、YouTube リサーチ、X/Twitter の閲覧、Product Hunt の検索、ウェブ検索、URL 抽出、AI 画像生成に JSON 優先でアクセスできます。

インストール

npm i -g vernclaw-connect-cli

エージェントスキルとして使う

各コネクターはエージェントスキル（skills/ 配下の SKILL.md）として提供されます。お使いの AI エージェントに直接インストールできます。

npx skills add hekmon8/vernclaw-connect-cli

エージェントスキルのエコシステムに掲載されています：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 は人が読みやすいコネクター一覧表を表示します。エージェントやスクリプトで構造化されたカタログデータが必要な場合は、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 ヘッダーで公開されます。

コネクターの出力はエージェント向けに最適化されています。デフォルトの 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

ライブ e2e スモークテストを有効にするには、VERNCLAW_E2E_RUN=1 を VERNCLAW_E2E_API_KEY と併用し、必要に応じて VERNCLAW_E2E_API_BASE_URL を指定してください。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 対応

ログインしてコメント

基本情報

ライセンス: MIT
作者: hekmon8
言語: node
掲載日: 2026年7月16日
最終更新: 3 週間前

問題を報告

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。