@aiquants/html-to-markdown 0.1.5 → 0.1.7

package/README.md

@@ -1,6 +1,6 @@
 # @aiquants/html-to-markdown
 
-A tool to dynamically fetch a web page from a given URL and convert it to Markdown. <!-- Now with Model Context Protocol (MCP) server support! -->
+A tool to dynamically fetch a web page from a given URL and convert it to Markdown. Now with Model Context Protocol (MCP) server support!
 
 This tool fetches the fully rendered HTML after JavaScript execution and converts it to Markdown. It supports complex pages, including footnotes and table structures.
 
@@ -10,9 +10,9 @@ This tool fetches the fully rendered HTML after JavaScript execution and convert
 - **High-Fidelity Conversion**: Performs powerful AST (Abstract Syntax Tree)-based conversion using `rehype` and `remark`.
 - **Preserves Table Content**: Retains HTML tags within table cells (`<td>`, `<th>`) as much as possible to maintain rich formatting.
 - **Link Normalization**: Automatically converts relative links on the page to absolute links to prevent broken links.
-- **Multiple Interfaces**: Usable as a Node.js library and command-line tool. <!-- and MCP server. -->
-<!-- - **MCP Server Support**: Provides Model Context Protocol server functionality for AI assistants. -->
-<!-- - **Streamable MCP Support**: Supports streamable MCP protocols for real-time progress updates. -->
+- **Multiple Interfaces**: Usable as a Node.js library, command-line tool, and MCP server.
+- **MCP Server Support**: Provides Model Context Protocol server functionality for AI assistants.
+- **Streamable MCP Support**: Supports streamable MCP protocols for real-time progress updates.
 
 ## Installation
 
@@ -75,7 +75,7 @@ async function main() {
 main();
 ```
 
-<!-- ### As an MCP Server
+### As an MCP Server
 
 This package can be used as a Model Context Protocol (MCP) server, allowing AI assistants and MCP-compatible applications to convert web pages to Markdown.
 
@@ -88,14 +88,15 @@ This package can be used as a Model Context Protocol (MCP) server, allowing AI a
   "html-to-md": {
     "command": "npx",
     "args": [
-      "@aiquants/html-to-markdown",
-      "mcp"
+      "--package=@aiquants/html-to-markdown",
+      "aiq-html2md-mcp"
     ],
     "type": "stdio"
   },
   "html-to-md-streamable": {
     "url": "http://127.0.0.1:4001/mcp",
-    "type": "http"
+    "type": "http",
+    "_comment": "Note: You need to start the streamable MCP server separately using 'npx --package=@aiquants/html-to-markdown aiq-html2md-mcp-stream'"
   }
 }
 ```
@@ -107,7 +108,7 @@ This package can be used as a Model Context Protocol (MCP) server, allowing AI a
   "mcpServers": {
     "html-to-markdown": {
       "command": "npx",
-      "args": ["@aiquants/html-to-markdown", "mcp"],
+      "args": ["--package=@aiquants/html-to-markdown", "aiq-html2md-mcp"],
       "description": "Convert HTML content from URLs to Markdown format"
     }
   }
@@ -119,14 +120,14 @@ This package can be used as a Model Context Protocol (MCP) server, allowing AI a
 ```bash
 # Start the streamable MCP server (requires global installation)
 npm install -g @aiquants/html-to-markdown
-html-to-markdown-mcp-streamable
+aiq-html2md-mcp-stream
 ```
 
 Alternatively, you can use npx to run without global installation:
 
 ```bash
 # Using npx with the streamable server binary
-npx @aiquants/html-to-markdown html-to-markdown-mcp-streamable
+npx --package=@aiquants/html-to-markdown aiq-html2md-mcp-stream
 ```
 
 #### MCP Tools Available
@@ -151,7 +152,6 @@ await mcpServer.start(8000);  // Port 8000
 const streamableMcpServer = createStreamableMcpServer();
 await streamableMcpServer.start(8000);  // Port 8000
 ```
--->
 
 ## API
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiquants/html-to-markdown",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "HTML to Markdown converter",
   "type": "module",
   "main": "./dist/index.js",
@@ -13,9 +13,9 @@
     }
   },
   "bin": {
-    "html-to-markdown": "./dist/main.js",
-    "html-to-markdown-mcp": "./dist/mcp.js",
-    "html-to-markdown-mcp-streamable": "./dist/mcp-streamable.js"
+    "aiq-html2md": "./dist/main.js",
+    "aiq-html2md-mcp": "./dist/mcp.js",
+    "aiq-html2md-mcp-stream": "./dist/mcp-streamable.js"
   },
   "files": [
     "dist",
@@ -29,6 +29,7 @@
     "debug": "NODE_OPTIONS='--enable-source-maps' vite-node --inspect-brk=9229 main.ts --",
     "start": "vite-node main.ts",
     "build": "vite build",
+    "prepublishOnly": "npm run build",
     "lint": "biome lint app/",
     "format": "biome format --write",
     "check": "biome check --fix src/",