mcp-scraper 0.57.2 → 0.57.3

package/CHANGELOG.md

@@ -4,6 +4,14 @@ All notable changes to MCP Scraper are documented here. The format is based on [
 
 ## [Unreleased]
 
+## [0.57.3] - 2026-08-16
+
+### Fixed
+
+- Local Sourcebook exact-place matching no longer rejects a Google listing that appends a service tagline to the business name. `nameOverlap` divided the intersection by the larger token set, so "Meljestic Spa" against "Meljestic Spa: Laser hair removal and Skincare" scored 0.33 against a 0.6 threshold and could never publish — even though the submitted name is fully contained in the Google name and Maps linked the same domain. Identity now also accepts containment of the smaller token set (which must carry two distinctive tokens) or a Maps listing that links the submitted domain. Wrong domain, wrong state, missing address, and single-generic-token still reject.
+- `acquisition_error` is now returned as `acquisitionError` on the submission. It was written on every failure and never selected back, so no response explained why a listing failed.
+- `local_sourcebook_submission_status` and `local_sourcebook_refresh` now state what a failed status means, that coverage counters are only written on success (so zeroed counters do not mean the crawl never ran), and that a replayed refresh still re-runs acquisition.
+
 ## [0.57.2] - 2026-08-16
 
 ### Fixed

package/README.md

@@ -90,7 +90,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.57.2`, SHA-256 `1c7ae1f1acf54fc91bc44a8dae29b1da20542a63b168f496ae91a67be9caaf33`). 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.57.3`, SHA-256 `b1edddd21790e7e5f24bacad85d992d8e995199c5d7e1d314500ba0abaab117c`). 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 every tool — web-intelligence plus all `browser_*` tools — through the one `mcp-scraper` server.
 

package/dist/bin/api-server.cjs

@@ -29050,6 +29050,7 @@ function mapSubmission(row) {
     businessName: String(rowValue(row, "business_name")),
     websiteUrl: String(rowValue(row, "website_url")),
     status: String(rowValue(row, "status")),
+    acquisitionError: rowValue(row, "acquisition_error") == null ? null : String(rowValue(row, "acquisition_error")),
     draftRevision: Number(rowValue(row, "draft_revision")),
     publishedRevision: rowValue(row, "published_revision") == null ? null : Number(rowValue(row, "published_revision")),
     coverage: parseJson2(rowValue(row, "coverage_json")),
@@ -30915,6 +30916,15 @@ function nameOverlap(left, right) {
   const intersection = [...a].filter((token6) => b.has(token6)).length;
   return intersection / Math.max(a.size, b.size);
 }
+function nameContainment(left, right) {
+  const a = tokens(left);
+  const b = tokens(right);
+  if (!a.size || !b.size) return 0;
+  const smaller = a.size <= b.size ? a : b;
+  if (smaller.size < 2) return 0;
+  const intersection = [...a].filter((token6) => b.has(token6)).length;
+  return intersection / smaller.size;
+}
 function validateLocalSourcebookMapsIdentity(submission, maps) {
   const expectedHost = host(submission.websiteUrl);
   const mapsHost = host(maps.website);
@@ -30924,7 +30934,9 @@ function validateLocalSourcebookMapsIdentity(submission, maps) {
   if (mapsHost && expectedHost && mapsHost !== expectedHost && !mapsHost.endsWith(`.${expectedHost}`) && !expectedHost.endsWith(`.${mapsHost}`)) {
     throw new Error(`Exact-place match rejected: Google Maps linked ${mapsHost}, not the submitted domain ${expectedHost}.`);
   }
-  if (overlap < 0.6) {
+  const containment = nameContainment(submission.businessName, actualName);
+  const domainConfirmsIdentity = Boolean(mapsHost && expectedHost);
+  if (overlap < 0.6 && containment < 0.9 && !domainConfirmsIdentity) {
     throw new Error(`Exact-place match rejected: Google Maps returned \u201C${actualName},\u201D which does not sufficiently match \u201C${submission.businessName}.\u201D`);
   }
   if (addressState && addressState !== submission.state.toLowerCase()) {
@@ -44638,7 +44650,7 @@ var PACKAGE_VERSION;
 var init_version = __esm({
   "src/version.ts"() {
     "use strict";
-    PACKAGE_VERSION = "0.57.2";
+    PACKAGE_VERSION = "0.57.3";
   }
 });
 
@@ -50647,14 +50659,14 @@ function registerPaaExtractorMcpTools(server, executor, options = {}) {
   }, async (input) => executor.localSourcebookCapture(input));
   server.registerTool("local_sourcebook_submission_status", {
     title: "Local Sourcebook Submission Status",
-    description: "Read the authenticated caller\u2019s listing draft, enrichment coverage, immutable revision number, publication state, and exact live LocalSourcebook.com profile and reviews URLs.",
+    description: "Read the authenticated caller\u2019s listing draft, enrichment coverage, immutable revision number, publication state, and exact live LocalSourcebook.com profile and reviews URLs. When status is failed, acquisitionError states why in plain language \u2014 read it before retrying, because a refresh repeats the same acquisition and will fail the same way until the cause is fixed. Coverage counters are written only when acquisition succeeds, so a failed listing still shows the pre-run crawl block; zeroed counters do not mean the crawl never ran.",
     inputSchema: LocalSourcebookSubmissionStatusInputSchema,
     outputSchema: recordOutputSchema("local_sourcebook_submission_status", LocalSourcebookOutputSchema),
     annotations: localPlanningToolAnnotations("Local Sourcebook Submission Status")
   }, async (input) => executor.localSourcebookSubmissionStatus(input));
   server.registerTool("local_sourcebook_refresh", {
     title: "Refresh a Local Sourcebook Listing",
-    description: "Queue a new broad crawl and review/media acquisition pass for a listing owned by the authenticated MCP Scraper account. A refresh costs 2 Credits total, including acquisition; idempotent retries are not charged twice. The last published revision remains public until the refreshed evidence revision completes and auto-publishes.",
+    description: "Queue a new broad crawl and review/media acquisition pass for a listing owned by the authenticated MCP Scraper account. A refresh costs 2 Credits total, including acquisition; idempotent retries are not charged twice, and a replayed retry still re-runs the acquisition, so a failed listing is always recoverable. Read local_sourcebook_submission_status first: a refresh repeats the same acquisition, so fix whatever acquisitionError reports before spending another pass. The last published revision remains public until the refreshed evidence revision completes and auto-publishes.",
     inputSchema: LocalSourcebookRefreshInputSchema,
     outputSchema: recordOutputSchema("local_sourcebook_refresh", LocalSourcebookOutputSchema),
     annotations: liveWebToolAnnotations("Refresh a Local Sourcebook Listing")