scrapeless-mcp-server 0.4.7 → 0.4.8

package/README.md

@@ -6,7 +6,7 @@
 
 Built on the open MCP standard, Scrapeless MCP Server seamlessly connects models like **ChatGPT**, **Claude**, and tools like **Cursor** and **Windsurf** to a wide range of external capabilities, including:
 
-- **Google services integration** (Search, Flights, Trends, Scholar, etc.)
+- **Google services integration** (Search, Trends)
 - **Browser automation** for page-level navigation and interaction
 - **Scrape** dynamic, JS-heavy sites—export as HTML, Markdown, or screenshots
 
@@ -42,8 +42,6 @@ Here are some additional examples of how to use these servers:
 
 | Example                                                                                                                           |
 | --------------------------------------------------------------------------------------------------------------------------------- |
-| Please help me with my flight ticket from Chicago to New York on November 20, 2025.                                               |
-| Find papers by "Yoshua Bengio" on deep learning.                                                                                  |
 | Search scrapeless by Google search.                                                                                               |
 | Find the search interest for "AI" over the last year.                                                                             |
 | Use a browser to visit [chatgpt.com](http://chatgpt.com), search for "What's the weather like today?", and summarize the results. |
@@ -134,9 +132,7 @@ Customize browser session behavior with optional parameters. These can be set vi
 | Name               | Description                                       |
 | ------------------ | ------------------------------------------------- |
 | google_search      | Universal information search engine.              |
-| google_flights     | Exclusive flight information query tool.          |
 | google_trends      | Get trending search data from Google Trends.      |
-| google_scholar     | Search for academic papers on Google Scholar.     |
 | browser_goto       | Navigate browser to a specified URL.              |
 | browser_go_back    | Go back one step in browser history.              |
 | browser_go_forward | Go forward one step in browser history.           |

package/build/tools/browser/browser.js

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import { defineTool, wrapMcpBrowserResponse, snapshot } from "../utils.js";
+import { defineTool, wrapMcpBrowserResponse, snapshot, } from "../utils.js";
 export const browserCreate = defineTool({
     name: "browser_create",
     description: "Create or reuse a cloud browser session using Scrapeless. Updates the active session.",
@@ -46,12 +46,8 @@ export const browserGoto = defineTool({
             content: [
                 {
                     type: "text",
-                    text: `Navigated to ${params.url}`,
+                    text: accessibilitySnapshot,
                 },
-                {
-                    type: "text",
-                    text: accessibilitySnapshot
-                }
             ],
         };
     },
@@ -77,10 +73,6 @@ export const browserGoBack = defineTool({
         const accessibilitySnapshot = await snapshot(session.page);
         return {
             content: [
-                {
-                    type: "text",
-                    text: "Navigated back.",
-                },
                 {
                     type: "text",
                     text: accessibilitySnapshot,
@@ -110,10 +102,6 @@ export const browserGoForward = defineTool({
         const accessibilitySnapshot = await snapshot(session.page);
         return {
             content: [
-                {
-                    type: "text",
-                    text: "Navigated forward.",
-                },
                 {
                     type: "text",
                     text: accessibilitySnapshot,
@@ -147,13 +135,9 @@ export const browserClick = defineTool({
                 content: [
                     {
                         type: "text",
-                        text: `Clicked on element with selector ${params.selector}`
+                        text: accessibilitySnapshot,
                     },
-                    {
-                        type: "text",
-                        text: accessibilitySnapshot
-                    }
-                ]
+                ],
             };
         }
         catch (error) {
@@ -187,13 +171,9 @@ export const browserType = defineTool({
                 content: [
                     {
                         type: "text",
-                        text: `Typed ${params.text} into element with selector ${params.selector}`
+                        text: accessibilitySnapshot,
                     },
-                    {
-                        type: "text",
-                        text: accessibilitySnapshot
-                    }
-                ]
+                ],
             };
         }
         catch (error) {
@@ -256,6 +236,38 @@ export const browserWait = defineTool({
         return wrapMcpBrowserResponse(`Waited for ${params.time ?? 30000} milliseconds`);
     },
 });
+export const browserSnapshot = defineTool({
+    name: "browser_snapshot",
+    description: `Capture the complete structure of a webpage, including DOM and resources, for inspection and analysis.`,
+    inputSchema: {
+        sessionId: z
+            .string()
+            .optional()
+            .describe("Optional session ID to use/reuse. If not provided or invalid, the active session is used."),
+    },
+    handle: async (context, params) => {
+        const session = context.getSession(params.sessionId);
+        if (!session?.page) {
+            return wrapMcpBrowserResponse("No active browser session found. Please create a browser session first.");
+        }
+        try {
+            const accessibilitySnapshot = await snapshot(session.page);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: accessibilitySnapshot,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [],
+            };
+        }
+    },
+});
 export const browserScreenshot = defineTool({
     name: "browser_screenshot",
     description: `Capture a screenshot of the current page.
@@ -297,7 +309,7 @@ export const browserScreenshot = defineTool({
                     {
                         type: "text",
                         text: accessibilitySnapshot,
-                    }
+                    },
                 ],
             };
         }
@@ -384,10 +396,6 @@ export const browserScroll = defineTool({
             const accessibilitySnapshot = await snapshot(session.page);
             return {
                 content: [
-                    {
-                        type: "text",
-                        text: `Scrolled to the bottom of the page.`,
-                    },
                     {
                         type: "text",
                         text: accessibilitySnapshot,
@@ -426,10 +434,6 @@ export const browserScrollTo = defineTool({
             const accessibilitySnapshot = await snapshot(session.page);
             return {
                 content: [
-                    {
-                        type: "text",
-                        text: `Scrolled to position (${params.x}, ${params.y})`,
-                    },
                     {
                         type: "text",
                         text: accessibilitySnapshot,
@@ -449,8 +453,13 @@ export const browserPressKey = defineTool({
     Valid: Press Enter in #search.
     Invalid: Press a key without specifying the key name.`,
     inputSchema: {
-        selector: z.string().describe("The CSS selector of the element to focus.").optional(),
-        key: z.string().describe('Name of the key to press or a character to generate, such as `ArrowLeft` or `a`'),
+        selector: z
+            .string()
+            .describe("The CSS selector of the element to focus.")
+            .optional(),
+        key: z
+            .string()
+            .describe("Name of the key to press or a character to generate, such as `ArrowLeft` or `a`"),
     },
     handle: async (context, params) => {
         const session = context.getSession(params.sessionId);
@@ -465,10 +474,6 @@ export const browserPressKey = defineTool({
             const accessibilitySnapshot = await snapshot(session.page);
             return {
                 content: [
-                    {
-                        type: "text",
-                        text: params.selector ? `Focus on the ${params.selector} and press ${params.key}` : `press ${params.key}`,
-                    },
                     {
                         type: "text",
                         text: accessibilitySnapshot,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scrapeless-mcp-server",
-  "version": "0.4.7",
+  "version": "0.4.8",
   "main": "index.js",
   "type": "module",
   "bin": {

package/build/logs/.8929a066e1e20cab48ddbfa9c509b48984514299-audit.json

@@ -1,15 +0,0 @@
-{
-    "keep": {
-        "days": false,
-        "amount": 5
-    },
-    "auditLog": "logs/.8929a066e1e20cab48ddbfa9c509b48984514299-audit.json",
-    "files": [
-        {
-            "date": 1758002645284,
-            "name": "logs/scrapeless-2025-09-16.log",
-            "hash": "420a4884014fec02915075dd83086ff92cbd6584fe2157bf99056d478c1ce079"
-        }
-    ],
-    "hashType": "sha256"
-}

package/build/tools/deepserp/googleFlights.js

@@ -1,209 +0,0 @@
-import { defineTool, wrapMcpResponse } from "../utils.js";
-import z from "zod";
-export const googleFlights = defineTool({
-    name: "google_flights",
-    description: `Exclusive Flight Information Query Tool.
-    Activated only when requests include departure city, arrival city, and specific date/date range.
-    Valid:Check flights from Beijing to Shanghai on July 15.
-    Invalid:Compare airline service quality (use google_search instead)`,
-    inputSchema: {
-        gl: z
-            .string()
-            .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).")
-            .default("us"),
-        hl: z
-            .string()
-            .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).")
-            .default("en"),
-        currency: z
-            .union([
-            z.literal("ALL"),
-            z.literal("DZD"),
-            z.literal("ARS"),
-            z.literal("AMD"),
-            z.literal("AWG"),
-            z.literal("AUD"),
-            z.literal("AZN"),
-            z.literal("BSD"),
-            z.literal("BHD"),
-            z.literal("BYN"),
-            z.literal("BMD"),
-            z.literal("BAM"),
-            z.literal("BRL"),
-            z.literal("GBP"),
-            z.literal("BGN"),
-            z.literal("XPF"),
-            z.literal("CAD"),
-            z.literal("CLP"),
-            z.literal("CNY"),
-            z.literal("COP"),
-            z.literal("CRC"),
-            z.literal("CUP"),
-            z.literal("CZK"),
-            z.literal("DKK"),
-            z.literal("DOP"),
-            z.literal("EGP"),
-            z.literal("EUR"),
-            z.literal("GEL"),
-            z.literal("HKD"),
-            z.literal("HUF"),
-            z.literal("ISK"),
-            z.literal("INR"),
-            z.literal("IDR"),
-            z.literal("IRR"),
-            z.literal("ILS"),
-            z.literal("JMD"),
-            z.literal("JPY"),
-            z.literal("JOD"),
-            z.literal("KZT"),
-            z.literal("KWD"),
-            z.literal("LBP"),
-            z.literal("MKD"),
-            z.literal("MYR"),
-            z.literal("MXN"),
-            z.literal("MDL"),
-            z.literal("MAD"),
-            z.literal("TWD"),
-            z.literal("NZD"),
-            z.literal("NOK"),
-            z.literal("OMR"),
-            z.literal("PKR"),
-            z.literal("PAB"),
-            z.literal("PEN"),
-            z.literal("PHP"),
-            z.literal("PLN"),
-            z.literal("QAR"),
-            z.literal("RON"),
-            z.literal("RUB"),
-            z.literal("SAR"),
-            z.literal("RSD"),
-            z.literal("SGD"),
-            z.literal("ZAR"),
-            z.literal("KRW"),
-            z.literal("SEK"),
-            z.literal("CHF"),
-            z.literal("THB"),
-            z.literal("TRY"),
-            z.literal("USD"),
-            z.literal("UAH"),
-            z.literal("AED"),
-            z.literal("VND"),
-        ])
-            .describe("Parameter defines the currency of the returned prices. Default to USD.")
-            .optional(),
-        departure_id: z
-            .string()
-            .describe("Departure airport code or location kgmid. An airport code is an uppercase 3-letter code. You can search for it on Google Flights or IATA. For example, CDG is Paris Charles de Gaulle Airport, /m/0vzm is the location kgmid for Austin.You can specify multiple departure airports by separating them with a comma. For example, CDG,ORY,/m/04jpl.")
-            .default("ORY"),
-        arrival_id: z
-            .string()
-            .describe("An airport code is an uppercase 3-letter code. You can search for it on Google Flights or IATA.")
-            .default("BCN"),
-        data_type: z
-            .number()
-            .describe("Parameter defines the type of the flights.\nAvailable options:\n1 - Round trip (default)\n2 - One way\n3 - Multi-city\n\nWhen this parameter is set to 3, use multi_city_json to set the flight information.\n\nTo obtain the returning flight information for Round Trip (1), you need to make another request using a departure_token.")
-            .default(1),
-        travel_class: z
-            .union([
-            z.literal(1).describe("Economy(default) - 1"),
-            z.literal(2).describe("Premium economy - 2"),
-            z.literal(3).describe("Business - 3"),
-            z.literal(4).describe("First - 4"),
-        ])
-            .describe("Parameter defines the travel class.\nAvailable options:\n1 - Economy (default)\n2 - Premium economy\n3 - Business\n4 - First")
-            .default(1),
-        multi_city_json: z
-            .any()
-            .describe("Parameter defines the flight information for multi-city flights. It's a JSON string containing multiple flight information objects. Each object should contain the following fields: departure_id, arrival_id, date, times (optional). See schema for details.")
-            .optional(),
-        adults: z
-            .number()
-            .describe("Parameter defines the number of adults. Default to 1.")
-            .default(1),
-        children: z
-            .number()
-            .describe("Parameter defines the number of children. Default to 0.")
-            .default(0),
-        infants_in_seat: z
-            .number()
-            .describe("Parameter defines the number of infants in seat. Default to 0.")
-            .default(0),
-        infants_on_lap: z
-            .number()
-            .describe("Parameter defines the number of infants on lap. Default to 0.")
-            .default(0),
-        outbound_date: z
-            .string()
-            .describe("Parameter defines the outbound date. The format is YYYY-MM-DD. e.g. 2025-03-09")
-            .default("next_1d"),
-        return_date: z
-            .string()
-            .describe("Parameter defines the return date. The format is YYYY-MM-DD. e.g. 2025-03-15\n\nParameter is required if type parameter is set to: 1 (Round trip)")
-            .default("next_1w"),
-        stops: z
-            .union([
-            z.literal(0).describe("Any number of stops (default) - 0"),
-            z.literal(1).describe("Nonstop only - 1"),
-            z.literal(2).describe("1 stop or fewer - 2"),
-            z.literal(3).describe("2 stops or fewer - 3"),
-        ])
-            .describe("Parameter defines the number of stops during the flight.\nAvailable options:\n0 - Any number of stops (default)\n1 - Nonstop only\n2 - 1 stop or fewer\n3 - 2 stops or fewer")
-            .default(0),
-        include_airlines: z
-            .string()
-            .describe("Parameter defines the airline codes to be included. Split multiple airlines with comma. It can't be used together with exclude_airlines. Each airline code should be a 2-character IATA code consisting of either two uppercase letters or one uppercase letter and one digit. Alliances can also be included. See schema for details.")
-            .optional()
-            .optional(),
-        bags: z
-            .number()
-            .describe("Parameter defines the number of carry-on bags. Default to 0.")
-            .default(0),
-        max_price: z
-            .number()
-            .describe("Parameter defines the maximum ticket price. Default to unlimited.")
-            .default(0),
-        outbound_times: z
-            .string()
-            .describe("Parameter defines the outbound times range. See schema for details.")
-            .optional()
-            .optional(),
-        return_times: z
-            .string()
-            .describe("Parameter defines the return times range. See schema for details.")
-            .optional()
-            .optional(),
-        emissions: z
-            .union([
-            z.literal(0).describe("reset"),
-            z.literal(1).describe("Less emissions only - ·"),
-        ])
-            .describe("Parameter defines the emission level of the flight.\nAvailable options:\n1 - Less emissions only")
-            .default(0),
-        layover_duration: z
-            .string()
-            .describe("Parameter defines the layover duration, in minutes. It's a string containing two comma-separated numbers. See schema for details.")
-            .optional()
-            .optional(),
-        exclude_conns: z
-            .string()
-            .describe("Parameter defines the connecting airport codes to be excluded. See schema for details.")
-            .optional()
-            .optional(),
-        max_duration: z
-            .number()
-            .describe("Parameter defines the maximum flight duration, in minutes. For example, specify 1500 for 25 hours.")
-            .default(0)
-            .optional(),
-        departure_token: z
-            .string()
-            .describe("Parameter is used to select the flight and get returning flights (for Round trip) or flights for the next leg of itinerary (for Multi-city). Find this token in the departure flight results.")
-            .optional()
-            .optional(),
-    },
-    handle: async (params, client) => {
-        return wrapMcpResponse(() => client.deepserp.scrape({
-            actor: "scraper.google.flights",
-            input: params,
-        }));
-    },
-});

package/build/tools/deepserp/googleScholar.js

@@ -1,74 +0,0 @@
-import { defineTool, wrapMcpResponse } from "../utils.js";
-import z from "zod";
-export const googleScholar = defineTool({
-    name: 'google_scholar',
-    description: `Search for academic papers on Google Scholar.
-    Restrictions: Activated only for academic or scientific research queries.
-    Valid: Find papers by "Yoshua Bengio" on deep learning.
-    Invalid: Search for news articles about "Yoshua Bengio" (use google_search).`,
-    inputSchema: {
-        q: z
-            .string()
-            .describe('Parameter defines the query you want to search. You can also use helpers in your query such as: author:, or source:. Usage of cites parameter makes q optional. Usage of cites together with q triggers search within citing articles. Usage of cluster together with q and cites parameters is prohibited. Use cluster parameter only.')
-            .default('Coffee'),
-        cites: z
-            .string()
-            .describe('Parameter defines unique ID for an article to trigger Cited By searches. Usage of cites will bring up a list of citing documents in Google Scholar. Example value: cites=1275980731835430123. Usage of cites and q parameters triggers search within citing articles.')
-            .optional(),
-        as_ylo: z
-            .string()
-            .describe('Parameter defines the year from which you want the results to be included. (e.g. if you set as_ylo parameter to the year 2018, the results before that year will be omitted.). This parameter can be combined with the as_yhi parameter.')
-            .optional(),
-        as_yhi: z
-            .string()
-            .describe('Parameter defines the year until which you want the results to be included. (e.g. if you set as_yhi parameter to the year 2018, the results after that year will be omitted.). This parameter can be combined with the as_ylo parameter.')
-            .optional(),
-        scisbd: z
-            .string()
-            .describe('Parameter defines articles added in the last year, sorted by date. It can be set to 1 to include only abstracts, or 2 to include everything. The default value is 0 which means that the articles are sorted by relevance.')
-            .optional(),
-        cluster: z.string().describe('Versions Of').optional(),
-        hl: z.string().describe('Language').default('en'),
-        author_id: z.string().describe('Show in google.scholar result').optional(),
-        citation_id: z
-            .string()
-            .describe('Parameter is used for retrieving individual article citation. It is a required parameter when view_op=view_citation is selected. You can access IDs inside our structured JSON response.')
-            .optional(),
-        view_op: z
-            .union([
-            z.literal('view_citation').describe('View Citation'),
-            z.literal('list_colleagues').describe('View List Colleagues')
-        ])
-            .describe('Parameter is used for viewing specific parts of a page. It has two options: view_citation - Select to view citations. citation_id is required. list_colleagues - Select to view all co-authors')
-            .optional(),
-        lr: z.string().describe('Set Multiple Languages').optional(),
-        start: z.string().describe('Result Offset').optional(),
-        num: z.string().describe('Number of Results').optional(),
-        as_sdt: z
-            .union([z.literal('1').describe('Abstracts'), z.literal('2').describe('Everything')])
-            .describe('Search Type / Filter')
-            .optional(),
-        safe: z
-            .union([z.literal('active').describe('Active'), z.literal('off').describe('Off')])
-            .describe('Adult Content Filtering')
-            .optional(),
-        filter: z
-            .union([z.literal('1').describe('On'), z.literal('0').describe('Off')])
-            .describe('Results Filtering')
-            .optional(),
-        as_vis: z
-            .union([z.literal('1').describe('On'), z.literal('0').describe('Off')])
-            .describe('Show Citations')
-            .optional(),
-        as_rr: z
-            .union([z.literal('1').describe('On'), z.literal('0').describe('Off')])
-            .describe('Show Only Review Articles')
-            .optional()
-    },
-    handle: async (params, client) => {
-        return wrapMcpResponse(() => client.deepserp.scrape({
-            actor: 'scraper.google.scholar',
-            input: params
-        }));
-    }
-});