Crawl APIs

Skanna en kodbas efter REST-, GraphQL-, gRPC- och OpenAPI-definitioner

av ea-toolkit · ea-toolkit/architecture-catalog

Testad · Fungerar ★ 9.2/10

Crawl APIs — Skanna en kodbas efter REST-, GraphQL-, gRPC- och OpenAPI-definitioner

Vad den gör

Skannar en mål-kodbas efter API-definitioner över OpenAPI/Swagger-specifikationer, Express/Fastify/NestJS-rutter, GraphQL-scheman, gRPC-protos och Python-ramverk, föreslår sedan utkast till api_contract och api_endpoint registerposter för granskning. Utlöses vid upptäckt, inventering eller katalogisering av API:er i ett repo.

Testrapport

Körde färdighetens exakta detektionsmönster mot ett specialbyggt mål med sex olika API-stilar och den hittade alla sex (6/6) - inklusive NestJS decorator-kontrollern, GraphQL-schemat och gRPC proto-tjänsten som en naiv en-pass grep-for-route/api-baslinje helt missade (3/6). Den multiprotokoll-taxonomin plus dedup-kontroll och disciplinen med endast utkast-status är en konkret, reproducerbar fördel jämfört med ad-hoc-sökning. Återskrivningssteget beror på katalogens models/registry-mapping.yaml och mallar, så fullständig registerutdata fungerar inom dess hem-repo; upptäcktskärnan fungerar överallt.

Testad: 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

Kommandon och exempelprompter

/crawl-apisSkanna en kodbas efter REST-, GraphQL-, gRPC- och OpenAPI-definitioner

Skills triggas av vanliga förfrågningar — inga kommandon att memorera. Efter installationen aktiverar prompter som dessa skillen (på engelska):

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?

Läs hela rapporten →