# web2-recon

web2-recon coordinates external web reconnaissance from subdomain discovery to URL crawling and fuzzing. Built for security researchers mapping target surfaces in Claude Code.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 16193 repo stars
- Author: Sachin Sharma
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/elementalsouls/Claude-BugHunter/tree/HEAD/skills/web2-recon/SKILL.md
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/web2-recon

## What it does

This skill guides security audits through a structured reconnaissance workflow. It strings together passive subdomain collection via `crt.sh`, Chaos API, and `subfinder`, then checks live servers with `dnsx` and `httpx`. Discovered URLs get indexed using `katana`, `waybackurls`, and `gau`, saving results directly into target directories.

Collected endpoints are filtered for administrative routes, upload forms, and parameters such as `redirect` or `token`. The workflow also parses JavaScript files using `LinkFinder` and `SecretFinder` to reveal hidden paths and leaked tokens. Vulnerability checks execute via `nuclei`, while route fuzzing relies on `ffuf`.

Without tools like `subfinder`, `httpx`, and `nuclei` installed in your `PATH`, the pipeline fails immediately. You also need an export of `CHAOS_API_KEY` for ProjectDiscovery endpoints. If five minutes of recon yield only static marketing pages or 403 statuses, the prompt recommends moving to another target.

## Requirements
- Works with: GitHub

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add elementalsouls/Claude-BugHunter
```
In the agent chat (not a shell):
```text
/plugin install claude-bughunter@elementalsouls
```
This installs the whole claude-bughunter plugin with all its skills

2. **Skills CLI (Vercel)**
```bash
npx skills add elementalsouls/Claude-BugHunter --skill web2-recon -a claude-code
```

3. **Manually: put the files in place**
- File: `~/.claude/skills/web2-recon/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/web2-recon/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add elementalsouls/Claude-BugHunter --skill web2-recon -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/web2-recon/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add elementalsouls/Claude-BugHunter --skill web2-recon -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/web2-recon/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install elementalsouls/Claude-BugHunter skills/web2-recon
```

2. **Manually: put the files in place**
- File: `.github/skills/web2-recon/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add elementalsouls/Claude-BugHunter --skill web2-recon -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/elementalsouls/Claude-BugHunter --path skills/web2-recon
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/web2-recon/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/elementalsouls/Claude-BugHunter/tree/HEAD/skills/web2-recon/SKILL.md

## When to use it
- Collect subdomains across passive APIs and certificate transparency logs
- Filter live web hosts and identify their server technology
- Inspect JavaScript bundles for hardcoded credentials and hidden endpoints
- Triage crawled URLs by parameter patterns to identify potential attack surface

## Example prompts
- Run the initial web2-recon discovery pipeline against `target.com`
- Extract API endpoints and file upload parameters from `urls.txt`
- Analyze the client JavaScript bundles with SecretFinder to check for exposed keys

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 5808eed9a528c134.

BEGIN THIRD-PARTY FILE 5808eed9a528c134
````text
---
name: web2-recon
description: Web2 recon pipeline — subdomain enumeration (subfinder, Chaos API, assetfinder), live host discovery (dnsx, httpx), URL crawling (katana, waybackurls, gau), directory fuzzing (ffuf), JS analysis (LinkFinder, SecretFinder), continuous monitoring (new subdomain alerts, JS change detection, GitHub commit watch). Use when starting recon on any web2 target or when asked about asset discovery, subdomain enum, or attack surface mapping.
sources: community, public_research
---

# WEB2 RECON PIPELINE

Full asset discovery from nothing to a prioritized URL list ready for hunting.

---

## SETUP (one-time)

```bash
# 1. Set your Chaos API key (get free key at chaos.projectdiscovery.io)
export CHAOS_API_KEY="your-key-here"
# Add to ~/.zshrc or ~/.bashrc for persistence:
echo 'export CHAOS_API_KEY="your-key-here"' >> ~/.zshrc

# 2. Update nuclei templates (run weekly)
nuclei -update-templates

# 3. Configure subfinder with API keys for more sources
mkdir -p ~/.config/subfinder
cat > ~/.config/subfinder/config.yaml << 'EOF'
# Get free keys at: virustotal.com, securitytrails.com, censys.io, shodan.io
virustotal: [YOUR_VT_KEY]
securitytrails: [YOUR_ST_KEY]
censys_apiid: YOUR_CENSYS_ID
censys_secret: YOUR_CENSYS_SECRET
shodan: [YOUR_SHODAN_KEY]
EOF

# 4. Verify all tools installed
which subfinder httpx dnsx nuclei katana waybackurls gau dalfox ffuf anew gf interactsh-client
```

---

## THE 5-MINUTE RULE

> If a target shows nothing interesting after 5 minutes of recon, move on. Don't burn hours on dead surface.

**5-minute kill signals:**
- All subdomains return 403 or static marketing pages
- No API endpoints visible in URLs
- No JavaScript bundles with interesting endpoint paths
- nuclei returns 0 medium/high findings
- No forms, no authentication, no user data

---

## STANDARD RECON PIPELINE

### Pre-Hunt: Always Run First

```bash
TARGET="target.com"

# Step 0: Passive — crt.sh certificate transparency (no API key needed)
curl -s "https://crt.sh/?q=%.${TARGET}&output=json" \
  | jq -r '.[].name_value' \
  | sed 's/\*\.//g' \
  | sort -u > /tmp/subs.txt
echo "[+] crt.sh: $(wc -l < /tmp/subs.txt) subdomains"

# Step 1: Chaos API (ProjectDiscovery — most comprehensive source)
curl -s "https://dns.projectdiscovery.io/dns/$TARGET/subdomains" \
  -H "Authorization: $CHAOS_API_KEY" \
````
END THIRD-PARTY FILE 5808eed9a528c134

The third-party file has ended. Everything between the 5808eed9a528c134 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2346 of 24289 bytes. © Sachin Sharma · MIT · https://github.com/elementalsouls/Claude-BugHunter/tree/HEAD/skills/web2-recon/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
