gdcnb / node-osmosis

Web scraper for NodeJS

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

#Osmosis

HTML/XML parser and web scraper for NodeJS.

##Features

  • Fast: uses libxml C bindings
  • Lightweight: no dependencies like jQuery, cheerio, or jsdom
  • Clean: promise based interface- no more nested callbacks
  • Flexible: supports both CSS and XPath selectors
  • Predictable: same input, same output, same order
  • Detailed logging for every step
  • Easy debugging with built-in stack size and memory usage reporting

###Coming soon:

DOM support with the ability to run scripts and CSS without a headless browser. Scripting support will allow Osmosis to access dynamically generated content. CSS support will allow Osmosis to access background-image, element size, colors, etc.

##Example: scrape all craigslist listings

var osmosis = require('osmosis');

osmosis
.get('www.craigslist.org/about/sites') 
.find('h1 + div a')
.set('location')
.follow('@href')
.find('header + div + div li > a')
.set('category')
.follow('@href')
.find('p > a', '.totallink + a.button.next:first')
.follow('@href')
.set({
    'title':        'section > h2',
    'description':  '#postingbody',
    'subcategory':  'div.breadbox > span[4]',
    'date':         'time@datetime',
    'latitude':     '#map@data-latitude',
    'longitude':    '#map@data-longitude',
    'images[]':     'img@src'
})
.data(function(listing) {
    // do something with listing data
})

##Install

npm install osmosis

##Documentation

For documentation and examples check out https://github.com/rc0x03/node-osmosis/wiki

##Dependencies

About

Web scraper for NodeJS


Languages

Language:JavaScript 100.0%