mcp-scraper 0.2.18 → 0.2.19

package/README.md

@@ -10,19 +10,25 @@ MCP Scraper ships three local stdio entrypoints plus human-facing helper CLIs:
 
 - `mcp-scraper` — live web intelligence, SERP, PAA, site extraction, YouTube, Facebook ads and organic video transcripts, Maps, directory, rank tracker blueprint, and credit tools.
 - `browser-agent` — an agent-controlled live cloud browser with screenshots, clicks, typing, scrolling, live watch URLs, replay links, and MP4 replay download.
-- `mcp-scraper-combined` — one local MCP server that exposes both tool sets. This is the entrypoint used by the MCPB Desktop Extension.
-- `mcp-scraper-install` — a human-facing terminal installer card with the branded ASCII intro and copyable install commands. This command is safe to print because it is not an MCP stdio server.
+- `mcp-scraper-combined` — one context-aware command. In a human terminal it prints the branded ASCII install card; in an MCP client it runs the combined stdio server with both tool sets. This is the entrypoint used by the MCPB Desktop Extension.
+- `mcp-scraper-install` — explicit alias for the human-facing terminal installer card with the branded ASCII intro and copyable install commands.
 - `mcp-scraper-cli` — a human-facing CLI for setup checks, AI-agent config generation, workflow prompts, local SEO workflow runs, and local HTML reports. This command is safe to print because it is not an MCP stdio server.
 
 ### Terminal installer
 
-Run this when you want the designed terminal install experience:
+Run the combined command when you want the designed terminal install experience:
 
 ```bash
-npx -y -p mcp-scraper@latest mcp-scraper-install
+npx -y -p mcp-scraper@latest mcp-scraper-combined
 ```
 
-It prints the MCP Scraper banner, loaded tool groups, Desktop Extension download, Claude Code command, and Codex config. This is the command to use when you want the ASCII terminal card. The MCP server commands, including `mcp-scraper-combined`, stay silent so stdout remains valid JSON-RPC for MCP clients.
+In a human terminal, it prints the MCP Scraper banner, loaded tool groups, Desktop Extension download, Claude Code command, and Codex config. When launched by an MCP client, the same command detects non-interactive stdio and writes only valid JSON-RPC to stdout.
+
+The explicit installer alias still works:
+
+```bash
+npx -y -p mcp-scraper@latest mcp-scraper-install
+```
 
 ### Human CLI
 
@@ -81,7 +87,7 @@ Build the branded one-click bundle:
 npm run build:mcpb
 ```
 
-The generated bundle is written to `build/mcpb/mcp-scraper-<version>.mcpb` and copied to `public/downloads/` for the hosted download. The current public bundle is `https://mcpscraper.dev/downloads/mcp-scraper.mcpb` (`0.2.18`, SHA-256 `3b94a39bf23712005a1a04accdefcf3ee24978995033b92e4488390d47350ea0`). Install it by opening or dragging it into Claude Desktop. Claude displays the `MCP Scraper` install card, icon, and API-key configuration field from the bundle manifest.
+The generated bundle is written to `build/mcpb/mcp-scraper-<version>.mcpb` and copied to `public/downloads/` for the hosted download. The current public bundle is `https://mcpscraper.dev/downloads/mcp-scraper.mcpb` (`0.2.19`, SHA-256 `b324b7bb2a0dca06978d436da0f69a16ad8b40e91cdc76e19547de2b078b66d3`). Install it by opening or dragging it into Claude Desktop. Claude displays the `MCP Scraper` install card, icon, and API-key configuration field from the bundle manifest.
 
 The MCPB install exposes the same web-intelligence tools as `mcp-scraper` plus all `browser_*` tools from `browser-agent` through one server.
 
@@ -223,7 +229,7 @@ Recommended config for update-friendly installs:
 npx -y -p mcp-scraper@latest mcp-scraper-combined
 ```
 
-This is an MCP stdio server command, not a human-facing terminal UI. If you run it directly, it appears to hang because it is waiting for JSON-RPC input from the MCP client. Use `npx -y -p mcp-scraper@latest mcp-scraper-install` when you want the visible installer and ASCII card.
+This is context-aware: in a normal terminal it prints the visible installer and ASCII card; in an MCP client it runs as the silent stdio server. Use `--stdio` or `MCP_SCRAPER_FORCE_STDIO=1` if you need to force server mode from a terminal.
 
 Split-server config:
 
@@ -243,7 +249,7 @@ Users who do not update can keep using the tools their local package already adv
 
 ## Branded One-Click Installs
 
-Raw `npx` MCP server installs are command/config based. They do not provide a reliable user-facing install card, logo, or setup screen inside MCP clients. Use `mcp-scraper-install` for terminal onboarding text and the ASCII card. Do not print marketing text to stdout from an MCP server; stdout is reserved for JSON-RPC protocol messages.
+Raw `npx` MCP server installs are command/config based. `mcp-scraper-combined` is context-aware: terminal TTY prints onboarding text and the ASCII card; MCP-client stdio pipes stay protocol-clean. Do not print marketing text to stdout from an active MCP stdio session; stdout is reserved for JSON-RPC protocol messages.
 
 For a branded Claude Desktop install, package MCP Scraper as an MCPB Desktop Extension. The repository now builds one combined MCPB bundle with a generated icon, `manifest.json`, bundled runtime dependencies, and `user_config` fields for API-key setup, API URL, and output folder.
 

package/dist/bin/api-server.cjs

@@ -20433,7 +20433,7 @@ var PACKAGE_VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    PACKAGE_VERSION = "0.2.18";
+    PACKAGE_VERSION = "0.2.19";
   }
 });