@aiquants/html-to-markdown 0.3.0 → 0.5.0

package/dist/{version-BF9-U8Ef.js → version-CTdrYd1G.js}

@@ -5,7 +5,7 @@ Object.assign(global, {
   window,
   self: window
 });
-import { b as getDefaultExportFromCjs } from "./core-CouDTni-.js";
+import { b as getDefaultExportFromCjs } from "./core-DJV8t_Qj.js";
 import { promises } from "fs";
 import { resolve, dirname } from "path";
 import { readFileSync } from "node:fs";
@@ -11297,7 +11297,7 @@ function parseHtmlToMarkdownArgs(args) {
     throw new Error("Arguments are required");
   }
   const { url, html_content, locale = "en-US" } = args;
-  if (!url && !html_content) {
+  if (!(url || html_content)) {
     throw new Error("Either 'url' or 'html_content' is required");
   }
   if (url && typeof url !== "string") {
@@ -11323,7 +11323,7 @@ function parseSaveContentArgs(args) {
   if (!content || typeof content !== "string") {
     throw new Error("'content' is required and must be a string");
   }
-  if (!save_path && !save_directory) {
+  if (!(save_path || save_directory)) {
     throw new Error("Either 'save_path' or 'save_directory' is required");
   }
   if (save_path && typeof save_path !== "string") {
@@ -11345,6 +11345,47 @@ function parseSaveContentArgs(args) {
     filename
   };
 }
+function parseUrlToMarkdownFileArgs(args) {
+  if (!args || typeof args !== "object") {
+    throw new Error("Arguments are required");
+  }
+  const { url, html_content, locale = "en-US", save_path, save_directory, filename } = args;
+  if (!(url || html_content)) {
+    throw new Error("Either 'url' or 'html_content' is required");
+  }
+  if (url && typeof url !== "string") {
+    throw new Error("'url' must be a string");
+  }
+  if (html_content && typeof html_content !== "string") {
+    throw new Error("'html_content' must be a string");
+  }
+  if (locale && !["en-US", "ja-JP"].includes(locale)) {
+    throw new Error("'locale' must be 'en-US' or 'ja-JP'");
+  }
+  if (!(save_path || save_directory)) {
+    throw new Error("Either 'save_path' or 'save_directory' is required");
+  }
+  if (save_path && typeof save_path !== "string") {
+    throw new Error("'save_path' must be a string");
+  }
+  if (save_directory && typeof save_directory !== "string") {
+    throw new Error("'save_directory' must be a string");
+  }
+  if (filename && typeof filename !== "string") {
+    throw new Error("'filename' must be a string");
+  }
+  if (save_path && save_directory) {
+    throw new Error("Cannot specify both 'save_path' and 'save_directory'");
+  }
+  return {
+    url,
+    html_content,
+    locale,
+    save_path,
+    save_directory,
+    filename
+  };
+}
 function generateFilename(url) {
   return "page";
 }
@@ -11406,6 +11447,38 @@ const MCP_TOOL_SCHEMAS = {
     },
     required: ["content"],
     anyOf: [{ required: ["save_path"] }, { required: ["save_directory"] }]
+  },
+  urlToMarkdownFile: {
+    type: "object",
+    properties: {
+      url: {
+        type: "string",
+        description: "URL of the web page to convert and save as Markdown file (e.g., https://example.com). Handles JavaScript-rendered dynamic content effectively."
+      },
+      html_content: {
+        type: "string",
+        description: "HTML string to convert directly and save as Markdown file. Use instead of URL for local files or API response HTML content."
+      },
+      locale: {
+        type: "string",
+        description: "Browser locale setting. Use 'ja-JP' for Japanese sites, 'en-US' for English sites. Affects content rendering and language detection.",
+        enum: ["en-US", "ja-JP"],
+        default: "en-US"
+      },
+      save_path: {
+        type: "string",
+        description: "Complete file path including filename to save the converted Markdown content (e.g., '/home/user/output.md'). Cannot be used with save_directory."
+      },
+      save_directory: {
+        type: "string",
+        description: "Directory path to save the converted Markdown content with auto-generated filename (e.g., '/home/user/downloads'). Cannot be used with save_path."
+      },
+      filename: {
+        type: "string",
+        description: "Base filename to use when save_directory is specified (e.g., 'my-document'). Extension .md will be added automatically."
+      }
+    },
+    anyOf: [{ required: ["url", "save_path"] }, { required: ["url", "save_directory"] }, { required: ["html_content", "save_path"] }, { required: ["html_content", "save_directory"] }]
   }
 };
 function createErrorResult(error) {
@@ -11454,12 +11527,13 @@ export {
   createErrorResult as a,
   parseSaveContentArgs as b,
   createSuccessResult as c,
-  isJSONRPCRequest as d,
-  SUPPORTED_PROTOCOL_VERSIONS as e,
-  isJSONRPCResponse as f,
+  parseUrlToMarkdownFileArgs as d,
+  isJSONRPCRequest as e,
+  SUPPORTED_PROTOCOL_VERSIONS as f,
   getPackageVersion as g,
-  isJSONRPCError as h,
+  isJSONRPCResponse as h,
   isInitializeRequest as i,
+  isJSONRPCError as j,
   parseHtmlToMarkdownArgs as p,
   saveContentToFile as s
 };

package/mcp.json

@@ -3,12 +3,12 @@
     "html-to-markdown": {
       "command": "npx",
       "args": ["@aiquants/html-to-markdown", "aiq-html2md-mcp"],
-      "description": "Convert web pages and HTML to Markdown with JavaScript dynamic content support, table structure preservation, and file saving."
+      "description": "Convert web pages and HTML to Markdown with JavaScript dynamic content support, table structure preservation, and file saving. Includes integrated URL-to-file conversion tool."
     },
     "html-to-markdown-streamable": {
       "command": "npx",
       "args": ["@aiquants/html-to-markdown", "aiq-html2md-mcp-stream"],
-      "description": "HTML to Markdown converter with real-time progress updates and file saving support. Ideal for large pages and time-consuming conversions with JavaScript dynamic content support."
+      "description": "HTML to Markdown converter with real-time progress updates and file saving support. Ideal for large pages and time-consuming conversions with JavaScript dynamic content support. Includes streamable URL-to-file conversion tool."
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiquants/html-to-markdown",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "HTML to Markdown converter",
   "type": "module",
   "main": "./dist/index.js",