mcp-scraper 0.45.0 → 0.46.0

package/dist/bin/mcp-stdio-server.js

@@ -12,16 +12,16 @@ import {
   registerScheduledResultsMcpTools,
   registerSerpIntelligenceCaptureTools,
   resolveDeploymentProfile
-} from "../chunk-FQIICRR4.js";
+} from "../chunk-BP2IUIAH.js";
 import "../chunk-2K74LVV7.js";
 import "../chunk-BBI7RGOT.js";
 import "../chunk-T5AFM4G5.js";
 import {
   renderInstallTerminal
-} from "../chunk-GRODXRUY.js";
+} from "../chunk-QSUGPYGQ.js";
 import {
   PACKAGE_VERSION
-} from "../chunk-CEZ3NFBP.js";
+} from "../chunk-TQKQK7OV.js";
 import "../chunk-SOEYDWJU.js";
 import "../chunk-5UN33CGU.js";
 import "../chunk-5X7CJEK3.js";

package/dist/{chunk-FQIICRR4.js → chunk-BP2IUIAH.js}

@@ -21,7 +21,7 @@ import {
 } from "./chunk-T5AFM4G5.js";
 import {
   PACKAGE_VERSION
-} from "./chunk-CEZ3NFBP.js";
+} from "./chunk-TQKQK7OV.js";
 import {
   MC_PER_CREDIT
 } from "./chunk-SOEYDWJU.js";
@@ -385,6 +385,18 @@ seam is noted so you can chain them.
   Use saved filters when a person wants their MCP to operate inside a reading room, trail, source scope,
   category, tag bundle, media constraint, or other personalized subset of the shared Commons graph.
 
