GitHunt
PI

pivotus/galerts

Ruby Google Alerts API (work with new google alerts page)

Galerts

Gem Version
Build Status

Simple Ruby library that uses Mechanize to scrape Google Alerts from the google
alerts webpage.

Features

  • List all alerts associated with account.
  • Create new alert for any google domain.
  • Update existing alert.
  • Delete an alert.
  • Find alerts by query, id, data_id, data_id_2, feed_url, domain, language,
    how_many, region, delivery.

Installation

gem install galerts

Example

require 'galerts'

manager = Galerts::Manager.new('example@gmail.com', 'password')

#   List alerts
alerts = manager.alerts
sample_alert = alerts.last

#   Create a new alert for on Google News Turkey in real time delivering alerts
#   via RSS
new_alert = manager.create("my keywords", {
  :frequency => Galerts::RT,
  :domain => 'com.tr',
  :language => "tr",
  :sources => [Galerts::NEWS],
  :how_many => Galerts::ALL_RESULTS,
  :region => "TR",
  :delivery => Galerts::RSS
  }
)

#   Update the query of this alert
sample_alert.query = "updated keyword"
manager.update(sample_alert)

#   Find examples
manager.find_by_query("keyword")
manager.find_by_delivery(Galerts::RSS)
manager.find({query: "keyword", delivery: Galerts::RSS})

#   Delete an alert
manager.delete(sample_alert)

Contribute

I need your contributions to make that work better!

License

This project licensed under MIT.

Languages

Ruby100.0%

Contributors

Created September 17, 2014
Updated September 12, 2023