{"id":26317198,"url":"https://github.com/alexmarqs/gramoco-cli","last_synced_at":"2025-03-15T13:18:45.276Z","repository":{"id":213826102,"uuid":"735002088","full_name":"alexmarqs/gramoco-cli","owner":"alexmarqs","description":"Gramoco CLI App: Easy interactions with the Instagram Graph API. For Business and Creator Accounts.","archived":false,"fork":false,"pushed_at":"2025-02-22T10:43:54.000Z","size":447,"stargazers_count":1,"open_issues_count":2,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-22T11:27:14.405Z","etag":null,"topics":["biome","cli","instagram","instagram-graph-api","pkg","typescript","vitest"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alexmarqs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-12-23T10:09:21.000Z","updated_at":"2025-02-22T10:43:57.000Z","dependencies_parsed_at":"2023-12-23T13:03:52.887Z","dependency_job_id":"50c1e145-5c21-4c55-a2ea-3103146db9c9","html_url":"https://github.com/alexmarqs/gramoco-cli","commit_stats":null,"previous_names":["alexmarqs/gramoco-cli"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexmarqs%2Fgramoco-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexmarqs%2Fgramoco-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexmarqs%2Fgramoco-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexmarqs%2Fgramoco-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alexmarqs","download_url":"https://codeload.github.com/alexmarqs/gramoco-cli/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243732199,"owners_count":20338839,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["biome","cli","instagram","instagram-graph-api","pkg","typescript","vitest"],"created_at":"2025-03-15T13:18:44.605Z","updated_at":"2025-03-15T13:18:45.261Z","avatar_url":"https://github.com/alexmarqs.png","language":"TypeScript","funding_links":["https://www.paypal.com/donate/?hosted_button_id=G3GPPS9EB35W4)!"],"categories":[],"sub_categories":[],"readme":"# Gramoco CLI 📸\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"./.github/assets/logo_cli_app.png\" width=\"200\" height=\"200\"\u003e\n  \u003cp\u003eEasy interactions with the Instagram Graph API. For Business and Creator Accounts.\u003c/p\u003e\n  \u003ca href=\"https://github.com/alexmarqs/gramoco-cli/actions/workflows/ci.yaml\" target=\"_blank\"\u003e\u003cimg height=20 src=\"https://github.com/alexmarqs/gramoco-cli/actions/workflows/ci.yaml/badge.svg\" /\u003e\u003c/a\u003e\n    \u003ca href=\"https://github.com/alexmarqs/gramoco-cli/actions/workflows/release.yaml\" target=\"_blank\"\u003e\u003cimg height=20 src=\"https://github.com/alexmarqs/gramoco-cli/actions/workflows/release.yaml/badge.svg\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://opensource.org/licenses/MIT\" target=\"_blank\"\u003e\u003cimg height=20 src=\"https://img.shields.io/badge/License-MIT-yellow.svg\" /\u003e\u003c/a\u003e\n\n\u003c/div\u003e\n\n## Purpose 🎯\n\nA 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.\n\n## Donations 💰\n\nIf 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)!\n\n## Tech stack 🤓\n\n- [Node.js](https://nodejs.org/en/) For running JavaScript code\n- [Vitest](https://vitest.dev/) For testing\n- [TypeScript](https://www.typescriptlang.org/) For type checking\n- [ofetch](https://www.npmjs.com/package/ofetch) For making HTTP requests\n- [Tsup](https://tsup.egoist.dev) For bundling\n- [Tsx](https://www.npmjs.com/package/tsx) To run TypeScript files\n- [Pkg](https://github.com/vercel/pkg) Package your Node.js project into an executable\n- [Inquirer.js](https://www.npmjs.com/package/inquirer) For interactive command line user interfaces\n- [Nanospinner](https://www.npmjs.com/package/nanospinner) For loading spinners\n- [Biome](https://biomejs.dev) For linting and formatting\n- [Zod Config](https://github.com/alexmarqs/zod-config) For loading configuration from several sources using Zod\n\n## Features 🚀\n- [x] Extract Instagram posts summary from your account to a Excel file\n- [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)\n- Do you have any request? [**Please open an issue!**](https://github.com/alexmarqs/gramoco-cli/issues)\n\n## Download 📥\n\nYou 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**).\n\n## How to use / Instructions 📖\n\nIn 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.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexmarqs%2Fgramoco-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falexmarqs%2Fgramoco-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexmarqs%2Fgramoco-cli/lists"}