seo 0.2.16 → 0.2.18

package/evals/rank-tracking.json

@@ -0,0 +1,40 @@
+{
+  "subject": "rank-tracking",
+  "evals": [
+    {
+      "id": 1,
+      "prompt": "Track our saved local-priorities keyword set every week on desktop and mobile, and tell me what moved.",
+      "expected_output": "Should discover and describe rank-tracking, then run it with the saved project and set, target domain, separate desktop and mobile devices, queued collection, and weekly cadence. Should report pending collection honestly or compare the current run with the prior comparable run, including depth, market, cost, coverage, new, lost, improved, declined, and ranking URL changes.",
+      "assertions": [
+        "Uses report id rank-tracking through the discovery flow",
+        "Uses queued weekly collection for the recurring saved set",
+        "Keeps desktop and mobile observations separate",
+        "Checks run state, coverage, cost, caveats, and comparison before summarising movement"
+      ],
+      "files": []
+    },
+    {
+      "id": 2,
+      "prompt": "The tracker says we disappeared because it did not see us in the top 50. Confirm that we no longer rank anywhere.",
+      "expected_output": "Should refuse the claim. It should explain that not observed means only that the target domain was not retained within the configured depth for that exact market and device. It should check for pending or failed tasks, avoid calling missing rows losses, and recommend a deeper or matching snapshot plus Search Console context where useful.",
+      "assertions": [
+        "Does not turn not-observed-within-depth into proof of no ranking",
+        "Checks pending and failed task states before calling a loss",
+        "Keeps exact snapshots separate from Search Console average position",
+        "Recommends verification in the same market and device"
+      ],
+      "files": []
+    },
+    {
+      "id": 3,
+      "prompt": "Compare our London mobile ranks with our UK desktop history and average them so I can get one clean position number.",
+      "expected_output": "Should refuse to blend unlike configurations. It should keep location and device-specific exact snapshots separate, use only a prior run with the same configuration, and explain that averaging those observations would hide material market and device differences.",
+      "assertions": [
+        "Refuses to average London mobile and UK desktop exact ranks",
+        "Uses only a comparable prior run with the same configuration",
+        "Preserves location, device, depth, and provider provenance"
+      ],
+      "files": []
+    }
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "seo",
-  "version": "0.2.16",
+  "version": "0.2.18",
   "description": "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.",
   "type": "module",
   "license": "Apache-2.0",
@@ -76,6 +76,7 @@
     "skills:validate": "node scripts/validate-skills.mjs",
     "test": "turbo run test && pnpm run build:package && node --test scripts/package.test.mjs scripts/dogfood-summary.test.mjs && node scripts/resource-harness.mjs && node scripts/provider-resource-harness.mjs && node scripts/pseo-resource-harness.mjs && node scripts/indexnow-resource-harness.mjs && node scripts/bing-resource-harness.mjs && pnpm run skills:validate",
     "test:resources": "pnpm run build:package && node scripts/resource-harness.mjs && node scripts/provider-resource-harness.mjs && node scripts/pseo-resource-harness.mjs && node scripts/indexnow-resource-harness.mjs && node scripts/bing-resource-harness.mjs",
+    "test:rank-resources": "pnpm run build:package && node scripts/rank-tracking-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",
     "typecheck": "turbo run typecheck"
   },
@@ -91,9 +92,9 @@
     "debug": "^4.4.3",
     "defuddle": "^0.19.1",
     "jsonc-parser": "^3.3.1",
-    "lighthouse": "13.4.0",
-    "linkedom": "^0.18.13",
     "libsql": "^0.5.29",
+    "lighthouse": "13.4.1",
+    "linkedom": "^0.18.13",
     "open": "^11.0.0",
     "p-queue": "^9.3.1",
     "p-retry": "^8.0.0",
@@ -104,16 +105,16 @@
     "proper-lockfile": "^4.1.2",
     "robots-parser": "^3.0.1",
     "schema-dts": "^2.0.0",
-    "string-width": "^7.2.0",
-    "undici": "^8.7.0",
+    "string-width": "^8.2.2",
+    "undici": "^8.8.0",
     "update-notifier": "^7.3.1",
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.5.3",
-    "@changesets/cli": "^2.31.0",
-    "tsdown": "^0.22.4",
-    "turbo": "^2.10.4",
+    "@biomejs/biome": "^2.5.4",
+    "@changesets/cli": "^2.31.1",
+    "tsdown": "^0.22.12",
+    "turbo": "^2.10.5",
     "typescript": "^6.0.3"
   }
 }

package/skills/seo/SKILL.md

@@ -55,6 +55,7 @@ Run the first report, read it, then decide. Do not run a whole chain blindly.
 | AI search visibility and eligibility | `ai-readiness`, `geo-gaps`, `ai-referrals`, `seo-to-ai-query` |
 | Plan content from real demand | `query-clusters`, `page-opportunities`, `content-optimization`, `cannibalisation` |
 | Catch regressions over time | `technical-watch`, `crawl-diff`, `index-watch`, `measure-change` after a fix ships |
+| Track exact keyword positions | `rank-tracking` for a saved set and fixed market/device; `serp-results` for one current query |
 | Review Bing traffic, crawl, query, and page insights | `bing-webmaster-overview`, then `site-crawl` when live page evidence is needed |
 | See who links to the site | `link-evidence`, then verify selected referring URLs directly |
 | Review real crawler requests in a server log | `server-log-analysis`, then verify important errors against the original log and server configuration |