Turn unstructured HTML pages into structured data. The OpenScraping library can extract information from HTML pages using a JSON config file with xPath rules. It can scrape even multi-level complex objects such as tables and forum posts.
This library is used in production to scrape thousands of pages.
The latest NuGet package is only compatible with .Net Core 2.0 projects. If your project uses .Net Framework, please use version 0.0.5 of the package.
Create a new console C# project, then install the OpenScraping NuGet package by using the GUI or by using this command in the Package Manager Console:
Install-Package OpenScrapingThen paste and run the following code:
namespace OpenScrapingTest
{
using System;
using Newtonsoft.Json;
using OpenScraping;
using OpenScraping.Config;
class Program
{
static void Main(string[] args)
{
var configJson = @"
{
'title': '//h1',
'body': '//div[contains(@class, \'article\')]'
}
";
var config = StructuredDataConfig.ParseJsonString(configJson);
var html = "<html><body><h1>Article title</h1><div class='article'>Article contents</div></body></html>";
var openScraping = new StructuredDataExtractor(config);
var scrapingResults = openScraping.Extract(html);
Console.WriteLine(scrapingResults["title"]);
Console.WriteLine("----------------------------");
Console.WriteLine(JsonConvert.SerializeObject(scrapingResults, Formatting.Indented));
Console.ReadKey();
}
}
}The output looks like this:
Article title
----------------------------
{
"title": "Article title",
"body": "Article contents"
}
Below is a simple configuration file that extracts an article from a www.bbc.com page.
{
"title": "//div[contains(@class, 'story-body')]//h1",
"dateTime": "//div[contains(@class, 'story-body')]//div[contains(@class, 'date')]",
"body": "//div[@property='articleBody']"
}Here is how to call the library:
// www.bbc.com.json contains the JSON configuration file pasted above
var jsonConfig = File.ReadAllText(@"www.bbc.com.json");
var config = StructuredDataConfig.ParseJsonString(jsonConfig);
var html = File.ReadAllText(@"www.bbc.com.html", Encoding.UTF8);
var openScraping = new StructuredDataExtractor(config);
var scrapingResults = openScraping.Extract(html);
Console.WriteLine(JsonConvert.SerializeObject(scrapingResults, Formatting.Indented));And here is the result for a bbc news article:
{
title: 'Robert Downey Jr pardoned for 20-year-old drug conviction',
dateTime: '24 December 2015',
body: 'Body of the article is shown here'
}Here is how the www.bbc.com page looked like on the day we saved the HTML for this sample:
The sample configuration below is more complex as it demonstrates support for extracting multiple items at the same time, and running transformations on them. For this example we are using a products page from ikea.com.
{
"products":
{
"_xpath": "//div[@id='productLists']//div[starts-with(@id, 'item_')]",
"title": ".//div[contains(@class, 'productTitle')]",
"description": ".//div[contains(@class, 'productDesp')]",
"price":
{
"_xpath": ".//div[contains(@class, 'price')]/text()[1]",
"_transformations": [
"TrimTransformation"
]
}
}
}Here is a snippet of the result:
{
products: [{
title: 'HEMNES',
description: 'coffee table',
price: '$139.00'
},
...
{
title: 'NORDEN',
description: 'sideboard',
price: '$149.00'
},
{
title: 'SANDHAUG',
description: 'tray table',
price: '$79.99'
}]
}Here is how the www.ikea.com page looked like on the day we saved the HTML for this sample:
You can find more complex examples in the unit tests.
In the Ikea example above we used a transformation called TrimTransformation. Transformation modify the raw extracted HTML nodes in some ways. For instance, TrimTransformation just runs String.Trim() on the extracted text before it gets written to the JSON output.
Here are a few of the built-in transformations:
| Name | Purpose | Example |
|---|---|---|
| AbbreviatedIntegerTranformation | Converts strings like "9k" to the integer 9,000, or "2m" to 2,000,000, or "5B" to 5,000,000,000. | Here |
| CastToIntegerTransformation | Converts strings to the corresponding integer. For example, converts "12450" to the integer 12,450. | Here |
| ExtractIntegerTransformation | Tries to find an integer in the middle of a string. For instance, for the string "Popularity: 1000 views" it extracts the integer 1,000. Note that if the string would have a comma after the 1, it would just extract 1 as the integer. | Here |
| ListTitleTransformation | Tries to find the "title" of the current unordered or ordered HTML list by looking for some text just above the list. | Here |
| RemoveExtraWhitespaceTransformation | Replaces consecutive spaces with a single space. For the string "hello world" it would return "hello world". | Here |
| SplitTransformation | Splits the string into an array based on a separator. | Here |
| TotalTextLengthAboveListTransformation | Tries to determine the length of the text which is above an unordered or ordered HTML list. | Here |
| TrimTransformation | Runs String.Trim() on the extracted text before it gets written to the JSON output. |