К основному содержанию
скилл CX Codex

hunt-shadow-api — скилл для Claude Code: что делает и как установить

Скилл hunt-shadow-api находит забытые и теневые версии API, сравнивая спецификации и проверяя регрессии в аутентификации и лимитах. Пригодится при аудите устаревших эндпоинтов.

MIT ★ 16 193 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add elementalsouls/Claude-BugHunter
/plugin install claude-bughunter@elementalsouls
Открыть на GitHub

Что делает hunt-shadow-api

Скилл находит теневые и устаревшие версии API по категории OWASP API9. Он перебирает префиксы путей вроде /v1/ или /beta/, а также проверяет заголовки версионирования. Любой эндпоинт с кодом 200, 401 или 403 считается рабочим и переходит на следующий этап анализа.

Инструмент собирает спецификации OpenAPI и Swagger через текущий хост и снимки Wayback Machine. Утилиты jq и comm помогают вычленить забытые маршруты. После этого сравнивается поведение версий: скилл проверяет просроченные токены и отсутствие лимитов на запросы.

Косметическая разница в структуре ответов считается чисто информационным результатом. Настоящей находкой признаются регрессии в авторизации или валидации. Для API с одной версией скилл бесполезен: сравнивать будет не с чем.

Какие задачи решает

  • выявить забытые версии API через пути, заголовки и поддомены
  • найти старые спецификации OpenAPI и Swagger через веб-архив
  • сравнить списки эндпоинтов между разными версиями спецификаций
  • проверить регрессии в авторизации и лимитах запросов на старых маршрутах

Примеры запросов агенту

  • Проверь старые версии API на target.com и найди различия в спецификациях OpenAPI
  • Выполни аудит забытых эндпоинтов через hunt-shadow-api для домена target.com

Как установить hunt-shadow-api

1Через маркетплейс плагинов

/plugin marketplace add elementalsouls/Claude-BugHunter
/plugin install claude-bughunter@elementalsouls

Команда ставит плагин claude-bughunter целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add elementalsouls/Claude-BugHunter --skill hunt-shadow-api -a claude-code

3Вручную: положить файлы

~/.claude/skills/hunt-shadow-api/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/hunt-shadow-api/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о hunt-shadow-api

Как установить hunt-shadow-api в Claude Code?

Сначала добавьте маркетплейс командой /plugin marketplace add elementalsouls/Claude-BugHunter, затем установите пакет через /plugin install claude-bughunter@elementalsouls.

Что делает hunt-shadow-api?

Скилл находит неучтённые и устаревшие версии API по путям, поддоменам или заголовкам. Он скачивает доступные спецификации OpenAPI, сравнивает эндпоинты и выявляет ослабленные проверки безопасности в старых версиях.

Когда скилл hunt-shadow-api не подходит для проверки?

Его не используют для сервисов с одной версией без истории изменений. В таких случаях нечего сравнивать, поэтому анализ эндпоинта проводят через hunt-api-misconfig.

Исходный текст

SKILL.md · MIT
---
name: hunt-shadow-api
description: "Hunt shadow / zombie / undocumented API surface (OWASP API9 Improper Inventory Management) — enumerate the full API version history (v1/v2/beta/legacy paths, header- and subdomain-based versioning), pull and diff every reachable OpenAPI/Swagger spec (including ones only findable via the Wayback Machine), and behaviorally diff old vs. current versions for auth/rate-limit/validation regressions rather than just response-shape differences. Distinct from hunt-api-misconfig, which owns exploitation once you have a spec or endpoint (mass assignment, JWT, OData, Swagger-chain attacks); distinct from hunt-subdomain, which owns host-level discovery. This skill owns the version-inventory and behavioral-diff workflow itself. Use when the target has versioned API paths, multiple specs, a changelog referencing deprecated endpoints, or a mobile app whose hardcoded backend calls look older than the current web app's."
sources: owasp_api_top10_2023, portswigger_research, public_research
report_count: 0
---

## OWASP API9 — Improper Inventory Management (Shadow / Zombie APIs)

As an API evolves, old versions and internal/staging routes routinely stay reachable without
receiving the same security fixes as the current version — because nobody tracks that they
still exist. The bug is rarely in one endpoint; it's in the **delta** between what an old
version enforces and what the current version enforces on the same operation.

### When to use

Trigger when:
- Versioned paths are visible (`/v1/`, `/v2/`, `/api/2023-01-01/`) or `Accept`/`X-API-Version`
  headers are in play.
- A changelog, release notes, or deprecation notice references removed/old API behavior.
- A mobile APK/IPA (via `apk-redteam-pipeline` / `ios-redteam-pipeline`) hardcodes endpoints
  that look like an older backend version than the current web app calls.
- Multiple OpenAPI/Swagger specs are discoverable, or `info.version` in one spec implies others
  exist.

DO NOT use for single-version APIs with no version history — there's nothing to diff; go
straight to `hunt-api-misconfig` for direct exploitation of the one surface that exists.

