Skip to content
Eli Duke edited this page Feb 20, 2024 · 22 revisions


Nokogiri is a simple HTML / XML parser with much of its interface borrowed from Hpricot. It uses libxml2 to parse and search, so it is very fast.


Installation is very easy. Just use the following command:

gem install nokogiri

Quick start to parsing HTML

Parsing HTML is easy, and you can take advantage of CSS selectors or XPath queries to find things in your document:

require 'open-uri'
require 'nokogiri'

# Perform a google search
doc = Nokogiri::HTML(''))

# Print out each link using a CSS selector
doc.css('h3.r > a.l').each do |link|
  puts link.content

Here is an example parsing some HTML and searching it using a combination of CSS selectors and XPath selectors:

require 'nokogiri'

doc = Nokogiri::HTML.parse(<<-eohtml)
    <title>Hello World</title>
    <h1>This is an awesome document</h1>
      I am a paragraph
        <a href="">I am a link</a>

# Search for nodes by css
doc.css('p > a').each do |a_tag|
  puts a_tag.content

# Search for nodes by xpath
doc.xpath('//p/a').each do |a_tag|
  puts a_tag.content

# Or mix and match.'//p/a', 'p > a').each do |a_tag|
  puts a_tag.content

# Find attributes and their values'a').first['href']

Further Information