seo 0.4.2 → 0.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "seo",
-  "version": "0.4.2",
+  "version": "0.6.0",
   "mcpName": "dev.seoskill/seo",
   "description": "The SEO command for AI agents: a free Google Search Console MCP server and CLI. Reads your real Search Console, Google Analytics and Bing data for traffic drops, quick wins, content decay, cannibalization and indexing, plus DataForSEO and Ahrefs keyword research.",
   "type": "module",
@@ -96,7 +96,7 @@
     "skills:validate": "node scripts/validate-skills.mjs",
     "test": "turbo run test && pnpm run test:contracts:built",
     "test:built": "turbo run test && pnpm run test:contracts:built",
-    "test:contracts:built": "node --test scripts/package.test.mjs scripts/provider-packages.test.mjs",
+    "test:contracts:built": "node --test scripts/package.test.mjs",
     "test:resources": "pnpm run build:package && pnpm run test:resources:built",
     "test:resources:built": "node scripts/resource-harness.mjs && node scripts/provider-resource-harness.mjs && node scripts/provider-extension-resource-harness.mjs",
     "test:package-install": "pnpm --filter @seo/core build && pnpm --filter @seo/mcp build && pnpm run build:package && node --test scripts/installed-package.test.mjs",

package/skills/seo/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: seo
-description: Free Google Search Console MCP server and CLI for AI agents. Reads your real Search Console, Google Analytics and Bing Webmaster Tools data, plus DataForSEO and Ahrefs keyword research. Use it for any SEO question - why Google traffic or clicks dropped, organic traffic decline, quick wins, low CTR, striking distance keywords, content decay and declining pages, keyword cannibalization, indexing and URL inspection, one page's queries, Google update impact, competitor keywords, backlinks, technical SEO crawls, redirects, internal links and client SEO reports. Returns facts from your own data, never guesses.
+description: Free Google Search Console MCP server and CLI for AI agents. Reads your real Search Console, Google Analytics, Bing Webmaster Tools and Clicky data, plus DataForSEO and Ahrefs keyword research. Use it for any SEO question - why Google traffic or clicks dropped, organic traffic decline, quick wins, low CTR, striking distance keywords, content decay and declining pages, keyword cannibalization, indexing and URL inspection, one page's queries, Google update impact, competitor keywords, backlinks, technical SEO crawls, redirects, internal links and client SEO reports. Returns facts from your own data, never guesses.
 ---
 
 # seo
@@ -14,12 +14,15 @@ There are two ways to reach the same commands:
 
 - **MCP tools**, from the hosted server at `https://seoskill.dev/mcp` or the
   local server from `seo mcp serve`. Use them when they are connected.
-- **The CLI**. Before the first call, run `command -v seo`. If it is missing,
-  run `npm i -g seo`, then `seo start` to sign in with Google. Add `--json`
-  for machine-readable output; JSON mode never prompts.
+- **The CLI**: `seo`, or `npx -y seo` when it is not installed. Sign in
+  once with `seo login`: show the person the link it prints, then run
+  `seo login` again after they approve. It uses the same seoskill.dev
+  account as the hosted server (Google accounts, Bing, keys). A cloud agent
+  can use an account-page token as `SEO_TOKEN`. Add `--json` for JSON; it
+  never prompts.
 
-Crawls, internal links and Bing run only on the person's machine, through
-the CLI or the local MCP server.
+Crawls, internal links and Bing run only in the CLI or the local MCP
+server, on any machine with a shell.
 
 ## The commands
 
@@ -30,7 +33,7 @@ the CLI or the local MCP server.
 | `seo compare --date <date>` | `seo_compare` | Equal periods before and after a date, with Google updates |
 | `seo index` | `seo_index` | Pages that lost most of their clicks, checked live and with URL Inspection |
 | `seo research <action>` | `seo_research` | Keyword metrics, ranked keywords, SERP, competitors, backlinks |
-| `seo data` | `seo_data` | Raw Search Console or Bing rows (source `bing`); the MCP tool also reads analytics landing pages |
+| `seo data` | `seo_data` | Raw Search Console, Bing (source `bing`) or Clicky (source `clicky`) rows; the MCP tool also reads Google Analytics landing pages |
 | `seo crawl` | `seo_crawl` | A site crawl with technical issues and the URLs they affect |
 | `seo internal-links --url <url>` | `seo_internal_links` | Pages that could link to a target page |
 
@@ -52,9 +55,6 @@ CLI commands need `--site` (or `--url`): `example.com`, a URL or
 4. Each result ends with the command to run next. Follow it when it fits the
    question.
 
-Each command takes a target and optional dates. Everything else is automatic
-and shown in the output.
-
 ## Common jobs
 
 | Job | Commands |
@@ -76,17 +76,18 @@ and shown in the output.
 The report overview shows Google and Bing clicks for the same dates. The
 `bing` section puts Bing's top queries and pages beside Google's numbers. Never
 add Bing to Google. Bing lists only its top rows by week, so a missing row is
-unknown, not zero. Bing runs in the CLI and local MCP server: connect it once
-with `seo providers bing connect` (or `SEO_BING_API_KEY`). The hosted server
-has no Bing yet, so its totals are Google only: no Bing data there is not
-"no Bing traffic". Run `npx -y seo report --site <site> --section bing --json`.
+unknown, not zero. Bing runs in the CLI and local MCP server: connect Bing
+on the account page and run `seo login`, or use `seo providers bing connect`.
+The hosted server cannot reach Bing, so its totals are Google only: no Bing
+data there is not "no Bing traffic". Run
+`npx -y seo report --site <site> --section bing --json`.
 
 ## Research keys
 
-Research costs the person's own provider credits. On the hosted server, add
-keys and missing Google accounts at `https://seoskill.dev/account`, or send
-keys as client headers. In the CLI and local server, run
-`seo providers <name> connect`. Domain Rating appears
+Research costs the person's own provider credits. Keys and missing Google
+accounts are added at `https://seoskill.dev/account`; the hosted server and
+a CLI linked with `seo login` both use them. `seo providers <name> connect`
+keeps a key on one machine only. Domain Rating appears
 as a free column next to domains; credit it as "Domain Rating by Ahrefs".
 
 ## Evidence rules