@seoagent-official/seoagent 1.68.0 → 1.70.0

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.
Files changed (3) hide show
  1. package/README.md +20 -0
  2. package/index.js +107 -107
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -324,6 +324,26 @@ Grouped by what they're for. Run as bare `seoagent <cmd>` after the one-time `np
324
324
 
325
325
  The hooks deliberately use the `npx -y …@latest` form (not bare `seoagent`) so they survive `npm uninstall -g` **and actually stay current** — pinning `@latest` forces npx to re-resolve the newest version each run instead of silently reusing a stale `~/.npm/_npx` cache. No-op when not logged in. Race-safe: a cooperative lock keeps a manual `seoagent sync` from clobbering an in-flight hook run. Both run the same `sync`, which **auto-refreshes the installed skill** when the CLI is newer than the project's `skill_version` — rewriting only the skill bundle, never `.seoagent/`.
326
326
 
327
+ ## Telemetry (anonymous, disclosed, opt-out)
328
+
329
+ `seoagent init` sends **one anonymous ping** so we can count installs: a random
330
+ install id (the same UUID `keywords --peek` uses), the event name (`init` /
331
+ `reinit`), the CLI version, and your OS platform. **Nothing else** — no domain,
332
+ no file paths, no environment contents, no username. The CLI prints a
333
+ disclosure line whenever a ping is sent.
334
+
335
+ `init` also runs one **free keyword peek** on your domain's brand name (the
336
+ same `keywords --peek` lookup, shown to you in the output) so you see real
337
+ keyword data immediately; that request carries your project domain, exactly
338
+ like a manual `--peek`.
339
+
340
+ Opt out of both with either:
341
+
342
+ ```bash
343
+ export SEOAGENT_TELEMETRY=0 # SEOAgent-specific
344
+ export DO_NOT_TRACK=1 # the cross-tool convention — also respected
345
+ ```
346
+
327
347
  ## SEOAgent Cloud
328
348
 
329
349
  The free skill handles audits, strategy, briefs, articles, and persistent state using Claude's native capabilities. For teams and production SEO, [SEOAgent Cloud](https://seoagent.com/pricing?ref=readme) adds: