clean-web-scraper 3.2.1 → 3.2.3

package/README.md

@@ -11,10 +11,10 @@ A powerful Node.js web scraper that extracts clean, readable content from websit
 - 🚫 Excludes unwanted paths from scraping
 - 🔄 Handles relative and absolute URLs like a pro
 - 🎯 No duplicate page visits
-- 📊 Generates JSONL output file for ML training
-- 📊 AI-friendly clean text and csv output (perfect for LLM fine-tuning!)
+- 🤖 AI-friendly output formats (JSONL, CSV, clean text)
 - 📊 Rich metadata extraction
 - 📁 Combine results from multiple scrapers into a unified dataset
+- 🎯 Turn any website into an AI training dataset
 
 ## 🛠️ Prerequisites
 
@@ -58,15 +58,37 @@ const scraper = new WebScraper({
   metadataFields: ['title', 'description']      // Optional: Specify metadata fields to include
 });
 await scraper.start();
-
-// Combine results from multiple scrapers
-await WebScraper.combineResults('./combined-dataset', [scraper1, scraper2]);
 ```
 
 ```bash
 node example-usage.js
 ```
 
+## 💻 Advanced Usage: Multi-Site Scraping
+
+```js
+const WebScraper = require('clean-web-scraper');
+
+// Scrape documentation website
+const docsScraper = new WebScraper({
+  baseURL: 'https://docs.example.com',
+  scrapResultPath: './datasets/docs'
+});
+
+// Scrape blog website
+const blogScraper = new WebScraper({
+  baseURL: 'https://blog.example.com',
+  scrapResultPath: './datasets/blog'
+});
+
+// Start scraping both sites
+await docsScraper.start();
+await blogScraper.start();
+
+// Combine all scraped content into a single dataset
+await WebScraper.combineResults('./combined', [docsScraper, blogScraper]);
+```
+
 ## 📤 Output
 
 Your AI-ready content is saved in a clean, structured format:
@@ -96,11 +118,84 @@ example.com/
 ├── train_with_metadata.jsonl  # When includeMetadata is true
 ├── train.csv             # Clean text in CSV format
 └── train_with_metadata.csv    # When includeMetadata is true
+
+combined/
+├── texts/                # Combined numbered text files
+│   ├── 1.txt
+│   ├── 2.txt
+│   └── n.txt
+├── texts_with_metadata/  # Combined metadata text files
+│   ├── 1.txt
+│   ├── 2.txt
+│   └── n.txt
+├── combined.jsonl        # Combined JSONL content
+├── combined_with_metadata.jsonl
+├── combined.csv         # Combined CSV content
+└── combined_with_metadata.csv
+```
+
+## 📄 Output File Formats
+
+### 📝 Text Files (*.txt)
+
+The actual article content starts here. This is the clean, processed text of the article that was extracted from the webpage
+
+### 📑 Text Files with Metadata (texts_with_metadata/*.txt)
+
+title: My Awesome Page
+description: This is a great article about coding
+author: John Doe
+language: en
+dateScraped: 2024-01-20T10:30:00Z
+
+\-\-\-
+
+The actual article content starts here. This is the clean, processed text of the article that was extracted from the webpage.
+
+### 📊 JSONL Files (train.jsonl)
+
+```json
+{"text": "Clean article content here"}
+{"text": "Another article content here"}
+```
+
+### 📈 JSONL with Metadata (train_with_metadata.jsonl)
+
+```json
+{"text": "Article content", "metadata": {"title": "Page Title", "author": "John Doe"}}
+{"text": "Another article", "metadata": {"title": "Second Page", "author": "Jane Smith"}}
+```
+
+### 🗃️ JSON Files In Website Output  (*.json)
+
+```json
+{
+  "url": "<https://example.com/page>",
+  "title": "Page Title",
+  "description": "Page description",
+  "dateScraped": "2024-01-20T10:30:00Z"
+}
+```
+
+### 📋 CSV Files (train.csv)
+
+```csv
+text
+"Clean article content here"
+"Another article content here"
+```
+
+### 📊 CSV with Metadata (train_with_metadata.csv)
+
+```csv
+text,title,author,description
+"Article content","Page Title","John Doe","Page description"
+"Another article","Second Page","Jane Smith","Another description"
 ```
 
 ## 🤖 AI/LLM Training Ready
 
-The output is specifically formatted for AI training purposes:
+The output is specifically formatted for AI training and fine-tuning purposes:
 
 - Clean, processed text without HTML markup
 - Multiple formats (JSONL, CSV, text files)

package/example-usage.js

@@ -68,5 +68,12 @@ void async function main ()
 
 	// 4
 	// https://electronicintifada.net/
+
+	// 5
+	// https://www.palestineremembered.com/ZionistFAQ.html
+
+	// 6 https://the-palestinian-side.vercel.app/
+
+	// 7 https://stand-with-palestine.org/blogs
 }()
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clean-web-scraper",
-  "version": "3.2.1",
+  "version": "3.2.3",
   "main": "main.js",
   "scripts": {
     "start": "node main.js",

package/src/WebScraper.js

@@ -36,11 +36,11 @@ class WebScraper
 		this.excludeList = new Set( excludeList );
 		this.exactExcludeList = this.normalizeExcludeList( exactExcludeList );
 		this.allProcessedContent = [];
-		this.createOutputDirectory();
 	}
 
 	async start ()
 	{
+		this.createOutputDirectory();
 		await this.fetchPage( this.startURL, 0 );
 		this.createJSONLFile();
 		this.saveNumberedTextFiles();
@@ -384,41 +384,71 @@ class WebScraper
 		const fullOutputPath = path.join( __dirname, outputPath );
 
 		// Create output directories
+		WebScraper.createCombinedDirectories( fullOutputPath );
+
+		// Combine files by type
+		WebScraper.combineJSONLFiles( fullOutputPath, websites );
+		WebScraper.combineCSVFiles( fullOutputPath, websites );
+		WebScraper.combineTextFiles( fullOutputPath, websites );
+	}
+
+	static createCombinedDirectories ( fullOutputPath )
+	{
+		if ( fs.existsSync( fullOutputPath ) )
+		{
+			fs.rmSync( fullOutputPath, { recursive: true, force: true });
+		}
 		fs.mkdirSync( fullOutputPath, { recursive: true });
 		fs.mkdirSync( path.join( fullOutputPath, "texts" ), { recursive: true });
 		fs.mkdirSync( path.join( fullOutputPath, "texts_with_metadata" ), { recursive: true });
+	}
 
-		// Combine regular JSONL files
+	static combineJSONLFiles ( fullOutputPath, websites )
+	{
 		const jsonlOutput = fs.createWriteStream( path.join( fullOutputPath, "combined.jsonl" ) )
-		    .on( "error", ( err ) => { return console.error( "Error combining JSONL:", err ) });
+		.on( "error", ( err ) => { return console.error( "Error combining JSONL:", err ) });
 		const jsonlMetaOutput = fs.createWriteStream( path.join( fullOutputPath, "combined_with_metadata.jsonl" ) )
-		    .on( "error", ( err ) => { return console.error( "Error combining metadata JSONL:", err ) });
+		.on( "error", ( err ) => { return console.error( "Error combining metadata JSONL:", err ) });
+
+		for ( const website of websites )
+		{
+			const jsonlContent = fs.readFileSync( path.join( __dirname, website.jsonlOutputPath ), "utf-8" );
+			jsonlOutput.write( jsonlContent );
+
+			if ( website.includeMetadata )
+			{
+				const jsonlMetaContent = fs.readFileSync( path.join( __dirname, website.jsonlOutputPathWithMeta ), "utf-8" );
+				jsonlMetaOutput.write( jsonlMetaContent );
+			}
+		}
+
+		jsonlOutput.end();
+		jsonlMetaOutput.end();
+	}
+
+	static combineCSVFiles ( fullOutputPath, websites )
+	{
 		const csvOutput = fs.createWriteStream( path.join( fullOutputPath, "combined.csv" ) );
 		const csvMetaOutput = fs.createWriteStream( path.join( fullOutputPath, "combined_with_metadata.csv" ) );
 
 		csvOutput.write( "text\n" );
 		const metadataFields = websites.find( w => { return w.includeMetadata })?.metadataFields || new Set();
+
 		if ( metadataFields.size > 0 )
 		{
 			csvMetaOutput.write( `text,${Array.from( metadataFields ).join( "," )}\n` );
 		}
+
 		for ( const website of websites )
 		{
-			const jsonlContent = fs.readFileSync( path.join( __dirname, website.jsonlOutputPath ), "utf-8" );
-			jsonlOutput.write( jsonlContent );
-
 			const csvContent = fs.readFileSync( path.join( __dirname, website.csvOutputPath ), "utf-8" )
 			.split( "\n" )
 			.slice( 1 )
 			.filter( line => { return line.trim() });
 			csvOutput.write( `${csvContent.join( "\n" )}\n` );
 
-			// Combine metadata files if they exist
 			if ( website.includeMetadata )
 			{
-				const jsonlMetaContent = fs.readFileSync( path.join( __dirname, website.jsonlOutputPathWithMeta ), "utf-8" );
-				jsonlMetaOutput.write( jsonlMetaContent );
-
 				const csvMetaContent = fs.readFileSync( path.join( __dirname, website.csvOutputPathWithMeta ), "utf-8" )
 				.split( "\n" )
 				.slice( 1 )
@@ -427,18 +457,18 @@ class WebScraper
 			}
 		}
 
-		// Close all streams
-		jsonlOutput.end();
-		jsonlMetaOutput.end();
 		csvOutput.end();
 		csvMetaOutput.end();
+	}
 
-		// Combine text files (both regular and metadata versions)
+	static combineTextFiles ( fullOutputPath, websites )
+	{
 		let textFileCounter = 1;
+
 		for ( const website of websites )
 		{
-			// Regular text files
 			const textFiles = fs.readdirSync( path.join( __dirname, website.textOutputPath ) );
+
 			for ( const file of textFiles )
 			{
 				const content = fs.readFileSync( path.join( __dirname, website.textOutputPath, file ), "utf-8" );
@@ -448,7 +478,6 @@ class WebScraper
 					"utf-8"
 				);
 
-				// Metadata text files if they exist
 				if ( website.includeMetadata )
 				{
 					const metaContent = fs.readFileSync(
@@ -465,6 +494,7 @@ class WebScraper
 			}
 		}
 	}
+
 }
 
 module.exports = WebScraper;