@lv24/seo 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,50 @@
-# Temporary Holding Version
+# @lv24/seo
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+`npx` launcher for the Python package [`lv24-seo`](https://pypi.org/project/lv24-seo/) —
+a free-first SEO control plane for humans and AI agents (Google Search Console, Yandex Webmaster,
+Yandex Metrika, Bing/IndexNow, CrUX, PageSpeed Insights, a 30-rule technical crawl, scheduled
+email/Telegram reports, an MCP server and agent skills).
+
+This npm package contains **no SEO logic**. It forwards every argument to
+`uvx --from lv24-seo lv24-seo …` (or to a `lv24-seo` binary already on `PATH`), so the CLI, its
+`--json` envelope and the documented exit codes behave exactly as in the Python package.
+
+## Requirements
+
+* [uv](https://docs.astral.sh/uv/) (recommended) **or** an installed `lv24-seo` binary
+  (`pipx install lv24-seo` / `uv tool install lv24-seo`). Python itself does not need to be installed
+  when uv is present — uv downloads the right interpreter.
+
+## Usage
+
+```bash
+npx @lv24/seo doctor --json
+npx @lv24/seo init --property https://example.com
+npx @lv24/seo auth set --provider gsc --stdin
+npx @lv24/seo report weekly --json --out reports/
+npx @lv24/seo mcp serve            # stdio MCP server for Claude/OpenCode/Cursor
+```
+
+The first run may take a few seconds while uv resolves and caches the Python package.
+
+## Configuration
+
+Tokens are read from the keychain (set them with `lv24-seo auth set`) or from `LV24_SEO_*`
+environment variables. Nothing is written by this wrapper.
+
+If auto-detection picks the wrong binary, point it explicitly:
+
+```bash
+LV24_SEO_BIN=/usr/local/bin/lv24-seo npx @lv24/seo doctor
+```
+
+## Links
+
+* Documentation: <https://github.com/LevapVeeskela/lv24-seo-optimizer>
+* MCP tools and skills: see `docs/mcp.md` and `skills/` in the repository
+* Issues: <https://github.com/LevapVeeskela/lv24-seo-optimizer/issues>
+
+## License
+
+Apache-2.0. Not affiliated with Google, Yandex or Microsoft; provider data belongs to the property
+owner and is never resold.

package/bin/lv24-seo.js

@@ -0,0 +1,74 @@
+#!/usr/bin/env node
+/**
+ * Thin launcher for the Python package `lv24-seo`.
+ *
+ * `npx @lv24/seo …` is a convenience entry point, not a second implementation: it forwards every
+ * argument to `uvx --from lv24-seo lv24-seo …` (or to an already installed `lv24-seo` binary).
+ * Exit code, stdout and stderr are passed through unchanged so agents can rely on `--json` and the
+ * documented exit codes.
+ */
+'use strict';
+
+const { spawn } = require('node:child_process');
+
+const PACKAGE = 'lv24-seo';
+const args = process.argv.slice(2);
+
+function candidates() {
+  const override = process.env.LV24_SEO_BIN;
+  if (override) {
+    return [{ command: override, prefix: [] }];
+  }
+  return [
+    { command: 'uvx', prefix: ['--from', PACKAGE, PACKAGE] },
+    { command: PACKAGE, prefix: [] },
+  ];
+}
+
+function hint() {
+  return [
+    'lv24-seo needs uv (recommended) or an installed lv24-seo binary.',
+    '',
+    '  Install uv:     https://docs.astral.sh/uv/getting-started/installation/',
+    '  Or install the CLI directly:',
+    '                  pipx install lv24-seo   (or: uv tool install lv24-seo)',
+    '',
+    'Set LV24_SEO_BIN=/absolute/path/to/lv24-seo to bypass auto-detection.',
+  ].join('\n');
+}
+
+function run(list, index) {
+  if (index >= list.length) {
+    process.stderr.write(hint() + '\n');
+    process.exit(127);
+  }
+
+  const current = list[index];
+  const child = spawn(current.command, [...current.prefix, ...args], {
+    stdio: 'inherit',
+    env: process.env,
+    shell: false,
+  });
+
+  let started = false;
+  child.on('spawn', () => {
+    started = true;
+  });
+  child.on('error', (error) => {
+    if (!started && error && error.code === 'ENOENT') {
+      run(list, index + 1);
+      return;
+    }
+    process.stderr.write(`lv24-seo launcher: ${error.message}\n`);
+    process.exit(1);
+  });
+  child.on('exit', (code, signal) => {
+    if (signal) {
+      process.kill(process.pid, signal);
+      return;
+    }
+    process.exit(code === null ? 1 : code);
+  });
+}
+
+run(candidates(), 0);

package/package.json

@@ -1,6 +1,42 @@
 {
   "name": "@lv24/seo",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Free-first SEO control plane for humans and AI agents — npx launcher for the Python package lv24-seo (GSC, Yandex Webmaster/Metrika, Bing, CrUX, PSI, crawl, reports, MCP).",
+  "keywords": [
+    "seo",
+    "mcp",
+    "model-context-protocol",
+    "google-search-console",
+    "yandex-webmaster",
+    "yandex-metrika",
+    "bing-webmaster",
+    "indexnow",
+    "core-web-vitals",
+    "ai-agents",
+    "cli"
+  ],
+  "homepage": "https://github.com/LevapVeeskela/lv24-seo-optimizer",
+  "bugs": {
+    "url": "https://github.com/LevapVeeskela/lv24-seo-optimizer/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/LevapVeeskela/lv24-seo-optimizer.git",
+    "directory": "packages/npm"
+  },
+  "license": "Apache-2.0",
+  "author": "LV24 <paulalexeev10@gmail.com>",
+  "bin": {
+    "lv24-seo": "bin/lv24-seo.js"
+  },
+  "files": [
+    "bin/lv24-seo.js",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}