@spicrawl/mcp 0.1.6 → 0.1.8

package/dist/tools/usage.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { run } from "./common.js";
+import { loose, run } from "./common.js";
 // Usage analytics: /v1/usage, /v1/usage/summary, /v1/usage/reconciliation.
 // All three require the API key to carry the `read` scope (not in the default
 // key scopes {scrape, batch, sessions}); without it the API answers 403.
@@ -35,6 +35,107 @@ const METRICS = [
     "client_other",
 ];
 const DATE = z.string().regex(/^\d{4}-\d{2}-\d{2}$/, "YYYY-MM-DD");
+// What the three endpoints answer (openapi.yaml: UsageBreakdown, UsageByKey,
+// UsageSummary, UsageReconciliation). Metric names are open-ended ("new metrics
+// may appear as map keys"), so a metric map is a record, not a fixed list.
+const METRIC_MAP = z
+    .record(z.string(), z.number())
+    .nullish()
+    .describe("Metric name -> quantity. credits are micro-credits (1 credit = 1000000), engine_ms milliseconds, bytes_* bytes, the rest counts.");
+const PERIOD = loose({
+    start: z.string().optional().describe("First UTC day, inclusive (YYYY-MM-DD)."),
+    end: z.string().optional().describe("End UTC day, EXCLUSIVE (YYYY-MM-DD)."),
+    days: z.number().optional(),
+    bounds: z.string().optional().describe("Always '[start, end)'."),
+}).optional().describe("The window, as a half-open range of UTC days.");
+const USAGE_AS_OF = z.string().nullish().describe("When the newest rollup row in the window was written; null when the window is empty.");
+const STALE_SECONDS = z.number().nullish().describe("Age of usage_as_of in seconds; null when the window is empty. A large value means the rollup is behind.");
+const WARNINGS = z.array(z.string()).optional().describe("Caveats the numbers would otherwise hide.");
+const USAGE_OUTPUT = loose({
+    period: PERIOD,
+    group_by: z.string().optional().describe("The dimension used: day, project, engine, feature or key."),
+    groups: z
+        .array(loose({
+        key: z.string().describe("The bucket: a YYYY-MM-DD day, a project id, an engine tier (fetch, js or browser) or a feature (extract, ai_extract, proxy_datacenter, proxy_residential, batch)."),
+        label: z.string().optional().describe("Human label for an engine tier."),
+        metrics: METRIC_MAP,
+    }))
+        .nullish()
+        .describe("The buckets, sorted by key. Empty (or missing for group_by=key) does not mean no usage: read totals."),
+    totals: METRIC_MAP.optional().describe("Billed quantities for the whole window. Authoritative; use these, not the sum of groups."),
+    unattributed: METRIC_MAP.optional().describe("The part of each total the groups do not explain."),
+    keys: z
+        .array(loose({
+        key_id: z.string(),
+        name: z.string().optional(),
+        prefix: z.string().optional().describe("Display prefix of the API key, never the secret."),
+        project_id: z.string().optional(),
+        revoked: z.boolean().optional(),
+        days: z.array(loose({ day: z.string(), metrics: METRIC_MAP })).nullish(),
+        totals: METRIC_MAP.optional(),
+    }))
+        .nullish()
+        .describe("group_by=key only: one entry per API key, with its counters per UTC day."),
+    usage_as_of: USAGE_AS_OF,
+    stale_seconds: STALE_SECONDS,
+    warnings: WARNINGS,
+});
+const SUMMARY_OUTPUT = loose({
+    period: PERIOD,
+    period_elapsed_days: z.number().optional().describe("Whole days of the period elapsed; use it to pace consumption."),
+    plan: loose({
+        code: z.string().optional(),
+        name: z.string().optional(),
+        version: z.number().optional(),
+        subscription_status: z.string().optional().describe("'none' when no subscription covers now (the free plan)."),
+        period_source: z.string().optional().describe("'subscription' (billing period) or 'allowance_month'."),
+    }).optional(),
+    credits: loose({
+        included_micro: z.number().optional(),
+        used_micro: z.number().optional().describe("Credits spent so far, from the usage rollup; excludes credits held for in-flight work."),
+        remaining_micro: z.number().optional(),
+        overage_micro: z.number().optional(),
+        overage_micro_cents_per_credit: z.number().optional(),
+        used_basis_points: z.number().nullish().describe("Used / included in basis points (10000 = 100%); null when nothing is included."),
+    })
+        .nullish()
+        .describe("Metered usage against the plan's included credits. Micro-credits: 1 credit = 1000000."),
+    allowance: loose({
+        limit_micro: z.number().optional(),
+        limit_credits: z.number().optional(),
+        limit_source: z.string().optional().describe("'default' or 'override'."),
+        unlimited: z.boolean().optional(),
+        used_micro: z.number().optional().describe("Spent plus credits held for in-flight work."),
+        remaining_micro: z.number().optional().describe("Credits left under the monthly limit: the number to show."),
+        window_start: z.string().optional(),
+        resets_at: z.string().optional().describe("When the allowance is restored in full."),
+    })
+        .optional()
+        .describe("The monthly allowance the API enforces. Omitted when it cannot be read (warnings says so)."),
+    metrics: METRIC_MAP.optional().describe("Every billed metric for the period."),
+    unattributed: METRIC_MAP.optional(),
+    usage_as_of: USAGE_AS_OF,
+    stale_seconds: STALE_SECONDS,
+    warnings: WARNINGS,
+});
+const RECONCILIATION_OUTPUT = loose({
+    day: z.string().optional().describe("The UTC day reconciled."),
+    drift: z
+        .array(loose({
+        project_id: z.string().optional(),
+        metric: z.string().optional(),
+        stored_qty: z.number().optional().describe("The billed quantity."),
+        observed_qty: z.number().optional().describe("The quantity re-derived from the request log."),
+        delta: z.number().optional(),
+        action: z.string().optional().describe("The verdict: missing_in_usage_daily, absent_from_request_log, undercounted or overcounted."),
+    }))
+        .nullish()
+        .describe("Disagreements; empty means no drift."),
+    request_log_rows: z.number().optional().describe("Rows in the request log for the day; 0 means there was nothing to compare against."),
+    interpretation: z.string().optional().describe("What the drift can and cannot prove. Read it before acting on drift."),
+    repairable: z.boolean().optional().describe("Always false; nothing is repaired."),
+    warnings: WARNINGS,
+});
 export const registerUsageTools = (server, client) => {
     server.registerTool("spicrawl_usage", {
         title: "Usage breakdown",
@@ -56,6 +157,7 @@ export const registerUsageTools = (server, client) => {
                 .optional()
                 .describe("Metrics to return. Omit for all of them."),
         },
+        outputSchema: USAGE_OUTPUT,
         annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     }, async (args) => run(() => {
         const qs = new URLSearchParams();
@@ -77,6 +179,7 @@ export const registerUsageTools = (server, client) => {
         description: "A compact current-period summary of your org's usage (totals as of now, from the daily rollup). No parameters. " +
             "Use for a quick 'how much have I used so far'; use spicrawl_usage for a windowed breakdown. Requires the `read` scope.",
         inputSchema: {},
+        outputSchema: SUMMARY_OUTPUT,
         annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     }, async () => run(() => client.request("GET", "/v1/usage/summary")));
     server.registerTool("spicrawl_usage_reconciliation", {
@@ -87,6 +190,7 @@ export const registerUsageTools = (server, client) => {
         inputSchema: {
             day: DATE.optional().describe("The UTC day to reconcile, YYYY-MM-DD. Default: yesterday."),
         },
+        outputSchema: RECONCILIATION_OUTPUT,
         annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     }, async ({ day }) => run(() => client.request("GET", `/v1/usage/reconciliation${day ? `?day=${encodeURIComponent(day)}` : ""}`)));
 };

package/dist/tools/usage.js.map

@@ -1 +1 @@
-{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/tools/usage.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/tools/usage.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@spicrawl/mcp",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "mcpName": "io.github.OfficialSpicrawl/mcp",
-  "description": "The Spicrawl MCP server is a Model Context Protocol server that gives AI agents in Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Gemini CLI and Codex web scraping to Markdown, structured data extraction, screenshots, browser sessions and batch scraping as 25 native tools.",
+  "description": "MCP server for web scraping: scrape any URL to Markdown or JSON for Claude, Cursor and AI agents, with JavaScript rendering, batch scraping and data extraction",
   "license": "Apache-2.0",
   "author": "Spicrawl",
   "homepage": "https://docs.spicrawl.com/agents/mcp",
@@ -20,25 +20,20 @@
     "model-context-protocol",
     "web-scraping",
     "web-scraper",
-    "web-crawler",
-    "html-to-markdown",
+    "scraper",
+    "batch-scraping",
     "markdown",
+    "html-to-markdown",
     "data-extraction",
     "structured-data",
-    "screenshot",
     "javascript-rendering",
-    "batch-scraping",
+    "browser-automation",
     "llm",
-    "ai-agents",
     "rag",
+    "ai-agents",
     "claude",
     "claude-code",
-    "claude-desktop",
-    "cursor",
-    "vscode",
-    "codex",
-    "gemini-cli",
-    "windsurf"
+    "cursor"
   ],
   "type": "module",
   "bin": {