scrapeless-mcp-server 0.1.0

package/README.md

@@ -0,0 +1,89 @@
+<div align="center">
+  <img src="https://avatars.githubusercontent.com/u/189844671" width="120" height="120" alt="Scrapeless Logo" />
+</div>
+
+# Scrapeless Mcp Server
+
+A Model Context Protocol (MCP) server implementation for Scrapeless, providing advanced search capabilities.
+
+## Overview
+
+This project provides several MCP servers that enable AI assistants like Claude to perform various search operations and retrieve data from:
+
+- Google Search
+
+## Tools
+
+### 1. Search Tool
+- Name: `google-search`
+- Description: Search the web using Scrapeless
+- Parameters:
+    * `query` (required): Parameter defines the query you want to search. You can use anything that you would use in a regular Google search. e.g. inurl:, site:, intitle:.
+    * `gl` (optional, default: "us"): Parameter defines the country to use for the Google search. It's a two-letter country code. (e.g., us for the United States, uk for United Kingdom, or fr for France).
+    * `hl` (optional, default: "en"): Parameter defines the language to use for the Google search. It's a two-letter language code. (e.g., en for English, es for Spanish, or fr for French).
+
+
+## Setup Guide
+
+### 1. Get Scrapeless Key
+1. Register at [Scrapeless](https://app.scrapeless.com/passport/register?utm_source=github&utm_medium=mcp)
+2. [Get your free trial](https://app.scrapeless.com/landing/guide?utm_source=github&utm_medium=mcp)
+3. [Generate API Key](https://app.scrapeless.com/dashboard/settings/api-key?utm_source=github&utm_medium=mcp)
+
+
+### 2. Configure
+
+```json
+{
+  "mcpServers": {
+    "scrapelessMcpServer": {
+      "command": "npx",
+      "args": ["-y", "scrapeless-mcp-server"],
+      "env": {
+        "SCRAPELESS_KEY": "YOUR_SCRAPELESS_KEY"
+      }
+    }
+  }
+}
+```
+
+
+## Example Queries
+
+Here are some examples of how to use these servers with Claude Desktop:
+
+### Google Search
+```
+Please search for "climate change solutions" and summarize the top results.
+```
+
+
+## Installation
+
+### Prerequisites
+
+- Node.js 22 or higher
+- NPM or Yarn
+
+### Install from Source
+
+1. Clone the repository:
+```bash
+git clone https://github.com/scrapeless-ai/scrapeless-mcp-server.git
+cd scrapeless-mcp-server
+```
+
+2. Install dependencies:
+```bash
+npm install
+```
+
+
+3. Build the server:
+```bash
+npm run build
+```
+
+
+## Community
+- [MCP Server Discord](https://backend.scrapeless.com/app/api/v1/public/links/discord)

package/build/client.js

@@ -0,0 +1,27 @@
+import axios from "axios";
+export class ScrapelessClient {
+    api;
+    constructor(config) {
+        this.api = axios.create({
+            baseURL: config.baseURL,
+            headers: {
+                "Content-Type": "application/json",
+                "x-api-token": config.token,
+            },
+        });
+    }
+    async sendRequest(endpoint, actor, inputData) {
+        try {
+            const response = await this.api.post(endpoint, { actor, input: inputData });
+            return {
+                content: [{ type: "text", text: `Response:\n\n${JSON.stringify(response.data, null, 2)}` }],
+            };
+        }
+        catch (error) {
+            console.error("Scrapeless API Error:", error);
+            return {
+                content: [{ type: "text", text: `Failed to fetch data. Error: ${error.message}` }],
+            };
+        }
+    }
+}

package/build/config.js

@@ -0,0 +1,12 @@
+const API_KEY = process.env.SCRAPELESS_KEY?.trim();
+const BASE_URL = process.env.SCRAPELESS_BASE_URL?.trim() || "https://api.scrapeless.com";
+if (!API_KEY) {
+    throw new Error("❌ Missing environment variable: SCRAPELESS_KEY");
+}
+export const TOOL_ENDPOINTS = {
+    SCRAPER: "/api/v1/scraper/request",
+};
+export const SCRAPELESS_CONFIG = {
+    baseURL: BASE_URL,
+    token: API_KEY,
+};

package/build/index.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { server } from "./server.js";
+async function main() {
+    try {
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+    }
+    catch (error) {
+        console.error("Fatal error in main():", error);
+        process.exit(1);
+    }
+}
+main();

package/build/server.js

@@ -0,0 +1,28 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { ScrapelessClient } from "./client.js";
+import { SCRAPELESS_CONFIG, TOOL_ENDPOINTS } from "./config.js";
+const scrapelessClient = new ScrapelessClient(SCRAPELESS_CONFIG);
+export const server = new McpServer({
+    name: "scrapeless-mcp-server",
+    version: "0.1.0",
+    capabilities: { resources: {}, tools: {} },
+});
+server.tool("google-search", "Fetch Google Search Results", {
+    query: z.string().describe("Parameter defines the query you want to search. You can use anything that you would use in a regular Google search. e.g. inurl:, site:, intitle:. We also support advanced search query parameters such as as_dt and as_eq."),
+    gl: z.string().optional().describe("Parameter defines the country to use for the Google search. It's a two-letter country code. (e.g., us for the United States, uk for United Kingdom, or fr for France)."),
+    hl: z.string().optional().describe("Parameter defines the language to use for the Google search. It's a two-letter language code. (e.g., en for English, es for Spanish, or fr for French)."),
+}, async ({ query, gl = "us", hl = "en" }) => {
+    const response = await scrapelessClient.sendRequest(TOOL_ENDPOINTS.SCRAPER, "scraper.google.search", {
+        q: query,
+        gl,
+        hl,
+        location: ""
+    });
+    return {
+        content: response.content.map((item) => ({
+            type: "text",
+            text: item.text,
+        })),
+    };
+});

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "scrapeless-mcp-server",
+  "version": "0.1.0",
+  "main": "index.js",
+  "type": "module",
+  "bin": {
+    "scrapeless-mcp-server": "./build/index.js"
+  },
+  "scripts": {
+    "build": "tsc && chmod 755 build/index.js"
+  },
+  "files": [
+    "build"
+  ],
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "description": "",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.8.0",
+    "zod": "^3.24.2",
+    "axios": "^1.8.4"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.14",
+    "typescript": "^5.8.2"
+  },
+  "homepage": "https://scrapeless.com",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/scrapeless-ai/scrapeless-mcp-server"
+  }
+}