searchdock-cli

SearchDock CLI — Google Search Console CLI

ターミナルまたは AI エージェントから、Google Search Console の分析データを読み取り、インデックス登録された URL を確認し、サイトマップを監視できます。

SearchDock はオープンソースで、ローカルで動作し、Google への読み取り専用アクセスを要求します。同じコア機能を npm、Python、MCP、Codex または Claude Code のプラグイン、あるいは単独のエージェントスキルから利用できます。Bing Webmaster Tools のサポートは今後追加予定です。

エージェントでセットアップする

このプロンプトをコーディングエージェントにコピーしてください。

Set up SearchDock CLI for this project using
https://github.com/xplormityai/searchdock-cli. Read its README and
skills/searchdock-setup/SKILL.md. Check Node.js 22+, reuse an existing
installation, or install the CLI from npm. Install searchdock-setup and
searchdock skills for the agent I am using, scoped to this project, and
connect the stdio MCP server if this agent supports it. Keep existing
agent configuration. For Google access, ask only for the local path to
my Desktop OAuth client JSON and guide me through read-only browser
consent. Never print credentials or tokens. Let me choose the Search
Console property, then verify the connection with a metrics request.
Tell me exactly which steps succeeded and what still needs my input.

インストールコマンド

すべての配布方法で、Node.js 22 以降が必要です。

パッケージ：npm · PyPI。

# npm
npm install --global searchdock-cli
searchdock --help

# No global installation
npx --yes [email protected] --help

# Python; Node.js is still required
pipx install searchdock-cli
# Alternatively: python -m pip install searchdock-cli

Python パッケージは、まったく同じ JavaScript ランタイムを含むランチャーです。Google の実装が別途含まれているわけではありません。両方のパッケージをインストールした場合、Python ランチャーを明示的に選択するには python -m searchdock_cli を使用してください。

Codex 用の両方のスキルを、現在のプロジェクトにインストールします。

npx --yes skills add xplormityai/searchdock-cli --skill searchdock-setup searchdock --agent codex --copy --yes

codex を claude-code、cursor、opencode、またはサポート対象のエージェントに置き換えてください。プロジェクトをまたいでインストールする場合に限り、--global を追加してください。スキルをインストールしても、CLI のインストールや Google へのアクセス許可は行われません。プラグイン、MCP、手動セットアップ。

ソースから実行するには：

git clone https://github.com/xplormityai/searchdock-cli.git
cd searchdock-cli
npm ci
npm run build
node dist/cli.cjs --help

Google Search Console に接続する

ご自身の Google Cloud プロジェクトで Google OAuth の デスクトップアプリ クライアントを作成し、Search Console API を有効にして、クライアント JSON をダウンロードしてください。手順とテストモードの制限については、Google のセットアップを参照してください。共有の開発者認証情報は含まれていません。

searchdock auth login --client-file /path/to/desktop-client.json
searchdock sites list
searchdock sites use sc-domain:example.com
searchdock auth status

Google の同意フローをローカルブラウザーで開きます。SearchDock は PKCE を使用し、コールバックの state を検証し、127.0.0.1 のみで待ち受けます。webmasters.readonly を要求し、リフレッシュトークンをリポジトリ外にある、オペレーティングシステムのユーザーごとの設定ディレクトリに保存します。認証情報は、アクセス権限で保護されたローカル JSON として保存され、SearchDock によって暗号化されることはありません。プライバシーを参照してください。

コマンド

# Search performance and top queries
searchdock analytics --days 28
searchdock analytics --dimensions page --days 28 --json
searchdock analytics --dimensions date --start 2026-09-01 --end 2026-09-30

# Exact, case-insensitive brand queries
searchdock analytics --brand "Your Brand" --json

# Sitemaps and Google's indexed URL status
searchdock sitemaps
searchdock inspect https://example.com/

# Combined report, including only the URLs you specify
searchdock report --urls https://example.com/,https://example.com/about --json
searchdock report --output ./private-report.json

# Multiple accounts/sites
searchdock auth login --client-file /path/to/client.json --profile work
searchdock sites use https://example.com/ --profile work
searchdock analytics --profile work --site https://example.com/ --json

# Diagnostics and local credential removal
searchdock doctor
searchdock auth logout

--json を指定すると、機械可読な結果を標準出力に書き込み、エラーは標準エラー出力に書き込みます。終了ステータスは、エラー時にゼロ以外になります。--output は JSON を新しいファイルに保存し、既存のファイルへの上書きは拒否します。非公開レポートはご自身で Git の対象外にしてください。CSV はまだサポートされていません。カンマを含む URL の場合は、MCP の urls 配列または JavaScript API を使って一括確認してください。

レポート期間はデフォルトで、Search Console の処理時間を考慮し、今日の 3 日前を終了日とする過去 28 日間です。タイムゾーンは太平洋時間です。日付を正確に指定することもできます。確定済みのデータでも反映が遅れる場合があります。ページネーションでは最大 100,000 行をリクエストできますが、Google の API が返すのは上位の行であり、一部の匿名化されたクエリデータは省略されます。行が欠けていても需要がゼロだとは限りません。また、インプレッションがゼロの場合、平均掲載順位に意味はありません。

