hunt-shadow-api

Validates shadow, legacy, and versioned API endpoints through evidence-gated differential testing.

10|3|Updated Aug 10, 2026
One-click install
npx skills add https://github.com/baiqigo/baiqi-redteam-lab --skill hunt-shadow-api-baiqigo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hunt-shadow-api
Source: https://github.com/baiqigo/baiqi-redteam-lab/tree/main/.agents/skills/hunt-shadow-api
Command: npx skills add https://github.com/baiqigo/baiqi-redteam-lab --skill hunt-shadow-api-baiqigo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Shadow, deprecated, and versioned APIs often retain weaker authorization or schema validation than current endpoints, but testing them safely requires strict scope control and evidence-based confirmation rather than blind scanning. ## Core Features & Use Cases - Version and Spec Differencing: Builds baselines of public, legacy, mobile, and documented API routes, then compares authorization, schema, and business semantics across versions. - Evidence-Gated Validation: Enforces a baseline → single-variable probe → post-baseline → server/browser oracle → evidence workflow, treating WAF blocks, captchas, and timeouts as inconclusive rather than findings. - Scope and Stop Controls: Halts on cross-host spread, bulk enumeration, third-party data, or irreversible side effects, and routes confirmed object-level issues to IDOR or API misconfiguration workflows. - Use Case: During an authorized assessment, you discover a deprecated v1 endpoint in old mobile traffic. Use this Skill to verify, on your own account and objects, whether the legacy route lacks the server-side authorization checks present in the current API. ## Quick Start Use $hunt-shadow-api to plan an evidence-gated, authorized validation path for the legacy API endpoints found in scope.

Frequently Asked Questions about hunt-shadow-api

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I test shadow and legacy API endpoints safely?

Test shadow APIs by first locking scope and building a baseline of known endpoints, then running single-variable probes against your own accounts and objects. Confirm every finding with a server or browser oracle before recording it as evidence.

What is a shadow API in security testing?

A shadow API is an undocumented, deprecated, or legacy endpoint that remains reachable but falls outside current documentation and maintenance. These routes often lack the authorization and validation controls applied to current API versions.

How do I compare API versions for authorization differences?

Compare API versions by replaying the same authenticated request against documented and legacy routes using the same identity and object, then diffing authorization checks, schema validation, and business semantics. Only differences confirmed by authoritative read-back count as valid findings.

Does this approach work on out-of-scope or third-party hosts?

No, validation is restricted to hosts, identities, and objects explicitly declared in the authorized scope. Cross-host expansion, third-party mobile hosts, and shared user data trigger an immediate stop.

Why are WAF blocks or captchas treated as inconclusive?

WAF responses, captchas, timeouts, and single errors do not prove a vulnerability exists, so they are recorded as INCONCLUSIVE rather than findings. Only server-side confirmed evidence from controlled probes qualifies as valid.