magicmd 0.1.0

package/README.md

@@ -0,0 +1,35 @@
+# MagicMD npm Wrapper
+
+This package is a thin npm wrapper for the Python MagicMD CLI.
+
+It does not reimplement article parsing in JavaScript. It forwards commands to the PyPI package with:
+
+```bash
+uvx --from magicmd magicmd
+```
+
+## Requirements
+
+- Node.js 18+
+- `uv` available on `PATH`
+
+## Usage
+
+After the npm package is published:
+
+```bash
+npm install -g magicmd
+magicmd --version
+magicmd batch urls.txt -o output/
+```
+
+Until then, install MagicMD directly from PyPI:
+
+```bash
+uv tool install magicmd
+magicmd doctor
+```
+
+## Why This Wrapper Exists
+
+MagicMD's core implementation lives in Python so that the CLI, PyPI package, and Agent Skill use the same parsing and conversion code. The npm package is only an installation convenience for users who expect a global `magicmd` command from npm.

package/bin/magicmd.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+
+const { spawnSync } = require("node:child_process");
+
+const args = process.argv.slice(2);
+const command = process.platform === "win32" ? "uvx.cmd" : "uvx";
+// Equivalent command: uvx --from magicmd magicmd ...
+const result = spawnSync(command, ["--from", "magicmd", "magicmd", ...args], {
+  stdio: "inherit",
+});
+
+if (result.error) {
+  if (result.error.code === "ENOENT") {
+    console.error(
+      "MagicMD npm wrapper requires uv. Install it from https://docs.astral.sh/uv/getting-started/installation/ or use: pipx install magicmd"
+    );
+    process.exit(127);
+  }
+  console.error(result.error.message);
+  process.exit(1);
+}
+
+if (result.signal) {
+  process.kill(process.pid, result.signal);
+}
+
+process.exit(result.status ?? 1);

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "magicmd",
+  "version": "0.1.0",
+  "description": "npm wrapper for the MagicMD article-to-Markdown CLI.",
+  "license": "MIT",
+  "private": false,
+  "bin": {
+    "magicmd": "bin/magicmd.js"
+  },
+  "files": [
+    "bin/",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "markdown",
+    "article",
+    "wechat",
+    "juejin",
+    "crawler"
+  ],
+  "homepage": "https://github.com/didilili/MagicMD#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/didilili/MagicMD.git",
+    "directory": "npm/magicmd"
+  },
+  "bugs": {
+    "url": "https://github.com/didilili/MagicMD/issues"
+  }
+}