botinsta 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 6aaa7af1d1799524017bfd68e099f63b940b8f99d7c5a39d1bf105c351419cdb
+  data.tar.gz: 8d38665b27b5a6aa1af0edfe34fc0f1129afe67682290ce8225e852c375f48ad
+SHA512:
+  metadata.gz: 5876356f6bd056b4ed0e6ba5109ecd1cc70ac166186dc3be7bfaee94f9f50b2e214d256d2aafd9cdccd584ed9d1c47999b3fb0ca3a24abccbeb07476a7d034d0
+  data.tar.gz: 28fbf4d409672370fce4d796fcac09e0d45c0cfc024ff7318d13299599647c870c9a8f7c79987b824c2bd384fa833f87800373d8aee30218fdb9a7ccbb637596

data/.gitignore

@@ -0,0 +1,16 @@
+/.bundle/
+/.yardoc
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+example/actions_db.db
+example/test.rb
+.idea/
+Gemfile.lock
+*.gem
+
+# rspec failure tracking
+.rspec_status

data/.rspec

@@ -0,0 +1,3 @@
+--format documentation
+--color
+--require spec_helper

data/.travis.yml

@@ -0,0 +1,7 @@
+---
+sudo: false
+language: ruby
+cache: bundler
+rvm:
+  - 2.5.1
+before_install: gem install bundler -v 1.16.5

data/Gemfile