---

## Stage 1 — Enumerate the Full Version Surface

```bash
# Path-based versioning
for v in v1 v2 v3 v4 beta alpha internal legacy old 2022-01-01 2023-01-01 2024-01-01; do
  curl -s -o /dev/null -w "%{http_code} /api/$v/\n" "https://$TARGET/api/$v/"
done

# Header-based versioning
curl -s -H "X-API-Version: 1" https://$TARGET/api/users
curl -s -H "Accept: application/vnd.company.v1+json" https://$TARGET/api/users

# Subdomain-based versioning
for sub in api api-v1 api-v2 apiv1 apiv2 legacy-api old-api internal-api staging-api; do
  curl -s -o /dev/null -w "%{http_code} $sub\n" "https://$sub.$TARGET/"
done
```

A `200`/`401`/`403` on an old version path (anything but `404`/connection-refused) means the
version is still live and worth carrying into Stage 3, even if it demands auth.

---

## Stage 2 — Pull Every Reachable Spec, Not Just the Linked One

```bash
for path in openapi.json swagger.json v1/swagger.json v2/swagger.json v3/api-docs \
            api-docs.json swagger/v1/swagger.json .well-known/openapi.json; do
  curl -s -o /dev/null -w "%{http_code} /$path\n" "https://$TARGET/$path"
done

# Wayback Machine — a DEPRECATED version's spec often stays indexed after the live link is removed
curl -s "http://web.archive.org/cdx/search/cdx?url=$TARGET/*swagger*&output=json&collapse=urlkey"
curl -s "http://web.archive.org/cdx/search/cdx?url=$TARGET/*openapi*&output=json&collapse=urlkey"
```

When more than one spec resolves (a current one and an archived/old one), diff the endpoint
inventories directly:
```bash
jq -r '.paths | keys[]' v1-swagger.json | sort > /tmp/v1_paths.txt
jq -r '.paths | keys[]' v2-swagger.json | sort > /tmp/v2_paths.txt
comm -23 /tmp/v1_paths.txt /tmp/v2_paths.txt   # in v1 only — candidates for "still live but forgotten"
```
For every path in that diff, confirm it's still reachable against the v1 base URL. A route
documented only in the old spec that still returns something other than `404` is a zombie-
endpoint candidate — carry it into Stage 3.

---

## Stage 3 — Behavioral Diff Between Old and Current Version

For each operation that exists in **both** versions, compare security-relevant behavior, not
response shape. Response shape differences are Informational; behavioral security regressions
are the finding.

- **Auth strength.** Does the old version accept no token, an expired token, or a lower-
  privilege token that the current version rejects?
  ```bash
  curl -s -H "Authorization: Bearer $EXPIRED_TOKEN" https://$TARGET/api/v1/users/me -w '\n%{http_code}\n'
  curl -s -H "Authorization: Bearer $EXPIRED_TOKEN" https://$TARGET/api/v2/users/me -w '\n%{http_code}\n'
  ```
- **Rate limiting.** Burst the same number of requests against both versions' equivalent
  endpoint; a missing `429` on the old version means rate-limiting was added later and never
  backported.
- **Input validation.** Send the identical injection/oversized/malformed payload to both; the
  old version accepting what the new one rejects means hardening happened forward-only —
  chain into whichever injection class the payload targets (`hunt-sqli`, `hunt-idor`, etc.).
- **Field exposure.** Does the old version's response body include fields — internal IDs, other
  users' data, internal notes, PII — that the current version has since redacted?

---

## Stage 4 — Deprecated / Internal Routes Never Referenced by the Current UI

- Grep JS bundles for API calls no visible UI flow triggers (`/internal/`, `/admin/`, `/debug/`,
  `/_internal/`, `/test/`, `/staging/`) — reuse `hunt-source-leak`'s JS-bundle grep patterns for
  this specifically.
- Check `robots.txt` / `sitemap.xml` for disallowed API paths — a self-inflicted disclosure.
- Mobile-app endpoint inventories (via `apk-redteam-pipeline` / `ios-redteam-pipeline`) very
  often reference an older backend version than the current web app calls. Treat every
  APK/IPA-sourced endpoint as a version-diff candidate against the live web API.

---

## False-Positive Gate

- A version difference alone (different response shape, cosmetic field renaming) is
  Informational. The finding is a **security-relevant regression** — auth, rate-limit, or
  validation that got weaker going backward in version history.
- Confirm the old endpoint is not simply an alias/proxy to the current implementation before
  claiming a behavioral difference — send a payload that would actually behave differently
  under old vs. new logic, not just compare a version string in the response body.
- A `200` on a path that just serves a static "this API version is deprecated, use v2" message
  is not a finding — confirm the underlying operation still executes.

---

## Severity Table