+## Transparent Commons user publications
+- A user-owned editorial publication is separate from the neutral public wiki. Start with
+  **commons_prepare_publication** to normalize the requested subdomain, check availability, and read the live
+  ownership contract. Then call **commons_validate_publication** with operation \`claim\` before
+  **commons_claim_publication**.
+- Each account may claim one stable name at \`https://{name}.transparent-commons.cc\`. Claims require an
+  idempotency key and never publish content by themselves.
+- To publish, use **editorial_reading_room_guide** when needed, research and author the complete source-grounded
+  edition, validate it with **commons_validate_publication** operation \`publish\`, then call
+  **commons_publish_editorial**. The publish result returns the permanent publication, archive, and edition URLs.
+- Use **commons_get_publication** to recover the caller's publication and current edition revisions. Existing
+  edition edits require the returned baseRevision. Only the account that claimed the subdomain can publish to it.
 
 ## Google Maps
 - Find multiple places/competitors/prospects -> **maps_search** (returns \`results[]\` with name,
@@ -5253,6 +5265,37 @@ var RenewEditorialReadingRoomDownloadOutputSchema = {
   downloadUrlExpiresAt: z4.string(),
   expiresAt: z4.string()
 };
+var CommonsPublicationSubdomainSchema = z4.string().trim().min(3).max(50).describe("Requested publication name under transparent-commons.cc. The server normalizes spaces to hyphens, rejects reserved names, and enforces one globally unique name per account.");
+var CommonsPreparePublicationInputSchema = {
+  requestedSubdomain: CommonsPublicationSubdomainSchema,
+  title: z4.string().trim().min(1).max(140).optional().describe("Reader-facing publication title. Omit to derive it from the chosen subdomain."),
+  description: z4.string().trim().max(500).optional().describe("Short description used on the publication archive and discovery surfaces.")
+};
+var CommonsValidatePublicationInputSchema = {
+  operation: z4.enum(["claim", "publish"]).describe("Validate either a new name claim or a finished editorial edition without writing."),
+  requestedSubdomain: CommonsPublicationSubdomainSchema.optional().describe("Publication name to validate when operation is claim."),
+  publicationSubdomain: CommonsPublicationSubdomainSchema.optional().describe("Already claimed publication name to validate when operation is publish."),
+  title: z4.string().trim().min(1).max(140).optional(),
+  description: z4.string().trim().max(500).optional(),
+  edition: z4.object(CreateEditorialReadingRoomInputSchema).strict().optional().describe("Complete source-grounded reading-room payload to validate when operation is publish."),
+  editionSlug: z4.string().trim().regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/).max(80).optional().describe("Stable public edition slug. Defaults to edition.site.slug."),
+  baseRevision: z4.number().int().positive().optional().describe("Current edition revision when validating an edit.")
+};
+var CommonsClaimPublicationInputSchema = {
+  ...CommonsPreparePublicationInputSchema,
+  idempotencyKey: z4.string().trim().min(8).max(200).describe("Unique key for this intended claim. Reuse it only when retrying the same claim.")
+};
+var CommonsPublishEditorialInputSchema = {
+  publicationSubdomain: CommonsPublicationSubdomainSchema.describe("Publication owned by the authenticated account."),
+  editionSlug: z4.string().trim().regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/).max(80).optional().describe("Stable public edition slug. Defaults to site.slug."),
+  idempotencyKey: z4.string().trim().min(8).max(200).describe("Unique key for this intended publish. Reuse it only when retrying the same revision."),
+  baseRevision: z4.number().int().positive().optional().describe("Required when revising an existing edition; use the current revision from commons_get_publication."),
+  ...CreateEditorialReadingRoomInputSchema
+};
+var CommonsGetPublicationInputSchema = {
+  subdomain: CommonsPublicationSubdomainSchema.optional().describe("Public publication name to inspect. Omit to return the publication owned by the authenticated account."),
+  includeEditions: z4.boolean().default(true).describe("Include the latest revision of every published edition.")
+};
 var RankTrackerModeSchema = z4.enum(["maps", "organic", "ai_overview", "paa"]);
 var RankTrackerBlueprintInputSchema = {
   projectName: z4.string().min(1).optional().describe("Optional name for the rank tracker project, client, or campaign."),
@@ -8029,6 +8072,41 @@ function registerPaaExtractorMcpTools(server, executor, options = {}) {
       openWorldHint: false
     }
   }, async (input) => executor.commonsListFilters(input));
+  server.registerTool("commons_prepare_publication", {
+    title: "Prepare Transparent Commons Publication",
+    description: "Check and normalize a subscriber-chosen Transparent Commons publication name before any write. Returns name availability, the caller's existing publication, permanent URL shape, ownership rules, and the required validate/claim/publish workflow. This is for a user-owned editorial publication, not a neutral /wiki/ entity.",
+    inputSchema: CommonsPreparePublicationInputSchema,
+    outputSchema: recordOutputSchema("commons_prepare_publication", CommonsGenericOutputSchema),
+    annotations: { title: "Prepare Transparent Commons Publication", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
+  }, async (input) => executor.commonsPreparePublication(input));
+  server.registerTool("commons_validate_publication", {
+    title: "Validate Transparent Commons Publication",
+    description: "Validate a publication name claim or a complete source-grounded editorial edition without writing. Use operation claim before commons_claim_publication and operation publish before commons_publish_editorial. This uses the editorial reading-room contract and checks ownership plus revision conflicts.",
+    inputSchema: CommonsValidatePublicationInputSchema,
+    outputSchema: recordOutputSchema("commons_validate_publication", CommonsGenericOutputSchema),
+    annotations: { title: "Validate Transparent Commons Publication", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
+  }, async (input) => executor.commonsValidatePublication(input));
+  server.registerTool("commons_claim_publication", {
+    title: "Claim Transparent Commons Publication",
+    description: "Permanently claim one globally unique publication subdomain for the authenticated MCP Scraper account. Call commons_prepare_publication and commons_validate_publication first. This creates public identity state but does not publish an edition. Requires an idempotencyKey; retries with the same intended claim are safe.",
+    inputSchema: CommonsClaimPublicationInputSchema,
+    outputSchema: recordOutputSchema("commons_claim_publication", CommonsGenericOutputSchema),
+    annotations: { title: "Claim Transparent Commons Publication", readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true }
+  }, async (input) => executor.commonsClaimPublication(input));
+  server.registerTool("commons_publish_editorial", {
+    title: "Publish Transparent Commons Editorial Edition",
+    description: "Publish a fully authored editorial reading-room edition to the caller-owned Transparent Commons subdomain and return permanent root, archive, and edition URLs. The calling AI must research and author the source-grounded edition first; this tool validates, renders, and persists it. For an existing edition, pass its current baseRevision. Requires an idempotencyKey; this is not the neutral wiki write tool.",
+    inputSchema: CommonsPublishEditorialInputSchema,
+    outputSchema: recordOutputSchema("commons_publish_editorial", CommonsGenericOutputSchema),
+    annotations: { title: "Publish Transparent Commons Editorial Edition", readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true }
+  }, async (input) => executor.commonsPublishEditorial(input));
+  server.registerTool("commons_get_publication", {
+    title: "Get Transparent Commons Publication",
+    description: "Read a Transparent Commons publication and its latest edition revisions. Omit subdomain to inspect the caller-owned publication; pass a name to inspect a public publication. Returns the permanent public and archive URLs needed for sharing or later edits.",
+    inputSchema: CommonsGetPublicationInputSchema,
+    outputSchema: recordOutputSchema("commons_get_publication", CommonsGenericOutputSchema),
+    annotations: { title: "Get Transparent Commons Publication", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }
+  }, async (input) => executor.commonsGetPublication(input));
   server.registerTool("directory_workflow", {
     title: "Directory Workflow: Markets + Maps",
     description: `Start a durable directory/prospecting job: selects US city markets from versioned hosted Census-place data, optionally joins the active hosted ZIP dataset, then runs Google Maps business searches per city. Pass a new idempotencyKey for each intended job and reuse it only when retrying that call. Production does not read server-local location CSVs. Always returns a background jobId; poll with directory_workflow_status. ${fileBehavior("Saves a CSV of results per city.", "Completed jobs return an owner-scoped CSV artifact.")}`,
@@ -8864,6 +8942,28 @@ var HttpMcpToolExecutor = class {
   commonsListNeedsLinks(input) {
     return this.call("/commons/needs-links/search", input);
   }
+  commonsPreparePublication(input) {
+    return this.call("/commons/publications/prepare", input);
+  }
+  commonsValidatePublication(input) {
+    return this.call("/commons/publications/validate", input);
+  }
+  commonsClaimPublication(input) {
+    const { idempotencyKey, ...body } = input;
+    return this.call("/commons/publications/claim", { ...body, idempotencyKey }, this.timeoutMs, "POST", {
+      "Idempotency-Key": `commons-publication-claim-${createHash4("sha256").update(idempotencyKey).digest("hex")}`
+    });
+  }
+  commonsPublishEditorial(input) {
+    const { idempotencyKey, ...body } = input;
+    return this.call("/commons/publications/publish", { ...body, idempotencyKey }, this.timeoutMs, "POST", {
+      "Idempotency-Key": `commons-publication-publish-${createHash4("sha256").update(idempotencyKey).digest("hex")}`
+    });
+  }
+  commonsGetPublication(input) {
+    const query = new URLSearchParams({ includeEditions: String(input.includeEditions ?? true) });
+    return this.getJson(input.subdomain ? `/commons/publications/${encodeURIComponent(input.subdomain)}?${query}` : `/commons/publications/me?${query}`);
+  }
   async captureSerpSnapshot(input) {
     const fingerprint = createHash4("sha256").update(JSON.stringify(input)).digest("hex");
     const now = Date.now();
@@ -13330,6 +13430,10 @@ export {
   SCHEDULED_ARTIFACT_TEMPLATE_PRESET,
   CreateEditorialReadingRoomInputSchema,
   RenewEditorialReadingRoomDownloadInputSchema,
+  CommonsPreparePublicationInputSchema,
+  CommonsValidatePublicationInputSchema,
+  CommonsClaimPublicationInputSchema,
+  CommonsPublishEditorialInputSchema,
   resolveDeploymentProfile,
   isLoopbackBaseUrl,
   permitsLocalNetworkAccess,
@@ -13346,4 +13450,4 @@ export {
   ScheduledResultsMcpExecutor,
   registerScheduledResultsMcpTools
 };
-//# sourceMappingURL=chunk-FQIICRR4.js.map
+//# sourceMappingURL=chunk-BP2IUIAH.js.map