SearchDock 设置

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install searchdock-setup
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 searchdock-setup。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

SearchDock 设置可帮助 AI 编码代理安装并检查 SearchDock CLI、配置只读 Google Search Console 身份验证、选择账号配置文件和已验证资源，并通过分析查询确认访问权限。此工具适用于首次设置或重新连接 Google 访问权限，并要求用户明确同意，同时保护 OAuth 凭据。
作为用于 Search Console 工作流的 Openclaw Skills 之一，它将安装、MCP 发现和 Google 身份验证分开处理，因此在用户同意或客户端重启仍待完成时，不会将设置报告为已完成。

应用场景

首次安装 SearchDock 并确认 CLI 已准备就绪。
当 Search Console 配置文件断开连接时，重新连接 Google 访问权限。
有多个选项时，选择正确的配置文件和已验证的 Search Console 资源。
在兼容的客户端中将 SearchDock 配置为 MCP 服务器，并检查是否已发现其工具。
请求 28 天分析报告以验证访问权限。
诊断反复出现的授权问题，包括 OAuth 应用仍处于 Google 测试模式时刷新令牌过期的问题。

工作原理

检查是否已安装 Node.js 22 或更高版本，以及是否已有 SearchDock；尽可能重复使用可正常运行的安装。
安装或构建 CLI，然后在开始 Google 登录前，使用 searchdock --version 和 searchdock doctor --json 进行验证。
为当前代理安装 searchdock-setup 和 searchdock 技能，除非插件已提供这些技能。默认使用项目范围。
如果客户端支持 MCP，在不替换现有服务器或账号设置的前提下合并 SearchDock 服务器配置，然后确认列出了全部五个 searchdock_* 工具。
使用 searchdock auth status 检查所选配置文件。如果未连接，引导用户完成 Google Cloud API 和 OAuth 设置；只请求已下载客户端 JSON 文件的本地路径。
为该配置文件启动 searchdock auth login，并让用户完成 Google 的只读浏览器授权流程。
重新检查身份验证，列出可用网站，并选择用户指定的资源。如果存在多个已验证资源且用户未指定任何一个，请询问要使用哪个。
运行 28 天分析检查，并分别报告 CLI 安装、技能安装、MCP 发现和 Google 验证状态。

配置指南

前提条件：Node.js 22 或更高版本。使用 Python 安装时还需要 Python 3.10 或更高版本。请使用现有且可正常运行的 SearchDock 安装，而不要重新安装。
使用 npm 全局安装 CLI：
npm install --global searchdock-cli
searchdock --version
searchdock doctor --json
或者，使用 npx --yes searchdock-cli@0.1.3 运行命令，而无需全局安装。Python 用户可以通过 pipx 安装，但仍须满足 Node.js 要求：
pipx install searchdock-cli
对于源代码检出，请安装依赖并构建：
npm ci
npm run build
node dist/cli.cjs --version
为当前代理安装两个独立技能，并将 codex 替换为其标识符。默认使用项目范围；只有在用户要求时才使用 --global：
npx --yes skills add xplormityai/searchdock-cli --skill searchdock-setup searchdock --agent codex --copy --yes
如果无法使用 skills CLI，请先检查目标位置是否已存在内容，然后将两个技能目录复制到代理支持的技能位置。如果支持 MCP，且插件尚未提供 MCP，则添加一个名为 searchdock 的服务器，命令为 npx，参数为 ["--yes", "searchdock-cli@0.1.3", "mcp"]，并保留客户端现有配置。在 Windows 上，请遵循客户端的进程启动指南，或使用 Node 可执行文件和已安装的 cli.cjs 文件的绝对路径。
登录 Google 前，请让用户在其 Google Cloud 项目中启用 Search Console API、配置 OAuth 授权页面；如果应用处于测试状态，则将用户添加为测试用户；并创建 Desktop app OAuth 客户端。用户在本地下载客户端 JSON 文件；只询问其路径，绝不询问文件内容。然后运行：
searchdock auth status --profile --json
searchdock auth login --client-file --profile searchdock auth status --profile --json
searchdock sites list --profile --json
searchdock sites use --profile searchdock analytics --profile --days 28 --json
不要绕过 Google 的授权流程，也不要暴露机密信息。如果浏览器无法打开，请说明用户如何完成本地流程。完整的 OAuth 说明：https://github.com/xplormityai/searchdock-cli/blob/main/docs/google-setup.md。

数据架构

