ctf-similar-search

1# CTF Similar Challenge Search
2 
3Search for similar CTF challenge writeups using Tavily API.
4 
5## Prerequisites
6 
7```bash
8pip install requests tavily
9```
10 
11Set your Tavily API key (from https://tavily.com) before running:
12 
13```bash
14export TAVILY_API_KEY='tvly-...'
15```
16 
17## API Overview
18 
19This skill provides two interfaces:
20 
21| Interface | Purpose | Command |
22|-----------|---------|---------|
23| **Tavily Search** | Search for writeups and articles | `./search.sh search <keyword>` |
24| **Tavily Extract** | Extract content from URLs | `./search.sh extract <url1> [url2] ...` |
25 
26## Search Workflow
27 
28### Step 1: Search with Keywords
29 
30Choose keywords based on available information:
31 
32#### Scenario 1: Known Competition + Challenge Name
33```bash
34# Format: [Competition Name] [Challenge Name] — max 3 words
35./search.sh search "DASCTF URL Storage"
36./search.sh search "HGAME baby web"
37./search.sh search "BUUCTF pwn1"
38```
39 
40#### Scenario 2: Challenge Name Only (no competition info)
41```bash
42# Use challenge name directly — max 3 words
43./search.sh search "URL Storage"
44./search.sh search "baby overflow"
45./search.sh search "crypto-rsa"
46```
47 
48#### Scenario 3: Unique Identifiers (code snippets, strings)
49```bash
50# Use unique, non-trivial strings from the challenge — NO word limit
51./search.sh search "def encrypt_flag(key): return base64"
52./search.sh search "CUSTOM_MAGIC_BYTES"
53./search.sh search "ERROR: invalid padding in AES block"
54```
55 
56### ⚠️ Critical: 3-Word Limit for Non-Code Queries
57…