graphql-methodology

Tests GraphQL endpoints for introspection leaks, injection, and authorization bypasses.

1|Updated Aug 3, 2026
One-click install
npx skills add https://github.com/hanmujun/hanmujun-agent-public --skill graphql-methodology-hanmujun
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: graphql-methodology
Source: https://github.com/hanmujun/hanmujun-agent-public/tree/main/skill-library/graphql-methodology
Command: npx skills add https://github.com/hanmujun/hanmujun-agent-public --skill graphql-methodology-hanmujun

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a CTF challenge or authorized target exposes a GraphQL endpoint, testers often lack a structured workflow to enumerate the schema, bypass disabled introspection, and exploit injection or authorization flaws. ## Core Features & Use Cases - Endpoint Discovery & Introspection: Confirms /graphql endpoints with a __typename probe and extracts the full schema via introspection queries. - Introspection Bypass Techniques: Covers field suggestion enumeration, GET request WAF bypass, alias/fragment obfuscation, and case/whitespace mutations when introspection is disabled. - Exploitation Patterns: Provides alias-based batch ID enumeration, SQL injection through GraphQL arguments, mutation-based privilege escalation, and rate-limit bypass via batched aliases. - Use Case: During an authorized CTF web challenge, you find /graphql returning data/errors JSON. Follow the phases to dump the schema, enumerate hidden flag fields, and extract the flag via aliased batch queries. ## Quick Start Ask the agent to load the graphql-methodology skill and test the target's /graphql endpoint starting with an introspection query.

Frequently Asked Questions about graphql-methodology

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

FAQPage Schema
How do I test a GraphQL endpoint for vulnerabilities?▼

Start by confirming the endpoint with a POST containing {"query":"{ __typename }"}, then run an introspection query to dump the full schema. Enumerate queries and mutations, probe hidden fields, and test injection and authorization bypass on identified arguments.

How to bypass disabled GraphQL introspection?▼

Use field suggestion enumeration by sending misspelled field names and reading the 'Did you mean' errors. Also try GET requests with the query in the URL parameter, alias or fragment obfuscation, and case or whitespace mutations of __schema.

How do I enumerate multiple user IDs in one GraphQL query?▼

Use GraphQL aliases to batch multiple queries in a single request, such as {u1:user(id:1){name} u2:user(id:2){name}}. This avoids sending many requests and can also bypass rate limiting on mutations.

Can GraphQL parameters be vulnerable to SQL injection?▼

Yes, when server-side code concatenates GraphQL argument values into SQL queries. Test string arguments with payloads like "admin' OR '1'='1" or UNION SELECT statements targeting flag tables.

What tools help automate GraphQL security testing?▼

Clairvoyance can recover schemas when introspection is disabled by exploiting field suggestions, and graphql-cop audits endpoints for common misconfigurations. Manual alias batching and WAF bypass techniques complement these automated tools.