- Home
- Skills
- APIs & Backend
- OpenAPI Security Check
More screenshots
Works with the AI Agents you already use
OpenAPI Security Check
Check OpenAPI and Swagger specs before you publish: write endpoints with no auth, plain http servers, real keys in examples, API keys in query strings, OAuth implicit and password flows, Basic auth and tokens in URLs.
$5
OpenAPI Security Check
Example session with this skill installed
Check this project with openapi-security-check.
- Read your context and instructions
- Compiled the openapi security check
$ python3 scripts/check_openapi.py examples/risky
BLOCK openapi.yaml:7 O02 PLAIN_HTTP_SERVER
server url: http://api.example.com/v1
Why: A server URL (or Swagger schemes) uses plain http://, so tokens, passwords and data travel unencrypted and can be read or changed on the network.
Safer: Serve the API over https:// only and remove http from servers and schemes (localhost is fine for development).
BLOCK openapi.yaml:32 O03 SECRET_IN_EXAMPLE
BLOCK openapi.yaml:45 O01 WRITE_WITHOUT_AUTH
REVIEW openapi.yaml:13 O12 API_KEY_IN_QUERY
REVIEW openapi.yaml:17 O14 HTTP_BASIC_AUTH
REVIEW openapi.yaml:20 O13 WEAK_OAUTH_FLOW
REVIEW openapi.yaml:35 O11 READ_WITHOUT_AUTH
REVIEW openapi.yaml:38 O15 SECRET_IN_URL_PARAMETER
(Each finding also has Why and Safer lines, as in the first one.)
Verdict: BLOCK. Checked 1 file, 1 with OpenAPI content.
This is a static check of file text. NOT FLAGGED is not a guarantee.
Connects securely to your tools. The creator never sees your data.
About this skill
A POST or DELETE endpoint with no security requirement in your OpenAPI spec tells every generated client and gateway that anyone may call it. A real key pasted into an example ends up in your public docs. This skill finds those and six other API spec risks, and tells you how to fix each one.
Your agent runs a scanner on openapi.yaml, swagger.json and similar files, in YAML or JSON, OpenAPI 3 or Swagger 2. It works out each operation's security from the global and operation settings, follows local $refs, understands camelCase names such as accessToken, and skips POSTs to login, sign-up and webhook endpoints. It returns BLOCK, REVIEW, or NOT FLAGGED, with the file, line, reason, and a safer approach.
What it checks
BLOCK
- O01: a POST, PUT, PATCH or DELETE operation with no security
- O02: a server URL using plain http://
- O03: a real-looking API key, token or secret in an example
REVIEW
- O11: a GET operation with no security in an API that uses auth
- O12: an API key sent in the query string
- O13: the OAuth2 implicit or password flow
- O14: HTTP Basic auth
- O15: a token or password passed as a query or path parameter
What's included
- The scanner (Python 3.9+, standard library only)
- A rules guide with the reason and safer approach for each rule
- A risky and a safe example spec, and the real report the scanner produces on the risky one
Limits It reads the spec, not your server, and does not follow $refs to other files. NOT FLAGGED is not a guarantee.
Find more skills like this on the Claude Skills Marketplace, the Codex Skills Marketplace and the Gemini Skills Marketplace, or browse Claude Skills for APIs & Backend.
Static check of the spec. Server code, $refs to other files, rate limits and input validation are not checked. NOT FLAGGED is not a guarantee.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before buying a skill.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
Fresh listing
Recently published to Agensi
Money-back guarantee
Doesn't do what its page promises? You get your money back.
Trust & safety
Security scan
Security scan passed 5 days ago
- Software
python3 (3.9 or newer)
Permissions
Runs one local Python script in the terminal. It reads your project's files, writes nothing, and makes no network calls. The example spec includes a clearly fake, inert key (tok_live_not_a_real_key_1234567890) for the scanner to find.