AI エージェントと MCP

SearchDock は、読み取り専用の MCP ツールを 5 つ提供します：searchdock_sites、searchdock_analytics、searchdock_sitemaps、searchdock_inspect、searchdock_report。まずローカルで認証してください。MCP ツールが同意手続きを開始したり、アカウント設定を変更したりすることはありません。

互換性のある任意の MCP クライアントに、次の stdio サーバーを追加します。

{
  "mcpServers": {
    "searchdock": {
      "command": "npx",
      "args": ["--yes", "[email protected]", "mcp"]
    }
  }
}

ソースをチェックアウトして使用する場合は、command を node に、args を ["/absolute/path/searchdock-cli/dist/cli.cjs", "mcp"] に設定します。シェル経由で npx.cmd を起動する Windows クライアントでは、command: "cmd" と args: ["/c", "npx", "--yes", "[email protected]", "mcp"] が必要になる場合があります。ご利用のクライアントの Windows 設定ガイドを参照してください。

プラグインでも同じ固定 npm バージョンを使用します。

# Codex CLI
codex plugin marketplace add xplormityai/searchdock-cli
codex plugin add searchdock@searchdock

Claude Code の場合：

/plugin install searchdock --marketplace xplormityai/searchdock-cli --scope project

このワンステップコマンドを使用するには、Claude Code 2.1.275 以降が必要です。それ以前のバージョンでは、/plugin marketplace add xplormityai/searchdock-cli を実行してから、/plugin install searchdock@searchdock --scope project を実行してください。

スタンドアロンのスキルを使用する場合は、skills/searchdock と skills/searchdock-setup の両方をエージェントのスキルディレクトリにコピーしてください。Codex では ~/.agents/skills/、Claude Code では ~/.claude/skills/ を使用します。CLI は別途インストールしてください。両方のスキルはプラグインに含まれています。このリポジトリには、移植可能な Agent Plugins、Codex および Claude のマニフェストが含まれています。ローカルの stdio プラグインは、ホスト型プラグインディレクトリに自動的に掲載されません。

open skills installer を使ってスキルをインストールすることもできます。

npx --yes skills add xplormityai/searchdock-cli --skill searchdock-setup searchdock --agent codex --copy --yes

SearchDock は、io.github.xplormityai/searchdock-cli として公式 MCP Registry に公開されています。リリースワークフローでは、GitHub OIDC を使用してメタデータを更新します。

SearchDock とセットアップの両方のスキルが ClawHub で公開されています。このレジストリの要件に従い、スキルのコピーには MIT-0 を使用しています。このリポジトリとそのパッケージは引き続き MIT ライセンスです。

ローカル MCPB バンドルは Smithery で公開されています。Node.js 22 以降と、ローカルで認証済みの Google プロフィールが必要です。認証情報は含まれていません。python scripts/build_mcpb.py は、ビルド済みの dist/cli.cjs をパッケージ化します。リリースとディスカバリーの自動化。

Google API でわかることとわからないこと

利用できる情報	Search Console の UI またはエクスポートが必要な情報
クリック数、表示回数、CTR、平均掲載順位	インデックス登録をリクエストする
上位のクエリ／ページと、日付／デバイス／国別の内訳	ライブ URL をテストする
ブランドクエリの正確なパフォーマンス	ページのインデックス登録除外に関する完全な表
サイトマップの処理状況	手動による対策とセキュリティの問題
特定の URL に対する Google のインデックス登録済みバージョン	現在のランキングまたはインデックス登録の保証

SearchDock のレポートでは、返されたサイトマップのエラー／警告、処理待ち、および検査した URL の PASS 以外の判定を示します。これは技術的な SEO の完全な監査ではなく、根拠のない SEO／AEO／GEO スコアを提示するものでもありません。

JavaScript API

import { selectedContext } from 'searchdock-cli';

const { adapter, site } = await selectedContext({ profile: 'default' });
const result = await adapter.analytics(site, { days: 28, dimensions: ['page'] });
console.log(result.rows);

プロバイダーレジストリでは、機能を個別に宣言します。CLI、MCP、Python の配布モデルを変更せずに、アダプターとして Bing を追加できます。プロバイダー固有の違いは明示したままにする必要があります。アーキテクチャを参照してください。

開発とリリース

npm ci
npm run build
npm test
npm run check
python -m pip install build twine
npm run release:artifacts
python -m twine check dist/releases/searchdock_cli-0.1.3-py3-none-any.whl dist/releases/searchdock_cli-0.1.3.tar.gz

リリース手順では、npm／PyPI アカウント、OIDC による信頼された公開、バージョン管理、GitHub リリースアーティファクトについて説明しています。パッケージを作成しただけでは、何も公開されません。

Xplormity Collective が開発しました。MIT ライセンス。