mashya-instagram-api

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

mashya-instagram-api

★ 54 Open GitHub ↗

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

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# mashya-instagram-api
<p align="center">
<a href="#And ... What's Mashya?"><img width="322" align="center" alt=" github.com/hamid  mashya instagram api" src="https://user-images.githubusercontent.com/1645233/165082744-c247ad88-a223-4ff1-96af-b0d1fbfd12f2.png"></a>
  </p>

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](https://playwright.dev/docs/library) 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 ...)*

---
![mashya-instagram-api](https://user-images.githubusercontent.com/1645233/165092167-acce8887-b5d5-4156-8cd5-4e09278f1243.gif)

# Table of Contents
- [Examples](#examples)
- [Install](#install)
- [Documents](#Docs)
- [debug](#examples)
- [Contribution](#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`

```typescript
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](https://playwright.dev/docs/library)
```sh
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](https://hub.docker.com/_/microsoft-playwright)
```sh
docker pull mcr.microsoft.com/playwright
```
and in your *Dockerfile* 
```Containerfile
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](https://playwright.dev/docs/library#linux)
```sh
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](docs)
```typescript
//-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](docs/account)
  - to controll main action of account, like login,register,edit profile,review home post,review explore post and etc
- [Page](docks/page)
  - any action to other accounts(or pages). like follow, message, get page info,get page last posts and etc
- [Post](docks/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](src/example.ts) for quick view.

## And ... What's Mashya?

<p align="center">
<img width="322" align="center" alt=" github.com/hamid  mashya instagram api" src="https://user-images.githubusercontent.com/1645233/165082744-c247ad88-a223-4ff1-96af-b0d1fbfd12f2.png"></p>
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](https://www.instagram.com/zeinab_hashemii)
##### Painter: [Mohammad Naghashbashi](https://www.instagram.com/mo.rasoulipour)
-------

mashya-instagram-api

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README