[components] Scrapeless - new actions

- Introduced a new README.md for Scrapeless, outlining its features and getting started guide.
- Implemented multiple Scrapeless actions inclues `Crawler`, `Scraping API`, and `Universal Scraping API`.

Author: joy-chanboop

components/scrapeless/README.md

@@ -0,0 +1,16 @@
+# Overview
+
+Scrapeless – your go-to platform for powerful, compliant web data extraction. With tools like Universal Scraping API, Scrapeless makes it easy to access and gather data from complex sites. Focus on insights while we handle the technical hurdles. Scrapeless – data extraction made simple.
+
+# Example Use Cases
+
+1. **Scraping API**: Endpoints for fresh, structured data from 100+ popular sites.
+2. **Universal Scraping API**: Access any website at scale and say goodbye to blocks.
+3. **Crawler**: Extract data from single pages or traverse entire domains.
+
+# Getting Started
+
+## Generating an API Key
+
+1. If you are not a member of Scrapeless, you can sign up for a free account at [Scrapeless](https://app.scrapeless.com/passport/register).
+2. Once registered, you can go to the API Key Management page to generate an API Key in the app settings.

components/scrapeless/actions/crawler/crawler.mjs

@@ -0,0 +1,84 @@
+import scrapeless from "../../scrapeless.app.mjs";
+
+export default {
+  key: "crawler-api",
+  name: "Crawler",
+  description: "Crawl any website at scale and say goodbye to blocks.",
+  version: "0.0.1",
+  type: "action",
+  props: {
+    scrapeless,
+    apiServer: {
+      type: "string",
+      label: "Please select a API server",
+      default: 'crawl',
+      options: [
+        {
+          label: "Crawl",
+          value: 'crawl'
+        },
+        {
+          label: "Scrape",
+          value: 'scrape'
+        }
+      ],
+      reloadProps: true,
+    },
+  },
+  async run({ $ }) {
+    const { apiServer, ...rest } = this;
+
+    if (apiServer === 'crawl') {
+      const submitData = {
+        limit: rest.limitCrawlPages,
+        url: rest.url,
+      }
+      const response = await this.scrapeless.crawlerCrawl({
+        $,
+        submitData,
+        ...rest,
+      });
+
+      $.export("$summary", `Successfully retrieved crawling results for ${rest.url}`);
+      return response;
+    }
+
+    if (apiServer === 'scrape') {
+      const submitData = {
+        url: rest.url,
+      }
+      const response = await this.scrapeless.crawlerScrape({
+        $,
+        submitData,
+        ...rest,
+      });
+
+      $.export("$summary", `Successfully retrieved scraping results for ${rest.url}`);
+      return response;
+    }
+  },
+  async additionalProps() {
+    const { apiServer } = this;
+
+    const props = {};
+
+    if (apiServer === 'crawl' || apiServer === 'scrape') {
+      props.url = {
+        type: "string",
+        label: "URL to Crawl",
+        description: "If you want to crawl in batches, please refer to the SDK of the document",
+      }
+    }
+
+    if (apiServer === 'crawl') {
+      props.limitCrawlPages = {
+        type: "integer",
+        label: "Number Of Subpages",
+        default: 5,
+        description: "Max number of results to return",
+      }
+    }
+
+    return props;
+  }
+}

components/scrapeless/actions/scraping-api/scraping-api.mjs

@@ -0,0 +1,76 @@
+import scrapeless from "../../scrapeless.app.mjs";
+
+export default {
+  key: "scrapeless-scraping-api",
+  name: "Scraping API",
+  description: "Endpoints for fresh, structured data from 100+ popular sites.",
+  version: "0.0.1",
+  type: "action",
+  props: {
+    scrapeless,
+    apiServer: {
+      type: "string",
+      label: "Please select a API server",
+      default: 'googleSearch',
+      options: [
+        {
+          label: "Google Search",
+          value: 'googleSearch'
+        }
+      ],
+      reloadProps: true,
+    },
+  },
+  async run({ $ }) {
+    const { apiServer, ...rest } = this;
+
+    if (apiServer === 'googleSearch') {
+      const submitData = {
+        actor: 'scraper.google.search',
+        input: {
+          q: rest.q,
+          hl: rest.hl,
+          gl: rest.gl,
+        }
+      }
+      const response = await this.scrapeless.scrapingApi({
+        $,
+        submitData,
+        ...rest,
+      });
+
+      $.export("$summary", `Successfully retrieved scraping results for Google Search`);
+      return response;
+    }
+  },
+  async additionalProps() {
+    const { apiServer } = this;
+
+    const props = {};
+
+    if (apiServer === 'googleSearch') {
+      props.q = {
+        type: "string",
+        label: "Search Query",
+        description: "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.",
+        default: "coffee"
+      }
+
+      props.hl = {
+        type: "string",
+        label: "Language",
+        description: "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"
+      }
+
+      props.gl = {
+        type: "string",
+        label: "Country",
+        description: "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"
+      }
+    }
+
+    return props;
+  }
+}

components/scrapeless/actions/universal-scraping-api/universal-scraping-api.mjs

@@ -0,0 +1,87 @@
+import scrapeless from "../../scrapeless.app.mjs";
+import { countryOptions } from "../../common/constants.mjs";
+
+export default {
+  key: "scrapeless-universal-scraping-api",
+  name: "Universal Scraping API",
+  description: "Access any website at scale and say goodbye to blocks.",
+  version: "0.0.1",
+  type: "action",
+  props: {
+    scrapeless,
+    apiServer: {
+      type: "string",
+      label: "Please select a API server",
+      default: 'webUnlocker',
+      options: [
+        {
+          label: "Web Unlocker",
+          value: 'webUnlocker'
+        }
+      ],
+      reloadProps: true,
+    },
+  },
+  async run({ $ }) {
+    const { apiServer, ...rest } = this;
+
+    if (apiServer === 'webUnlocker') {
+      const submitData = {
+        actor: 'unlocker.webunlocker',
+        input: {
+          url: rest.url,
+          jsRender: rest.jsRender,
+          headless: rest.headless,
+        },
+        proxy: {
+          country: rest.country,
+        }
+      }
+      const response = await this.scrapeless.universalScrapingApi({
+        $,
+        submitData,
+        ...rest,
+      });
+
+      $.export("$summary", `Successfully retrieved scraping results for Web Unlocker`);
+      return response;
+    }
+  },
+  async additionalProps() {
+    const { apiServer } = this;
+
+    const props = {};
+
+    if (apiServer === 'webUnlocker') {
+      props.url = {
+        type: "string",
+        label: "Target URL",
+        description: "Parameter defines the URL you want to scrape.",
+      }
+
+      props.jsRender = {
+        type: "boolean",
+        label: "Js Render",
+        default: true,
+      }
+
+      props.headless = {
+        type: "boolean",
+        label: "Headless",
+        default: true,
+      }
+
+      props.country = {
+        type: "string",
+        label: "Country",
+        default: "ANY",
+        options: countryOptions.map((country) => ({
+          label: country.label,
+          value: country.value,
+        }))
+      }
+    }
+
+    return props;
+  }
+}