fail2ban-reporter
Auto-report fail2ban banned IPs to AbuseIPDB and notify via Telegram. Use when monitoring server security, reporting attackers, or checking banned IPs. Watches fail2ban for new bans, reports them to AbuseIPDB, and sends alerts.
Best use case
fail2ban-reporter is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Auto-report fail2ban banned IPs to AbuseIPDB and notify via Telegram. Use when monitoring server security, reporting attackers, or checking banned IPs. Watches fail2ban for new bans, reports them to AbuseIPDB, and sends alerts.
Teams using fail2ban-reporter should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/fail2ban-reporter/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How fail2ban-reporter Compares
| Feature / Agent | fail2ban-reporter | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Auto-report fail2ban banned IPs to AbuseIPDB and notify via Telegram. Use when monitoring server security, reporting attackers, or checking banned IPs. Watches fail2ban for new bans, reports them to AbuseIPDB, and sends alerts.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# fail2ban Reporter
Monitor fail2ban bans and auto-report attackers to AbuseIPDB.
## Setup
1. Get a free AbuseIPDB API key at https://www.abuseipdb.com/account/api
2. Store it: `pass insert abuseipdb/api-key`
3. Install the monitor: `bash {baseDir}/scripts/install.sh`
## Manual Usage
### Report all currently banned IPs
```bash
bash {baseDir}/scripts/report-banned.sh
```
### Check a specific IP
```bash
bash {baseDir}/scripts/check-ip.sh <ip>
```
### Show ban stats
```bash
bash {baseDir}/scripts/stats.sh
```
## Auto-Reporting
The install script sets up a fail2ban action that auto-reports new bans.
```bash
bash {baseDir}/scripts/install.sh # install auto-reporting
bash {baseDir}/scripts/uninstall.sh # remove auto-reporting
```
## Heartbeat Integration
Add to HEARTBEAT.md to check for new bans periodically:
```markdown
- [ ] Check fail2ban stats and report any unreported IPs to AbuseIPDB
```
## Workflow
1. fail2ban bans an IP → action triggers `report-single.sh`
2. Script reports to AbuseIPDB with SSH brute-force category
3. Sends Telegram notification (if configured)
4. Logs report to `/var/log/abuseipdb-reports.log`
## API Reference
See [references/abuseipdb-api.md](references/abuseipdb-api.md) for full API docs.Related Skills
biz-reporter
Automated business intelligence reports pulling data from Google Analytics GA4, Google Search Console, Stripe.
performance-reporter
Use when the user asks to "generate SEO report", "performance report", "traffic report", "SEO dashboard", "report.
paylock
Non-custodial SOL escrow for AI agent deals.
agent-reputation
summary: Cross-platform AI agent reputation checker with trust scoring and PayLock escrow recommendations.
Telecom Agent Skill
Turn your AI Agent into a Telecom Operator. Bulk calling, ChatOps, and Field Monitoring.
OpenClaw-Finnhub
OpenClaw skill for real-time stock quote, and financials via Finnhub API.
```markdown
# OpenClaw-Last.fm
security-operator
Runtime security guardrails for OpenClaw agents.
operator-humanizer
Transform AI-generated text into authentic human writing.
kit-email-operator
**AI-powered email marketing for Kit (ConvertKit)**.
agora
Trade prediction markets on Agora — the prediction market exclusively for AI agents. Register, browse markets, trade YES/NO, create markets, earn reputation via Brier scores.
surf-check
Surf forecast decision engine.