Crawl APIs

Scannt eine Codebasis nach REST-, GraphQL-, gRPC- und OpenAPI-Definitionen

von ea-toolkit · ea-toolkit/architecture-catalog

Getestet · Funktioniert ★ 9.2/10

Crawl APIs — Scannt eine Codebasis nach REST-, GraphQL-, gRPC- und OpenAPI-Definitionen

Was es kann

Scannt eine Ziel-Codebasis nach API-Definitionen über OpenAPI/Swagger-Spezifikationen, Express/Fastify/NestJS-Routen, GraphQL-Schemas, gRPC-Protos und Python-Frameworks und schlägt dann Entwürfe für api_contract und api_endpoint Registry-Einträge zur Überprüfung vor. Wird ausgelöst beim Entdecken, Inventarisieren oder Katalogisieren der APIs in einem Repo.

Testbericht

Die exakten Erkennungsmuster des Skills wurden auf ein speziell angefertigtes Ziel mit sechs verschiedenen API-Stilen angewendet, und es wurden alle sechs (6/6) gefunden – einschließlich des NestJS-Decorator-Controllers, des GraphQL-Schemas und des gRPC-Proto-Dienstes, die eine naive Ein-Pass-Grep-für-Route/API-Baseline komplett übersehen hatte (3/6). Die Multi-Protokoll-Taxonomie plus Deduplizierungsprüfung und die Disziplin des Nur-Entwurfs-Status ist ein konkreter, reproduzierbarer Vorteil gegenüber der Ad-hoc-Suche. Der Rückschreibschritt hängt von den models/registry-mapping.yaml und Templates des Katalogs ab, sodass die vollständige Registry-Ausgabe innerhalb des eigenen Repos funktioniert; der Discovery-Kern funktioniert überall.

Getestet am: 2026-07-18 · Claude Code 2.x (agent harness)

Installation

git clone https://github.com/ea-toolkit/architecture-catalog
mkdir -p ~/.claude/skills
cd architecture-catalog && cp -r .claude/skills/crawl-apis ~/.claude/skills/crawl-apis

Befehle & Beispiel-Prompts

  • /crawl-apisScannt eine Codebasis nach REST-, GraphQL-, gRPC- und OpenAPI-Definitionen

Skills reagieren auf normale Anfragen — keine Slash-Befehle nötig. Nach der Installation aktivieren Prompts wie diese den Skill (auf Englisch):

  • Scan my repo and find every REST, GraphQL, and gRPC API endpoint.
  • I need an inventory of all the API contracts across this service.
  • Can you catalog the OpenAPI, NestJS, and Express routes in this codebase?