https://github.com/zapnap/serpentor

Simple SERP / search engine keyword rank checker
https://github.com/zapnap/serpentor

Last synced: about 2 months ago
JSON representation

Simple SERP / search engine keyword rank checker

• Host: GitHub
• URL: https://github.com/zapnap/serpentor
• Owner: zapnap
• License: mit
• Created: 2015-10-26T20:15:10.000Z (about 9 years ago)
• Default Branch: master
• Last Pushed: 2015-10-27T15:34:13.000Z (about 9 years ago)
• Last Synced: 2024-10-03T13:06:37.918Z (3 months ago)
• Language: Ruby
• Homepage:
• Size: 180 KB
• Stars: 2
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
# Serpentor

Simple utility to check search engine result rankings for a given set of keywords.

Right now only Google search is supported.

## Installation

Add this line to your application's Gemfile:

```ruby

gem 'serpentor'

```

And then execute:

    $ bundle

Or install it yourself as:

    $ gem install serpentor

## Usage

Run an individual keyword test:

```ruby

rank = Serpentor::Rank.check('SOSV', 'sosv.com')

puts "Rank is #{rank.value} (#{rank.url})"

```

Or configure a bulk keyword test:

```ruby

config = Serpentor.configure do |config|

  config.keywords = ["keyword1", "keyword2"]

  config.host = "my-site.com"

  config.limit = 10 # only care if result is on first page

end

results = Serpentor.rank

results.each do |res|

  puts "Rank for '#{res.keyword}' is #{res.rank || 'N/A'} (#{res.url})"

end

```

The first 5 pages (50 results) are checked by default. You can further limit

that number, for example, if you only care about first page results.

## Contributing

1. Fork it ( https://github.com/[my-github-username]/serpentor/fork )

2. Create your feature branch (`git checkout -b my-new-feature`)

3. Commit your changes (`git commit -am 'Add some feature'`)

4. Push to the branch (`git push origin my-new-feature`)

5. Create a new Pull Request