https://github.com/alexmarqs/gramoco-cli
Gramoco CLI App: Easy interactions with the Instagram Graph API. For Business and Creator Accounts.
https://github.com/alexmarqs/gramoco-cli
biome cli instagram instagram-graph-api pkg typescript vitest
Last synced: 7 months ago
JSON representation
Gramoco CLI App: Easy interactions with the Instagram Graph API. For Business and Creator Accounts.
- Host: GitHub
- URL: https://github.com/alexmarqs/gramoco-cli
- Owner: alexmarqs
- License: mit
- Created: 2023-12-23T10:09:21.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2025-02-22T10:43:54.000Z (8 months ago)
- Last Synced: 2025-02-22T11:27:14.405Z (8 months ago)
- Topics: biome, cli, instagram, instagram-graph-api, pkg, typescript, vitest
- Language: TypeScript
- Homepage:
- Size: 437 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 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](https://www.paypal.com/donate/?hosted_button_id=G3GPPS9EB35W4)!
## Tech stack 🤓
- [Node.js](https://nodejs.org/en/) For running JavaScript code
- [Vitest](https://vitest.dev/) For testing
- [TypeScript](https://www.typescriptlang.org/) For type checking
- [ofetch](https://www.npmjs.com/package/ofetch) For making HTTP requests
- [Tsup](https://tsup.egoist.dev) For bundling
- [Tsx](https://www.npmjs.com/package/tsx) To run TypeScript files
- [Pkg](https://github.com/vercel/pkg) Package your Node.js project into an executable
- [Inquirer.js](https://www.npmjs.com/package/inquirer) For interactive command line user interfaces
- [Nanospinner](https://www.npmjs.com/package/nanospinner) For loading spinners
- [Biome](https://biomejs.dev) For linting and formatting
- [Zod Config](https://github.com/alexmarqs/zod-config) For loading configuration from several sources using Zod
## Features 🚀
- [x] Extract Instagram posts summary from your account to a Excel file
- [x] 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!**](https://github.com/alexmarqs/gramoco-cli/issues)
## Download 📥
You can download the latest version in the [releases page](https://github.com/alexmarqs/gramoco-cli/releases) 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](./SETUP.md) file.