https://github.com/3kh0/slackscan
Inspired by the popular bot on Telegram, TgScan, SlackScan can index channels and their members to provide information about what channels a user is in.
https://github.com/3kh0/slackscan
slack slack-bot tgscan
Last synced: 2 months ago
JSON representation
Inspired by the popular bot on Telegram, TgScan, SlackScan can index channels and their members to provide information about what channels a user is in.
- Host: GitHub
- URL: https://github.com/3kh0/slackscan
- Owner: 3kh0
- Created: 2025-09-18T14:05:39.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2026-03-10T11:59:45.000Z (4 months ago)
- Last Synced: 2026-03-10T18:47:03.831Z (4 months ago)
- Topics: slack, slack-bot, tgscan
- Language: JavaScript
- Homepage:
- Size: 99.6 KB
- Stars: 5
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
SlackScan
Inspired by the popular bot on Telegram, [TgScan](https://tgdev.io/tgscan/), SlackScan can index channels and their members to provide information about what channels a user is in.
As a Hack Club exclusive, you can also look up a user's status in [Hack Club Account](https://auth.hackclub.com/) if their Slack ID is linked to their HCA account.
Using SlackScan is easy as DMing the bot a user mention (if you are in the Hack Club Slack) or using the `/scan` command anywhere in your workspace.
## Features
- Yoinks channels
- Yoinks members in said channels
- If people are schizo about privacy, you can opt out
- If you're in Hack Club, you can look up people's HCA status
- Find people's username, which commonly includes part of their real email (not a bug, just a feature)
- Better than stalking people manually
## Setup
Want to stalk people on your own Slack workspace? Here's how to set it up:
1. Clone the code and install packages with `pnpm i`.
2. Get a Slack app with these scopes: `channels:read`, `chat:write`, `commands`, `users:read`, `groups:read`. Enable Event Subscriptions and set the Request URL to `https://your-domain.com/slack/events`. Subscribe to `message.im` and `message.channels` bot events. For the `/scan` slash command, set the Request URL to `https://your-domain.com/slack/events`.
3. Set up a Postgres database (see the init.sql file for schema)
4. Create a `.env` file by copying `.env.example` and filling it in
5. SlackScan also supports a slash command, which you can register `/scan` in your Slack settings. Make sure to tick the "Escape channels, users, and links sent to your app" option and set the usage hint as "[user mention|user id]".
6. Run the app with `pnpm start` and the channel indexing script with `pnpm run index`.
7. Profit???
## Legal mumbo jumbo
Don't use this to be weird, okay? Just don't be a dic,k and if you get in trouble, fuck around and find out. Don't sue me.