How milancodess/tagspy works
Project type and purpose
• This is a small, open-source CLI tool (“tagspy”) written in Node.js.
• Purpose: Given a public Instagram Story URL plus a valid session cookie, it programmatically navigates to the story, extracts all user mentions (full name + username), and writes them as JSON.
File structure
• Top-level files only:
• index.js – main script
• mentions.json – output file
• package.json & package-lock.json – dependency and script metadata
• .gitignore, README.md
• No frontend or backend subfolders: it is a single‐process CLI app.
• Dependencies (in package.json) include puppeteer-extra + stealth plugin, dotenv for .env, etc.
Key insights from README
• Uses Puppeteer-Extra + stealth plugin for headless browser automation and bot‐avoidance.
• Requires IG_SESSION_ID in .env for session‐based authentication.
• Workflow: Launch Puppeteer → navigate to story URL → scrape mentions → write mentions.json.