Skip to content

Gramoco CLI App: Easy interactions with the Instagram Graph API. For Business and Creator Accounts.

License

Notifications You must be signed in to change notification settings

alexmarqs/gramoco-cli

Repository files navigation

Gramoco CLI 📸

Easy interactions with the Instagram Graph API. For Business and Creator Accounts.

Purpose 🎯

A friend of mine needed help extracting data from his Instagram account. He mainly wanted to get the comments from a post into an Excel file. I thought, why not make a CLI app for this? It could be useful for him and others needing to do the same thing. So, here's what I ended up creating.

Donations 💰

If you like this project and you want to support it, you can do it through PayPal!

Tech stack 🤓

  • Node.js For running JavaScript code
  • Vitest For testing
  • TypeScript For type checking
  • ofetch For making HTTP requests
  • Tsup For bundling
  • Tsx To run TypeScript files
  • Pkg Package your Node.js project into an executable
  • Inquirer.js For interactive command line user interfaces
  • Nanospinner For loading spinners
  • Biome For linting and formatting
  • Zod Config For loading configuration from several sources using Zod

Features 🚀

  • Extract Instagram posts summary from your account to a Excel file
  • Extract Instagram comments from a post via Media ID to a Excel file (the Media ID can be found in the post information retrieved by the previous action)
  • Do you have any request? Please open an issue!

Download 📥

You can download the latest version in the releases page for your operating system. In alternative, you can clone this repository and build the project yourself and then install it globally (advanced/developer users).

How to use / Instructions 📖

In the downloaded zip folder you will find the executable file and a config file gramoco.config.json. In the config file you will need to fill in the following properties: INSTAGRAM_ACCESS_TOKEN and INSTAGRAM_ACCOUNT_ID. You can find the instructions to get these values in the SETUP.md file.