searchdock-cli 0.1.2__tar.gz → 0.1.3__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: searchdock-cli
3
- Version: 0.1.2
3
+ Version: 0.1.3
4
4
  Summary: Google Search Console CLI with agent skills and MCP support. Requires Node.js 22+.
5
5
  Author-email: Xplormity Collective <xplormityai@gmail.com>
6
6
  License-Expression: MIT
@@ -24,7 +24,25 @@ Read Google Search Console analytics, inspect indexed URLs, and monitor sitemaps
24
24
 
25
25
  SearchDock is open source, runs locally, and requests read-only Google access. Use the same core through npm, Python, MCP, a Codex or Claude Code plugin, or a standalone agent skill. **Bing Webmaster Tools support is planned.**
26
26
 
27
- ## Install
27
+ ## Set up with your agent
28
+
29
+ Copy this prompt into your coding agent:
30
+
31
+ ```text
32
+ Set up SearchDock CLI for this project using
33
+ https://github.com/xplormityai/searchdock-cli. Read its README and
34
+ skills/searchdock-setup/SKILL.md. Check Node.js 22+, reuse an existing
35
+ installation, or install the CLI from npm. Install searchdock-setup and
36
+ searchdock skills for the agent I am using, scoped to this project, and
37
+ connect the stdio MCP server if this agent supports it. Keep existing
38
+ agent configuration. For Google access, ask only for the local path to
39
+ my Desktop OAuth client JSON and guide me through read-only browser
40
+ consent. Never print credentials or tokens. Let me choose the Search
41
+ Console property, then verify the connection with a metrics request.
42
+ Tell me exactly which steps succeeded and what still needs my input.
43
+ ```
44
+
45
+ ## Installation commands
28
46
 
29
47
  Node.js **22 or later** is required for every distribution.
30
48
 
@@ -36,7 +54,7 @@ npm install --global searchdock-cli
36
54
  searchdock --help
37
55
 
38
56
  # No global installation
39
- npx --yes searchdock-cli@0.1.2 --help
57
+ npx --yes searchdock-cli@0.1.3 --help
40
58
 
41
59
  # Python; Node.js is still required
42
60
  pipx install searchdock-cli
@@ -45,6 +63,14 @@ pipx install searchdock-cli
45
63
 
46
64
  The Python package is a launcher containing the exact same JavaScript runtime. It has no separate Google implementation. If you install both packages, use `python -m searchdock_cli` to select the Python launcher explicitly.
47
65
 
