scrapeunblocker-mcp 0.3.5 → 0.4.0

package/README.md

@@ -18,6 +18,7 @@ You bring your **own** API key. Nothing is shared or proxied through us.
 | `google_search` | Run a Google search and return organic results as JSON. |
 | `list_plugins` | List the ready-made site plugins (100+: Amazon, Walmart, Zillow, Booking.com, Indeed, Google Trends, YouTube, App Store, Ahrefs, ...) with their parameters. Free - it calls nothing. |
 | `run_plugin` | Run one site plugin and return its structured JSON. |
+| `amazon_search`, `amazon_product`, `amazon_reviews`, `walmart_search`, `ebay_search`, `google_shopping`, `google_local`, `maps_place_details`, `google_images`, `youtube_search`, `youtube_transcript`, `zillow_search`, `indeed_jobs`, `trustpilot_reviews`, `booking_hotels` | The most-used site plugins as tools of their own, each with its parameters in the tool schema - one call, no `list_plugins` lookup. Same JSON as `run_plugin`. |
 
 ### Site plugins (structured JSON for known sites)
 
@@ -25,7 +26,8 @@ For many popular sites there is a plugin that returns the data already
 parsed - a Target search, a Zillow listing search, an app's App Store reviews,
 Google Trends for a few keywords. The model calls `list_plugins` (optionally
 with `search: "zillow"` or a `category`) to find the plugin and its
-parameters, then `run_plugin` with `name` and `params`:
+parameters, then `run_plugin` with `name` and `params` (the most-used plugins, listed in
+the table above, can also be called directly as their own tools):
 
 ```json
 { "name": "target_search", "params": { "query": "coffee maker", "max_results": 20 } }

package/dist/index.js

@@ -5506,6 +5506,23 @@ var MAX_OUTPUT_CHARS = 1e5;
 var BY_NAME = new Map(PLUGINS.map((p) => [p.name, p]));
 var NAMES = PLUGINS.map((p) => p.name);
 var CATEGORIES2 = CATEGORIES;
+var FEATURED_PLUGINS = [
+  "amazon_search",
+  "amazon_product",
+  "amazon_reviews",
+  "walmart_search",
+  "ebay_search",
+  "google_shopping",
+  "google_local",
+  "maps_place_details",
+  "google_images",
+  "youtube_search",
+  "youtube_transcript",
+  "zillow_search",
+  "indeed_jobs",
+  "trustpilot_reviews",
+  "booking_hotels"
+];
 var text = (t, isError = false) => isError ? { content: [{ type: "text", text: t }], isError: true } : { content: [{ type: "text", text: t }] };
 function signature(p) {
   return `${p.name}(${p.params.map((q) => q.required ? `${q.name}*` : q.name).join(", ")})`;
@@ -5564,8 +5581,49 @@ function prepare(p, params) {
   }
   return out;
 }
+function paramType(q) {
+  const scalar = (t) => t === "integer" ? z.number().int() : t === "number" ? z.number() : t === "boolean" ? z.boolean() : z.string();
+  let type;
+  if (q.type === "array") {
+    const item = scalar(q.items);
+    type = z.union([z.array(item), item]);
+  } else if (q.enum && q.enum.length && q.enum.every((v) => typeof v === "string")) {
+    type = z.enum(q.enum);
+    if (q.join) type = z.union([type, z.array(type)]);
+  } else {
+    type = scalar(q.type);
+    if (q.join) type = z.union([type, z.array(type)]);
+  }
+  const extras = [
+    q.enum && !q.enum.every((v) => typeof v === "string") ? `One of: ${q.enum.join(", ")}.` : "",
+    q.default !== void 0 ? `Default: ${String(q.default)}.` : ""
+  ].filter(Boolean);
+  const description = [q.description, ...extras].filter(Boolean).join(" ");
+  if (description) type = type.describe(description);
+  return q.required ? type : type.optional();
+}
 function registerPluginTools(server2, options) {
   const annotations = { readOnlyHint: true, openWorldHint: true, destructiveHint: false, ...options.annotations };
+  async function run(plugin, raw) {
+    const blocked = options.blocked?.();
+    if (blocked) return blocked;
+    const params = prepare(plugin, raw);
+    if (typeof params === "string") return text(`${params}
+
+${details(plugin)}`, true);
+    try {
+      const result = await options.call(plugin.path, params);
+      const body = JSON.stringify(result);
+      if (body.length <= MAX_OUTPUT_CHARS) return text(body);
+      return text(
+        body.slice(0, MAX_OUTPUT_CHARS) + `
+
+[Cut at ${MAX_OUTPUT_CHARS} of ${body.length} characters - ask for fewer results (max_results) or a narrower filter to get the whole answer.]`
+      );
+    } catch (err) {
+      return text(options.errorText(err), true);
+    }
+  }
   server2.registerTool(
     "list_plugins",
     {
@@ -5604,32 +5662,32 @@ function registerPluginTools(server2, options) {
         params: z.record(z.string(), z.union([z.string(), z.number(), z.boolean(), z.array(z.union([z.string(), z.number()]))])).optional().describe(`The plugin's parameters, e.g. {"query": "coffee maker", "max_results": 20}.`)
       }
     },
-    async (args) => {
-      const blocked = options.blocked?.();
-      if (blocked) return blocked;
-      const plugin = BY_NAME.get(args.name);
-      const params = prepare(plugin, args.params ?? {});
-      if (typeof params === "string") return text(`${params}
-
-${details(plugin)}`, true);
-      try {
-        const result = await options.call(plugin.path, params);
-        const body = JSON.stringify(result);
-        if (body.length <= MAX_OUTPUT_CHARS) return text(body);
-        return text(
-          body.slice(0, MAX_OUTPUT_CHARS) + `
-
-[Cut at ${MAX_OUTPUT_CHARS} of ${body.length} characters - ask for fewer results (max_results) or a narrower filter to get the whole answer.]`
+    async (args) => run(BY_NAME.get(args.name), args.params ?? {})
+  );
+  for (const name of FEATURED_PLUGINS) {
+    const plugin = BY_NAME.get(name);
+    if (!plugin) continue;
+    const shape = Object.fromEntries(plugin.params.map((q) => [q.name, paramType(q)]));
+    server2.registerTool(
+      plugin.name,
+      {
+        title: plugin.title,
+        annotations: { title: plugin.title, ...annotations },
+        description: `${plugin.description} Returns JSON. Billed like an API request; listing plugins bill one unit per result page they fetch, so keep max_results modest.`,
+        inputSchema: shape
+      },
+      async (args) => {
+        const raw = Object.fromEntries(
+          Object.entries(args).filter(([, v]) => v !== void 0)
         );
-      } catch (err) {
-        return text(options.errorText(err), true);
+        return run(plugin, raw);
       }
-    }
-  );
+    );
+  }
 }
 
 // src/index.ts
-var VERSION = "0.3.5";
+var VERSION = "0.4.0";
 var DEFAULT_BASE_URL = "https://api.scrapeunblocker.com";
 var API_KEY_HEADER = "x-scrapeunblocker-key";
 function resolveApiKey() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scrapeunblocker-mcp",
-  "version": "0.3.5",
+  "version": "0.4.0",
   "mcpName": "com.scrapeunblocker/scrapeunblocker-mcp",
   "description": "Model Context Protocol (MCP) server for ScrapeUnblocker - lets Claude fetch any web page's HTML (or AI-parsed JSON) and run 100+ site plugins that return structured JSON, through the ScrapeUnblocker anti-bot API, using your own API key.",
   "keywords": [