ShulkwiSEC/bb-huge / skills/curated/kaido-proxy-integration
kaido-proxy-integration
VerifiedIntegrate Kaido (Caido) proxy with Claude Code CLI for automated HTTP interception, request replay, and vulnerability scanning. Based on Critical Thinking Ep. 166.
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:
_shared/references/elite-chaining-strategy.md— Exploit chaining methodology and high-payout chain patterns_shared/references/elite-report-writing.md— HackerOne-optimized report writing, CWE quick reference_shared/references/real-world-bounties.md— Verified disclosed bounties by vulnerability class
References
- Source: Critical Thinking Ep. 166 [13:46]
- Caido Docs: https://docs.caido.io/
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 467k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 467k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 467k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 193k | Updated | Claude CodeCodex | Verified | Install |