https://github.com/mamad-1999/writeup-finder
A tool to find and save recent writeups from specified URLs, with optional Telegram notifications.
https://github.com/mamad-1999/writeup-finder
cyber-security golang medium medium-writeups postgresql security security-writeups telegram-api telegram-bot writeup writeup-ctf writeups
Last synced: 5 months ago
JSON representation
A tool to find and save recent writeups from specified URLs, with optional Telegram notifications.
- Host: GitHub
- URL: https://github.com/mamad-1999/writeup-finder
- Owner: mamad-1999
- Created: 2024-08-11T13:08:33.000Z (9 months ago)
- Default Branch: master
- Last Pushed: 2024-12-30T17:50:42.000Z (5 months ago)
- Last Synced: 2024-12-30T18:35:31.075Z (5 months ago)
- Topics: cyber-security, golang, medium, medium-writeups, postgresql, security, security-writeups, telegram-api, telegram-bot, writeup, writeup-ctf, writeups
- Language: Go
- Homepage: https://t.me/writeup_hacking
- Size: 95.7 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Writeup Finder
[](https://golang.org/dl/)
[](https://github.com/mamad-1999/writeup-finder/issues)
[](https://github.com/mamad-1999/writeup-finder/stargazers)
[](https://github.com/mamad-1999/writeup-finder/blob/master/LICENSE)
Join our Writeup Hacking supergroup for curated hacking writeups and resources!
📜🔍 https://t.me/writeup_hacking
Writeup Finder is a tool designed to automatically find and save recent writeups from specified URLs. It supports saving the found writeups in a PostgreSQL database, and sending them directly to a Telegram.
```
Writeup-finder is a tool to search for writeups and manage article data, including sending notifications.
Usage:
writeup-finder [flags]
writeup-finder [command]
Available Commands:
completion Generate autocompletion script
help Help about any command
Flags:
--database Save new articles in the database
--help Show help
--proxy string Proxy URL to use for sending Telegram messages
--telegram Send new articles to Telegram
Use "writeup-finder [command] --help" for more information about a command.
```
## Features
- Fetch recent writeups from multiple URLs.
- Save writeups to a PostgreSQL database.
- Optionally send notifications of new writeups to a Telegram.
- It filters topics based on the title and sends them to the corresponding topic in the Telegram group.
```
# Directory structure of WriteUp-finder
├── .env
├── .env.example
├── .gitignore
├── README.md
├── command/
│ └── command.go
├── config/
│ └── env.go
├── data/
│ ├── keywords.json
│ └── url.txt
├── db/
│ └── db.go
├── global/
│ └── global.go
├── go.mod
├── go.sum
├── main.go
├── rss/
│ └── fetch.go
├── run_writeUp-finder.sh
├── telegram/
│ └── telegram.go
├── url/
│ └── url.go
├── utils/
│ ├── filters.go
│ ├── http.go
│ └── utils.go
└── writeup-finder
```
## Requirements
- Go 1.16+
- PostgreSQL
## Setup
1. Clone the repository.
2. Install dependencies using `go mod tidy`.
3. Create a `.env` file with the `.env.example` file.
4. Update the `url.txt` file with the URLs you want to monitor.
5. Run the tool with the desired flags.
6. Run `go build -o writeup-finder`
## Usage
| Command | Description |
| ------------------------------------------------------------------------- | ------------------------------------------------ |
| `writeup-finder --database` | Save new articles to PostgreSQL database |
| `writeup-finder [--database] --telegram` | Send new writeups to Telegram |
| `writeup-finder [--database] --telegram --proxy=PROTOCOL://HOSTNAME:PORT` | Send new writeups to Telegram with proxy support |
## Flags:
- `--database` Save new articles in the database
- `--help` Show help
- `--proxy string` Proxy URL to use for sending Telegram messages
- `--telegram` Send new articles to Telegram
Use `writeup-finder [command] --help` for more information about a command.
You can use `CRON` to run script every *hours, *days, or etc.
#### Example for run script every 3 hour
More read: [How to Automate Tasks with cron Jobs in Linux](https://www.freecodecamp.org/news/cron-jobs-in-linux/)
```bash
0 */3 * * * cd /path/to/your/script && /usr/local/go/bin/writeup-finder -d -t
```