extractly-mcp 1.0.0

package/README.md

@@ -0,0 +1,60 @@
+# extractly-mcp
+
+MCP server that exposes [Extractly](https://getextractly.com) as a tool: send a URL and a JSON extraction schema, and get structured JSON back.
+
+## Install & run
+
+```bash
+npx extractly-mcp
+```
+
+Requires **Node.js 18+** (uses built-in `fetch`).
+
+Get an API key at [getextractly.com](https://getextractly.com).
+
+## Tool: `extract_structured_data`
+
+- **url** — page to extract from  
+- **schema** — JSON object describing fields to extract  
+- **api_key** — your Extractly API key  
+
+The server calls `POST https://getextractly.com/api/v1/extract` with `url` and `schema` in the body and `x-api-key` set to your key.
+
+## Claude Desktop
+
+Edit your MCP config (e.g. `claude_desktop_config.json`) and add a server entry:
+
+```json
+{
+  "mcpServers": {
+    "extractly": {
+      "command": "npx",
+      "args": ["-y", "extractly-mcp"]
+    }
+  }
+}
+```
+
+Restart Claude Desktop after saving.
+
+## Cursor
+
+1. Open **Cursor Settings** → **MCP** (or edit your MCP config file, depending on your Cursor version).  
+2. Add a server that runs the same command as above, for example:
+
+```json
+{
+  "mcpServers": {
+    "extractly": {
+      "command": "npx",
+      "args": ["-y", "extractly-mcp"]
+    }
+  }
+}
+```
+
+You will pass your **api_key** when the model calls the tool (or your client may support env-based config in the future).
+
+## License
+
+MIT

package/index.js

@@ -0,0 +1,73 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+
+const EXTRACTLY_EXTRACT_URL = 'https://getextractly.com/api/v1/extract';
+
+const server = new McpServer(
+  { name: 'extractly-mcp', version: '1.0.0' },
+  {
+    instructions:
+      'Call extract_structured_data with a URL, a JSON schema describing fields to extract, and your Extractly API key.',
+  }
+);
+
+server.registerTool(
+  'extract_structured_data',
+  {
+    description:
+      'Extract structured data from any URL by providing a JSON schema. Returns clean JSON matching your schema. Powered by Extractly.',
+    inputSchema: z.object({
+      url: z.string().describe('The webpage to scrape'),
+      schema: z
+        .object({})
+        .catchall(z.unknown())
+        .describe('JSON object describing the fields to extract'),
+      api_key: z.string().describe('Extractly API key from getextractly.com'),
+    }),
+  },
+  async ({ url, schema, api_key }) => {
+    const response = await fetch(EXTRACTLY_EXTRACT_URL, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'x-api-key': api_key,
+      },
+      body: JSON.stringify({ url, schema }),
+    });
+
+    const raw = await response.text();
+    let parsed;
+    try {
+      parsed = raw ? JSON.parse(raw) : null;
+    } catch {
+      parsed = undefined;
+    }
+
+    if (!response.ok) {
+      const message =
+        parsed !== undefined && parsed !== null && typeof parsed === 'object' && 'message' in parsed
+          ? String(parsed.message)
+          : raw || response.statusText;
+      return {
+        isError: true,
+        content: [{ type: 'text', text: `Extractly API error (${response.status}): ${message}` }],
+      };
+    }
+
+    if (parsed === undefined) {
+      return {
+        content: [{ type: 'text', text: raw || '' }],
+      };
+    }
+
+    return {
+      content: [{ type: 'text', text: JSON.stringify(parsed, null, 2) }],
+      structuredContent: parsed,
+    };
+  }
+);
+
+const transport = new StdioServerTransport();
+await server.connect(transport);

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "extractly-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for Extractly — extract structured data from any URL",
+  "type": "module",
+  "main": "index.js",
+  "bin": {
+    "extractly-mcp": "./index.js"
+  },
+  "scripts": {
+    "start": "node index.js",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "keywords": [
+    "mcp",
+    "extractly",
+    "web-scraping",
+    "structured-data",
+    "ai-agents"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.28.0"
+  }
+}