@aiquants/html-to-markdown 0.3.0 → 0.5.0

package/dist/mcp-streamable.cjs

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-"use strict";require("./mcp-server-streamable-mF26pg3E.cjs").runStreamableMcpServer().catch(e=>{process.exit(1)});
+"use strict";require("./mcp-server-streamable-IQlimU2H.cjs").runStreamableMcpServer().catch(e=>{process.exit(1)});

package/dist/mcp-streamable.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { r as runStreamableMcpServer } from "./mcp-server-streamable-CVDJHcWu.js";
+import { r as runStreamableMcpServer } from "./mcp-server-streamable-DODolSbj.js";
 runStreamableMcpServer().catch((error) => {
   console.error("Failed to start streamable MCP server:", error);
   process.exit(1);

package/dist/mcp.cjs

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-const e=new(require("happy-dom").Window);Object.assign(global,{document:e.document,window:e,self:e});require("./mcp-server-CCu0Pcm3.cjs").runMcpServer().catch(e=>{process.exit(1)});
+const e=new(require("happy-dom").Window);Object.assign(global,{document:e.document,window:e,self:e});require("./mcp-server-CMBUHOmc.cjs").runMcpServer().catch(e=>{process.exit(1)});

package/dist/mcp.js

@@ -6,7 +6,7 @@ Object.assign(global, {
   window,
   self: window
 });
-import { r as runMcpServer } from "./mcp-server-BAmy7d8r.js";
+import { r as runMcpServer } from "./mcp-server-DD8CqdNw.js";
 runMcpServer().catch((error) => {
   console.error("Failed to start MCP server:", error);
   process.exit(1);

package/dist/src/index.d.ts

@@ -4,6 +4,6 @@
  */
 export { htmlToMarkdown } from './core.ts';
 export { getMessage } from './i18n.ts';
-export type { HtmlToMarkdownOptions } from './types.ts';
 export { createMcpServer, runMcpServer } from './mcp-server.ts';
 export { createStreamableMcpServer, runStreamableMcpServer } from './mcp-server-streamable.ts';
+export type { HtmlToMarkdownOptions } from './types.ts';

package/dist/src/mcp-common.d.ts

@@ -18,6 +18,18 @@ export interface SaveContentArgs {
     save_directory?: string;
     filename?: string;
 }
+/**
+ * Arguments for URL to Markdown file conversion tool.
+ * URL から Markdown ファイルへの変換ツールの引数
+ */
+export interface UrlToMarkdownFileArgs {
+    url?: string;
+    html_content?: string;
+    locale?: "en-US" | "ja-JP";
+    save_path?: string;
+    save_directory?: string;
+    filename?: string;
+}
 /**
  * Validate and parse arguments for HTML to Markdown conversion.
  * HTML から Markdown への変換の引数を検証・解析
@@ -28,6 +40,11 @@ export declare function parseHtmlToMarkdownArgs(args: HtmlToMarkdownArgs | undef
  * コンテンツ保存の引数を検証・解析
  */
 export declare function parseSaveContentArgs(args: SaveContentArgs | undefined): SaveContentArgs;
+/**
+ * Validate and parse arguments for URL to Markdown file conversion.
+ * URL から Markdown ファイルへの変換の引数を検証・解析
+ */
+export declare function parseUrlToMarkdownFileArgs(args: UrlToMarkdownFileArgs | undefined): UrlToMarkdownFileArgs;
 /**
  * Generate filename from URL or use default.
  * URL からファイル名を生成または既定値を使用
@@ -94,6 +111,46 @@ export declare const MCP_TOOL_SCHEMAS: {
             readonly required: readonly ["save_directory"];
         }];
     };
+    urlToMarkdownFile: {
+        readonly type: "object";
+        readonly properties: {
+            readonly url: {
+                readonly type: "string";
+                readonly description: "URL of the web page to convert and save as Markdown file (e.g., https://example.com). Handles JavaScript-rendered dynamic content effectively.";
+            };
+            readonly html_content: {
+                readonly type: "string";
+                readonly description: "HTML string to convert directly and save as Markdown file. Use instead of URL for local files or API response HTML content.";
+            };
+            readonly locale: {
+                readonly type: "string";
+                readonly description: "Browser locale setting. Use 'ja-JP' for Japanese sites, 'en-US' for English sites. Affects content rendering and language detection.";
+                readonly enum: readonly ["en-US", "ja-JP"];
+                readonly default: "en-US";
+            };
+            readonly save_path: {
+                readonly type: "string";
+                readonly description: "Complete file path including filename to save the converted Markdown content (e.g., '/home/user/output.md'). Cannot be used with save_directory.";
+            };
+            readonly save_directory: {
+                readonly type: "string";
+                readonly description: "Directory path to save the converted Markdown content with auto-generated filename (e.g., '/home/user/downloads'). Cannot be used with save_path.";
+            };
+            readonly filename: {
+                readonly type: "string";
+                readonly description: "Base filename to use when save_directory is specified (e.g., 'my-document'). Extension .md will be added automatically.";
+            };
+        };
+        readonly anyOf: readonly [{
+            readonly required: readonly ["url", "save_path"];
+        }, {
+            readonly required: readonly ["url", "save_directory"];
+        }, {
+            readonly required: readonly ["html_content", "save_path"];
+        }, {
+            readonly required: readonly ["html_content", "save_directory"];
+        }];
+    };
 };
 /**
  * Common error handling utility for MCP tools.

package/dist/src/mcp-server-streamable.d.ts

@@ -1,6 +1,6 @@
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { CallToolResult, Progress, Tool } from '@modelcontextprotocol/sdk/types.js';
-import { HtmlToMarkdownArgs, SaveContentArgs } from './mcp-common.ts';
+import { HtmlToMarkdownArgs, SaveContentArgs, UrlToMarkdownFileArgs } from './mcp-common.ts';
 /**
  * The context for a tool call.
  * ツール呼び出しのコンテキスト
@@ -13,7 +13,7 @@ export type ToolContext<T = unknown> = {
  * ハンドラー関数を含む拡張 Tool インターフェース
  */
 interface ExtendedTool extends Tool {
-    handler: (args: HtmlToMarkdownArgs | SaveContentArgs, context: ToolContext<HtmlToMarkdownArgs | SaveContentArgs>) => AsyncGenerator<Progress | {
+    handler: (args: HtmlToMarkdownArgs | SaveContentArgs | UrlToMarkdownFileArgs, context: ToolContext<HtmlToMarkdownArgs | SaveContentArgs | UrlToMarkdownFileArgs>) => AsyncGenerator<Progress | {
         type: "result";
         result: CallToolResult;
     }>;
@@ -54,6 +54,19 @@ export declare class StreamableHtmlToMarkdownMcpServer {
         type: "result";
         result: CallToolResult;
     }>;
+    /**
+     * Handle URL to Markdown file conversion tool call with streamable support.
+     * streamable サポート付きの URL から Markdown ファイルへの変換ツール呼び出しを処理
+     */
+    handleUrlToMarkdownFile(args: UrlToMarkdownFileArgs, _context: ToolContext<UrlToMarkdownFileArgs>): AsyncGenerator<Progress | {
+        type: "result";
+        result: CallToolResult;
+    }>;
+    /**
+     * Generate filename from URL.
+     * URL からファイル名を生成
+     */
+    private generateFilenameFromUrl;
     /**
      * Start the streamable MCP server.
      * streamable MCP サーバーを開始

package/dist/src/mcp-server.d.ts

@@ -1,6 +1,6 @@
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-import { HtmlToMarkdownArgs, SaveContentArgs } from './mcp-common.ts';
-export { type HtmlToMarkdownArgs, type SaveContentArgs, parseHtmlToMarkdownArgs, parseSaveContentArgs, saveContentToFile, createErrorResult, createSuccessResult, MCP_TOOL_SCHEMAS, } from './mcp-common.ts';
+import { HtmlToMarkdownArgs, SaveContentArgs, UrlToMarkdownFileArgs } from './mcp-common.ts';
+export { createErrorResult, createSuccessResult, type HtmlToMarkdownArgs, MCP_TOOL_SCHEMAS, parseHtmlToMarkdownArgs, parseSaveContentArgs, parseUrlToMarkdownFileArgs, type SaveContentArgs, saveContentToFile, type UrlToMarkdownFileArgs, } from './mcp-common.ts';
 /**
  * MCP Server for HTML to Markdown conversion.
  * HTML から Markdown への変換を行う MCP サーバー
@@ -158,6 +158,83 @@ export declare class HtmlToMarkdownMcpServer {
         } | undefined;
         isError?: boolean | undefined;
     }>;
+    /**
+     * Handle URL to Markdown file conversion tool call.
+     * URL から Markdown ファイルへの変換ツール呼び出しを処理
+     */
+    handleUrlToMarkdownFile(args: UrlToMarkdownFileArgs | undefined): Promise<{
+        [x: string]: unknown;
+        content: ({
+            [x: string]: unknown;
+            text: string;
+            type: "text";
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "image";
+            data: string;
+            mimeType: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "audio";
+            data: string;
+            mimeType: string;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "resource_link";
+            name: string;
+            uri: string;
+            title?: string | undefined;
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+            mimeType?: string | undefined;
+            description?: string | undefined;
+        } | {
+            [x: string]: unknown;
+            type: "resource";
+            resource: {
+                [x: string]: unknown;
+                text: string;
+                uri: string;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+                mimeType?: string | undefined;
+            } | {
+                [x: string]: unknown;
+                uri: string;
+                blob: string;
+                _meta?: {
+                    [x: string]: unknown;
+                } | undefined;
+                mimeType?: string | undefined;
+            };
+            _meta?: {
+                [x: string]: unknown;
+            } | undefined;
+        })[];
+        _meta?: {
+            [x: string]: unknown;
+        } | undefined;
+        structuredContent?: {
+            [x: string]: unknown;
+        } | undefined;
+        isError?: boolean | undefined;
+    }>;
+    /**
+     * Generate filename from URL.
+     * URL からファイル名を生成
+     */
+    private generateFilenameFromUrl;
     /**
      * Start the MCP server.
      * MCP サーバーを開始

package/dist/src/types.d.ts

@@ -20,16 +20,16 @@ export interface HtmlToMarkdownOptions {
      */
     htmlContent?: string;
 }
-/**
- * Message keys for i18n.
- * i18n 用のメッセージキー
- */
-export type MessageKey = "error_url_required" | "usage" | "example" | "cli_start" | "cli_url" | "cli_locale" | "cli_output" | "success_save" | "success_path" | "error_app" | "playwright_launch" | "playwright_goto" | "playwright_get_content" | "playwright_close" | "playwright_error" | "convert_start" | "convert_success" | "url_parse_error";
 /**
  * Supported locales.
  * サポートされているロケール
  */
-export type SupportedLocale = "ja-JP" | "en-US";
+export type SupportedLocale = "en-US" | "ja-JP";
+/**
+ * Message keys for i18n.
+ * i18n 用のメッセージキー
+ */
+export type MessageKey = "error_url_required" | "error_url_or_html_required" | "usage" | "example" | "cli_start" | "cli_url" | "cli_html_content" | "cli_locale" | "cli_output" | "success_save" | "success_path" | "error_app" | "playwright_launch" | "playwright_goto" | "playwright_get_content" | "playwright_close" | "playwright_error" | "convert_start" | "convert_success" | "url_parse_error";
 /**
  * The following types are based on the type definitions of `hast-util-to-mdast`.
  * `hast-util-to-mdast` の型定義に基づいた型。