SearchDock 会将配置文件和本地凭据存储在操作系统中每个用户专属的 SearchDock 配置目录内，该目录位于代码仓库之外。设置 SEARCHDOCK_CONFIG_DIR 可覆盖默认位置。配置文件用于限定身份验证和资源选择；命令接受 --profile ，因此设置时可以避免更改其他配置文件。
数据或产物 位置或处理方式
OAuth 客户端 JSON 由用户在本地下载；登录时提供其路径，绝不提供其内容。
配置文件配置和凭据 存储在每个用户专属的 SearchDock 配置目录中，或存储在 SEARCHDOCK_CONFIG_DIR 指定的目录中。
所选 Search Console 资源 使用 searchdock sites use --profile 为指定配置文件设置。 CLI 报告 命令可以输出 JSON，包括状态、网站列表、诊断信息和分析数据；不要无必要地打印私人报告，也不要将其提交到代码仓库。
绝不要打印或提交客户端 JSON、令牌或私人报告。searchdock auth logout 会移除本地凭据；在 Google 账号权限中撤销访问权限则是另一项操作。

高级特性

支持全局 npm 安装、一次性
npx
执行、pipx 安装，以及从源代码检出内容构建。
安装两个独立技能，并支持特定代理的技能位置；插件可能已经提供这些技能或 MCP 服务器。
searchdock
服务器与 MCP 客户端集成，并将发现五个
searchdock_*
工具的状态与身份验证状态分开验证。
使用命名配置文件进行身份验证和资源选择，有助于避免更改无关账号。
执行只读 Google Search Console 授权，并通过可配置日期范围的分析命令验证连接。
考虑到 Search Console 数据可能存在延迟：缺少查询行并不能证明需求为零。
指出频繁重新连接的一个潜在原因：仍处于 Google 测试模式的 OAuth 应用可能会使用有效期较短的刷新令牌。

name: searchdock-setup description: Set up SearchDock CLI and read-only Google Search Console authentication, choose an account profile and verified property, and check the connection. Use for first installation or reconnecting Google access.

Check node --version (22 or later) and searchdock --version. Reuse a working installation. Otherwise run npm install --global searchdock-cli; a no-global alternative is npx --yes searchdock-cli@0.1.3 . Python users can run pipx install searchdock-cli, but still need Node.js 22+ and Python 3.10+. For a checkout use npm ci, npm run build and node dist/cli.cjs. Verify with --version and doctor --json before starting Google login.

Install both standalone skills for the current agent, unless a plugin already supplies them:

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

Replace codex with the current agent's identifier. Default to project scope; use --global only when requested. Without the skills CLI, copy the two repository skill directories to the agent's supported skills location, checking existing destinations before replacing them.

If MCP is supported, merge a server named searchdock with command npx and args ["--yes", "searchdock-cli@0.1.3", "mcp"] into the client's configuration. Preserve existing servers and account settings. On Windows, follow the client's process-launch guidance or use an absolute node executable with the installed cli.cjs path. A plugin already declares this server. Confirm the five searchdock_* tools are listed; authentication is a separate verification.

Check searchdock auth status --profile --json before reconnecting. If Google is disconnected, tell the user to enable the Search Console API in their own Google Cloud project, configure the OAuth consent screen, add their account as a test user if the app is in testing, and create a Desktop app OAuth client. They must download the JSON locally. Ask only for its path, never its contents. The complete steps are at https://github.com/xplormityai/searchdock-cli/blob/main/docs/google-setup.md.

When connection is requested, run searchdock auth login --client-file --profile . The user must complete Google's read-only browser consent; do not bypass it or expose secrets. If the browser cannot open, explain how the user can complete the local flow.

Run searchdock auth status --profile --json, then searchdock sites list --profile --json. Use the property the user named if verified; ask which property to use when several exist and no site was specified. Set it using searchdock sites use --profile , without changing another profile.

Verify searchdock analytics --profile --days 28 --json. Explain Search Console's data delay and that missing query rows do not establish zero demand. Report CLI installation, skill installation, MCP discovery and Google verification separately; do not call setup complete while consent or a client restart is pending.

Profiles are stored in the operating system's per-user SearchDock configuration directory, outside the repo. SEARCHDOCK_CONFIG_DIR overrides it. Never print client JSON, tokens or private reports or commit them. auth logout removes local credentials; revocation in Google Account permissions is separate. OAuth apps left in Google's testing mode can have short-lived refresh tokens; use the Google setup guide when reconnects are frequent.

AIScope 指令审计

AIScope Setup