seo 0.2.4 → 0.2.5
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.
- package/PRIVACY.md +1 -1
- package/README.md +19 -11
- package/dist/cli.js +91 -92
- package/dist/cli.js.map +1 -1
- package/dist/{dist-BhdgeyGe.js → dist-oHPXlHac.js} +1 -1
- package/dist/{dist-DMSBrZYd.js → dist-oOrG0Vub.js} +69 -227
- package/dist/dist-oOrG0Vub.js.map +1 -0
- package/dist/index.d.ts +48 -32
- package/dist/index.js +187 -281
- package/dist/index.js.map +1 -1
- package/dist/mcp.js +112 -97
- package/dist/mcp.js.map +1 -1
- package/dist/{package-D6bCOqrD.js → package-BF_XgK7-.js} +2 -2
- package/dist/{package-D6bCOqrD.js.map → package-BF_XgK7-.js.map} +1 -1
- package/evals/ai-referrals.json +7 -7
- package/evals/compare-crawls.json +2 -2
- package/evals/monthly-action-plan.json +1 -1
- package/evals/refresh-priorities.json +7 -7
- package/evals/seo-fix-queue.json +2 -2
- package/evals/seo-geo-readiness.json +1 -1
- package/evals/seo-to-ai-query.json +2 -2
- package/package.json +2 -2
- package/skills/seo/SKILL.md +7 -6
- package/skills/seo/agents/openai.yaml +1 -1
- package/dist/dist-DMSBrZYd.js.map +0 -1
package/PRIVACY.md
CHANGED
|
@@ -18,7 +18,7 @@ read-only access to:
|
|
|
18
18
|
you connected;
|
|
19
19
|
- Search Console properties, performance data, and URL Inspection data you can
|
|
20
20
|
already access; and
|
|
21
|
-
- Google Analytics
|
|
21
|
+
- Google Analytics accounts, properties, and report data you can already
|
|
22
22
|
access.
|
|
23
23
|
|
|
24
24
|
The software uses this data to list properties, run the report you requested,
|
package/README.md
CHANGED
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
<h1 align="center">SEO Skill</h1>
|
|
9
9
|
|
|
10
10
|
<p align="center">
|
|
11
|
-
The only SEO skill your agent needs. 50+ SEO audit tools through a local CLI and MCP server, using your own crawl, Search Console, and
|
|
11
|
+
The only SEO skill your agent needs. 50+ SEO audit tools through a local CLI and MCP server, using your own crawl, Search Console, and Google Analytics data.
|
|
12
12
|
</p>
|
|
13
13
|
|
|
14
14
|
<p align="center">
|
|
@@ -47,7 +47,7 @@ clicks, and catch regressions after a release.
|
|
|
47
47
|
|
|
48
48
|
- People running their own sites who want a clear audit and a ranked list of
|
|
49
49
|
fixes, without learning a heavy dashboard.
|
|
50
|
-
- AI agents that need real crawl, Search Console, and
|
|
50
|
+
- AI agents that need real crawl, Search Console, and Google Analytics evidence through MCP
|
|
51
51
|
and one packaged SEO skill instead of screenshots or guesses.
|
|
52
52
|
- Developers who want to embed the same report engine in a script, a CI job, or
|
|
53
53
|
a TypeScript app.
|
|
@@ -63,7 +63,7 @@ seo report
|
|
|
63
63
|
```
|
|
64
64
|
|
|
65
65
|
The setup walks you through Google sign-in, your Search Console property, an
|
|
66
|
-
optional
|
|
66
|
+
optional Google Analytics property, and a local project profile. Public releases can include
|
|
67
67
|
the shared Google app. If it is unavailable in your build, setup guides you
|
|
68
68
|
through adding your own desktop OAuth client.
|
|
69
69
|
|
|
@@ -77,7 +77,7 @@ technical report before connecting Google.
|
|
|
77
77
|
Running `seo help` shows the shape of the tool:
|
|
78
78
|
|
|
79
79
|
```txt
|
|
80
|
-
seo v0.2.
|
|
80
|
+
seo v0.2.5
|
|
81
81
|
|
|
82
82
|
Run SEO audits, find what needs fixing, and ship the changes with your agent.
|
|
83
83
|
|
|
@@ -140,7 +140,7 @@ The point of a report is to be defensible, so the design keeps a few rules:
|
|
|
140
140
|
## Everyday use
|
|
141
141
|
|
|
142
142
|
`seo start` can save a project profile, which is a local shortcut for a site,
|
|
143
|
-
Search Console property,
|
|
143
|
+
Search Console property, Google Analytics property, and brand terms. If you have one default
|
|
144
144
|
project, most commands need no flags.
|
|
145
145
|
|
|
146
146
|
```sh
|
|
@@ -173,6 +173,14 @@ property with `seo start`.
|
|
|
173
173
|
|
|
174
174
|
Run `seo help` for the short path or `seo help all` for the full command list.
|
|
175
175
|
|
|
176
|
+
Google Analytics commands sit under their provider namespace. List the properties available
|
|
177
|
+
to the connected account, then run a report with the property you need:
|
|
178
|
+
|
|
179
|
+
```sh
|
|
180
|
+
seo analytics google properties
|
|
181
|
+
seo analytics google report --property 123456789 --dimensions landingPage --metrics sessions,totalUsers
|
|
182
|
+
```
|
|
183
|
+
|
|
176
184
|
## Crawl a site
|
|
177
185
|
|
|
178
186
|
Run a readable technical crawl, the base of any technical SEO audit:
|
|
@@ -212,7 +220,7 @@ terminal prose.
|
|
|
212
220
|
evidence so an agent can choose its next call without loading every raw report.
|
|
213
221
|
Use `--full` only when a script needs the complete report object.
|
|
214
222
|
|
|
215
|
-
When a CI job needs Search Console or
|
|
223
|
+
When a CI job needs Search Console or Google Analytics data, give it a Google service
|
|
216
224
|
account JSON key through its secret store. The service account needs access to
|
|
217
225
|
the exact properties it will query. This GitHub Actions step runs without a
|
|
218
226
|
browser or a copied local token:
|
|
@@ -227,7 +235,7 @@ browser or a copied local token:
|
|
|
227
235
|
```
|
|
228
236
|
|
|
229
237
|
The [Google data guide](https://seoskill.dev/docs/google) covers Search
|
|
230
|
-
Console and
|
|
238
|
+
Console and Google Analytics permissions, mounted secret files, and how to check the active
|
|
231
239
|
identity safely.
|
|
232
240
|
|
|
233
241
|
Agents can discover and run the same report catalog as MCP without starting a
|
|
@@ -368,9 +376,9 @@ seo reset
|
|
|
368
376
|
`seo auth status` shows the active storage mode. Power users can choose it with
|
|
369
377
|
`seo auth storage --keychain` or `seo auth storage --file`.
|
|
370
378
|
|
|
371
|
-
Power users can bring their own Google OAuth client
|
|
372
|
-
[
|
|
373
|
-
|
|
379
|
+
Power users can bring their own Google OAuth client or use a service account in
|
|
380
|
+
CI. The [Google data guide](https://seoskill.dev/docs/google) covers both auth
|
|
381
|
+
paths, including OAuth testing-mode limits.
|
|
374
382
|
|
|
375
383
|
## Common questions
|
|
376
384
|
|
|
@@ -384,7 +392,7 @@ account, or telemetry service.
|
|
|
384
392
|
### Do I need a Google API key?
|
|
385
393
|
|
|
386
394
|
No. `seo start` uses a normal Google sign-in for read-only Search Console and
|
|
387
|
-
|
|
395
|
+
Google Analytics access. Public releases can include a shared desktop OAuth client, and if
|
|
388
396
|
your build does not have one, setup helps you add your own. You can also run a
|
|
389
397
|
local technical crawl with no Google connection at all.
|
|
390
398
|
|