@opencraw/mcp 0.1.0 → 0.1.2

package/README.md

@@ -27,9 +27,11 @@ can write files passes their `paths`; one that can't (a chat-only host) passes t
 `probe`/`run` call's `browserPath`/`insecureTls`, so a sandbox without Playwright's own bundled browser
 does not need every tool call to repeat them.
 
-`OPENCRAW_HOOKS` points at a JavaScript module whose default export is `{ name: function }`: the hooks the
-recipes call (`hook` steps and transforms). Only the server's environment names it, never a tool call, so an
-agent can run recipes that use your hooks but can't make the server load a module of its choosing.
+`OPENCRAW_PLUGINS` (or `OPENCRAW_HOOKS`) points at a plugins module: named exports `hooks` (the recipes'
+`hook` steps and transforms), `accessPlugins` (for `{ kind: "plugin" }` access profiles) and `captchaSolvers`;
+a module whose default export is `{ name: function }` is read as hooks alone. Only the server's environment
+names it, never a tool call, so an agent can run recipes that use your plugins but can't make the server load
+a module of its choosing.
 
 `OPENCRAW_ACCESS` points at an access config ([access.md](../../docs/recipes/access.md)): proxy profiles, with
 credentials as `{{env.NAME}}` read from the server's environment. The `probe` and `run` tools then take an
@@ -51,7 +53,15 @@ endpoints only a script fetches after load.
 | `browserPath?`, `insecureTls?`, `userAgent?` | As in the cli. |
 | `access?` | An access profile from the server's `OPENCRAW_ACCESS` config. |
 
-Returns `{ url, status, findings: { jsonLd, inlineJson, jsonUrls, scriptHosts, apiLinks }, observed }`.
+Returns `{ url, status, findings: { jsonLd, inlineJson, jsonUrls, scriptHosts, apiLinks }, observed }`. For a
+PDF (served as `application/pdf`, or a local path) it adds `pdf: { pages, rows, headers }`: the first rows and
+every likely table header with the `selector` a `table` extract needs. For a spreadsheet or a CSV (served as a
+spreadsheet type or `text/csv`, or a local `.xlsx`, `.csv` or `.tsv` path) it adds
+`workbook: { csv?: { encoding, delimiter }, sheets, rows, headers }`. For a presentation it adds
+`deck: { width, height, slides, headers, charts, grids }`, and for JSON, JSON Lines or YAML
+`json: { format, type, tree, lists }`: the structure, and every list of records with its path. An HTML page
+adds `html: { tables, outline?, frontMatter? }`: its tables' header rows, and for Markdown its sections and
+front matter keys.
 
 ### `validate`
 

package/dist/index.esm.js

@@ -1,6 +1,6 @@
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { readRecipeFiles, probeUrl, loadForRun, resolveAccess, loadHooks } from '@opencraw/cli';
+import { readRecipeFiles, probeUrl, loadForRun, loadPlugins, resolveAccess } from '@opencraw/cli';
 import { z } from 'zod';
 import { memorySink, jsonLinesSink, createCrawler, RecipeSet, RecipeValidationError, RecipeBindingError, parseOutputRecipe, parseInputRecipe, bindRecipeSet } from '@opencraw/core';
 
@@ -72,7 +72,8 @@ async function probeTool(args) {
       insecureTls: args.insecureTls === true || process.env.OPENCRAW_INSECURE_TLS === '1',
       userAgent: args.userAgent,
       access: process.env.OPENCRAW_ACCESS === '' ? undefined : process.env.OPENCRAW_ACCESS,
-      accessProfile: args.access
+      accessProfile: args.access,
+      plugins: nonEmpty(process.env.OPENCRAW_PLUGINS) ?? nonEmpty(process.env.OPENCRAW_HOOKS)
     });
     return {
       content: [{
@@ -91,6 +92,9 @@ async function probeTool(args) {
     };
   }
 }
+function nonEmpty(value) {
+  return value === '' ? undefined : value;
+}
 
 const recipeObject = z.record(z.string(), z.unknown());
 const recipeObjects = z.array(recipeObject).min(1);
@@ -163,10 +167,13 @@ async function runTool(args) {
     append: args.append
   });
   try {
-    const hooksFile = serverFile('OPENCRAW_HOOKS');
+    const pluginsFile = serverFile('OPENCRAW_PLUGINS') ?? serverFile('OPENCRAW_HOOKS');
+    const plugins = pluginsFile === undefined ? undefined : await loadPlugins(pluginsFile);
     crawler = createCrawler({
       sink,
-      hooks: hooksFile === undefined ? undefined : await loadHooks(hooksFile),
+      hooks: plugins?.hooks,
+      accessPlugins: plugins?.accessPlugins,
+      captchaSolvers: plugins?.captchaSolvers,
       access: await resolveAccess({
         insecureTls: false,
         access: serverFile('OPENCRAW_ACCESS'),
@@ -218,7 +225,7 @@ async function runTool(args) {
   }
 }
 /**
- * A file the server was started with (`OPENCRAW_ACCESS`, `OPENCRAW_HOOKS`).
+ * A file the server was started with (`OPENCRAW_ACCESS`, `OPENCRAW_PLUGINS` or `OPENCRAW_HOOKS`).
  * Never a tool argument: a caller picks a profile, never a file, and never
  * names a module for the server to run.
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@opencraw/mcp",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "type": "module",
   "main": "./dist/index.esm.js",
   "module": "./dist/index.esm.js",
@@ -24,8 +24,8 @@
     "!**/*.js.map"
   ],
   "dependencies": {
-    "@opencraw/core": "^0.1.0",
-    "@opencraw/cli": "^0.1.0",
+    "@opencraw/core": "^0.1.2",
+    "@opencraw/cli": "^0.1.2",
     "@modelcontextprotocol/sdk": "^1.30.1",
     "playwright": "^1.63.0",
     "zod": "^4.6.5"