nodebench-mcp 2.28.0 → 2.31.0

package/dist/tools/scraplingTools.js

@@ -0,0 +1,278 @@
+/**
+ * Scrapling tools — Adaptive web scraping via Scrapling Python bridge server.
+ *
+ * Calls the scrapling_bridge FastAPI server over HTTP (port 8008).
+ * Requires SCRAPLING_SERVER_URL env var (default: http://localhost:8008).
+ *
+ * Tiers:
+ *   http     — Basic HTTP fetch with stealthy headers
+ *   stealth  — Anti-bot bypass (Cloudflare, TLS fingerprinting)
+ *   dynamic  — Full browser rendering (Playwright)
+ *
+ * Note: Web scraping should comply with target site ToS. User responsibility.
+ */
+// ─── HTTP helpers ─────────────────────────────────────────────────────────────
+const DEFAULT_SERVER = "http://localhost:8008";
+function getServerUrl() {
+    return (process.env.SCRAPLING_SERVER_URL || DEFAULT_SERVER).replace(/\/$/, "");
+}
+async function scraplingRequest(endpoint, method, body) {
+    const url = `${getServerUrl()}${endpoint}`;
+    try {
+        const res = await fetch(url, {
+            method,
+            headers: body ? { "Content-Type": "application/json" } : undefined,
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        return await res.json();
+    }
+    catch (e) {
+        return {
+            error: true,
+            message: `Scrapling bridge unreachable at ${url}: ${e.message}`,
+            suggestion: "Ensure the Scrapling bridge server is running. Start with: cd python-mcp-servers/scrapling_bridge && uvicorn server:app --port 8008",
+        };
+    }
+}
+// ─── Tools ────────────────────────────────────────────────────────────────────
+export const scraplingTools = [
+    // 1. scrapling_fetch
+    {
+        name: "scrapling_fetch",
+        description: "Fetch a URL with adaptive scraping. Auto-selects fetcher tier: 'http' for public pages, 'stealth' for anti-bot bypass (Cloudflare, TLS fingerprinting), 'dynamic' for JS-rendered pages. Returns page title, text preview, status code. Optionally extract data inline with CSS/XPath selectors. Requires Scrapling bridge server (SCRAPLING_SERVER_URL, default localhost:8008). Web scraping must comply with target site ToS.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                url: { type: "string", description: "URL to fetch" },
+                tier: {
+                    type: "string",
+                    enum: ["http", "stealth", "dynamic"],
+                    description: "Fetcher tier (default: http). Use 'stealth' for Cloudflare sites, 'dynamic' for JS-rendered pages.",
+                },
+                impersonate: {
+                    type: "string",
+                    description: "Browser TLS fingerprint to impersonate (e.g. 'chrome')",
+                },
+                extract: {
+                    type: "object",
+                    properties: {
+                        selectors: {
+                            type: "object",
+                            additionalProperties: { type: "string" },
+                            description: "Map of name -> CSS/XPath selector to extract",
+                        },
+                    },
+                    description: "Optional inline extraction selectors",
+                },
+                proxy: { type: "string", description: "Optional proxy URL" },
+                timeout: { type: "number", description: "Request timeout in seconds (default: 30)" },
+            },
+            required: ["url"],
+        },
+        handler: async (params) => {
+            return await scraplingRequest("/fetch", "POST", {
+                url: params.url,
+                tier: params.tier || "http",
+                impersonate: params.impersonate,
+                extract: params.extract,
+                proxy: params.proxy,
+                timeout: params.timeout || 30,
+                stealthy_headers: true,
+            });
+        },
+    },
+    // 2. scrapling_extract
+    {
+        name: "scrapling_extract",
+        description: "Extract structured data from a URL using CSS or XPath selectors. Zero LLM tokens — deterministic extraction. Use CSS selectors like 'h1::text', '.price::text', 'a[href]::attr(href)'. Use XPath for complex queries starting with '//'. Falls back to fetch_url + LLM extraction if selectors fail. Requires Scrapling bridge server.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                url: { type: "string", description: "URL to extract from" },
+                selectors: {
+                    type: "object",
+                    additionalProperties: { type: "string" },
+                    description: "Map of field name -> CSS or XPath selector. E.g. { title: 'h1::text', prices: '.price::text' }",
+                },
+                tier: {
+                    type: "string",
+                    enum: ["http", "stealth", "dynamic"],
+                    description: "Fetcher tier (default: http)",
+                },
+                impersonate: { type: "string", description: "Browser fingerprint" },
+                proxy: { type: "string", description: "Optional proxy URL" },
+            },
+            required: ["url", "selectors"],
+        },
+        handler: async (params) => {
+            return await scraplingRequest("/extract", "POST", {
+                url: params.url,
+                selectors: params.selectors,
+                tier: params.tier || "http",
+                impersonate: params.impersonate,
+                proxy: params.proxy,
+                timeout: params.timeout || 30,
+            });
+        },
+    },
+    // 3. scrapling_batch_fetch
+    {
+        name: "scrapling_batch_fetch",
+        description: "Fetch multiple URLs in parallel with configurable concurrency. Use for competitive analysis, multi-source research, or batch data collection. Up to 20 URLs, 1-10 concurrent fetches. Each URL gets the same tier/proxy config. Returns per-URL results with success/failure status. Requires Scrapling bridge server.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                urls: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "URLs to fetch (1-20)",
+                },
+                tier: {
+                    type: "string",
+                    enum: ["http", "stealth", "dynamic"],
+                    description: "Fetcher tier for all URLs (default: http)",
+                },
+                concurrency: {
+                    type: "number",
+                    description: "Max parallel fetches (default: 5, max: 10)",
+                },
+                extract: {
+                    type: "object",
+                    properties: {
+                        selectors: {
+                            type: "object",
+                            additionalProperties: { type: "string" },
+                        },
+                    },
+                    description: "Optional extraction selectors applied to all URLs",
+                },
+                impersonate: { type: "string" },
+                proxy: { type: "string" },
+                timeout: { type: "number" },
+            },
+            required: ["urls"],
+        },
+        handler: async (params) => {
+            return await scraplingRequest("/fetch/batch", "POST", {
+                urls: params.urls,
+                tier: params.tier || "http",
+                concurrency: params.concurrency || 5,
+                extract: params.extract,
+                impersonate: params.impersonate,
+                proxy: params.proxy,
+                timeout: params.timeout || 30,
+                stealthy_headers: true,
+            });
+        },
+    },
+    // 4. scrapling_track_element
+    {
+        name: "scrapling_track_element",
+        description: "Track an element across page versions using Scrapling's adaptive element relocation. Survives CSS class renames, DOM restructuring, and layout changes. Use for price monitoring, content change detection, or element stability checks. Returns element tag, text, attributes, and HTML. Requires Scrapling bridge server.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                url: { type: "string", description: "URL of the page" },
+                selector: { type: "string", description: "CSS selector for the element to track" },
+                tier: {
+                    type: "string",
+                    enum: ["http", "stealth", "dynamic"],
+                    description: "Fetcher tier (default: http)",
+                },
+                impersonate: { type: "string" },
+                proxy: { type: "string" },
+            },
+            required: ["url", "selector"],
+        },
+        handler: async (params) => {
+            return await scraplingRequest("/track", "POST", {
+                url: params.url,
+                selector: params.selector,
+                tier: params.tier || "http",
+                impersonate: params.impersonate,
+                proxy: params.proxy,
+            });
+        },
+    },
+    // 5. scrapling_crawl
+    {
+        name: "scrapling_crawl",
+        description: "Start a multi-page spider crawl with extraction. Crawls from start URLs, follows links matching a CSS selector, extracts data per page. Returns a session_id to poll with scrapling_crawl_status. Max 500 pages, 1-20 concurrent. Domain whitelist enforced. Use for SEC filing crawls, news aggregation, or site-wide data collection. Requires Scrapling bridge server.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                start_urls: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "URLs to start crawling from (1-10)",
+                },
+                max_pages: {
+                    type: "number",
+                    description: "Max pages to crawl (default: 50, max: 500)",
+                },
+                concurrency: {
+                    type: "number",
+                    description: "Concurrent fetches (default: 5, max: 20)",
+                },
+                selectors: {
+                    type: "object",
+                    additionalProperties: { type: "string" },
+                    description: "CSS/XPath selectors to extract from each page",
+                },
+                follow_links: {
+                    type: "string",
+                    description: "CSS selector for links to follow (e.g. '.pagination a')",
+                },
+                domain_whitelist: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Only follow links to these domains",
+                },
+            },
+            required: ["start_urls"],
+        },
+        handler: async (params) => {
+            return await scraplingRequest("/crawl/start", "POST", {
+                start_urls: params.start_urls,
+                max_pages: params.max_pages || 50,
+                concurrency: params.concurrency || 5,
+                selectors: params.selectors || {},
+                follow_links: params.follow_links,
+                domain_whitelist: params.domain_whitelist || [],
+            });
+        },
+    },
+    // 6. scrapling_crawl_status
+    {
+        name: "scrapling_crawl_status",
+        description: "Check crawl progress and get collected items. Pass the session_id from scrapling_crawl. Returns status (running/completed/stopped), pages crawled, items with extracted data, and errors. Poll periodically until status is 'completed'. Requires Scrapling bridge server.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                session_id: { type: "string", description: "Crawl session ID from scrapling_crawl" },
+            },
+            required: ["session_id"],
+        },
+        handler: async (params) => {
+            return await scraplingRequest(`/crawl/status?session_id=${encodeURIComponent(params.session_id)}`, "GET");
+        },
+    },
+    // 7. scrapling_crawl_stop
+    {
+        name: "scrapling_crawl_stop",
+        description: "Stop a running crawl session. Pass the session_id from scrapling_crawl. Items collected so far are preserved. Use when you have enough data or need to abort. Requires Scrapling bridge server.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                session_id: { type: "string", description: "Crawl session ID to stop" },
+            },
+            required: ["session_id"],
+        },
+        handler: async (params) => {
+            return await scraplingRequest("/crawl/stop", "POST", {
+                session_id: params.session_id,
+            });
+        },
+    },
+];
+//# sourceMappingURL=scraplingTools.js.map

