{"id":25630064,"url":"https://github.com/blackvoidx/writeup-finder","last_synced_at":"2025-04-14T16:16:59.293Z","repository":{"id":252647722,"uuid":"841038456","full_name":"blackvoidx/writeup-finder","owner":"blackvoidx","description":"A tool to find and save recent writeups from specified URLs, with optional Telegram notifications.","archived":false,"fork":false,"pushed_at":"2025-02-16T13:40:48.000Z","size":136,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-16T17:50:39.933Z","etag":null,"topics":["cyber-security","golang","hashnode","hashnode-blog","medium","medium-writeups","pentesterland","postgresql","rss","rss-feed","rss-reader","security","security-writeups","telegram-api","telegram-bot","writeup","writeup-ctf","writeups","youtube","youtube-rss"],"latest_commit_sha":null,"homepage":"https://t.me/writeup_hacking","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/blackvoidx.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":"2024-08-11T13:08:33.000Z","updated_at":"2025-02-16T13:40:51.000Z","dependencies_parsed_at":null,"dependency_job_id":"87c75f6e-ea30-4760-83a8-bfa259383f50","html_url":"https://github.com/blackvoidx/writeup-finder","commit_stats":null,"previous_names":["mamad-1999/writeup-finder","blackvoidx/writeup-finder"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blackvoidx%2Fwriteup-finder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blackvoidx%2Fwriteup-finder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blackvoidx%2Fwriteup-finder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blackvoidx%2Fwriteup-finder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/blackvoidx","download_url":"https://codeload.github.com/blackvoidx/writeup-finder/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240229882,"owners_count":19768584,"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":["cyber-security","golang","hashnode","hashnode-blog","medium","medium-writeups","pentesterland","postgresql","rss","rss-feed","rss-reader","security","security-writeups","telegram-api","telegram-bot","writeup","writeup-ctf","writeups","youtube","youtube-rss"],"created_at":"2025-02-22T19:40:45.726Z","updated_at":"2025-02-22T19:40:46.223Z","avatar_url":"https://github.com/blackvoidx.png","language":"Go","readme":"# Writeup Finder\n\n[![Go Version](https://img.shields.io/badge/go-1.17%20%7C%201.18%20%7C%201.19%20%7C%201.20-blue)](https://golang.org/dl/)\n[![GitHub Issues](https://img.shields.io/github/issues/blackvoidx/writeup-finder)](https://github.com/blackvoidx/writeup-finder/issues)\n[![GitHub Stars](https://img.shields.io/github/stars/blackvoidx/writeup-finder)](https://github.com/blackvoidx/writeup-finder/stargazers)\n[![GitHub License](https://img.shields.io/github/license/blackvoidx/writeup-finder)](https://github.com/blackvoidx/writeup-finder/blob/master/LICENSE)\n\n\u003cp\u003e\n    \u003ca href=\"https://skillicons.dev\"\u003e\n      \u003cimg src=\"https://github.com/tandpfun/skill-icons/blob/main/icons/GoLang.svg\" width=\"48\" title=\"Go\"\u003e\n      \u003cimg src=\"https://github.com/tandpfun/skill-icons/blob/main/icons/Github-Dark.svg\" width=\"48\" title=\"github\"\u003e\n    \u003c/a\u003e\n\u003c/p\u003e\n\nJoin our Writeup Hacking supergroup for curated hacking writeups and resources!\n\n📜🔍 https://t.me/writeup_hacking\n\nWriteup 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.\n\n```\nWriteup-finder is a tool to search for writeups and manage article data, including sending notifications.\n\nUsage:\n  writeup-finder [flags]\n  writeup-finder [command]\n\nAvailable Commands:\n  completion  Generate autocompletion script\n  help        Help about any command\n\nFlags:\n      --database       Save new articles in the database\n      --help           Show help\n      --proxy string   Proxy URL to use for sending Telegram messages\n      --telegram       Send new articles to Telegram\n\nUse \"writeup-finder [command] --help\" for more information about a command.\n\n```\n\n## Features\n\n- Fetch recent writeups from multiple URLs.\n- Save writeups to a PostgreSQL database.\n- Optionally send notifications of new writeups to a Telegram.\n- It filters topics based on the title and sends them to the corresponding topic in the Telegram group.\n\n```\n── .env \n├── .env.example \n├── .github/ \n│   └── workflows/ \n│       └── writeup-finder-runner.yml \n├── .gitignore \n├── CHANGELOG.md \n├── README.md \n├── command/ \n│   ├── action.go \n│   ├── command.go \n│   ├── completion.go \n│   └── flags.go \n├── data/ \n│   ├── Youtube_channel.md \n│   ├── keywords.json \n│   └── url.txt \n├── db/ \n│   └── db.go \n├── global/ \n│   └── global.go \n├── go.mod \n├── go.sum \n├── handler/ \n│   ├── handler.go \n│   ├── medium.go \n│   ├── utils.go \n│   └── youtube.go \n├── main.go \n├── run_writeUp-finder.sh \n├── telegram/ \n│   ├── message.go \n│   ├── proxy.go \n│   ├── request.go \n│   └── telegram.go \n├── utils/ \n│   ├── env.go \n│   ├── filters.go \n│   ├── http.go \n│   ├── rss.go \n│   └── utils.go \n└── writeup-finder \n```\n\n## Requirements\n\n- Go 1.16+\n- PostgreSQL\n\n## Setup\n\n1. Clone the repository.\n2. Install dependencies using `go mod tidy`.\n3. Create a `.env` file with the `.env.example` file.\n4. Update the `url.txt` file with the URLs you want to monitor.\n5. Run the tool with the desired flags.\n6. Run `go build -o writeup-finder`\n\n## Usage\n\n| Command                                                                   | Description                                      |\n| ------------------------------------------------------------------------- | ------------------------------------------------ |\n| `writeup-finder --database`                                               | Save new articles to PostgreSQL database         |\n| `writeup-finder [--database] --telegram`                                  | Send new writeups to Telegram                    |\n| `writeup-finder [--database] --telegram --proxy=PROTOCOL://HOSTNAME:PORT` | Send new writeups to Telegram with proxy support |\n\n## Flags:\n- `--database`       Save new articles in the database\n- `--help`           Show help\n- `--proxy string`   Proxy URL to use for sending Telegram messages\n- `--telegram`       Send new articles to Telegram\n\nUse `writeup-finder [command] --help` for more information about a command.\n\nYou can use `CRON` to run script every *hours, *days, or etc.\n\n#### Example for run script every 3 hour\n\nMore read: [How to Automate Tasks with cron Jobs in Linux](https://www.freecodecamp.org/news/cron-jobs-in-linux/)\n\n```bash\n    0 */3 * * * cd /path/to/your/script \u0026\u0026 /usr/local/go/bin/writeup-finder -d -t\n```\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblackvoidx%2Fwriteup-finder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fblackvoidx%2Fwriteup-finder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblackvoidx%2Fwriteup-finder/lists"}