How viralvaghela/graphypy works
Project type and purpose
• This is an open-source, command-line Python tool (GraphQL Endpoint Detector) aimed at helping bug bounty hunters and penetration testers automatically detect GraphQL endpoints and schemas on a target URL.
File structure
• Top level:
• graphypy.py – main entry point containing the orchestration logic
• endpoints_wordlist.py – helper module providing common endpoint paths and wordlists
• requirements.txt – lists external Python dependencies (e.g., requests)
• README.md, LICENSE – documentation and licensing
• No frontend/backend folders because it’s a single-binary CLI.
• No explicit tests directory (could be added later).
• The presence of a wordlist module suggests a brute-forcing component; main script imports and sequences calls.
README for additional insights
• The README outlines a 4-step detection sequence:
1) Brute force endpoints from a wordlist
2) Try GraphQL introspection query
3) Fallback to GET introspection
4) Fallback to URL-encoded requests
• There’s a “ToDo” for mutation checks after endpoint detection.
• Usage is via “python graphypy.py URL” after installing dependencies.