@@ -0,0 +1,3 @@
+source "https://rubygems.org"
+
+gemspec

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2018 andreyuhai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,117 @@
+# Botinsta [![Build Status](https://travis-ci.com/andreyuhai/botinsta.svg?branch=master)](https://travis-ci.com/andreyuhai/botinsta) [![Gem Version](https://badge.fury.io/rb/botinsta.svg)](https://badge.fury.io/rb/botinsta)
+
+## Description
+
+This is a **tag-based Instagram bot** I've created under the influence of other cool Instagram bots [instabot.py](https://github.com/instabot-py) and [instabot.rb](https://github.com/eVanilla/instabot.rb/) to improve my Ruby skills.
+
+#### What do you mean tag-based?!
+
+Well, tag-based means that the bot works based on solely the tags you specified. You specify the tags you want the bot to like medias and follow users from and it loops through all tags liking a number of medias specified by you and also following the owners of medias it liked. See [how it works](#usage--how-it-works)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'botinsta'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install botinsta
+
+## Features
+
+  * Follow
+  * Like
+  * Unfollow people followed after a day. Creates a local database for that.
+  * Avoid liking blacklisted tags
+
+## Features to come
+
+  * Comments
+  * Unlike medias
+  * Avoid following blacklisted users
+
+I am still not sure what else to add but if you have any idea don't hesitate to hit me up or send me a pull request!
+
+## Usage & How it works
+
+You can use the bot simply like below. It already has default parameters so you could just input your `username` and `password` and let it use the defaults for the rest.
+
+```ruby
+require 'botinsta'
+
+bot = Botinsta.new ({ username: 'YOUR_USERNAME',
+                      password: 'YOUR_PASSWORD',
+                      tags:              ['photography','vsco','fotografia'],
+                      tag_blacklist:     ['nsfw','sexy','hot'],
+                      likes_per_tag:     20,
+                      unfollows_per_run: 200,
+                      follows_per_tag:   10
+})
+
+bot.start
+```
+
+The bot loops through each tag liking as many images as `@likes_per_tag` and following as many users as `@follows_per_tag`.
+
+Liking medias and following users from the tag's first page is easy because all you have to do is:
+
+    https://instagram.com/explore/tags/YOURTAG/?__a=1
+
+to navigate to above link and get the JSON string then parse it accordingly
+to extract necessary information (i.e. media ID, owner ID).
+
+It gets complicated when you liked all the medias on the first page and need to get the next page—with next page I am referring to when you scroll down the page to load more content—to continue extracting data, liking medias & following users. So we can do the same with a `GET` request instead since we are using `Mechanize` for automation.
+
+To get the next page you need two things:
+
+  * query\_id (query\_hash)
+  * end\_cursor
+
+which will be used in GET requests to get the JSON string for the next page.
+
+An example of the link:
+
+    https://www.instagram.com/graphql/query/?query_hash=1780c1b186e2c37de9f7da95ce41bb67&variables={"tag_name":"photography","first":4,"after":"AQAiksCP1Uzk5-bXZ3qnwUsA89YRn1LBia9_yDFeWm5S1KTfzyU8eH8EFjq8LPuFOemdkRjzWb8_5vmyQ8Gnj-sTCfVGwRHs8WoKhPtBncmLbg"}
+
+As you can see we need to provide the query\_id (query\_hash) and end\_cursor (the same as `after`) in the link.
+
+We get the above parameters with the help of methods in the module [Pages]() below:
+
+## Documentation
+
+  * [Documentation](https://www.rubydoc.info/github/andreyuhai/botinsta/master) 
+
+I will eventually complete all method descriptions and usages. You can help me if you would like to!
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Gems used
+
+  * Colorize
+  * Hashie
+  * Json
+  * Mechanize
+  * Nokogiri
+  * Sequel
+  * Sqlite3
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/andreyuhai/botinsta.
+
+If you like the bot and want to see the new features very soon, please do not forget to star the repo to let me now you are interested. Boost me!  :rocket:  :blush:
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,6 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require 'bundler/setup'
+require 'botinsta'
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/botinsta.gemspec

@@ -0,0 +1,33 @@
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'botinsta/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'botinsta'
+  spec.version       = Botinsta::VERSION
+  spec.authors       = ['andreyuhai']
+  spec.email         = ['yuhai.ndre@gmail.com']
+
+  spec.summary       = 'Ruby Instagram bot'
+  spec.description   = 'A tag-based Instagram bot which works without using any Instagram API.'
+  spec.homepage      = 'https://github.com/andreyuhai/botinsta'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files`.split("\n")
+  spec.bindir        = 'exe'
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ['lib']
+
+  spec.add_runtime_dependency 'colorize',     ['~> 0.8.1']
+  spec.add_runtime_dependency 'hashie',       ['~> 3.6']
+  spec.add_runtime_dependency 'mechanize',    ['~> 2.7', '>= 2.7.6']
+  spec.add_runtime_dependency 'nokogiri',     ['~> 1.8', '>= 1.8.4']
+  spec.add_runtime_dependency 'pry',          ['~> 0.11.3']
+  spec.add_runtime_dependency 'rb-readline',  ['~> 0.5.5']
+  spec.add_runtime_dependency 'sequel',       ['~> 5.12']
+  spec.add_runtime_dependency 'sqlite3',      ['~> 1.3', '>= 1.3.13']
+
+  spec.add_development_dependency 'bundler', '~> 1.16'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec', '~> 3.0'
+end

data/example/example.rb

@@ -0,0 +1,12 @@
+require 'botinsta'
+
+bot = Botinsta.new ({ username: 'YOUR_USERNAME',
+                      password: 'YOUR_PASSWORD',
+                      tags:              ['photography','vsco','b&w'],
+                      likes_per_tag:     60,
+                      tag_blacklist:     ['nsfw','sexy','hot'],
+                      unfollows_per_run: 200,
+                      follows_per_tag:   10
+})
+
+bot.start

data/lib/botinsta.rb

@@ -0,0 +1,56 @@
+require 'colorize'
+require 'hashie'
+require 'json'
+require 'mechanize'
+require 'sequel'
+require 'sqlite3'
+require 'nokogiri'
+
+require_relative 'botinsta/class_methods'
+
+# This is our main class from which we will be
+# instantiating our bot.
+class Botinsta
+
+  include ClassMethods
+
+  DEFAULT_PARAMETERS = { tags:              %w[photography fotografia vsco],
+                         tag_blacklist:     %w[nsfw hot sexy],
+                         user_blacklist:    [],
+                         likes_per_tag:     10,
+                         unfollows_per_run: 200,
+                         follows_per_tag:   50
+  }.freeze
+
+  def initialize(**params)
+
+    params = DEFAULT_PARAMETERS.merge(params)
+
+    @username           = params[:username]
+    @password           = params[:password]
+    @tags               = params[:tags]
+    @tag_blacklist      = params[:tag_blacklist]
+    @user_blacklist     = params[:user_blacklist]
+    @likes_per_tag      = params[:likes_per_tag]
+    @follows_per_tag    = params[:follows_per_tag]
+    @unfollows_per_run  = params[:unfollows_per_run]
+
+    @total_likes        = 0
+    @total_follows      = 0
+    @total_unfollows    = 0
+
+    @agent = Mechanize.new
+
+    handle_database_creation
+    return if @table_follows.empty?
+
+    @first_db_entry = @table_follows.first
+    @last_follow_time = @table_follows.first[:follow_time]
+  end
+
+  def start
+    login
+    tag_based_mode
+    logout
+  end
+end

data/lib/botinsta/actions.rb

@@ -0,0 +1,108 @@
+# Various actions you can do on Instagram
+# and other related methods.
+module Actions
+
+  # Likes media given by media id.
+  #
+  # @param media_id [String]
+  # @return [true, false] returns true on success, false otherwise.
+  def like_media(media_id)
+    url_like = "https://www.instagram.com/web/likes/#{media_id}/like/"
+    print_try_message(action: :like, data: media_id)
+    begin
+      set_request_params
+      response = @agent.post url_like, @params, @request_headers
+    rescue Mechanize::ResponseCodeError
+      return false
+    end
+    response_data = JSON.parse(response.body)
+    response.code == '200' && response_data['status'] == 'ok' ? true : false
+  end
+
+  # Unlikes media given by media id.
+  #
+  # @param media_id [String]
+  # @return (see #like_media)
+  def unlike_media(media_id)
+    url_unlike = "https://www.instagram.com/web/likes/#{media_id}/unlike/"
+    print_try_message(action: :unlike, data: media_id)
+    begin
+      set_request_params
+      response = @agent.post url_unlike, @params, @request_headers
+    rescue Mechanize::ResponseCodeError
+      return false
+    end
+    response_data = JSON.parse(response.body)
+    response.code == '200' && response_data['status'] == 'ok' ? true : false
+  end
+
+  # Follows user given by user_id.
+  #
+  # @param user_id [String]
+  # @return (see #like_media)
+  def follow_user(user_id)
+    url_follow = "https://www.instagram.com/web/friendships/#{user_id}/follow/"
+    print_try_message(action: :follow, data: user_id)
+    begin
+      set_request_params
+      response = @agent.post url_follow, @params, @request_headers
+    rescue Mechanize::ResponseCodeError
+      return false
+    end
+    response_data = JSON.parse(response.body)
+    response.code == '200' && response_data['result'] == 'following' ? true : false
+  end
+
+  # Unfollows user given by user_id.
+  #
+  # @param user_id [String]
+  # @return (see #like_media)
+  def unfollow_user(user_id)
+    url_unfollow = "https://www.instagram.com/web/friendships/#{user_id}/unfollow/"
+    print_try_message(action: :unfollow, data: user_id)
+    begin
+      set_request_params
+      response = @agent.post url_unfollow, @params, @request_headers
+    rescue Mechanize::ResponseCodeError
+      return false
+    end
+    response_data = JSON.parse(response.body)
+    response.code == '200' && response_data['status'] == 'ok' ? true : false
+  end
+
+  # Likes the media if it doesn't exist in the database.
+  #
+  # @param media [MediaData] a MediaData instance.
+  # @return (see #like_media)
+  def like_if_not_in_db(media)
+    return false if media.exists_in_db?(@table_likes)
+
+    if like_media(media.id)
+      @total_likes += 1
+      print_success_message(action: :like, number: @total_likes, data: @media.id)
+      media.insert_into_db(@table_likes)
+      sleep_rand(28, 36)
+      true
+    else
+      false
+    end
+  end
+
+  # Follows the user if it doesn't exist in the database.
+  #
+  # @param user [UserData] a UserData instance.
+  # @return (see #like_media)
+  def follow_if_not_in_db(user)
+    return false if user.exists_in_db?(@table_follows)
+
+    if follow_user(user.id)
+      @total_follows += 1
+      print_success_message(action: :follow, number: @total_follows, data: @user.username)
+      user.insert_into_db(@table_follows)
+      sleep_rand(28, 36)
+      true
+    else
+      false
+    end
+  end
+end

data/lib/botinsta/class_methods.rb

@@ -0,0 +1,21 @@
+require_relative 'actions'
+require_relative 'data/media_data'
+require_relative 'data/user_data'
+require_relative 'data/page_data'
+require_relative 'helpers'
+require_relative 'login'
+require_relative 'modes'
+require_relative 'pages'
+require_relative 'requests'
+
+
+module ClassMethods
+
+  include Actions
+  include Helpers
+  include Login
+  include Modes
+  include Pages
+  include Requests
+
+end