| Finding | Severity |
|---|---|
| Old version bypasses auth entirely where current version requires it | Critical |
| Old version missing rate-limit present on current version | Medium–High (chain via `hunt-brute-force`) |
| Old version leaks extra fields (PII, internal IDs) vs. current | Medium–High |
| Old version accepts payloads the current version now validates/sanitizes | High (chain to the underlying injection class) |
| Version is reachable but behaviorally identical to current | Informational |

---

## Related Skills & Chains

- **`hunt-api-misconfig`** — owns exploitation once a spec or endpoint is in hand (mass
  assignment, JWT attacks, OData, Swagger-chain attacks). This skill hands it a sharper target:
  "here's a zombie endpoint with weaker validation than the current one."
- **`hunt-subdomain`** — owns host/subdomain-level discovery (`api-v1.target.com` as its own
  host, potential takeover). This skill owns what happens once you're inside a given host's
  version surface.
- **`hunt-source-leak`** — JS-bundle grep for internal/undocumented calls; reused here
  specifically for version-diffing rather than secret extraction.
- **`apk-redteam-pipeline`** / **`ios-redteam-pipeline`** — mobile builds routinely hardcode an
  older API version; every mobile-sourced endpoint is a version-diff candidate.
- **`hunt-brute-force`** — a rate-limit regression found here is only a complete finding once
  chained to actual brute-forceable impact (login, OTP, enumeration).

© Sachin Sharma · MIT · elementalsouls/Claude-BugHunter

Похожие скиллы

Все скиллы по теме «Безопасность» →
api-reference-documentation aj-geddes Скилл api-reference-documentation помогает агенту собрать справочник по API: эндпоинты, аутентификация, примеры запросов и ответов, спецификация OpenAPI. CX Codex +1 501установок doc-api davila7 Команда doc-api для Claude Code генерирует документацию API по кодовой базе проекта. Она находит маршруты, контроллеры и схемы данных, формируя спецификации OpenAPI или интерактивный Swagger UI. CX Codex +1 733установок api-documenter alirezarezvani Скилл api-documenter для Claude Code собирает спецификации API по коду и комментариям. Формирует документацию при изменении маршрутов или подготовке OpenAPI-документа. CX Codex +1 ★ 788звёзд репо design-rest-api davila7 Команда design-rest-api проектирует архитектуру REST API с эндпоинтами, аутентификацией и документацией OpenAPI с учётом текущего кода проекта. CX Codex +1 559установок api-design-reviewer Alireza Rezvani Скилл api-design-reviewer проверяет REST API по спецификациям OpenAPI, находит ломающие изменения и выставляет оценку дизайну. Пригодится при ревью пуллреквестов с новыми эндпоинтами. CX Codex +1 768установок adding-api-docs spencerpauly Скилл adding-api-docs собирает OpenAPI/Swagger-описание вашего API: схемы эндпоинтов, типы запросов и ответов, интерактивную страницу документации. CX Codex +1 455установок

Из того же набора92

Весь набор →
hunt-file-upload Скилл hunt-file-upload для поиска уязвимостей в функциях загрузки файлов: RCE через webshell, XSS через SVG, SSRF через XXE в DOCX, обход фильтров расширений. CX Codex +1 ★ 16 193звёзд репо hunt-nodejs Скилл hunt-nodejs для поиска уязвимостей в приложениях на Node.js, Express, Fastify, NestJS и Koa. CX Codex +1 ★ 16 193звёзд репо hunt-laravel Скилл hunt-laravel проверяет Laravel-приложения на уязвимости: от открытых панелей Telescope и Horizon до ошибок в подписанных URL. Запускайте его при аудите проекта на Laravel. CX Codex +1 ★ 16 193звёзд репо hunt-ssti Скилл hunt-ssti ищет серверный шаблонный инжекшн в Jinja2, Twig, Freemarker и других движках, а найденную пробу доводит до выполнения команд на сервере. CX Codex +1 ★ 16 193звёзд репо hunt-mfa-bypass Скилл hunt-mfa-bypass помогает проверять, можно ли обойти MFA в потоке входа: пропустить проверку, повторно использовать OTP или получить доступ к защищённому ресурсу раньше времени. Используйте его при аудите авторизации. CX Codex +1 ★ 16 193звёзд репо hunt-spa-api Скилл hunt-spa-api извлекает карту API из JS-бандлов одностраничного приложения и проверяет маршруты на отсутствие аутентификации. CX Codex +1 ★ 16 193звёзд репо hunt-jwt-crypto Скилл hunt-jwt-crypto ищет криптографические уязвимости в JWT-токенах: обход проверки через alg:none, подмену алгоритма RS256 на HS256 и инъекции в заголовки. CX Codex +1 ★ 16 193звёзд репо hunt-rag-vector Скилл hunt-rag-vector для Claude Code ищет слабые места в хранении и поиске векторов в RAG-системах. Запускается для приложений с общей базой знаний, загрузкой документов или доступным портом векторной БД. CX Codex +1 ★ 16 193звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой