@thynker-labs/tools-firecrawl 0.0.1

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+import { ToolProvider } from '@thynker-labs/core';
+
+interface FirecrawlToolProviderConfig {
+    apiKeyEnv: string;
+    /** Required scopes (default: ["web:scrape"]). */
+    requiredScopes?: string[];
+    /** Default scrape output formats. */
+    defaultFormats?: Array<"markdown" | "html" | "links">;
+}
+type FirecrawlFetch = typeof fetch;
+/**
+ * Firecrawl ToolProvider — scrape, map, and search via Firecrawl API.
+ */
+declare function createFirecrawlToolProvider(config: FirecrawlToolProviderConfig, fetchImpl?: FirecrawlFetch): ToolProvider;
+
+export { type FirecrawlFetch, type FirecrawlToolProviderConfig, createFirecrawlToolProvider };

package/dist/index.js

@@ -0,0 +1,119 @@
+// src/index.ts
+var FIRECRAWL_API = "https://api.firecrawl.dev/v1";
+var TOOLS = [
+  {
+    name: "firecrawl_scrape",
+    description: "Scrape a single URL and return page content (markdown by default). Use for reading a specific page.",
+    requiredScopes: ["web:scrape"],
+    inputSchema: {
+      type: "object",
+      properties: {
+        url: { type: "string", description: "URL to scrape" },
+        formats: {
+          type: "array",
+          items: { type: "string", enum: ["markdown", "html", "links"] },
+          description: "Output formats (default: markdown)"
+        }
+      },
+      required: ["url"]
+    }
+  },
+  {
+    name: "firecrawl_map",
+    description: "Map a website and return discovered URLs (fast site structure discovery).",
+    requiredScopes: ["web:scrape"],
+    inputSchema: {
+      type: "object",
+      properties: {
+        url: { type: "string", description: "Root URL to map" },
+        limit: { type: "number", description: "Max URLs to return (default 50)" }
+      },
+      required: ["url"]
+    }
+  },
+  {
+    name: "firecrawl_search",
+    description: "Search the web via Firecrawl and return relevant page snippets (alternative to Brave search).",
+    requiredScopes: ["web:search"],
+    inputSchema: {
+      type: "object",
+      properties: {
+        query: { type: "string", description: "Search query" },
+        limit: { type: "number", description: "Max results (default 5)" }
+      },
+      required: ["query"]
+    }
+  }
+];
+function resolveApiKey(config) {
+  const key = process.env[config.apiKeyEnv];
+  if (!key) {
+    throw new Error(
+      `Missing ${config.apiKeyEnv}. Set it in .env to enable Firecrawl tools.`
+    );
+  }
+  return key;
+}
+function scopesFor(config, tool) {
+  if (config.requiredScopes) return config.requiredScopes;
+  return tool.requiredScopes ?? ["web:scrape"];
+}
+async function firecrawlPost(path, apiKey, body, fetchImpl) {
+  const res = await fetchImpl(`${FIRECRAWL_API}${path}`, {
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${apiKey}`,
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify(body)
+  });
+  const data = await res.json();
+  if (!res.ok || data.success === false) {
+    throw new Error(
+      `Firecrawl ${path} failed (${res.status}): ${data.error ?? JSON.stringify(data)}`
+    );
+  }
+  return data.data ?? data;
+}
+function createFirecrawlToolProvider(config, fetchImpl = fetch) {
+  const scopedTools = TOOLS.map((t) => ({
+    ...t,
+    requiredScopes: scopesFor(config, t)
+  }));
+  return {
+    async list() {
+      resolveApiKey(config);
+      return scopedTools;
+    },
+    async execute(name, args, _authCtx) {
+      const apiKey = resolveApiKey(config);
+      if (name === "firecrawl_scrape") {
+        const url = String(args.url ?? "");
+        if (!url) throw new Error("url is required");
+        const formats = args.formats ?? config.defaultFormats ?? ["markdown"];
+        return firecrawlPost(
+          "/scrape",
+          apiKey,
+          { url, formats },
+          fetchImpl
+        );
+      }
+      if (name === "firecrawl_map") {
+        const url = String(args.url ?? "");
+        if (!url) throw new Error("url is required");
+        const limit = Number(args.limit ?? 50);
+        return firecrawlPost("/map", apiKey, { url, limit }, fetchImpl);
+      }
+      if (name === "firecrawl_search") {
+        const query = String(args.query ?? "");
+        if (!query.trim()) throw new Error("query is required");
+        const limit = Number(args.limit ?? 5);
+        return firecrawlPost("/search", apiKey, { query, limit }, fetchImpl);
+      }
+      throw new Error(`Unknown Firecrawl tool: ${name}`);
+    }
+  };
+}
+export {
+  createFirecrawlToolProvider
+};

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@thynker-labs/tools-firecrawl",
+  "version": "0.0.1",
+  "description": "Firecrawl ToolProvider for scrape, map, and search",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@thynker-labs/core": "0.0.1"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
+}