Kaido (Caido) Proxy Integration Skill
When to Use
- When Claude needs to intercept and analyze HTTP traffic through Kaido proxy.
- When automating request modification and replay attacks against target endpoints.
- When Burp Suite is unavailable and Kaido is the primary interception proxy.
Prerequisites
- Kaido (Caido) running on
http://127.0.0.1:8080
- Kaido API enabled (GraphQL endpoint)
- Claude Code CLI installed
- Target within authorized scope
Core Concept
"Build a skill that tells Claude how to interact with Kaido —
intercepting, replaying, modifying requests."
— Episode 166 [13:46]
Workflow
Phase 1: Query Intercepted Traffic (3-Tier Fallback)
// scripts/intercept.ts — Query Kaido's captured HTTP traffic
const KAIDO_API = process.env.KAIDO_API_URL || "http://127.0.0.1:8080/graphql";
// Tier 1: GraphQL API (preferred)
async function queryTraffic(host?: string) {
try {
const res = await fetch(KAIDO_API, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
query: `query { requests(filter: "${host ? `host:${host}` : ""}", first: 100) {
edges { node { id method url path responseStatusCode responseLength } }
}}`,
}),
});
if (!res.ok) throw new Error(`API: ${res.status}`);
return (await res.json()).data.requests.edges.map((e: any) => e.node);
} catch {
console.warn("[FALLBACK] GraphQL failed, trying REST...");
return queryTrafficREST(host);
}
}
// Tier 2: REST fallback
async function queryTrafficREST(host?: string) {
try {
const res = await fetch(`http://127.0.0.1:8080/api/requests?limit=100`);
if (!res.ok) throw new Error(`REST: ${res.status}`);
return (await res.json()).filter((r: any) => !host || r.host.includes(host));
} catch {
console.warn("[FALLBACK] REST failed, using curl...");
return queryViaCurl(host);
}
}
// Tier 3: curl fallback
async function queryViaCurl(host?: string) {
const { execSync } = await import("child_process");
const output = execSync(
`curl -s http://127.0.0.1:8080/api/requests 2>/dev/null || echo "[]"`
).toString();
return JSON.parse(output);
}
Phase 2: Replay and Modify Requests
// scripts/replay.ts — Replay captured requests with modifications
async function replayRequest(requestId: string, mods?: Record<string, string>) {
const mutation = `mutation { replayRequest(id: "${requestId}"${
mods ? `, modifications: ${JSON.stringify(mods)}` : ""
}) { id responseStatusCode responseBody } }`;
const res = await fetch(KAIDO_API, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ query: mutation }),
});
return (await res.json()).data.replayRequest;
}
// IDOR test: replay with different user IDs
async function idorSweep(requestId: string, idRange: number[]) {
for (const id of idRange) {
const result = await replayRequest(requestId, { userId: String(id) });
if (result.responseStatusCode === 200) {
console.log(`[HIT] ID ${id} → ${result.responseStatusCode} (IDOR confirmed)`);
}
}
}
Phase 3: Auto-Scan Intercepted Traffic
Analyze captured requests for vulnerability indicators:
| Indicator |
Severity |
Detection Logic |
| Numeric ID in URL path |
INFO |
/users/12345 → test IDOR |
| Reflected parameter value |
MEDIUM |
Input appears in response body |
| Stack trace in 500 response |
MEDIUM |
Error contains at or Traceback |
| Missing auth on sensitive endpoint |
HIGH |
200 response without auth header |
| Debug headers present |
LOW |
X-Debug, X-Powered-By in response |
Decision Point 🔀
flowchart TD
A[Analyze HTTP traffic?] --> B{Kaido running?}
B -->|Yes| C[Query via GraphQL API]
B -->|No| D[Start: caido --listen 8080]
C --> E{Interesting request?}
E -->|Yes| F[Replay with modifications]
E -->|No| G[Browse target to generate traffic]
F --> H{Different response?}
H -->|Yes| I[Promote to Lead in funnel]
H -->|No| J[Modify params and retry]
Creativity Directive
IMPORTANT: Go beyond these steps. Build custom HTTPQL filters,
create automated replay chains, integrate with fuzzing and SQLi skills.
Think like an attacker. Adapt. Improvise.
🔵 Blue Team
- Deploy robust WAF rules to detect anomalies.
- Monitor logs for unusual access patterns.
🛡️ Remediation & Mitigation Strategy
- Input Validation: Sanitize and strictly type-check all inputs.
- Least Privilege: Constrain component execution bounds.
📚 Shared Resources
For cross-cutting methodology applicable to all vulnerability classes, see:
References
1---2name: kaido-proxy-integration3description: >4 Integrate Kaido (Caido) proxy with Claude Code CLI for automated HTTP interception, 5 request replay, and vulnerability scanning. Based on Critical Thinking Ep. 166.6domain: cybersecurity7subdomain: bug-hunting8category: Methodology9difficulty: intermediate10estimated_time: "2-3 hours"11platforms: [linux, macos, windows]12tags: [kaido, caido, proxy, http-interception, request-replay, traffic-analysis]13tools: [kaido, caido, claude-code-cli, typescript, curl]14version: "1.0"15author: CyberSkills-Elite16license: Apache-2.017source: "Critical Thinking Bug Bounty Podcast Ep. 166"18source_url: "http://www.youtube.com/watch?v=qTX9u-EsjmM"19metadata:20 source: https://skillmd.com/skills/shulkwisec/kaido-proxy-integration21---2223# Kaido (Caido) Proxy Integration Skill2425## When to Use26- When Claude needs to intercept and analyze HTTP traffic through Kaido proxy.27- When automating request modification and replay attacks against target endpoints.28- When Burp Suite is unavailable and Kaido is the primary interception proxy.2930## Prerequisites31- Kaido (Caido) running on `http://127.0.0.1:8080`32- Kaido API enabled (GraphQL endpoint)33- Claude Code CLI installed34- Target within authorized scope3536## Core Concept3738> **"Build a skill that tells Claude how to interact with Kaido — 39> intercepting, replaying, modifying requests."**40> — Episode 166 [13:46]4142## Workflow4344### Phase 1: Query Intercepted Traffic (3-Tier Fallback)4546```typescript47// scripts/intercept.ts — Query Kaido's captured HTTP traffic48const KAIDO_API = process.env.KAIDO_API_URL || "http://127.0.0.1:8080/graphql";4950// Tier 1: GraphQL API (preferred)51async function queryTraffic(host?: string) {52 try {53 const res = await fetch(KAIDO_API, {54 method: "POST",55 headers: { "Content-Type": "application/json" },56 body: JSON.stringify({57 query: `query { requests(filter: "${host ? `host:${host}` : ""}", first: 100) {58 edges { node { id method url path responseStatusCode responseLength } }59 }}`,60 }),61 });62 if (!res.ok) throw new Error(`API: ${res.status}`);63 return (await res.json()).data.requests.edges.map((e: any) => e.node);64 } catch {65 console.warn("[FALLBACK] GraphQL failed, trying REST...");66 return queryTrafficREST(host);67 }68}6970// Tier 2: REST fallback71async function queryTrafficREST(host?: string) {72 try {73 const res = await fetch(`http://127.0.0.1:8080/api/requests?limit=100`);74 if (!res.ok) throw new Error(`REST: ${res.status}`);75 return (await res.json()).filter((r: any) => !host || r.host.includes(host));76 } catch {77 console.warn("[FALLBACK] REST failed, using curl...");78 return queryViaCurl(host);79 }80}8182// Tier 3: curl fallback83async function queryViaCurl(host?: string) {84 const { execSync } = await import("child_process");85 const output = execSync(86 `curl -s http://127.0.0.1:8080/api/requests 2>/dev/null || echo "[]"`87 ).toString();88 return JSON.parse(output);89}90```9192### Phase 2: Replay and Modify Requests9394```typescript95// scripts/replay.ts — Replay captured requests with modifications96async function replayRequest(requestId: string, mods?: Record<string, string>) {97 const mutation = `mutation { replayRequest(id: "${requestId}"${98 mods ? `, modifications: ${JSON.stringify(mods)}` : ""99 }) { id responseStatusCode responseBody } }`;100101 const res = await fetch(KAIDO_API, {102 method: "POST",103 headers: { "Content-Type": "application/json" },104 body: JSON.stringify({ query: mutation }),105 });106 return (await res.json()).data.replayRequest;107}108109// IDOR test: replay with different user IDs110async function idorSweep(requestId: string, idRange: number[]) {111 for (const id of idRange) {112 const result = await replayRequest(requestId, { userId: String(id) });113 if (result.responseStatusCode === 200) {114 console.log(`[HIT] ID ${id} → ${result.responseStatusCode} (IDOR confirmed)`);115 }116 }117}118```119120### Phase 3: Auto-Scan Intercepted Traffic121122Analyze captured requests for vulnerability indicators:123124| Indicator | Severity | Detection Logic |125|-----------|----------|-----------------|126| Numeric ID in URL path | INFO | `/users/12345` → test IDOR |127| Reflected parameter value | MEDIUM | Input appears in response body |128| Stack trace in 500 response | MEDIUM | Error contains `at ` or `Traceback` |129| Missing auth on sensitive endpoint | HIGH | 200 response without auth header |130| Debug headers present | LOW | `X-Debug`, `X-Powered-By` in response |131132## Decision Point 🔀133134```mermaid135flowchart TD136 A[Analyze HTTP traffic?] --> B{Kaido running?}137 B -->|Yes| C[Query via GraphQL API]138 B -->|No| D[Start: caido --listen 8080]139 C --> E{Interesting request?}140 E -->|Yes| F[Replay with modifications]141 E -->|No| G[Browse target to generate traffic]142 F --> H{Different response?}143 H -->|Yes| I[Promote to Lead in funnel]144 H -->|No| J[Modify params and retry]145```146147## Creativity Directive148149> **IMPORTANT**: Go beyond these steps. Build custom HTTPQL filters,150> create automated replay chains, integrate with fuzzing and SQLi skills.151> **Think like an attacker. Adapt. Improvise.**152153## 🔵 Blue Team154- Deploy robust WAF rules to detect anomalies.155- Monitor logs for unusual access patterns.156157## 🛡️ Remediation & Mitigation Strategy158- **Input Validation:** Sanitize and strictly type-check all inputs.159- **Least Privilege:** Constrain component execution bounds.160161162## 📚 Shared Resources163> For cross-cutting methodology applicable to all vulnerability classes, see:164> - [`_shared/references/elite-chaining-strategy.md`](../_shared/references/elite-chaining-strategy.md) — Exploit chaining methodology and high-payout chain patterns165> - [`_shared/references/elite-report-writing.md`](../_shared/references/elite-report-writing.md) — HackerOne-optimized report writing, CWE quick reference166> - [`_shared/references/real-world-bounties.md`](../_shared/references/real-world-bounties.md) — Verified disclosed bounties by vulnerability class167168## References169- Source: [Critical Thinking Ep. 166](http://www.youtube.com/watch?v=qTX9u-EsjmM) [13:46]170- Caido Docs: [https://docs.caido.io/](https://docs.caido.io/)