seo 0.2.3 → 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 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 4 accounts, properties, and report data you can already
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 GA4 data.
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 GA4 evidence through MCP
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 GA4 property, and a local project profile. Public releases can include
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.3
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, GA4 property, and brand terms. If you have one default
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 GA4 data, give it a Google service
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 GA4 permissions, mounted secret files, and how to check the active
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. See
372
- [getting started](https://seoskill.dev/docs/getting-started) for the available
373
- auth paths.
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
- GA4 access. Public releases can include a shared desktop OAuth client, and if
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