mcpscraper-cli 0.24.0 → 0.24.2

package/dist/bin/cli.js

@@ -9,7 +9,7 @@ import { join } from "path";
 import { ScraperClient, ScraperApiError } from "mcpscraper-sdk";
 
 // src/version.ts
-var CLI_VERSION = "0.24.0";
+var CLI_VERSION = "0.24.2";
 
 // src/generated-tools.ts
 var MCP_TOOL_CATALOG = [
@@ -2653,7 +2653,7 @@ var MCP_TOOL_CATALOG = [
     "name": "commons_submit_entity",
     "category": "commons",
     "title": "Transparent Commons Governed Entity Write",
-    "description": "Create or propose an edit to a Transparent Commons public wiki entity through the governed MCP Scraper write plane. This never edits rendered HTML directly. Normal workflow is commons_prepare_entity, compose, commons_validate_entity, then submit. Choose a precise entityType and write a neutral encyclopedia projection with the matching entity structure, not a blog article or raw scrape dump. Use H2 sections and H3/H4/H5 subitems; every heading appears in the public page menu. Omit unsupported sections instead of publishing empty/filler headings. It writes a proposal, records a contribution ledger entry when accepted, and auto-publishes only safe non-conflicting changes with a featured image and source/body evidence. Existing entity edits require baseRevision to auto-publish. Requires idempotencyKey.",
+    "description": "Create or propose an edit to a Transparent Commons public wiki entity through the governed MCP Scraper write plane. A new entity costs 10 Credits; an edit to an existing entity costs 2 Credits. Preparation and validation are free, and idempotent retries are not charged twice. This never edits rendered HTML directly. Normal workflow is commons_prepare_entity, compose, commons_validate_entity, then submit. Choose a precise entityType and write a neutral encyclopedia projection with the matching entity structure, not a blog article or raw scrape dump. Use H2 sections and H3/H4/H5 subitems; every heading appears in the public page menu. Omit unsupported sections instead of publishing empty/filler headings. It writes a proposal, records a contribution ledger entry when accepted, and auto-publishes only safe non-conflicting changes with a featured image and source/body evidence. Existing entity edits require baseRevision to auto-publish. Requires idempotencyKey.",
     "inputSchema": {
       "type": "object",
       "$schema": "https://json-schema.org/draft/2020-12/schema",
@@ -3550,7 +3550,7 @@ var MCP_TOOL_CATALOG = [
     "name": "get-local-sourcebook-contract",
     "category": "directory",
     "title": "Get Local Sourcebook Contract",
-    "description": "Read the governed listing purpose, supported categories, canonical profile/review routes, required sections, acquisition limits, tag policy, ownership boundary, and admin-only publication rule. Call this before composing a listing when its required shape is uncertain.",
+    "description": "Read the governed listing purpose, supported categories, accepted Schema.org LocalBusiness subtypes, exact LocalSourcebook.com profile/review URLs, nationwide directory URL, required sections, fixed 10-Credit creation and 2-Credit edit prices, acquisition limits, tag policy, ownership boundary, and automatic evidence-publication rule. Call this before composing a listing when its required shape is uncertain.",
     "inputSchema": {
       "type": "object",
       "$schema": "https://json-schema.org/draft/2020-12/schema",
@@ -3658,7 +3658,7 @@ var MCP_TOOL_CATALOG = [
     "name": "prepare-local-sourcebook-write",
     "category": "directory",
     "title": "Prepare Local Sourcebook Write",
-    "description": "Mandatory planning pass for a new listing. Returns the category contract, canonical profile and review routes, normalized identity, live tag resolutions, and exact next instructions. Inspect list-local-sourcebook-tags first, then validate the returned proposal before capture.",
+    "description": "Mandatory planning pass for a new listing. Returns the category contract, a category-appropriate Schema.org LocalBusiness subtype, canonical profile and review routes, normalized identity, live tag resolutions, and exact next instructions. Select a more specific accepted subtype when the business evidence supports it; callers cannot inject arbitrary JSON-LD. Inspect list-local-sourcebook-tags first, then validate the returned proposal before capture.",
     "inputSchema": {
       "type": "object",
       "$schema": "https://json-schema.org/draft/2020-12/schema",
@@ -3689,6 +3689,75 @@ var MCP_TOOL_CATALOG = [
           "type": "string",
           "format": "uri"
         },
+        "schemaOrgType": {
+          "description": "Optional Schema.org LocalBusiness subtype. Omit to receive the category default; use a more specific accepted subtype when the business evidence supports it.",
+          "type": "string",
+          "enum": [
+            "LocalBusiness",
+            "AnimalShelter",
+            "AutomotiveBusiness",
+            "AutoBodyShop",
+            "AutoDealer",
+            "AutoPartsStore",
+            "AutoRental",
+            "AutoRepair",
+            "AutoWash",
+            "GasStation",
+            "MotorcycleDealer",
+            "MotorcycleRepair",
+            "ChildCare",
+            "Dentist",
+            "DryCleaningOrLaundry",
+            "EmergencyService",
+            "EmploymentAgency",
+            "EntertainmentBusiness",
+            "FinancialService",
+            "AccountingService",
+            "AutomatedTeller",
+            "BankOrCreditUnion",
+            "InsuranceAgency",
+            "FoodEstablishment",
+            "Bakery",
+            "BarOrPub",
+            "Brewery",
+            "CafeOrCoffeeShop",
+            "Distillery",
+            "FastFoodRestaurant",
+            "IceCreamShop",
+            "Restaurant",
+            "Winery",
+            "HealthAndBeautyBusiness",
+            "BeautySalon",
+            "DaySpa",
+            "HairSalon",
+            "HealthClub",
+            "NailSalon",
+            "TattooParlor",
+            "HomeAndConstructionBusiness",
+            "Electrician",
+            "GeneralContractor",
+            "HVACBusiness",
+            "HousePainter",
+            "Locksmith",
+            "MovingCompany",
+            "Plumber",
+            "RoofingContractor",
+            "LegalService",
+            "Library",
+            "LodgingBusiness",
+            "MedicalBusiness",
+            "Pharmacy",
+            "Physician",
+            "RealEstateAgent",
+            "RecyclingCenter",
+            "SelfStorage",
+            "ShoppingCenter",
+            "SportsActivityLocation",
+            "Store",
+            "TouristInformationCenter",
+            "TravelAgency"
+          ]
+        },
         "slug": {
           "type": "string",
           "maxLength": 100,
@@ -3758,13 +3827,12 @@ var MCP_TOOL_CATALOG = [
     "name": "validate-local-sourcebook-write",
     "category": "directory",
     "title": "Validate Local Sourcebook Write",
-    "description": "Validate a proposed new listing or complete owner draft revision without writing it. Checks identity or listing completeness, canonical tags, tag decisions, and baseRevision requirements. Capture only when valid is true.",
+    "description": "Validate a proposed new listing identity without writing it. Checks business identity, canonical tags, and explicit tag decisions. Public facts are compiled from MCP Scraper evidence rather than accepted from the owner. Capture only when valid is true.",
     "inputSchema": {
       "type": "object",
       "$schema": "https://json-schema.org/draft/2020-12/schema",
       "properties": {
         "identity": {
-          "description": "New-listing identity returned by prepare-local-sourcebook-write.",
           "type": "object",
           "properties": {
             "category": {
@@ -3793,6 +3861,74 @@ var MCP_TOOL_CATALOG = [
               "type": "string",
               "format": "uri"
             },
+            "schemaOrgType": {
+              "type": "string",
+              "enum": [
+                "LocalBusiness",
+                "AnimalShelter",
+                "AutomotiveBusiness",
+                "AutoBodyShop",
+                "AutoDealer",
+                "AutoPartsStore",
+                "AutoRental",
+                "AutoRepair",
+                "AutoWash",
+                "GasStation",
+                "MotorcycleDealer",
+                "MotorcycleRepair",
+                "ChildCare",
+                "Dentist",
+                "DryCleaningOrLaundry",
+                "EmergencyService",
+                "EmploymentAgency",
+                "EntertainmentBusiness",
+                "FinancialService",
+                "AccountingService",
+                "AutomatedTeller",
+                "BankOrCreditUnion",
+                "InsuranceAgency",
+                "FoodEstablishment",
+                "Bakery",
+                "BarOrPub",
+                "Brewery",
+                "CafeOrCoffeeShop",
+                "Distillery",
+                "FastFoodRestaurant",
+                "IceCreamShop",
+                "Restaurant",
+                "Winery",
+                "HealthAndBeautyBusiness",
+                "BeautySalon",
+                "DaySpa",
+                "HairSalon",
+                "HealthClub",
+                "NailSalon",
+                "TattooParlor",
+                "HomeAndConstructionBusiness",
+                "Electrician",
+                "GeneralContractor",
+                "HVACBusiness",
+                "HousePainter",
+                "Locksmith",
+                "MovingCompany",
+                "Plumber",
+                "RoofingContractor",
+                "LegalService",
+                "Library",
+                "LodgingBusiness",
+                "MedicalBusiness",
+                "Pharmacy",
+                "Physician",
+                "RealEstateAgent",
+                "RecyclingCenter",
+                "SelfStorage",
+                "ShoppingCenter",
+                "SportsActivityLocation",
+                "Store",
+                "TouristInformationCenter",
+                "TravelAgency"
+              ]
+            },
             "slug": {
               "type": "string",
               "maxLength": 100,
@@ -3820,26 +3956,8 @@ var MCP_TOOL_CATALOG = [
             "businessName",
             "websiteUrl",
             "idempotencyKey"
-          ]
-        },
-        "listing": {
-          "description": "Complete replacement listing draft for an existing owner-scoped submission.",
-          "type": "object",
-          "propertyNames": {
-            "type": "string"
-          },
-          "additionalProperties": {}
-        },
-        "submissionId": {
-          "description": "Existing owner-scoped submission being revised. Omit for a new capture.",
-          "type": "string",
-          "minLength": 1
-        },
-        "baseRevision": {
-          "description": "Required current draft revision for an edit, preventing silent overwrites.",
-          "type": "integer",
-          "minimum": 1,
-          "maximum": 9007199254740991
+          ],
+          "description": "New-listing identity returned by prepare-local-sourcebook-write. Evidence-bearing public fields are compiled by MCP Scraper and cannot be supplied here."
         },
         "tagCandidates": {
           "maxItems": 20,
@@ -3904,7 +4022,10 @@ var MCP_TOOL_CATALOG = [
             ]
           }
         }
-      }
+      },
+      "required": [
+        "identity"
+      ]
     },
     "annotations": {
       "title": "Validate Local Sourcebook Write",
@@ -3918,13 +4039,12 @@ var MCP_TOOL_CATALOG = [
     "name": "local-sourcebook-capture",
     "category": "directory",
     "title": "Capture Governed Local Sourcebook Listing",
-    "description": "Strict owner-scoped write path after list, contract, prepare, and validate. A new capture registers canonical tags and queues paid website, exact-place, review, service-area, staff, and genuine-media acquisition. An edit requires the current baseRevision. Capture never publishes; admin review remains required.",
+    "description": "Strict owner-scoped LocalBusiness write path after list, contract, prepare, and validate. Creating a listing costs 10 Credits total, including website, exact-place, review, service-area, staff, genuine-media, and structured-data compilation; preparation and validation are free, and idempotent retries are not charged twice. Capture registers canonical tags and the accepted Schema.org LocalBusiness subtype, returns the exact LocalSourcebook.com profile and reviews URLs, and queues acquisition. MCP Scraper generates the final JSON-LD from source-backed evidence. A successful system-compiled evidence revision publishes automatically; owner-authored public claims and arbitrary JSON-LD are not accepted.",
     "inputSchema": {
       "type": "object",
       "$schema": "https://json-schema.org/draft/2020-12/schema",
       "properties": {
         "identity": {
-          "description": "New-listing identity returned by prepare-local-sourcebook-write.",
           "type": "object",
           "properties": {
             "category": {
@@ -3953,6 +4073,74 @@ var MCP_TOOL_CATALOG = [
               "type": "string",
               "format": "uri"
             },
+            "schemaOrgType": {
+              "type": "string",
+              "enum": [
+                "LocalBusiness",
+                "AnimalShelter",
+                "AutomotiveBusiness",
+                "AutoBodyShop",
+                "AutoDealer",
+                "AutoPartsStore",
+                "AutoRental",
+                "AutoRepair",
+                "AutoWash",
+                "GasStation",
+                "MotorcycleDealer",
+                "MotorcycleRepair",
+                "ChildCare",
+                "Dentist",
+                "DryCleaningOrLaundry",
+                "EmergencyService",
+                "EmploymentAgency",
+                "EntertainmentBusiness",
+                "FinancialService",
+                "AccountingService",
+                "AutomatedTeller",
+                "BankOrCreditUnion",
+                "InsuranceAgency",
+                "FoodEstablishment",
+                "Bakery",
+                "BarOrPub",
+                "Brewery",
+                "CafeOrCoffeeShop",
+                "Distillery",
+                "FastFoodRestaurant",
+                "IceCreamShop",
+                "Restaurant",
+                "Winery",
+                "HealthAndBeautyBusiness",
+                "BeautySalon",
+                "DaySpa",
+                "HairSalon",
+                "HealthClub",
+                "NailSalon",
+                "TattooParlor",
+                "HomeAndConstructionBusiness",
+                "Electrician",
+                "GeneralContractor",
+                "HVACBusiness",
+                "HousePainter",
+                "Locksmith",
+                "MovingCompany",
+                "Plumber",
+                "RoofingContractor",
+                "LegalService",
+                "Library",
+                "LodgingBusiness",
+                "MedicalBusiness",
+                "Pharmacy",
+                "Physician",
+                "RealEstateAgent",
+                "RecyclingCenter",
+                "SelfStorage",
+                "ShoppingCenter",
+                "SportsActivityLocation",
+                "Store",
+                "TouristInformationCenter",
+                "TravelAgency"
+              ]
+            },
             "slug": {
               "type": "string",
               "maxLength": 100,
@@ -3980,26 +4168,8 @@ var MCP_TOOL_CATALOG = [
             "businessName",
             "websiteUrl",
             "idempotencyKey"
-          ]
-        },
-        "listing": {
-          "description": "Complete replacement listing draft for an existing owner-scoped submission.",
-          "type": "object",
-          "propertyNames": {
-            "type": "string"
-          },
-          "additionalProperties": {}
-        },
-        "submissionId": {
-          "description": "Existing owner-scoped submission being revised. Omit for a new capture.",
-          "type": "string",
-          "minLength": 1
-        },
-        "baseRevision": {
-          "description": "Required current draft revision for an edit, preventing silent overwrites.",
-          "type": "integer",
-          "minimum": 1,
-          "maximum": 9007199254740991
+          ],
+          "description": "New-listing identity returned by prepare-local-sourcebook-write. Evidence-bearing public fields are compiled by MCP Scraper and cannot be supplied here."
         },
         "tagCandidates": {
           "maxItems": 20,
@@ -4065,12 +4235,15 @@ var MCP_TOOL_CATALOG = [
           }
         },
         "idempotencyKey": {
-          "description": "Stable retry key for a new capture. Required for new listings; omit only when revising an existing submissionId.",
+          "description": "Stable retry key for a new capture. Required either here or in identity.",
           "type": "string",
           "minLength": 8,
           "maxLength": 200
         }
-      }
+      },
+      "required": [
+        "identity"
+      ]
     },
     "annotations": {
       "title": "Capture Governed Local Sourcebook Listing",
@@ -4084,7 +4257,7 @@ var MCP_TOOL_CATALOG = [
     "name": "local_sourcebook_submission_status",
     "category": "directory",
     "title": "Local Sourcebook Submission Status",
-    "description": "Read the authenticated caller\u2019s listing draft, enrichment coverage, immutable revision number, and publication state.",
+    "description": "Read the authenticated caller\u2019s listing draft, enrichment coverage, immutable revision number, publication state, and exact live LocalSourcebook.com profile and reviews URLs.",
     "inputSchema": {
       "type": "object",
       "$schema": "https://json-schema.org/draft/2020-12/schema",
@@ -4111,7 +4284,7 @@ var MCP_TOOL_CATALOG = [
     "name": "local_sourcebook_refresh",
     "category": "directory",
     "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.",
+    "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.",
     "inputSchema": {
       "type": "object",
       "$schema": "https://json-schema.org/draft/2020-12/schema",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcpscraper-cli",
-  "version": "0.24.0",
+  "version": "0.24.2",
   "description": "Command-line interface for mcpscraper.dev and memory.mcpscraper.dev",
   "license": "MIT",
   "type": "module",
@@ -19,7 +19,7 @@
   },
   "dependencies": {
     "commander": "^12.0.0",
-    "mcpscraper-sdk": "^0.25.0"
+    "mcpscraper-sdk": "^0.25.2"
   },
   "devDependencies": {
     "@types/node": "^22.0.0"