Kaido proxy integration
Skill ShulkwiSEC/bb-huge/skills/curated/kaido-proxy-integration
Integrate Kaido (Caido) proxy with Claude Code CLI for automated HTTP interception, request replay, and vulnerability scanning. Based on Critical Thinking Ep. 166.From its SKILL.md
npx -y skills add ShulkwiSEC/bb-huge --skill kaido-proxy-integrationAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 21 stars21 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its file declares
Copied from the file, not written here
The file declares its own license as Apache-2.0. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.
SKILL.md
6.0 KB, ~1.4k tokens by cl100k_base, as published. Nobody here has run it
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/
What ships with it
Read from the repository
Just SKILL.md. No reference files, no scripts.