package/dist/tools/scraplingTools.js.map

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

package/dist/tools/thompsonProtocolTools.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Thompson Protocol Tools — "Calculus Made Easy" approach to AI content
+ *
+ * 4-agent pipeline:
+ *   1. Thompson Writer — Plain English mandate, intuition-before-mechanics
+ *   2. Feynman Editor — Skeptical Beginner rejection loop
+ *   3. Visual Metaphor Mapper — 1:1 analogy→visual prompt generation
+ *   4. Anti-Elitism Linter — Mechanical ban list + readability scoring
+ *
+ * Plus orchestration:
+ *   5. thompson_pipeline — End-to-end orchestrator
+ *   6. thompson_quality_gate — Deterministic pass/fail checklist
+ */
+import type { McpTool } from "../types.js";
+export declare const THOMPSON_SYSTEM_PROMPTS: {
+    writer: string;
+    feynman_editor: string;
+    visual_mapper: string;
+    anti_elitism_linter: string;
+};
+export interface ThompsonQualityChecklist {
+    hasPlainEnglishTranslations: boolean;
+    hasAnalogyPerConcept: boolean;
+    hasDifficultyAcknowledgment: boolean;
+    hasIntuitionBeforeMechanics: boolean;
+    passesFeynmanEdit: boolean;
+    passesAntiElitismLint: boolean;
+    hasVisualMetaphors: boolean;
+    fleschKincaidUnder10: boolean;
+    noBannedPhrases: boolean;
+    hasProgressiveComplexity: boolean;
+}
+export declare function deriveThompsonGrade(checklist: ThompsonQualityChecklist): "exemplary" | "passing" | "needs_work" | "failing";
+declare function lintBannedPhrases(text: string): Array<{
+    phrase: string;
+    category: string;
+    replacement: string;
+    position: number;
+}>;
+declare function computeReadabilityMetrics(text: string): {
+    fleschKincaidGrade: number;
+    passiveVoicePct: number;
+    avgSentenceLength: number;
+    jargonDensity: number;
+};
+declare function countSyllables(word: string): number;
+export declare function createThompsonProtocolTools(): McpTool[];
+export declare const _testExports: {
+    lintBannedPhrases: typeof lintBannedPhrases;
+    computeReadabilityMetrics: typeof computeReadabilityMetrics;
+    countSyllables: typeof countSyllables;
+    BANNED_PHRASES: {
+        phrase: string;
+        category: string;
+        replacement: string;
+    }[];
+};
+export {};