README.md

mashya-instagram-api

NodeJS Instagram API.it's like bot that simulate main instagram action like login, register, post, story, like, follow and etc.

This bot makes a full simulation to do not detect by instagram as robot. it uses Playwright under the hood for simulation.

This instgram bot consists of these below method:

• Account
  • register
  • login
  • edit profile
  • review home post
  • add new post
  • add new story
• Page
  • follow
  • get page info
• Post
  • like
  • comment

( and to be developing ...)

---

Table of Contents

• Examples
• Install
• Documents
• debug
• Contribution

Examples

Note for JavaScript users: As of Node v.13.5.0, there isn't support for ESModules and the 'import'-syntax. So you have to read the imports in the examples like this:

import A from 'b' ➡ const { A } = require('b').default

import MashyaInstagramBot from 'mashya-instagram-api';
// or
const MashyaInstagramBot = require('mashya-instagram-api').default;


(async () => {

    //-1) Setup individual bot for a acoount
    var bot = new MashyaInstagramBot({
        botName: "myinsta",
        isDevelopment: true,
        logScreenshot:true,  //-** for PRODUCTION enviroments or non GUI os , you should set this options `true`
        log:true,
    });
    await bot.start()
    
    //-2) Login acoount into created bot
    await bot.account.login({
        uname       : "username",
        password    : "pass"
    });

    //-3) and now your bot at your services sir!
    

    //-- Review Home post
     await bot.account.reviewHome({
         postReviewCount     : 10,
         onPostReview        : async (targetPost)=>{
             // console.log('Post Review ...', targetPost);
             await targetPost.comment("Hello... " + targetPost.owner);
         }
     });
     
    //-- load  and follow page
    await bot.page.Follow("meta");


    //-- Comment & like
     let targetPost = await bot.post.loadPostByUrl("https://www.instagram.com/p/CVTtCZotdJX/");
     await targetPost.like();
     await targetPost.comment("Hi friend...");


})();

Install

Playwright requires Node.js version 12 or above

Mac and Windows

Requires 10.14 (Mojave) or above.

1. First you should install Playwright

npm i -D playwright

2. and then install the package from npm

npm install mashya-instagram-api

Install and run in Linux

using Docker

We offer using a official Playwright Docker image

docker pull mcr.microsoft.com/playwright

and in your Dockerfile

FROM mcr.microsoft.com/playwright:bionic
...
npm install mashya-instagram-api

or Install dependencies

If you don't want use Docker, depending on your Linux distribution, you might need to install additional dependencies to run the bots.see playwright install

npx playwright install --with-deps chromium
npm install mashya-instagram-api

Docs

Before run any command you should create and start a bot. each bot should manage one account. for building a bot and see available options see Bot docs

//-1) Setup individual bot for a acoount
    var bot = new MashyaInstagramBot({
        botName: "myinsta",
        isDevelopment: true, //-** for PRODUCTION enviroments or non GUI os , you should set this options `false`
        logScreenshot:true, 
        log:true,
        //.. see other options in bot docs page
    });

After create successfully the bot, you could all run available commands. these commands divided into below master actions.

• Account
  • to controll main action of account, like login,register,edit profile,review home post,review explore post and etc
• Page
  • any action to other accounts(or pages). like follow, message, get page info,get page last posts and etc
• Post
  • any action to individual post,these actions include: like, comment and etc.the post may belong to your account or any other pages account.

You could see example file for quick view.

And ... What's Mashya?

According to persian mythology, Mashya and Mashyana were the first man and woman whose procreation gave rise to the human race based on Zoroastrian cosmology. Based on Bundahishn, When Ahriman (devil) invaded the world of AhuraMazda, Kiomars were killed by evil spirits. Kiomars fell into his left hand at his death, and sperm came out of him. The sperm of Kiomars remained on the earth for forty years. And in forty years, with the shape of a one-stemed Rivas-plant, Mashya and Mashyana grew up from the earth. They were so connected together that it was not clear which is the male and which the female. They learned farming, lighting fire, and milking goats from angels. They did not have sex for fifty years, and sexual desire awoke in them after this time. From them was born in nine month a pair, and owing to tenderness for offspring the mother devoured one, and the father one. AhuraMazda took this tenderness away, so that one may nourish a child. After that, seven pairs of male and female offspring emerged from them, who are believed to be the human race's ancestors.

---

Research: Zeinab hashemii

Painter: Mohammad Naghashbashi

---