66
+ Install both skills for Codex in the current project:
67
+
68
+ ```sh
69
+ npx --yes skills add xplormityai/searchdock-cli --skill searchdock-setup searchdock --agent codex --copy --yes
70
+ ```
71
+
72
+ Replace `codex` with `claude-code`, `cursor`, `opencode`, or your [supported agent](https://github.com/vercel-labs/skills#supported-agents). Add `--global` only for installation across projects. Skills do not install the CLI or authorize Google access. [Plugin, MCP and manual setup](https://github.com/xplormityai/searchdock-cli/blob/main/docs/agents.md).
73
+
48
74
  To run from source:
49
75
 
50
76
  ```sh
@@ -112,13 +138,13 @@ Add this stdio server to any compatible MCP client:
112
138
  "mcpServers": {
113
139
  "searchdock": {
114
140
  "command": "npx",
115
- "args": ["--yes", "searchdock-cli@0.1.2", "mcp"]
141
+ "args": ["--yes", "searchdock-cli@0.1.3", "mcp"]
116
142
  }
117
143
  }
118
144
  }
119
145
  ```
120
146
 
121
- For a source checkout, set `command` to `node` and `args` to `["/absolute/path/searchdock-cli/dist/cli.cjs", "mcp"]`. Windows clients that launch `npx.cmd` through a shell may need `command: "cmd"` and `args: ["/c", "npx", "--yes", "searchdock-cli@0.1.2", "mcp"]`. Use your client's Windows configuration guidance.
147
+ For a source checkout, set `command` to `node` and `args` to `["/absolute/path/searchdock-cli/dist/cli.cjs", "mcp"]`. Windows clients that launch `npx.cmd` through a shell may need `command: "cmd"` and `args: ["/c", "npx", "--yes", "searchdock-cli@0.1.3", "mcp"]`. Use your client's Windows configuration guidance.
122
148
 
123
149
  Plugins use the same pinned npm version:
124
150
 
@@ -131,16 +157,17 @@ codex plugin add searchdock@searchdock
131
157
  In Claude Code:
132
158
 
133
159
  ```text
134
- /plugin marketplace add xplormityai/searchdock-cli
135
- /plugin install searchdock@searchdock
160
+ /plugin install searchdock --marketplace xplormityai/searchdock-cli --scope project
136
161
  ```
137
162
 
138
- For a standalone skill, copy [`skills/searchdock`](https://github.com/xplormityai/searchdock-cli/blob/main/skills/searchdock) into your agent's skills directory. Codex uses `~/.agents/skills/`; Claude Code uses `~/.claude/skills/`. Install the CLI separately. The setup skill is included in the plugin. The repository includes portable Agent Plugins, Codex and Claude manifests; local stdio plugins are not automatically listed in hosted plugin directories.
163
+ This one-step command requires Claude Code 2.1.275+. Earlier versions can use `/plugin marketplace add xplormityai/searchdock-cli`, then `/plugin install searchdock@searchdock --scope project`.
164
+
165
+ For standalone skills, copy both [`skills/searchdock`](https://github.com/xplormityai/searchdock-cli/blob/main/skills/searchdock) and [`skills/searchdock-setup`](https://github.com/xplormityai/searchdock-cli/blob/main/skills/searchdock-setup) into your agent's skills directory. Codex uses `~/.agents/skills/`; Claude Code uses `~/.claude/skills/`. Install the CLI separately. Both skills are included in the plugin. The repository includes portable Agent Plugins, Codex and Claude manifests; local stdio plugins are not automatically listed in hosted plugin directories.
139
166
 
140
167
  You can also install the skill with the [open skills installer](https://github.com/vercel-labs/skills):
141
168
 
142
169
  ```sh
143
- npx skills add xplormityai/searchdock-cli --skill searchdock
170
+ npx --yes skills add xplormityai/searchdock-cli --skill searchdock-setup searchdock --agent codex --copy --yes
144
171
  ```
145
172
 
146
173
  [`server.json`](https://github.com/xplormityai/searchdock-cli/blob/main/server.json) prepares a listing in the MCP Registry under `io.github.xplormityai/searchdock-cli`. Registry publication requires the npm package to be live and namespace authentication; the metadata file alone does not create a listing.
@@ -178,7 +205,7 @@ npm test
178
205
  npm run check
179
206
  python -m pip install build twine
180
207
  npm run release:artifacts
181
- python -m twine check dist/releases/searchdock_cli-0.1.2-py3-none-any.whl dist/releases/searchdock_cli-0.1.2.tar.gz
208
+ python -m twine check dist/releases/searchdock_cli-0.1.3-py3-none-any.whl dist/releases/searchdock_cli-0.1.3.tar.gz
182
209
  ```
183
210
 
184
211
  [Release instructions](https://github.com/xplormityai/searchdock-cli/blob/main/docs/releasing.md) cover npm/PyPI accounts, OIDC trusted publishing, versioning and GitHub release artifacts. Package creation alone does not publish anything.
@@ -4,7 +4,25 @@ Read Google Search Console analytics, inspect indexed URLs, and monitor sitemaps
4
4
 
5
5
  SearchDock is open source, runs locally, and requests read-only Google access. Use the same core through npm, Python, MCP, a Codex or Claude Code plugin, or a standalone agent skill. **Bing Webmaster Tools support is planned.**
6
6
 
7
- ## Install
7
+ ## Set up with your agent
8
+
9
+ Copy this prompt into your coding agent:
10
+
11
+ ```text
12
+ Set up SearchDock CLI for this project using
13
+ https://github.com/xplormityai/searchdock-cli. Read its README and
14
+ skills/searchdock-setup/SKILL.md. Check Node.js 22+, reuse an existing
15
+ installation, or install the CLI from npm. Install searchdock-setup and
16
+ searchdock skills for the agent I am using, scoped to this project, and
17
+ connect the stdio MCP server if this agent supports it. Keep existing
18
+ agent configuration. For Google access, ask only for the local path to
19
+ my Desktop OAuth client JSON and guide me through read-only browser
20
+ consent. Never print credentials or tokens. Let me choose the Search
21
+ Console property, then verify the connection with a metrics request.
22
+ Tell me exactly which steps succeeded and what still needs my input.
23
+ ```
24
+
25
+ ## Installation commands
8
26
 
9
27
  Node.js **22 or later** is required for every distribution.
10
28
 
@@ -16,7 +34,7 @@ npm install --global searchdock-cli
16
34
  searchdock --help
17
35
 
18
36
  # No global installation
19
- npx --yes searchdock-cli@0.1.2 --help
37
+ npx --yes searchdock-cli@0.1.3 --help
20
38
 
21
39
  # Python; Node.js is still required
22
40
  pipx install searchdock-cli
@@ -25,6 +43,14 @@ pipx install searchdock-cli
25
43
 
26
44
  The Python package is a launcher containing the exact same JavaScript runtime. It has no separate Google implementation. If you install both packages, use `python -m searchdock_cli` to select the Python launcher explicitly.
27
45
 
46
+ Install both skills for Codex in the current project:
47
+
48
+ ```sh
49
+ npx --yes skills add xplormityai/searchdock-cli --skill searchdock-setup searchdock --agent codex --copy --yes
50
+ ```
51
+
52
+ Replace `codex` with `claude-code`, `cursor`, `opencode`, or your [supported agent](https://github.com/vercel-labs/skills#supported-agents). Add `--global` only for installation across projects. Skills do not install the CLI or authorize Google access. [Plugin, MCP and manual setup](https://github.com/xplormityai/searchdock-cli/blob/main/docs/agents.md).
53
+
28
54
  To run from source:
29
55
 
30
56
  ```sh
@@ -92,13 +118,13 @@ Add this stdio server to any compatible MCP client:
92
118
  "mcpServers": {
93
119
  "searchdock": {
94
120
  "command": "npx",
95
- "args": ["--yes", "searchdock-cli@0.1.2", "mcp"]
121
+ "args": ["--yes", "searchdock-cli@0.1.3", "mcp"]
96
122
  }
97
123
  }
98
124
  }
99
125
  ```
100
126
 
101
- For a source checkout, set `command` to `node` and `args` to `["/absolute/path/searchdock-cli/dist/cli.cjs", "mcp"]`. Windows clients that launch `npx.cmd` through a shell may need `command: "cmd"` and `args: ["/c", "npx", "--yes", "searchdock-cli@0.1.2", "mcp"]`. Use your client's Windows configuration guidance.
127
+ For a source checkout, set `command` to `node` and `args` to `["/absolute/path/searchdock-cli/dist/cli.cjs", "mcp"]`. Windows clients that launch `npx.cmd` through a shell may need `command: "cmd"` and `args: ["/c", "npx", "--yes", "searchdock-cli@0.1.3", "mcp"]`. Use your client's Windows configuration guidance.
102
128
 
103
129
  Plugins use the same pinned npm version:
104
130
 
@@ -111,16 +137,17 @@ codex plugin add searchdock@searchdock
111
137
  In Claude Code:
112
138
 
113
139
  ```text
114
- /plugin marketplace add xplormityai/searchdock-cli
115
- /plugin install searchdock@searchdock
140
+ /plugin install searchdock --marketplace xplormityai/searchdock-cli --scope project
116
141
  ```
117
142
 
118
- For a standalone skill, copy [`skills/searchdock`](https://github.com/xplormityai/searchdock-cli/blob/main/skills/searchdock) into your agent's skills directory. Codex uses `~/.agents/skills/`; Claude Code uses `~/.claude/skills/`. Install the CLI separately. The setup skill is included in the plugin. The repository includes portable Agent Plugins, Codex and Claude manifests; local stdio plugins are not automatically listed in hosted plugin directories.
143
+ This one-step command requires Claude Code 2.1.275+. Earlier versions can use `/plugin marketplace add xplormityai/searchdock-cli`, then `/plugin install searchdock@searchdock --scope project`.
144
+
145
+ For standalone skills, copy both [`skills/searchdock`](https://github.com/xplormityai/searchdock-cli/blob/main/skills/searchdock) and [`skills/searchdock-setup`](https://github.com/xplormityai/searchdock-cli/blob/main/skills/searchdock-setup) into your agent's skills directory. Codex uses `~/.agents/skills/`; Claude Code uses `~/.claude/skills/`. Install the CLI separately. Both skills are included in the plugin. The repository includes portable Agent Plugins, Codex and Claude manifests; local stdio plugins are not automatically listed in hosted plugin directories.
119
146
 
120
147
  You can also install the skill with the [open skills installer](https://github.com/vercel-labs/skills):
121
148
 
122
149
  ```sh
123
- npx skills add xplormityai/searchdock-cli --skill searchdock
150
+ npx --yes skills add xplormityai/searchdock-cli --skill searchdock-setup searchdock --agent codex --copy --yes
124
151
  ```
125
152
 
126
153
  [`server.json`](https://github.com/xplormityai/searchdock-cli/blob/main/server.json) prepares a listing in the MCP Registry under `io.github.xplormityai/searchdock-cli`. Registry publication requires the npm package to be live and namespace authentication; the metadata file alone does not create a listing.
@@ -158,7 +185,7 @@ npm test
158
185
  npm run check
159
186
  python -m pip install build twine
160
187
  npm run release:artifacts
161
- python -m twine check dist/releases/searchdock_cli-0.1.2-py3-none-any.whl dist/releases/searchdock_cli-0.1.2.tar.gz
188
+ python -m twine check dist/releases/searchdock_cli-0.1.3-py3-none-any.whl dist/releases/searchdock_cli-0.1.3.tar.gz
162
189
  ```
163
190
 
164
191
  [Release instructions](https://github.com/xplormityai/searchdock-cli/blob/main/docs/releasing.md) cover npm/PyPI accounts, OIDC trusted publishing, versioning and GitHub release artifacts. Package creation alone does not publish anything.
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "searchdock-cli"
7
- version = "0.1.2"
7
+ version = "0.1.3"
8
8
  description = "Google Search Console CLI with agent skills and MCP support. Requires Node.js 22+."
9
9
  readme = "README.md"
10
10
  requires-python = ">=3.10"
@@ -59,7 +59,7 @@ ${f}
59
59
  `)},fetcher:o})}else if(u==="logout")await n.remove(d),p={profile:d,removedLocalCredentials:!0,note:"To revoke Google access too, remove the OAuth app in your Google Account permissions."};else if(u==="status"){let f=await ir(m),g=await f.adapter.sites();p={connected:!0,provider:h,profile:d,selectedSite:f.site||null,...g}}else throw new N("Use auth login, auth status or auth logout.")}else if(c==="sites")if(u==="use"&&l.length===1)p=await Kp(l[0],m);else if(u==="list"&&!l.length)p=await(await ir(m)).adapter.sites();else throw new N("Use sites list or sites use <property>.");else if(["analytics","sitemaps","inspect","report"].includes(c)){if(c==="inspect"?a.length!==2:a.length!==1)throw new N("Unexpected or missing positional arguments. Run searchdock --help.");let f={days:qv(i.days,28,"Days"),start:i.start,end:i.end,dimensions:i.dimensions?.split(","),type:i.type,brand:i.brand,limit:qv(i.limit,1e3,"Limit"),urls:i.urls?.split(",")},g=await Go(m);p=c==="inspect"?await g.adapter.inspect(g.site,u):c==="sitemaps"?await g.adapter.sitemaps(g.site):await g.adapter[c](g.site,f)}else throw new N(`Unknown command "${c}". Run searchdock --help.`);if(i.output){try{throw await(0,Ki.access)(i.output),new N("The output file already exists. Choose a new path.")}catch(f){if(f.code!=="ENOENT")throw f}await(0,Ki.writeFile)(i.output,JSON.stringify(p,null,2)+`
60
60
  `,{flag:"wx",mode:384})}return e.write((s?JSON.stringify(p,null,2):ZR(p))+`
61
61
  `),0}catch(i){return r.write((s?JSON.stringify({error:{code:i.code?.startsWith?.("GOOGLE_")?i.code:"SEARCHDOCK_ERROR",message:Rn(i)}}):`SearchDock: ${Rn(i)}`)+`
62
- `),1}}var Lv,Ki,Uo,IR,Ap=x(()=>{Lv=require("node:util"),Ki=require("node:fs/promises");na();sa();ca();aa();Et();Uo="0.1.2",IR=`SearchDock CLI ${Uo} \u2014 Google Search Console from your terminal
62
+ `),1}}var Lv,Ki,Uo,IR,Ap=x(()=>{Lv=require("node:util"),Ki=require("node:fs/promises");na();sa();ca();aa();Et();Uo="0.1.3",IR=`SearchDock CLI ${Uo} \u2014 Google Search Console from your terminal
63
63
 
64
64
  Usage: searchdock <command> [options]
65
65
 
@@ -0,0 +1 @@
1
+ __version__ = "0.1.3"
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: searchdock-cli
3
- Version: 0.1.2
3
+ Version: 0.1.3
4
4
  Summary: Google Search Console CLI with agent skills and MCP support. Requires Node.js 22+.
5
5
  Author-email: Xplormity Collective <xplormityai@gmail.com>
6
6
  License-Expression: MIT
@@ -24,7 +24,25 @@ Read Google Search Console analytics, inspect indexed URLs, and monitor sitemaps
24
24
 
25
25
  SearchDock is open source, runs locally, and requests read-only Google access. Use the same core through npm, Python, MCP, a Codex or Claude Code plugin, or a standalone agent skill. **Bing Webmaster Tools support is planned.**
26
26
 
27
- ## Install
27
+ ## Set up with your agent
28
+
29
+ Copy this prompt into your coding agent:
30
+
31
+ ```text
32
+ Set up SearchDock CLI for this project using
33
+ https://github.com/xplormityai/searchdock-cli. Read its README and
34
+ skills/searchdock-setup/SKILL.md. Check Node.js 22+, reuse an existing
35
+ installation, or install the CLI from npm. Install searchdock-setup and
36
+ searchdock skills for the agent I am using, scoped to this project, and
37
+ connect the stdio MCP server if this agent supports it. Keep existing
38
+ agent configuration. For Google access, ask only for the local path to
39
+ my Desktop OAuth client JSON and guide me through read-only browser
40
+ consent. Never print credentials or tokens. Let me choose the Search
41
+ Console property, then verify the connection with a metrics request.
42
+ Tell me exactly which steps succeeded and what still needs my input.
43
+ ```
44
+
45
+ ## Installation commands
28
46
 
29
47
  Node.js **22 or later** is required for every distribution.
30
48
 
@@ -36,7 +54,7 @@ npm install --global searchdock-cli
36
54
  searchdock --help
37
55
 
38
56
  # No global installation
39
- npx --yes searchdock-cli@0.1.2 --help
57
+ npx --yes searchdock-cli@0.1.3 --help
40
58
 
41
59
  # Python; Node.js is still required
42
60
  pipx install searchdock-cli
@@ -45,6 +63,14 @@ pipx install searchdock-cli
45
63
 
46
64
  The Python package is a launcher containing the exact same JavaScript runtime. It has no separate Google implementation. If you install both packages, use `python -m searchdock_cli` to select the Python launcher explicitly.
47
65
 
66
+ Install both skills for Codex in the current project:
67
+
68
+ ```sh
69
+ npx --yes skills add xplormityai/searchdock-cli --skill searchdock-setup searchdock --agent codex --copy --yes
70
+ ```
71
+
72
+ Replace `codex` with `claude-code`, `cursor`, `opencode`, or your [supported agent](https://github.com/vercel-labs/skills#supported-agents). Add `--global` only for installation across projects. Skills do not install the CLI or authorize Google access. [Plugin, MCP and manual setup](https://github.com/xplormityai/searchdock-cli/blob/main/docs/agents.md).
73
+
48
74
  To run from source:
49
75
 
50
76
  ```sh
@@ -112,13 +138,13 @@ Add this stdio server to any compatible MCP client:
112
138
  "mcpServers": {
113
139
  "searchdock": {
114
140
  "command": "npx",
115
- "args": ["--yes", "searchdock-cli@0.1.2", "mcp"]
141
+ "args": ["--yes", "searchdock-cli@0.1.3", "mcp"]
116
142
  }
117
143
  }
118
144
  }
119
145
  ```
120
146
 
121
- For a source checkout, set `command` to `node` and `args` to `["/absolute/path/searchdock-cli/dist/cli.cjs", "mcp"]`. Windows clients that launch `npx.cmd` through a shell may need `command: "cmd"` and `args: ["/c", "npx", "--yes", "searchdock-cli@0.1.2", "mcp"]`. Use your client's Windows configuration guidance.
147
+ For a source checkout, set `command` to `node` and `args` to `["/absolute/path/searchdock-cli/dist/cli.cjs", "mcp"]`. Windows clients that launch `npx.cmd` through a shell may need `command: "cmd"` and `args: ["/c", "npx", "--yes", "searchdock-cli@0.1.3", "mcp"]`. Use your client's Windows configuration guidance.
122
148
 
123
149
  Plugins use the same pinned npm version:
124
150
 
@@ -131,16 +157,17 @@ codex plugin add searchdock@searchdock
131
157
  In Claude Code:
132
158
 
133
159
  ```text
134
- /plugin marketplace add xplormityai/searchdock-cli
135
- /plugin install searchdock@searchdock
160
+ /plugin install searchdock --marketplace xplormityai/searchdock-cli --scope project
136
161
  ```
137
162
 
138
- For a standalone skill, copy [`skills/searchdock`](https://github.com/xplormityai/searchdock-cli/blob/main/skills/searchdock) into your agent's skills directory. Codex uses `~/.agents/skills/`; Claude Code uses `~/.claude/skills/`. Install the CLI separately. The setup skill is included in the plugin. The repository includes portable Agent Plugins, Codex and Claude manifests; local stdio plugins are not automatically listed in hosted plugin directories.
163
+ This one-step command requires Claude Code 2.1.275+. Earlier versions can use `/plugin marketplace add xplormityai/searchdock-cli`, then `/plugin install searchdock@searchdock --scope project`.
164
+
165
+ For standalone skills, copy both [`skills/searchdock`](https://github.com/xplormityai/searchdock-cli/blob/main/skills/searchdock) and [`skills/searchdock-setup`](https://github.com/xplormityai/searchdock-cli/blob/main/skills/searchdock-setup) into your agent's skills directory. Codex uses `~/.agents/skills/`; Claude Code uses `~/.claude/skills/`. Install the CLI separately. Both skills are included in the plugin. The repository includes portable Agent Plugins, Codex and Claude manifests; local stdio plugins are not automatically listed in hosted plugin directories.
139
166
 
140
167
  You can also install the skill with the [open skills installer](https://github.com/vercel-labs/skills):
141
168
 
142
169
  ```sh
143
- npx skills add xplormityai/searchdock-cli --skill searchdock
170
+ npx --yes skills add xplormityai/searchdock-cli --skill searchdock-setup searchdock --agent codex --copy --yes
144
171
  ```
145
172
 
146
173
  [`server.json`](https://github.com/xplormityai/searchdock-cli/blob/main/server.json) prepares a listing in the MCP Registry under `io.github.xplormityai/searchdock-cli`. Registry publication requires the npm package to be live and namespace authentication; the metadata file alone does not create a listing.
@@ -178,7 +205,7 @@ npm test
178
205
  npm run check
179
206
  python -m pip install build twine
180
207
  npm run release:artifacts
181
- python -m twine check dist/releases/searchdock_cli-0.1.2-py3-none-any.whl dist/releases/searchdock_cli-0.1.2.tar.gz
208
+ python -m twine check dist/releases/searchdock_cli-0.1.3-py3-none-any.whl dist/releases/searchdock_cli-0.1.3.tar.gz
182
209
  ```
183
210
 
184
211
  [Release instructions](https://github.com/xplormityai/searchdock-cli/blob/main/docs/releasing.md) cover npm/PyPI accounts, OIDC trusted publishing, versioning and GitHub release artifacts. Package creation alone does not publish anything.
@@ -1 +0,0 @@
1
- __version__ = "0.1.2"
File without changes
File without changes